接口名称t100.oapi.customer.data.create接口说明创建客户资料程序代号wssp00136输入参数说明参数代号型态是否必填参数说明范例值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_TWserviceprodstring是接收方产品名称T100namestring是服务名称t100.oapi.customer.data.createsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码，提供同一产品多台主机辨别之用topprddatakeyEntIdstring是企业编号99CompanyIdstring否营运据点DSCTC参数代号型态是否必填参数说明范例值ERP字段enterprise_nostring否企业编号若无传值则预设值g_enterprise99pmaaentsite_nostring否营运中心pmaa095is_digiwin_productstring是是否为鼎捷产品(Y,N)Ycustomer_detail—是客户明细(单头节点，支持多数组)customer_nostring是客户编号16584TESTpmaa001customer_full_namestring否客户全名16584测试客户资料pmaal003customer_shortnamestring否客户简称16584测资pmaal004trans_object_typestring否交易对象类型1.供应商,2.客户,3.二者皆是2pmaa002legal_typestring否法人类型1.法人,1pmaa0042.一次性交易对象,3.分公司,4.内部员工belong_legalstring否所属法人16584TESTpmaa005belong_group_nostring否所属集团A002pmaa006uniform_numbernumeric否统一编号12345678pmaa003country_nostring否国家别TWpmaa007industry_idstring否产业别pmaa023monthly_settlement_daynumeric否月结日25pmaa038payment_daynumeric否付款日10pmaa041receivable_daynumeric否收款日15pmaa044main_sales_nostring否负责业务人员16584pmaa096responsibility_department_nostring否负责业务部门DC0300pmaa097create_employee_nostring否建档人员编号16584pmaacrtidcurrency_nostring否交易币别TWDpmaa011tax_nostring否交易税别001pmab084receive_conditionstring否收款条件101pmab087trade_condition_nostring否交易条件CFRpmab053account_typestring否帐款类别101pmab055create_datedate否资料创建日格式：yyyyMMddHHmmss20230606161419pmaacrtdttrans_object_relation_detail—是交易对象关系明细(单身节点，支持多数组)trade_typestring否交易类型1.收/付款对象,2.送货对象,3.发票对象1pmac003is_mainboolean否主要否Npmac004trans_object_nostring否交易对象编号00000002pmac002contact_address_detail—是联络地址明细/联系地址明细(单身节点，支持多数组)brief_nostring否简要编号TESToofb019address_typestring否地址类型1.登记地址,2.联络地址,3.送货地址,4.其他地址,5.帐款地址1oofb008is_main_contact_addrestring否是否主要联络地址Noofb010ssY/Ncountry_codestring否国家/地区TWoofb012addressstring否地址oofb017expiration_datedate否失效日期格式：yyyyMMdd20991231oofb018communication_detail—是通讯方式(单身节点，支持多数组)communication_typestring否通讯类型1:一般电话2:行动电话3:传真4:电子邮件5:Skype联络6:Skypeout7:QQ8:Facebook9:网址10:发票电话4oofc008communication_contentstring否通讯内容oofc012is_main_communication_methodstring否是否主要通讯方式Y/NYoofc010expiration_datedate否失效日期格式：yyyyMMdd20991231oofc013bank_info—是银行信息(单身节点，支持多数组)bank_codestring否银行编号pmaf002bank_accountstring否银行账户pmaf003main_receive_bank_accountstring否主要收款银行账户Y/NYpmaf008main_payment_bank_accountstring否主要付款银行账户Y/NYpmaf009allow_payment_condition—是允许付款条件(单身节点，支持多数组)trade_condition_nostring否交易条件编号001pmad002is_mainstring否主要否Y/NNpmad004Request范例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":"T100","name":"t100.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编号16584TESTpmaa001source_nostring否来源单号(编号)16584TESTpmaa001参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码00：正确<>0：FAIL（原因代码）sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述customer_detail—否客户明细(单头节点，支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传，若执行失败回传空值)16584TESTpmaa001source_nostring是来源单号(编号)(回传入参中的PK字段值)16584TESTpmaa001execute_descriptionstring否执行描述(执行成功则回传空值；执行失败则回传失败描述)Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:d71a4e22-8ea3-48f0-8743-39f496d64549digi-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编号16584TESTpmaa001source_nostring否来源单号(编号)16584TESTpmaa001参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码0：正确<>0：FAIL（原因代码）aws-00102sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述[T100_message]处理笔数1,成功0,失败1customer_detail—否客户明细(单头节点，支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传，若执行失败回传空值)source_nostring是来源单号(编号)(回传入参中的PK字段值)16584TESTpmaa001execute_descriptionstring否执行描述(执行成功则回传空值；执行失败则回传失败描述)传入的资料不存在或已失效Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:24200a6f-c903-41d5-a8bf-f2b3a8dfa755digi-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":"执行描述"}]}}}
