深圳鼎润捷通供应链有限公司


创建订单

<p>创建订单</p> <h5>简要描述</h5> <ul> <li>无</li> </ul> <h5>请求URL</h5> <ul> <li><code>{host}/api/open/order_add</code></li> </ul> <h5>请求方式</h5> <ul> <li>post</li> </ul> <h5>Header</h5> <table> <thead> <tr> <th>字段名</th> <th>示例值</th> <th>必选</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>apikey</td> <td>6519827339</td> <td>是</td> <td>string</td> <td>apikey</td> </tr> <tr> <td>timestamp</td> <td>1724288542</td> <td>是</td> <td>string</td> <td>时间戳</td> </tr> <tr> <td>sign</td> <td>2fb775334b02d663127a8a9fd1edbc64</td> <td>是</td> <td>string</td> <td>签名</td> </tr> <tr> <td>accept</td> <td>application/json</td> <td>是</td> <td>string</td> <td>accept</td> </tr> <tr> <td>content-type</td> <td>application/json;charset=UTF-8</td> <td>是</td> <td>string</td> <td>content-type</td> </tr> <tr> <td>lang</td> <td>en-us</td> <td>是</td> <td>string</td> <td>lang</td> </tr> </tbody> </table> <h5>请求参数示例</h5> <pre><code>{ &amp;quot;reference_no&amp;quot;: &amp;quot;AW14w58721021q2112&amp;quot;, &amp;quot;cecm&amp;quot;: null, &amp;quot;shipping_method&amp;quot;: &amp;quot;CNFED-IP5000B&amp;quot;, &amp;quot;country_code&amp;quot;: &amp;quot;US&amp;quot;, &amp;quot;weight&amp;quot;: &amp;quot;1.25&amp;quot;, &amp;quot;volume&amp;quot;: &amp;quot;1.25&amp;quot;, &amp;quot;pieces&amp;quot;: &amp;quot;12&amp;quot;, &amp;quot;platform&amp;quot;: &amp;quot;Amazon&amp;quot;, &amp;quot;platform_no&amp;quot;: &amp;quot;TDS-986548-6310&amp;quot;, &amp;quot;amount&amp;quot;: 170.32, &amp;quot;amount_currency&amp;quot;: &amp;quot;HKD&amp;quot;, &amp;quot;remark&amp;quot;: null, &amp;quot;shipper_name&amp;quot;: &amp;quot;张三&amp;quot;, &amp;quot;shipper_company&amp;quot;: &amp;quot;张三公司&amp;quot;, &amp;quot;shipper_country_code&amp;quot;: &amp;quot;CN&amp;quot;, &amp;quot;shipper_province&amp;quot;: &amp;quot;广东省&amp;quot;, &amp;quot;shipper_city&amp;quot;: &amp;quot;深圳市&amp;quot;, &amp;quot;shipper_area&amp;quot;: &amp;quot;希望小区&amp;quot;, &amp;quot;shipper_street&amp;quot;: &amp;quot;坂田街道吉华路509号&amp;quot;, &amp;quot;shipper_postcode&amp;quot;: &amp;quot;51800&amp;quot;, &amp;quot;shipper_telephone&amp;quot;: &amp;quot;0755-86858698&amp;quot;, &amp;quot;shipper_mobile&amp;quot;: &amp;quot;13367154259&amp;quot;, &amp;quot;shipper_email&amp;quot;: &amp;quot;81562632654@gmai.com&amp;quot;, &amp;quot;consignee_name&amp;quot;: &amp;quot;Anri Kawatani&amp;quot;, &amp;quot;consignee_company&amp;quot;: &amp;quot;Kawatani CO.&amp;quot;, &amp;quot;consignee_doorplate&amp;quot;: &amp;quot;S5869&amp;quot;, &amp;quot;consignee_province&amp;quot;: &amp;quot;112132121&amp;quot;, &amp;quot;consignee_city&amp;quot;: &amp;quot;Matsubara Shi&amp;quot;, &amp;quot;consignee_area&amp;quot;: null, &amp;quot;consignee_street&amp;quot;: &amp;quot;6-3-33 Miyakenaka,Matsubara-shi,Osaka,Japan,580-0046&amp;quot;, &amp;quot;consignee_street2&amp;quot;: &amp;quot;6-3-33 Miyakenaka,Matsubara-shi,Osaka,Japan,580-0046 -2&amp;quot;, &amp;quot;consignee_street3&amp;quot;: &amp;quot;6-3-33 Miyakenaka,Matsubara-shi,Osaka,Japan,580-0046 -3&amp;quot;, &amp;quot;consignee_mobile&amp;quot;: &amp;quot;13365245878&amp;quot;, &amp;quot;consignee_telephone&amp;quot;: &amp;quot;85693411&amp;quot;, &amp;quot;consignee_email&amp;quot;: &amp;quot;62554552144@d-rain.cn&amp;quot;, &amp;quot;consignee_postcode&amp;quot;: &amp;quot;218600&amp;quot;, &amp;quot;consignee_tax_no&amp;quot;: &amp;quot;218600&amp;quot;, &amp;quot;wh_code&amp;quot;: &amp;quot;ITTEST&amp;quot;, &amp;quot;items&amp;quot;: [ { &amp;quot;sku_code&amp;quot;: &amp;quot;MY_D_0312311&amp;quot;, &amp;quot;goods_name&amp;quot;: &amp;quot;检测工具&amp;quot;, &amp;quot;goods_en_name&amp;quot;: &amp;quot;Testing tools&amp;quot;, &amp;quot;goods_img&amp;quot;: &amp;quot;https://img.alicdn.com/imgextra/i1/6000000002115/O1CN01UXUkWd1RUieKQjej2_!!6000000002115-0-at.jpg_.webp&amp;quot;, &amp;quot;goods_link&amp;quot;: &amp;quot;https://chaoshi.detail.tmall.com/item.htm?id=773090238783&amp;amp;ali_trackid=2:mm_43125636_4246598_114820950246:1736220237249_557748378_0&amp;amp;spm=a2e1u.27659560.d166185234306.1&amp;amp;union_lens=lensId:OPT@1710136889@0b87bd25_0d45_18e2c1a0fce_934a@0245ZHkzNPR2oEmxWEf7w7uq@eyJmbG9vcklkIjo4NzgwMSwiic3JjRmxvb3JJZCI6IjM4OTU3In0ie;scm:1007.15348.115058.0_87801_dcc9dfdc-648f-4a08-a108-004187631aa0;recoveryid:554130571_0@1736220176148;prepvid:201_33.8.143.57_5046628_1736220176451&amp;amp;rootPageId=20150318020018244&amp;amp;scm=20140767.59990_33_61_49_76_467_1736220176704.0%7Citem%7C773090238783.0&amp;amp;bxsign=tbkozCsJYitTGOjM8oiN_WmCqDF8pU2LwYOklcHlXPCvd7PaNc5TzMZWzSMd7FHJjRb2VJvQTU7dzzeqan1eMQNrcmoXvME_zabbQWy6jLIuGvI9x5OQF5rqePGYZIi6MMwq2L5KJSGkJKOdR_CukfYyCeyzO_C8qcUAHui564nV_gUKDqKFwn2VZjELwnXsUKU&amp;quot;, &amp;quot;net_weight&amp;quot;: &amp;quot;0.012&amp;quot;, &amp;quot;gross_weight&amp;quot;: &amp;quot;0.50&amp;quot;, &amp;quot;quantity&amp;quot;: 10, &amp;quot;unit&amp;quot;: &amp;quot;个&amp;quot;, &amp;quot;unit_price&amp;quot;: &amp;quot;10.25&amp;quot;, &amp;quot;currency&amp;quot;: &amp;quot;CNY&amp;quot;, &amp;quot;amount&amp;quot;: 102.5, &amp;quot;material&amp;quot;: &amp;quot;铁&amp;quot;, &amp;quot;model&amp;quot;: &amp;quot;SL&amp;quot;, &amp;quot;use&amp;quot;: &amp;quot;大锅&amp;quot;, &amp;quot;brand&amp;quot;: &amp;quot;Ads&amp;quot;, &amp;quot;cs_hs_code&amp;quot;: 12345667, &amp;quot;cs_goods_name&amp;quot;: &amp;quot;检测工具&amp;quot;, &amp;quot;cs_goods_en_name&amp;quot;: &amp;quot;Testing tools&amp;quot;, &amp;quot;cs_brand&amp;quot;: &amp;quot;Ads&amp;quot;, &amp;quot;cs_use&amp;quot;: &amp;quot;大锅&amp;quot;, &amp;quot;cs_unit&amp;quot;: &amp;quot;个&amp;quot;, &amp;quot;cs_unit_price&amp;quot;: &amp;quot;10.25&amp;quot;, &amp;quot;cs_currency&amp;quot;: &amp;quot;CNY&amp;quot;, &amp;quot;cs_amount&amp;quot;: 102.5, &amp;quot;cs_unit_one&amp;quot;: &amp;quot;个&amp;quot;, &amp;quot;cs_unit_one_qty&amp;quot;: 10, &amp;quot;cs_unit_second&amp;quot;: &amp;quot;件&amp;quot;, &amp;quot;cs_unit_second_qty&amp;quot;: 10, &amp;quot;cs_des_country&amp;quot;: &amp;quot;USA&amp;quot;, &amp;quot;cs_origin_place&amp;quot;: &amp;quot;原产地区&amp;quot;, &amp;quot;cs_duty_mode&amp;quot;: &amp;quot;全免&amp;quot;, &amp;quot;cs_origin_country&amp;quot;: &amp;quot;原产国地区&amp;quot;, &amp;quot;cs_inside_place&amp;quot;: &amp;quot;境内目的地&amp;quot;, &amp;quot;cs_destinate_place&amp;quot;: &amp;quot;目的地代码&amp;quot;, &amp;quot;cs_declaration_elements&amp;quot;: &amp;quot;1|0|汽车维修检测用|连 接汽车电脑诊断座,读取车辆数据|检测|品牌THINKCAR||型号TCBD6&amp;quot; } ] }</code></pre> <h5>请求json字段说明</h5> <table> <thead> <tr> <th>字段名</th> <th>必选</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>reference_no</td> <td>是</td> <td>string</td> <td>客户单号 客户系统订单号</td> </tr> <tr> <td>cecm</td> <td>否</td> <td>object</td> <td>通关模式 如1210,9610等</td> </tr> <tr> <td>shipping_method</td> <td>是</td> <td>string</td> <td>物流渠道代码</td> </tr> <tr> <td>country_code</td> <td>是</td> <td>string</td> <td>国家二字码</td> </tr> <tr> <td>weight</td> <td>是</td> <td>string</td> <td>订单重量(kg)</td> </tr> <tr> <td>volume</td> <td>是</td> <td>string</td> <td>订单包裹体积(m3)</td> </tr> <tr> <td>pieces</td> <td>是</td> <td>string</td> <td>件数</td> </tr> <tr> <td>platform</td> <td>否</td> <td>string</td> <td>来源,如Amazon,ebay等</td> </tr> <tr> <td>platform_no</td> <td>否</td> <td>string</td> <td>平台订单号</td> </tr> <tr> <td>amount</td> <td>是</td> <td>string</td> <td>订单总金额</td> </tr> <tr> <td>amount_currency</td> <td>是</td> <td>string</td> <td>订单总金额币种</td> </tr> <tr> <td>remark</td> <td>否</td> <td>object</td> <td>订单备注</td> </tr> <tr> <td>shipper_name</td> <td>是</td> <td>string</td> <td>发件人名称</td> </tr> <tr> <td>shipper_company</td> <td>否</td> <td>string</td> <td>发件人公司</td> </tr> <tr> <td>shipper_country_code</td> <td>是</td> <td>string</td> <td>发件人国家二字码</td> </tr> <tr> <td>shipper_province</td> <td>是</td> <td>string</td> <td>发件人省/州</td> </tr> <tr> <td>shipper_city</td> <td>是</td> <td>string</td> <td>发件人城市</td> </tr> <tr> <td>shipper_area</td> <td>否</td> <td>string</td> <td>发件人区/县</td> </tr> <tr> <td>shipper_street</td> <td>是</td> <td>string</td> <td>发件人详细地址</td> </tr> <tr> <td>shipper_postcode</td> <td>否</td> <td>string</td> <td>发件人邮编</td> </tr> <tr> <td>shipper_telephone</td> <td>是</td> <td>string</td> <td>发件人联系电话</td> </tr> <tr> <td>shipper_mobile</td> <td>否</td> <td>string</td> <td>发件人联系手机</td> </tr> <tr> <td>shipper_email</td> <td>否</td> <td>string</td> <td>发件人邮编</td> </tr> <tr> <td>consignee_name</td> <td>是</td> <td>string</td> <td>收货人名称</td> </tr> <tr> <td>consignee_company</td> <td>否</td> <td>string</td> <td>收货人公司</td> </tr> <tr> <td>consignee_doorplate</td> <td>否</td> <td>string</td> <td>收货人门牌号</td> </tr> <tr> <td>consignee_province</td> <td>是</td> <td>string</td> <td>收货人省/州</td> </tr> <tr> <td>consignee_city</td> <td>是</td> <td>string</td> <td>收货人城市</td> </tr> <tr> <td>consignee_area</td> <td>否</td> <td>object</td> <td>收货人所在区/县</td> </tr> <tr> <td>consignee_street</td> <td>是</td> <td>string</td> <td>收货人详细地址</td> </tr> <tr> <td>consignee_street2</td> <td>否</td> <td>string</td> <td>收货人详细地址2</td> </tr> <tr> <td>consignee_street3</td> <td>否</td> <td>string</td> <td>收货人详细地址3</td> </tr> <tr> <td>consignee_mobile</td> <td>是</td> <td>string</td> <td>收货人联系手机</td> </tr> <tr> <td>consignee_telephone</td> <td>否</td> <td>string</td> <td>收货人联系电话</td> </tr> <tr> <td>consignee_email</td> <td>是</td> <td>string</td> <td>收货人联系邮箱</td> </tr> <tr> <td>consignee_postcode</td> <td>是</td> <td>string</td> <td>收货人邮编</td> </tr> <tr> <td>consignee_tax_no</td> <td>否</td> <td>string</td> <td>收货人相关税号</td> </tr> <tr> <td>wh_code</td> <td>否</td> <td>string</td> <td>仓库代码,多个仓库时间必填</td> </tr> <tr> <td>items</td> <td>是</td> <td>array</td> <td>订单货物信息</td> </tr> <tr> <td>items.sku_code</td> <td>是</td> <td>string</td> <td>sku code</td> </tr> <tr> <td>items.goods_name</td> <td>是</td> <td>string</td> <td>货物中文名称</td> </tr> <tr> <td>items.goods_en_name</td> <td>否</td> <td>string</td> <td>货物英文名称</td> </tr> <tr> <td>items.goods_img</td> <td>是</td> <td>string</td> <td>在线商品图片地址</td> </tr> <tr> <td>items.goods_link</td> <td>否</td> <td>string</td> <td>在线商品地址</td> </tr> <tr> <td>items.net_weight</td> <td>是</td> <td>double</td> <td>单件净重</td> </tr> <tr> <td>items.gross_weight</td> <td>是</td> <td>double</td> <td>单件毛重</td> </tr> <tr> <td>items.quantity</td> <td>是</td> <td>int</td> <td>数量</td> </tr> <tr> <td>items.unit</td> <td>否</td> <td>string</td> <td>单位</td> </tr> <tr> <td>items.unit_price</td> <td>是</td> <td>string</td> <td>售价</td> </tr> <tr> <td>items.currency</td> <td>是</td> <td>double</td> <td>销售币种</td> </tr> <tr> <td>items.amount</td> <td>是</td> <td>double</td> <td>销售总金额</td> </tr> <tr> <td>items.material</td> <td>否</td> <td>string</td> <td>材质</td> </tr> <tr> <td>items.model</td> <td>否</td> <td>string</td> <td>型号</td> </tr> <tr> <td>items.use</td> <td>否</td> <td>string</td> <td>用途</td> </tr> <tr> <td>items.brand</td> <td>否</td> <td>string</td> <td>品牌</td> </tr> <tr> <td>items.cs_hs_code</td> <td>否</td> <td>string</td> <td>海关编码</td> </tr> <tr> <td>items.cs_goods_name</td> <td>否</td> <td>string</td> <td>申报中文名称 海关编码存在时必填</td> </tr> <tr> <td>items.cs_goods_en_name</td> <td>否</td> <td>string</td> <td>申报英文名称</td> </tr> <tr> <td>items.cs_brand</td> <td>否</td> <td>string</td> <td>申报品牌 海关编码存在时必填</td> </tr> <tr> <td>items.cs_use</td> <td>否</td> <td>string</td> <td>申报通途 海关编码存在时必填</td> </tr> <tr> <td>items.cs_unit</td> <td>否</td> <td>string</td> <td>申报成交单位 海关编码存在时必填</td> </tr> <tr> <td>items.cs_unit_price</td> <td>否</td> <td>string</td> <td>申报单价 海关编码存在时必填</td> </tr> <tr> <td>items.cs_currency</td> <td>否</td> <td>string</td> <td>申报币种 海关编码存在时必填</td> </tr> <tr> <td>items.cs_amount</td> <td>否</td> <td>string</td> <td>申报总金额 海关编码存在时必填</td> </tr> <tr> <td>items.cs_unit_one</td> <td>否</td> <td>string</td> <td>法一单位 海关编码存在时必填</td> </tr> <tr> <td>items.cs_unit_one_qty</td> <td>否</td> <td>string</td> <td>法一数量 法一单位存在时必填</td> </tr> <tr> <td>items.cs_unit_second</td> <td>否</td> <td>string</td> <td>法二单位</td> </tr> <tr> <td>items.cs_unit_second_qty</td> <td>否</td> <td>string</td> <td>法二数量</td> </tr> <tr> <td>items.cs_des_country</td> <td>否</td> <td>string</td> <td>最终目的国</td> </tr> <tr> <td>items.cs_origin_place</td> <td>否</td> <td>string</td> <td>原产地区</td> </tr> <tr> <td>items.cs_duty_mode</td> <td>否</td> <td>string</td> <td>征免方式 海关编码存在时必填</td> </tr> <tr> <td>items.cs_origin_country</td> <td>否</td> <td>string</td> <td>原产国地区</td> </tr> <tr> <td>items.cs_inside_place</td> <td>否</td> <td>string</td> <td>境内目的地</td> </tr> <tr> <td>items.cs_destinate_place</td> <td>否</td> <td>string</td> <td>目的地</td> </tr> <tr> <td>items.cs_declaration_elements</td> <td>否</td> <td>string</td> <td>申报要素 海关编码存在时必填</td> </tr> </tbody> </table> <h5>成功返回示例</h5> <pre><code>{ &amp;quot;code&amp;quot;: 1, &amp;quot;msg&amp;quot;: &amp;quot;订单创建成功&amp;quot;, &amp;quot;time&amp;quot;: 1730451301, &amp;quot;data&amp;quot;: { &amp;quot;order_no&amp;quot;: &amp;quot;DR306609013693208&amp;quot;, &amp;quot;reference_no&amp;quot;: &amp;quot;AW14587122891165522&amp;quot; }, &amp;quot;log_id&amp;quot;: &amp;quot;9bfb91de74ce19d38956db12cd2004b8&amp;quot; }</code></pre> <h5>成功返回示例的参数说明</h5> <table> <thead> <tr> <th>参数名</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>code</td> <td>string</td> <td>1:成功 ,0: 失败</td> </tr> <tr> <td>msg</td> <td>string</td> <td>提示信息</td> </tr> <tr> <td>time</td> <td>string</td> <td>无</td> </tr> <tr> <td>data.order_no</td> <td>string</td> <td>订单订单号</td> </tr> <tr> <td>data.reference_no</td> <td>string</td> <td>客户单号</td> </tr> <tr> <td>log_id</td> <td>string</td> <td>日志ID</td> </tr> </tbody> </table> <h5>失败返回示例</h5> <pre><code>{ &amp;quot;code&amp;quot;: 0, &amp;quot;msg&amp;quot;: &amp;quot;Signature timeout&amp;quot;, &amp;quot;data&amp;quot;: [], &amp;quot;track_id&amp;quot;: &amp;quot;2bef4a39c5de410e170db134fbc7e686&amp;quot; }</code></pre> <h5>失败返回示例的参数说明</h5> <table> <thead> <tr> <th>参数名</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>code</td> <td>string</td> <td>1:成功 ,0: 失败</td> </tr> <tr> <td>msg</td> <td>string</td> <td>提示信息</td> </tr> <tr> <td>data</td> <td>array</td> <td>数据</td> </tr> <tr> <td>track_id</td> <td>string</td> <td>日志ID</td> </tr> </tbody> </table>

页面列表

ITEM_HTML