接口名称tt.oapi.supplier.data.create接口说明新增供应商资料程序代号soap_oapi00077输入参数说明参数代号型态是否必填参数说明范例值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是接收方产品名称TIPTOPnamestring是服务名称tt.oapi.supplier.data.createsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码,提供同一产品多台主机辨别之用topproddatakeyEntIdstring否企业编号CompanyIdstring否营运据点DS1enterprise_nostring否企业编号supplier_nostring是供应商编号DAJA001参数代号型态是否必填参数说明范例值ERP栏位enterprise_nostring否企业别不使用site_nostring否营运中心不使用is_digiwin_productstring是是否为鼎捷产品(Y,N)Ysupplier_detail—是供应商明细(单头节点,支持多数组)supplier_nostring是供应商编号(入参.is_auto_coding传入Y时,此入参须传入”编码性质-编码类型-编码编号”,若编码编号有多组则须以-隔开,由ERP自动编码;入参.is_auto_coding传入N或为空时,DAJA001pmc01此入参须传入”供应商编号”)is_auto_codingstring否是否自动编码(Y,N)(供应商编号是否由ERP自动编码)Ysupplier_full_namestring否供应商全名靖江市格瑞特传动轴有限公司pmc081supplier_shortnamestring否供应商简称鼎新计算机pmc03trans_object_typestring否交易对象类型1:送货厂商2:付款厂商3:两者3pmc30payment_supplier_nostring否付款厂商(交易对象类型=2或3,此入参可不传)pmc04delivery_supplier_nostring否送货厂商(交易对象类型=1或3,此入参可不传)pmc901legal_typestring否法人类型不使用belong_legalstring否所属法人不使用belong_group_nostring否所属集团不使用uniform_numberstring否统一编号33pmc24data_typestring否资料类别1:采购厂商2:杂项厂商3:员工4:代理商6:代送商1pmc14is_affiliatestring否是否为关系人(Y,N)Npmc903vendor_classificationstring否厂商分类S1pmc02region_nostring否区域别101pmc06country_nostring否国家别JPpmc07area_nostring否地区别101pmc908zip_codestring否邮政编码101pmc904addressstring否地址401pmc091invoice_addressstring否发票地址台中市中兴路666号pmc52invoice_mailing_addressstring否寄票地址台中市中兴路666号pmc53remittance_ac_nostring否汇款账号001-1234566776pmc56remitting_bankstring否汇款银行102100000030pmc55telephone_nostring否电话04-2345678pmc10industry_idstring否产业别不使用monthly_settlement_daynumeric否月结日1pmc29payment_daynumeric否付款日不使用receivable_daynumeric否收款日不使用purchaser_nostring否预设采购员不使用responsibility_departstring否预设采购部门不使用ment_nocreate_employee_nostring否建档人员编号00939pmcoriucurrency_nostring否交易币别CNYpmc22tax_nostring否交易税别pmc47payment_condition_nostring否付款条件102pmc17price_conditionstring否价格条件F01pmc49language_categorystring否语言类别0:繁体中文1:English2:简体中文3:日本语4:VietNam5:Tai6:Korean0pmc911asking_for_waiverstring否缴交切结书0:不需1:未缴2:已缴0pmc902note_delivery_methodstring否票据寄领1:寄出2:自领3:其它1pmc27is_prepayment_with_purchasestring否预付金额是否与采购单勾稽(Y,N)Npmc913trade_condition_nostring否交易条件不使用account_typestring否帐款类别不使用create_datedate否资料创建日2015-06-23pmccrattrans_object_relation_detail—是交易对象关系明细(单身节点,支持多数组)trade_typestring否交易类型不使用is_mainstring否主要否不使用trans_object_nostring否交易对象编号不使用contact_address_detail—是联络地址明细/联系地址明细(单身节点,支持多数组)brief_nostring否简要编号不使用address_typestring否地址类型不使用is_main_contact_addressstring否主要联络地址不使用country_codestring否国家/地区不使用addressstring否地址不使用expiration_datedate否失效日期不使用communication_detail—是通讯方式(单身节点,支持多数组)communication_typestring否通讯类型不使用communication_contentstring否通讯内容不使用is_main_communication_methodstring否是否主要通讯方式不使用expiration_datedate否失效日期不使用bank_info—是银行信息(单身节点,支持多数组)bank_codestring否银行编号0040107pmf02bank_accountstring否银行账户1238888pmf03main_receive_bank_accountstring否主要收款银行账户不使用main_payment_bank_accountstring否主要付款银行账户(Y,N)Ypmf05allow_payment_condition—是允许付款条件(单身节点,支持多数组)trade_condition_nostring否交易条件编号不使用is_mainstring否主要否不使用Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:a5e7f741701e726aefeaaa58199a724fdigi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_TW","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"tt","name":"tt.oapi.supplier.data.create","ip":"10.20.88.75","id":"topprod"}digi-datakey:{"EntId":"企业编号","CompanyId":"营运据点","supplier_no":"供应商编号"}{"std_data":{"parameter":{"enterprise_no":"企业编号","site_no":"营运据点","is_digiwin_product":"是否为鼎捷产品","supplier_detail":[{"supplier_no":"供应商编号","is_auto_coding":"是否自动编码","supplier_full_name":"供应商全名","supplier_shortname":"供应商简称","trans_object_type":"交易对象类型","payment_supplier_no":"付款厂商","delivery_supplier_no":"送货厂商","legal_type":"法人类型","belong_legal":"所属法人","belong_group_no":"所属集团","uniform_number":"统一编号","data_type":"资料类别","is_affiliate":"是否为关系人","vendor_classification":"厂商分类","region_no":"区域别","country_no":"国家别","area_no":"地区别","zip_code":"邮政编码","address":"地址","invoice_address":"发票地址","invoice_mailing_address":"寄票地址","remittance_ac_no":"汇款账号","remitting_bank":"汇款银行","telephone_no":"电话","industry_id":"产业别","monthly_settlement_day":"月结日","payment_day":"付款日","receivable_day":"收款日","purchaser_no":"预设采购员","responsibility_department_no":"预设采购部门","create_employee_no":"建档人员编号","currency_no":"交易币别","tax_no":"交易税别","payment_condition_no":"付款条件","price_condition":"价格条件","language_category":"语言类别","asking_for_waiver":"缴交切结书","note_delivery_method":"票据寄领","is_prepayment_with_purchase":"预付金额是否与采购单勾稽","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栏位supplier_noString是供应商编号DAJA001pmaa006statuscodestring是错误码0:正确<>0:FAIL(原因代码)0sql_codestring否失败时数据库回传代码0descriptionstring否错误问题描述supplier_no—是供应商编号(单头节点,支持多数组)erp_nostring否ERP编号(执行成功时把PK值回传,若执行失败回传空值)A01396000pmc01source_nostring是来源单号(编号)pmc01(回传入参中的PK栏位值)execute_descriptionstring否执行描述(执行成功则回传空值;执行失败则回传失败描述)Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:297858af-3f3b-4a21-b260-d1e40f566dc3digi-protocol:rawdigi-srvver:1.0digi-srvcode:000digi-datakey:{"erp_no":"ERP编号","source_no":"来源单号(编号)"}{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"supplier_no":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述"}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值ERP栏位supplier_noString是供应商编号DAJA001pmaa006statuscodestring是错误码0:正确<>0:FAIL(原因代码)0sql_codestring否失败时数据库回传代码0descriptionstring否错误问题描述supplier_no—是供应商编号(单头节点,支持多数组)erp_nostring否ERP编号(执行成功时把PK值回传,若执行失败回传空值)pmc01source_nostring是来源单号(编号)(回传入参中的PK栏位值)pmc01execute_descriptionstring否执行描述(执行成功则回传空值;执行失败则回传失败描述)Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:297858af-3f3b-4a21-b260-d1e40f566dc3digi-protocol:rawdigi-srvver:1.0digi-srvcode:100digi-datakey:{"erp_no":"ERP编号","source_no":"来源单号(编号)"}{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"supplier_no":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述"}]}}}