创建订单
<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 class="language-json">{
&quot;reference_no&quot;: &quot;BD4-S001&quot;,
&quot;shipping_method&quot;: &quot;CNFED-IP5000B&quot;,
&quot;country_code&quot;: &quot;US&quot;,
&quot;weight&quot;: &quot;1.11&quot;,
&quot;volume&quot;: &quot;1.256&quot;,
&quot;pieces&quot;: &quot;2&quot;,
&quot;platform&quot;: &quot;Amazon&quot;,
&quot;platform_no&quot;: &quot;TDS-986548-6310&quot;,
&quot;amount&quot;: 170.32,
&quot;amount_currency&quot;: &quot;HKD&quot;,
&quot;remark&quot;: &quot;尽快发货哦,客户急要求&quot;,
&quot;shipper_name&quot;: &quot;张三&quot;,
&quot;shipper_company&quot;: &quot;张三公司&quot;,
&quot;shipper_country_code&quot;: &quot;CN&quot;,
&quot;shipper_province&quot;: &quot;广东省&quot;,
&quot;shipper_city&quot;: &quot;深圳市&quot;,
&quot;shipper_area&quot;: &quot;希望小区&quot;,
&quot;shipper_street&quot;: &quot;坂田街道吉华路509号&quot;,
&quot;shipper_postcode&quot;: &quot;51800&quot;,
&quot;shipper_telephone&quot;: &quot;0755-86858698&quot;,
&quot;shipper_mobile&quot;: &quot;13367154259&quot;,
&quot;shipper_email&quot;: &quot;81562632654@gmai.com&quot;,
&quot;consignee_name&quot;: &quot;Anri Kawatani&quot;,
&quot;consignee_company&quot;: &quot;Kawatani CO.&quot;,
&quot;consignee_doorplate&quot;: &quot;S5869&quot;,
&quot;consignee_province&quot;: &quot;112132121&quot;,
&quot;consignee_city&quot;: &quot;Matsubara Shi&quot;,
&quot;consignee_area&quot;: &quot;小城故事&quot;,
&quot;consignee_street&quot;: &quot;6-3-33 Miyakenaka,Matsubara-shi,Osaka,Japan,580-0046&quot;,
&quot;consignee_street2&quot;: &quot;6-3-33 Miyakenaka,Matsubara-shi,Osaka,Japan,580-0046 -2&quot;,
&quot;consignee_street3&quot;: &quot;6-3-33 Miyakenaka,Matsubara-shi,Osaka,Japan,580-0046 -3&quot;,
&quot;consignee_mob1ile&quot;: &quot;13365245878&quot;,
&quot;consignee_telephone&quot;: &quot;85693411&quot;,
&quot;consignee_email&quot;: &quot;62554552144@d-rain.cn&quot;,
&quot;consignee_postcode&quot;: &quot;218600&quot;,
&quot;consignee_tax_no&quot;: &quot;218600&quot;,
&quot;id_card_no&quot;: null,
&quot;id_card_front_side&quot;: null,
&quot;id_card_reverse_side&quot;: null,
&quot;is_magnetic&quot;: 0,
&quot;is_electric&quot;: 0,
&quot;is_liquid&quot;: 0,
&quot;is_hazardous_material&quot;: 1,
&quot;items&quot;: [
{
&quot;sku_code&quot;: &quot;MY_D_0312311_T0&quot;,
&quot;goods_name&quot;: &quot;检测工具&quot;,
&quot;goods_en_name&quot;: &quot;Testing tools&quot;,
&quot;goods_img&quot;: &quot;https://img.alicdn.com/imgextra/i1/6000000002115/O1CN01UXUkWd1RUieKQjej2_!!6000000002115-0-at.jpg_.webp&quot;,
&quot;goods_link&quot;: &quot;https://chaoshi.detail.tmall.com/item.htm?id=77309023878nXsUKU&quot;,
&quot;net_weight&quot;: &quot;0.012&quot;,
&quot;gross_weight&quot;: &quot;0.50&quot;,
&quot;quantity&quot;: 15,
&quot;unit&quot;: &quot;个&quot;,
&quot;unit_price&quot;: &quot;11.25&quot;,
&quot;currency&quot;: &quot;CNY&quot;,
&quot;amount&quot;: 102.5,
&quot;hs_code&quot;: &quot;1245789632&quot;,
&quot;material&quot;: &quot;铁&quot;,
&quot;model&quot;: &quot;SL&quot;,
&quot;use&quot;: &quot;大锅&quot;,
&quot;brand&quot;: &quot;Ads&quot;
},
{
&quot;sku_code&quot;: &quot;MY_D_0312311_T6&quot;,
&quot;goods_name&quot;: &quot;检测工具&quot;,
&quot;goods_en_name&quot;: &quot;Testing tools&quot;,
&quot;goods_img&quot;: &quot;https://img.alicdn.com/imgextra/i1/6000000002115/O1CN01UXUkWd1RUieKQjej2_!!6000000002115-0-at.jpg_.webp&quot;,
&quot;goods_link&quot;: &quot;https://chaoshi.detail.tmall.com/itkJKOdR_CukfYyCeyzO_CgUKDqKFwn2VZjELwnXsUKU&quot;,
&quot;net_weight&quot;: &quot;0.012&quot;,
&quot;gross_weight&quot;: &quot;0.50&quot;,
&quot;quantity&quot;: 5,
&quot;unit&quot;: &quot;个&quot;,
&quot;unit_price&quot;: &quot;20.25&quot;,
&quot;currency&quot;: &quot;CNY&quot;,
&quot;amount&quot;: 102.5,
&quot;hs_code&quot;: &quot;1245789632&quot;,
&quot;material&quot;: &quot;铁&quot;,
&quot;model&quot;: &quot;SL&quot;,
&quot;use&quot;: &quot;大锅&quot;,
&quot;brand&quot;: &quot;Ads&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>id_card_no</td>
<td>否</td>
<td>string</td>
<td>身份证号</td>
</tr>
<tr>
<td>id_card_front_side</td>
<td>否</td>
<td>string</td>
<td>base64 身份证正页</td>
</tr>
<tr>
<td>id_card_reverse_side</td>
<td>否</td>
<td>string</td>
<td>base64 身份证反页</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.hs_code</td>
<td>否</td>
<td>string</td>
<td>hs_code</td>
</tr>
</tbody>
</table>
<h5>成功返回示例</h5>
<pre><code class="language-json">{
&quot;status&quot;: true,
&quot;code&quot;: 1,
&quot;msg&quot;: &quot;添加订单成功&quot;,
&quot;time&quot;: 1751440930,
&quot;data&quot;: {
&quot;order_no&quot;: &quot;DR183553304528787&quot;,
&quot;reference_no&quot;: &quot;BD4-S001&quot;,
&quot;erp_reference_no&quot;: &quot;Z001-BD4-S001&quot;,
&quot;awb_no&quot;: null
},
&quot;log_id&quot;: &quot;6008d9d2dcca4f0fedbb640d095c8a64&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>{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;Signature timeout&quot;,
&quot;data&quot;: [],
&quot;track_id&quot;: &quot;2bef4a39c5de410e170db134fbc7e686&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>