接口名称tt.oapi.shipping.data.create接口说明新增出货单资料程序代号soap_oapi00144输入参数说明参数代号型态是否必填参数说明范例值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.shipping.data.createsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码,提供同一产品多台主机辨别之用topprddatakeyEntIdstring是企业编号CompanyIdstring否营运据点DS1参数代号型态是否必填参数说明范例值ERP字段enterprise_nostring否企业编号不使用site_nostring否营运据点不使用is_digiwin_productstring是是否为鼎捷产品(Y,N)Yshipping_info—是出货单信息(单头节点,支持多数组)source_nostring是来源单号SOURCE230724001oga74doc_slipstring是单据单别200-23072402oga01doc_datedate否单据日期格式:yyyyMMdd若无传值则预设值g_today20230724oga02sales_nostring否业务人员012345oga14sales_department_nostring否业务部门TP320oga15customer_nostring是客户编号00001oga03delivery_customer_nostring否收货客户00001oga04account_customerstring否收款客户00001oga18doc_typestring否单据性质2.出貨單A.借貨出貨單3.無訂單出貨單2oga09shipping_propertystring否出货性质1.一般出貨2.換貨出貨3.出至境外倉4.境外倉出貨5.BU間銷售6.調貨出貨7.寄銷出貨A.借貨出貨B.借貨償價1oga00in_transit_cost_warehouse_nostring否在途成本仓不使用in_transit_non_cost_warehouse_nostring否在途非成本仓不使用delivery_addressstring否送货地址oga044receive_conditionstring否收款条件002oga32trade_conditionstring否交易条件不使用tax_nostring否税别编号001oga21currency_nostring否币别编号CNYoga23invoice_classstring否发票类型13oga05valuation_method_nostring否取价方式编号不使用internal_external_salsestring否内外销1oga08rate_calculation_typestring否汇率计算基准类型不使用sales_classification_nostring否销售分类1000oga25sales_channel_nostring否销售通路不使用remarkstring否备注不使用create_employee_nostring否建档人员编号若无传值则预设值g_user1234ogaoriucreate_datedate否资料创建日格式:yyyyMMdd若无传值则预设值g_today20230306ogadatedoc_approve_setstring否单据签核设定(Y,N)shipping_detail—是出货明细(单身节点,支持多数组)seq_nonumeric是项次1ogb03shipping_notice_nostring否出通单号201-13060621oga011shipping_notice_seqnumeric否出通项次1不使用so_nostring否订单单号100-23072402ogb31so_seqnumeric否订单项次1ogb32item_nostring否料件编号12787-Aogb04product_feature_nostring否产品特征不使用shipping_unit_nostring否出货单位PCSogb05shipping_qtynumeric否出货数量20ogb12warehouse_nostring否库位编号T16584ogb09location_nostring否储位001ogb091lot_nostring否批号ogb092inventory_management_featuresstring否库存管理特征不使用valuation_unit_nostring否计价单位PCSogb916valuation_pricenumeric否单价5.0000ogb13project_nostring否项目编号ogb41multiple_warehouse_storage_lot_detail—是多库储批明细/多仓库储位批号详情(子单身节点,支持多数组)warehouse_nostring否库位编号T16584ogc09location_nostring否储位001ogc091lot_nostring否批号ogc092shipping_qtynumeric否出货数量20ogc12inventory_management_featuresstring否库存管理特征不使用Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:797c0407bad455ceeed6d26ae4949c40digi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_CN","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"TIPTOP","name":"tt.oapi.shipping.data.create","ip":"10.20.88.75","id":"topprod"}digi-datakey:{"EntId":"企业编号","CompanyId":"营运据点","source_no":"来源单号"}{"std_data":{"parameter":{"enterprise_no":"企业编号","site_no":"营运据点","is_digiwin_product":"是否为鼎捷产品","shipping_info":[{"source_no":"来源单号","doc_slip":"单据单别","doc_date":"单据日期","sales_no":"业务人员","sales_department_no":"业务部门","customer_no":"客户编号","delivery_customer_no":"收货客户","account_customer":"收款客户","doc_type":"单据性质","shipping_property":"出货性质","in_transit_cost_warehouse_no":"在途成本仓","in_transit_non_cost_warehouse_no":"在途非成本仓","delivery_address":"送货地址","receive_condition":"收款条件","trade_condition":"交易条件","tax_no":"税别编号","currency_no":"币别编号","invoice_class":"发票类型","valuation_method_no":"取价方式编号","internal_external_salse":"内外销","rate_calculation_type":"汇率计算基准类型","sales_classification_no":"销售分类","sales_channel_no":"销售通路","remark":"备注","create_employee_no":"建档人员编号","create_date":"资料创建日","doc_approve_set":"单据签核设定","shipping_detail":[{"seq_no":"项次","shipping_notice_no":"出通单号","shipping_notice_seq":"出通项次","so_no":"订单单号","so_seq":"订单项次","item_no":"料件编号","product_feature_no":"产品特征","shipping_unit_no":"出货单位","shipping_qty":"出货数量","warehouse_no":"库位编号","location_no":"储位","lot_no":"批号","inventory_management_features":"库存管理特征","valuation_unit_no":"计价单位","valuation_price":"单价","project_no":"项目编号","multiple_warehouse_storage_lot_detail":[{"warehouse_no":"库位编号","location_no":"储位","lot_no":"批号","shipping_qty":"出货数量","inventory_management_features":"库存管理特征"}]}]}]}}}成功返回参数说明参数代号型态是否必填参数说明范例值ERP字段srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程,并产生预期的结果(Basicflow)100:服务未按照正常流程执行,例如发生信息检核不通过等情况,导致无法完成预期的结果000参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码0:正确<>0:FAIL(原因代码)00sql_codestring否失败时数据库回传代码00descriptionstring否错误问题描述shipping_info—是出货单信息(单头节点,支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传,若执行失败回传空值)200-23072402oga01source_nostring是来源单号(编号)(回传入参中的PK字段值)SOURCE230724001oga74execute_descriptionstring否执行描述(执行成功则回传空值;执行失败则回传失败描述)is_auto_confirmstring否是否自动确认NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:61053a81-af84-45e4-980b-97a5086354efdigi-protocol:rawdigi-srvver:1.0digi-srvcode:000{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"shipping_info":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述","is_auto_confirm":"是否自动审核"}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值ERP字段srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程,并产生预期的结果(Basicflow)100:服务未按照正常流程执行,例如发生信息检核不通过等情况,导致无法完成预期的结果000参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码0:正确<>0:FAIL(原因代码)aws1380sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述抛转笔数:1笔成功笔数:0笔失败笔数:1笔shipping_info—是出货单信息(单头节点,支持多数组)erp_nostring否ERP编号(执行成功时把PK值回传,若执行失败回传空值)source_nostring是来源单号(编号)(回传入参中的PK字段值)SOURCE230724001oga74execute_descriptionstring是执行描述(执行成功则回传空值;执行失败则回传失败描述)传入的资料不存在或已失效is_auto_confirmstring否是否自动确认NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:43837244-7560-4cff-93f6-73fc704eb2c2digi-protocol:rawdigi-srvver:1.0digi-srvcode:100{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"shipping_info":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述","is_auto_confirm":"是否自动审核"}]}}}