接口名称tt.oapi.customer.data.create接口说明创建客户资料程序代号soap_oapi00136输入参数说明参数代号型态是否必填参数说明范例值requestkeystring是检核编码(MD5)109c3c41a1441e702b909ed3de58e4b1typestring是Request类型(sync,async)固定传入synchostprodstring是发起方产品名称OAPIverstring是发起方产品版本1.0ipstring是发起方IP位置10.40.71.91idstring否发起方产品识别码，提供同一产品多台主机辨别之用acctstring是登入帐号固定传入tiptoptimestampstring是时间戳记格式：yyyyMMddHHmmssSSS20151211123204361timezonestring否发起方时区(-12~+14)+8langstring是语言别(zh_TW,zh_CN,en,vi)zh_CNserviceprodstring是接收方产品名称ttnamestring是服务名称tt.oapi.customer.data.createsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码，提供同一产品多台主机辨别之用topprddatakeyEntIdstring否企业编号CompanyIdstring否营运据点DS1参数代号型态是否必填参数说明范例值ERP栏位enterprise_nostring否企业编号若无传值则预设值g_enterprisesite_nostring否营运中心is_digiwin_productstring是是否为鼎捷产品(Y,N)Ycustomer_detail—是客户明细(单头节点，支持多数组)customer_noString是客户编号16584TESTocc01customer_full_nameString否客户全名16584测试客户资料occ18customer_shortnameString否客户简称16584测资occ02trans_object_typeString否交易对象类型1.供应商,2.客户,3.二者皆是2occ06legal_typeString否法人类型1.法人,2.一次性交易对象,3.分公司,4.内部员工belong_legalString否所属法人belong_group_noString否所属集团A002occ34uniform_numbernumeric否统一编号12345678occ11country_nostring否国家别TWocc21industry_idstring否产业别monthly_settlement_daynumeric否月结日25occ38payment_daynumeric否付款日10occ39receivable_daynumeric否收款日main_sales_nostring否负责业务人员16584occ04responsibility_department_nostring否负责业务部门create_employee_nostring否建档人员编号16584occoriucurrency_nostring否交易币别TWDocc42tax_nostring否交易税别001occ41receive_conditionstring否收款条件101occ45trade_condition_nostring否交易条件account_typestring否帐款类别create_datedate否资料创建日20230606occdatetrans_object_relation_detail—是交易对象关系明细(单身节点，支持多数组)trade_typestring否交易类型1.收/付款对象,2.送货对象,3.发票对象is_mainboolean否主要否trans_object_nostring否交易对象编号00000002occ007/occ009contact_address_detail—是联络地址明细/联系地址明细(单身节点，支持多数组)brief_nostring否简要编号address_typestring否地址类型1.登记地址,2.联络地址,3.送货地址,4.其他地址,5.帐款地址is_main_contact_addressstring否是否主要联络地址country_codestring否国家/地区addressstring否地址occ231/occ241expiration_datedate否失效日期communication_detail—是通讯方式(单身节点，支持多数组)communication_typestring否通讯类型1:一般电话2:行动电话3:传真4:电子邮件5:Skype联络6:Skypeout7:QQ8:Facebook9:网址10:发票电话communication_contentstring否通讯内容occ261/occ262/occ263is_main_communication_methodstring否是否主要通讯方式Yexpiration_datedate否失效日期bank_info—是银行信息(单身节点，支持多数组)bank_codestring否银行编号ocj02bank_accountstring否银行账户ocj03main_receive_bank_accountstring否主要收款银行账户Yocj05main_payment_bank_accountstring否主要付款银行账户allow_payment_condition—是允许付款条件(单身节点，支持多数组)trade_condition_nostring否交易条件编号is_mainstring否主要否Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:5addbad5ad2f853afbcb515e0f281873digi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_CN","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"tt","name":"tt.oapi.customer.data.create","ip":"10.20.88.75","id":"topprod"}digi-datakey:{"EntId":"企业编号","CompanyId":"营运据点","customer_no":"客户编号"}{"std_data":{"parameter":{"enterprise_no":"企业编号","site_no":"营运据点","is_digiwin_product":"是否为鼎捷产品","customer_detail":[{"customer_no":"客户编号","customer_full_name":"客户全名","customer_shortname":"客户简称","trans_object_type":"交易对象类型","legal_type":"法人类型","belong_legal":"所属法人","belong_group_no":"所属集团","uniform_number":"统一编号","country_no":"国家别","industry_id":"产业别","monthly_settlement_day":"月结日","payment_day":"付款日","receivable_day":"收款日","main_sales_no":"负责业务人员","responsibility_department_no":"负责业务部门","create_employee_no":"建档人员编号","currency_no":"交易币别","tax_no":"交易税别","receive_condition":"收款条件","trade_condition_no":"交易条件","account_type":"帐款类别","create_date":"资料创建日","trans_object_relation_detail":[{"trade_type":"交易类型","is_main":"主要否","trans_object_no":"交易对象编号"}],"contact_address_detail":[{"brief_no":"简要编号","address_type":"地址类型","is_main_contact_address":"是否主要联络地址","country_code":"国家/地区","address":"地址","expiration_date":"失效日期"}],"communication_detail":[{"communication_type":"通讯类型","communication_content":"通讯内容","is_main_communication_method":"是否主要通讯方式","expiration_date":"失效日期"}],"bank_info":[{"bank_code":"银行编号","bank_account":"银行账户","main_receive_bank_account":"主要收款银行账户","main_payment_bank_account":"主要付款银行账户"}],"allow_payment_condition":[{"trade_condition_no":"交易条件编号","is_main":"主要否"}]}]}}}成功返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，并产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果000datakeyerp_nostring否ERP编号16584TESTocc01source_nostring否来源单号(编号)16584TESTocc01参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码00：正确<>0：FAIL（原因代码）sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述customer_detail—否客户明细(单头节点，支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传，若执行失败回传空值)16584TESTocc01source_nostring是来源单号(编号)(回传入参中的PK栏位值)16584TESTocc01execute_descriptionstring否执行描述(执行成功则回传空值；执行失败则回传失败描述)Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:c2694722-cb55-4ffe-ba83-474266dec841digi-protocol:rawdigi-srvver:1.0digi-srvcode:000digi-datakey:{"erp_no":"ERP编号","source_no":"来源单号(编号)"}{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"customer_detail":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述"}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，并产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果000datakeyerp_nostring否ERP编号16584TESTocc01source_nostring否来源单号(编号)16584TESTocc01参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码0：正确<>0：FAIL（原因代码）aws-00102aws1380sql_codestring否失败时数据库回传代码descriptionstring是错误问题描述[tt_message]处理笔数1,成功0,失败1customer_detail—否客户明细(单头节点，支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传，若执行失败回传空值)source_nostring是来源单号(编号)(回传入参中的PK栏位值)16584TESTocc01execute_descriptionstring否执行描述(执行成功则回传空值；执行失败则回传失败描述)传入的资料不存在或已失效Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:b3d0514a-117b-4ed8-84ea-96ada4c3ea87digi-protocol:rawdigi-srvver:1.0digi-srvcode:100digi-datakey:{"erp_no":"ERP编号","source_no":"来源单号(编号)"}{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"customer_detail":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述"}]}}}
