【顺丰快递管家】通用接口文档


1.下订单接口

<h3>功能描述</h3> <ul> <li>该接口用于: 1.客户系统向顺丰快递管家下发国际件订单; 2.为订单分配运单号;</li> </ul> <h3>接口定义</h3> <table> <thead> <tr> <th style="text-align: center;">服务名称</th> <th style="text-align: center;">批量交易</th> <th style="text-align: center;">接口类型</th> <th style="text-align: center;">接口uri</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">下订单</td> <td style="text-align: center;">不支持</td> <td style="text-align: center;">接入/POST</td> <td style="text-align: center;">/public/internationalOrder/v1/create</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求Body&gt;</strong></h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>companyId</td> <td>String(50)</td> <td>Y</td> <td>分配客户sendAppId</td> </tr> <tr> <td>2</td> <td>version</td> <td>String(10)</td> <td>N</td> <td>版本号(默认为空即可)</td> </tr> <tr> <td>3</td> <td>orderOperateType</td> <td>Integer</td> <td>N</td> <td>订单操作类型:1-新增;5-改单;默认1</td> </tr> <tr> <td>4</td> <td>customerOrderNo</td> <td>String(64)</td> <td>N</td> <td>客户订单号(改单时不能改动)</td> </tr> <tr> <td>5</td> <td>customerOrderNoTwo</td> <td>String(64)</td> <td>N</td> <td>客户订单号2。顺丰侧不做任何逻辑处理,仅为存储与订单号强关联的信息所用,便于客户梳理订单信息。如“客户订单号”对应的批次号</td> </tr> <tr> <td>10</td> <td>sfWaybillNo</td> <td>String(32)</td> <td>N</td> <td>顺丰运单号(改单时不能改动)</td> </tr> <tr> <td>11</td> <td>interProductCode</td> <td>String(32)</td> <td>Y</td> <td>国际产品映射码</td> </tr> <tr> <td>12</td> <td>parcelQuantity</td> <td>Int(8)</td> <td>Y</td> <td>包裹总件数(改单时不能改动)(大于1表示是子母件,最大值200)</td> </tr> <tr> <td>13</td> <td>parcelTotalWeight</td> <td>BigDecimal(16,2)</td> <td>N</td> <td>包裹总重量。精确到小数点后2位,默认为KG</td> </tr> <tr> <td>14</td> <td>parcelWeightUnit</td> <td>String(16)</td> <td>N</td> <td>包裹总重量单位,默认KG</td> </tr> <tr> <td>15</td> <td>parcelTotalLength</td> <td>BigDecimal(16,2)</td> <td>N</td> <td>客户订单货物总长。精确到小数点后2位,默认单位CM</td> </tr> <tr> <td>16</td> <td>parcelTotalWidth</td> <td>BigDecimal(16,2)</td> <td>N</td> <td>客户订单货物总宽。精确到小数点后2位,默认单位CM</td> </tr> <tr> <td>17</td> <td>parcelTotalHeight</td> <td>BigDecimal(16,2)</td> <td>N</td> <td>客户订单货物总高。精确到小数点后2位,默认单位CM</td> </tr> <tr> <td>18</td> <td>declaredValue</td> <td>String(20)</td> <td>Y</td> <td>申明价值</td> </tr> <tr> <td>19</td> <td>declaredCurrency</td> <td>String(10)</td> <td>Y</td> <td>包裹总计声明价值币种</td> </tr> <tr> <td>20</td> <td>parcelVolumeUnit</td> <td>String(16)</td> <td>N</td> <td>客户订单货物长度单位 1.可选项:CM、INCH 2.默认单位为CM 3.原寄国为CA和US,长度单位为英寸</td> </tr> <tr> <td>21</td> <td>pickupType</td> <td>String(2)</td> <td>N</td> <td>寄件方式: 0-服务点自寄或自行联系快递员; 1-上门收件;</td> </tr> <tr> <td>22</td> <td>pickupAppointTime</td> <td>String(20)</td> <td>N</td> <td>上门取件预约时间。格式:yyyy-MM-dd HH:mm:ss 若寄件方式选择了上门收件,则预约方式必填</td> </tr> <tr> <td>23</td> <td>pickupAppointTimeZone</td> <td>String(100)</td> <td>N</td> <td>上门预约时间时区详细参考附录字典</td> </tr> <tr> <td>25</td> <td>remark</td> <td>String(200)</td> <td>N</td> <td>运单备注</td> </tr> <tr> <td>26</td> <td>isBbd</td> <td>String(8)</td> <td>N</td> <td>是否BBD 0-不是 1-BBD单(需提前开通BBD权限);</td> </tr> <tr> <td>35</td> <td>orderExtendInfo</td> <td>OrderExtendInfo</td> <td>N</td> <td>订单额外信息</td> </tr> <tr> <td>36</td> <td>paymentInfo</td> <td>PaymentInfo</td> <td>Y</td> <td>付款方式信息</td> </tr> <tr> <td>37</td> <td>senderInfo</td> <td>SenderInfo</td> <td>Y</td> <td>寄件人信息</td> </tr> <tr> <td>38</td> <td>receiverInfo</td> <td>ReceiverInfo</td> <td>Y</td> <td>收件人信息</td> </tr> <tr> <td>39</td> <td>customsInfo</td> <td>CustomsInfo</td> <td>N</td> <td>报关信息</td> </tr> <tr> <td>40</td> <td>parcelInfoList</td> <td>List&lt;ParcelInfo&gt;</td> <td>Y</td> <td>包裹信息</td> </tr> <tr> <td>41</td> <td>addServiceInfoList</td> <td>List&lt;AddServiceInfo&gt;</td> <td>N</td> <td>增值服务信息</td> </tr> <tr> <td>42</td> <td>childInfoList</td> <td>List&lt;ChildInfo&gt;</td> <td>N</td> <td>子单信息</td> </tr> <tr> <td>43</td> <td>extendAttributeList</td> <td>List&lt;OrderExtendAttribute&gt;</td> <td>N</td> <td>扩展属性</td> </tr> <tr> <td>44</td> <td>ecommerceInfo</td> <td>OrderEcommerceInfo</td> <td>N</td> <td>电子商务信息</td> </tr> <tr> <td>45</td> <td>creatorUser</td> <td>String(20)</td> <td>N</td> <td>创建人。如需使用顺丰快递管家进行订单管理,则需要填顺丰快递管家中真实账号,用于订单归属人的判断,否则无要求,如为空,则取公司接口人账号</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;**</strong>OrderExtendInfo**</h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>isSignBack</td> <td>String(8)</td> <td>N</td> <td>是否要求签回单;0.否1.是(签回原寄地)2.是(签回第三方地址)</td> </tr> <tr> <td>2</td> <td>isSelfPick</td> <td>String(8)</td> <td>N</td> <td>是否自取件:0-否;1-是</td> </tr> <tr> <td>3</td> <td>signBackWaybillNo</td> <td>String(32)</td> <td>N</td> <td>签回回单号</td> </tr> <tr> <td>4</td> <td>specialField1</td> <td>String(200)</td> <td>N</td> <td>特殊派送字段1</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;**</strong>PaymentInfo**</h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>payMethod</td> <td>String(8)</td> <td>Y</td> <td>付款方式:1-寄方付; 2-收方付; 3-第三方付</td> </tr> <tr> <td>2</td> <td>payMonthCard</td> <td>String(20)</td> <td>N</td> <td>月结卡号</td> </tr> <tr> <td>3</td> <td>taxPayMethod</td> <td>String(8)</td> <td>Y</td> <td>税金付款方式:1-寄方付; 2-收方付; 3-第三方付</td> </tr> <tr> <td>4</td> <td>taxPayMonthCard</td> <td>String(20)</td> <td>N</td> <td>税金结算账号 (税金付款方式taxPayMethod选择寄付时,此税金月结账号必填)</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;**</strong>SenderInfo**</h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>company</td> <td>String(100)</td> <td>N</td> <td>寄件方公司</td> </tr> <tr> <td>2</td> <td>contact</td> <td>String(100)</td> <td>Y</td> <td>寄件方姓名</td> </tr> <tr> <td>3</td> <td>country</td> <td>String(5)</td> <td>Y</td> <td>寄件方国家/地区,如:CN,US,JP,KR,SG,MY更多参考附录字典</td> </tr> <tr> <td>4</td> <td>postCode</td> <td>String(20)</td> <td>Y</td> <td>邮编</td> </tr> <tr> <td>5</td> <td>regionFirst</td> <td>String(128)</td> <td>Y</td> <td>寄件方地址一级区划(州/省)</td> </tr> <tr> <td>6</td> <td>regionSecond</td> <td>String(128)</td> <td>Y</td> <td>寄件方地址二级区划(城市)</td> </tr> <tr> <td>7</td> <td>regionThird</td> <td>String(128)</td> <td>N</td> <td>寄件方地址三级区划(区/县)</td> </tr> <tr> <td>8</td> <td>address</td> <td>String(200)</td> <td>Y</td> <td>寄件方详细地址</td> </tr> <tr> <td>9</td> <td>email</td> <td>String(128)</td> <td>N</td> <td>寄件方邮箱</td> </tr> <tr> <td>10</td> <td>telAreaCode</td> <td>String(10)</td> <td>N</td> <td>寄件方固定电话区号</td> </tr> <tr> <td>11</td> <td>telNo</td> <td>String(20)</td> <td>N</td> <td>寄件方固定电话。寄件方手机号和寄件方固定电话至少填写一个</td> </tr> <tr> <td>12</td> <td>phoneAreaCode</td> <td>String(10)</td> <td>N</td> <td>寄件方移动电话区号</td> </tr> <tr> <td>13</td> <td>phoneNo</td> <td>String(20)</td> <td>N</td> <td>寄件方移动电话。寄件方手机号和寄件方固定电话至少填写一个</td> </tr> <tr> <td>14</td> <td>cargoType</td> <td>INT(1)</td> <td>N</td> <td>寄件方货物类型:1-个人件;2-公司件</td> </tr> <tr> <td>15</td> <td>certType</td> <td>String(10)</td> <td>N</td> <td>寄件方证件类型详细参考附录字典</td> </tr> <tr> <td>16</td> <td>certCardNo</td> <td>String(100)</td> <td>N</td> <td>寄件方证件号</td> </tr> <tr> <td>17</td> <td>vat</td> <td>String(18)</td> <td>N</td> <td>寄件方VAT号</td> </tr> <tr> <td>18</td> <td>eori</td> <td>String(100)</td> <td>N</td> <td>寄件方EORI号</td> </tr> <tr> <td>19</td> <td>iossNo</td> <td>String(100)</td> <td>N</td> <td>寄件方IOSS号</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;**</strong>ReceiverInfo**</h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>company</td> <td>String(100)</td> <td>N</td> <td>收件方公司</td> </tr> <tr> <td>2</td> <td>contact</td> <td>String(100)</td> <td>Y</td> <td>收件方姓名</td> </tr> <tr> <td>3</td> <td>country</td> <td>String(5)</td> <td>Y</td> <td>收件方国家/地区,如:CN,US,JP,KR,SG,MY更多参考附录字典</td> </tr> <tr> <td>4</td> <td>postCode</td> <td>String(20)</td> <td>Y</td> <td>邮编</td> </tr> <tr> <td>5</td> <td>regionFirst</td> <td>String(128)</td> <td>Y</td> <td>收件方地址一级区划(州/省)</td> </tr> <tr> <td>6</td> <td>regionSecond</td> <td>String(128)</td> <td>Y</td> <td>收件方地址二级区划(城市)</td> </tr> <tr> <td>7</td> <td>regionThird</td> <td>String(128)</td> <td>N</td> <td>收件方地址三级区划(区/县)</td> </tr> <tr> <td>8</td> <td>address</td> <td>String(200)</td> <td>Y</td> <td>收件方详细地址</td> </tr> <tr> <td>9</td> <td>regionFifth</td> <td>String(200)</td> <td>N</td> <td>收件方地址五级区划(道路名,收件方国家为韩国,则必填,长度100)</td> </tr> <tr> <td>10</td> <td>regionSixth</td> <td>String(100)</td> <td>N</td> <td>收件方地址六级区划(建筑编号,收件方国家为韩国,则必填)</td> </tr> <tr> <td>11</td> <td>email</td> <td>String(128)</td> <td>N</td> <td>收件方邮箱</td> </tr> <tr> <td>12</td> <td>telAreaCode</td> <td>String(10)</td> <td>N</td> <td>收件方固定电话区号</td> </tr> <tr> <td>13</td> <td>telNo</td> <td>String(20)</td> <td>N</td> <td>收件方固定电话。收件方手机号和收件方固定电话至少填写一个</td> </tr> <tr> <td>14</td> <td>phoneAreaCode</td> <td>String(10)</td> <td>N</td> <td>收件方移动电话区号</td> </tr> <tr> <td>15</td> <td>phoneNo</td> <td>String(20)</td> <td>N</td> <td>收件方移动电话。收件方手机号和收件方固定电话至少填写一个</td> </tr> <tr> <td>16</td> <td>cargoType</td> <td>INT(1)</td> <td>N</td> <td>收件方货物类型:1-个人件;2-公司件</td> </tr> <tr> <td>17</td> <td>certType</td> <td>String(10)</td> <td>N</td> <td>收件方证件类型详细参考附录字典</td> </tr> <tr> <td>18</td> <td>certCardNo</td> <td>String(100)</td> <td>N</td> <td>收件方证件号</td> </tr> <tr> <td>19</td> <td>vat</td> <td>String(18)</td> <td>N</td> <td>收件方VAT号</td> </tr> <tr> <td>20</td> <td>eori</td> <td>String(100)</td> <td>N</td> <td>收件方EORI号</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;**</strong>CustomsInfo**</h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>tradeCondition</td> <td>String(30)</td> <td>N</td> <td>贸易条件,参考附录字典</td> </tr> <tr> <td>2</td> <td>senderReason</td> <td>Int(2)</td> <td>N</td> <td>寄件原因:1-商业;2-非商业</td> </tr> <tr> <td>3</td> <td>senderReasonContent</td> <td>String(256)</td> <td>N</td> <td>寄件原因内容</td> </tr> <tr> <td>4</td> <td>businessRemark</td> <td>String(256)</td> <td>N</td> <td>商业发票备注</td> </tr> <tr> <td>5</td> <td>customsBatch</td> <td>String(20)</td> <td>N</td> <td>报关批次</td> </tr> <tr> <td>6</td> <td>importCustomsType</td> <td>String(30)</td> <td>N</td> <td>进口报关方式参考附录字典</td> </tr> <tr> <td>7</td> <td>exportCustomsType</td> <td>String(30)</td> <td>N</td> <td>出口报关方式参考附录字典</td> </tr> <tr> <td>8</td> <td>harmonizedCode</td> <td>String(100)</td> <td>N</td> <td>Harmonized Code美国寄出的可填写</td> </tr> <tr> <td>9</td> <td>aesNo</td> <td>String(100)</td> <td>N</td> <td>AES No.美国寄出可填写</td> </tr> <tr> <td>10</td> <td>passportId</td> <td>String(100)</td> <td>N</td> <td>韩国个人清关代码</td> </tr> <tr> <td>11</td> <td>category</td> <td>String(50)</td> <td>N</td> <td>订单所属品类,用于海关清关</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;**</strong>ParcelInf<strong>**o</strong></h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>name</td> <td>String(30)</td> <td>Y</td> <td>商品名称(默认使用,可以是各个国家的语言名称) (备注:有效长度30字符;超出30字符,请联系对接服务支持人员确认是否可行)</td> </tr> <tr> <td>3</td> <td>eName</td> <td>String(128)</td> <td>N</td> <td>商品英文名称</td> </tr> <tr> <td>4</td> <td>unit</td> <td>String(32)</td> <td>Y</td> <td>货物单位,如:个,台</td> </tr> <tr> <td>5</td> <td>amount</td> <td>DECIMAL(24,10)</td> <td>Y</td> <td>单价</td> </tr> <tr> <td>7</td> <td>quantity</td> <td>DECIMAL(16,6)</td> <td>Y</td> <td>数量</td> </tr> <tr> <td>8</td> <td>originCountry</td> <td>String(5)</td> <td>Y</td> <td>原产国家</td> </tr> <tr> <td>9</td> <td>hsCode</td> <td>String(100)</td> <td>N</td> <td>海关编码</td> </tr> <tr> <td>10</td> <td>brand</td> <td>String(16)</td> <td>N</td> <td>品牌</td> </tr> <tr> <td>11</td> <td>stateBarCode</td> <td>String(64)</td> <td>N</td> <td>国条码</td> </tr> <tr> <td>12</td> <td>productCustomsNo</td> <td>String(100)</td> <td>N</td> <td>海关备案号</td> </tr> <tr> <td>13</td> <td>productRecordNo</td> <td>String(18)</td> <td>N</td> <td>货物产品国检备案编号</td> </tr> <tr> <td>14</td> <td>goodsCode</td> <td>String(60)</td> <td>N</td> <td>商品编号</td> </tr> <tr> <td>15</td> <td>goodsUrl</td> <td>String(2000)</td> <td>N</td> <td>商品链接</td> </tr> <tr> <td>16</td> <td>weight</td> <td>DECIMAL</td> <td>N</td> <td>托寄物重量(不能小于0, 单位KG)。支持小数点后2位</td> </tr> <tr> <td>17</td> <td>goodsDesc</td> <td>String(200)</td> <td>N</td> <td>商品描述</td> </tr> <tr> <td>18</td> <td>material</td> <td>String(600)</td> <td>N</td> <td>材质</td> </tr> <tr> <td>19</td> <td>specifications</td> <td>String(64)</td> <td>N</td> <td>型号</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;**</strong>AddServiceInfo**</h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>serviceCode</td> <td>String(32)</td> <td>Y</td> <td>增值服务编码</td> </tr> <tr> <td>2</td> <td>value</td> <td>String(256)</td> <td>N</td> <td>增值服务扩展属性</td> </tr> <tr> <td>3</td> <td>valueOne</td> <td>String(256)</td> <td>N</td> <td>增值服务扩展属性1</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;**</strong>ChildInfo**</h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>sfWaybillNo</td> <td>String(32)</td> <td>N</td> <td>子单编号</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;OrderExtendAttribute</strong></h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>attributeName</td> <td>String(200)</td> <td>N</td> <td>属性名 参考附录字典</td> </tr> <tr> <td>2</td> <td>attributeValue</td> <td>String(1024)</td> <td>N</td> <td>属性值</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;**</strong>Order<strong>**EcommerceInfo</strong></h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>payerCertType</td> <td>String(200)</td> <td>N</td> <td>订购人证件类型</td> </tr> <tr> <td>2</td> <td>payerCertNo</td> <td>String(1000)</td> <td>N</td> <td>订购人证件号码</td> </tr> <tr> <td>3</td> <td>payerName</td> <td>String(100)</td> <td>N</td> <td>订购人姓名</td> </tr> <tr> <td>4</td> <td>payerTel</td> <td>String(300)</td> <td>N</td> <td>订购人联络电话</td> </tr> <tr> <td>5</td> <td>buyerEmail</td> <td>String(300)</td> <td>N</td> <td>买家邮件地址</td> </tr> <tr> <td>6</td> <td>buyerNickname</td> <td>String(100)</td> <td>N</td> <td>买家昵称</td> </tr> <tr> <td>7</td> <td>buyerFreight</td> <td>decimal(10,2)</td> <td>N</td> <td>买家邮费(电商收取消费者的邮费)</td> </tr> <tr> <td>8</td> <td>buyerPremium</td> <td>decimal(10,2)</td> <td>N</td> <td>买家保费(电商收取消费者的保价费用)</td> </tr> <tr> <td>9</td> <td>tax</td> <td>String(10)</td> <td>N</td> <td>税款,企业预先代扣的税款金额</td> </tr> <tr> <td>10</td> <td>preferentialAmount</td> <td>decimal(10,2)</td> <td>N</td> <td>优惠金额(整个订单的,电商给消费者的优惠金额)</td> </tr> <tr> <td>11</td> <td>actPay</td> <td>decimal(10,2)</td> <td>N</td> <td>成交实际付款金额(消费者向电商支付的金额,商品价格+运杂费+代扣税款-优惠金额)</td> </tr> <tr> <td>12</td> <td>currency</td> <td>String(10)</td> <td>N</td> <td>结算币种</td> </tr> <tr> <td>13</td> <td>payToolType</td> <td>String(100)</td> <td>N</td> <td>支付工具、方式,如支付宝,财付通</td> </tr> <tr> <td>14</td> <td>applicationNo</td> <td>String(100)</td> <td>N</td> <td>申请单编号</td> </tr> <tr> <td>15</td> <td>payNo</td> <td>String(100)</td> <td>N</td> <td>支付交易号</td> </tr> <tr> <td>16</td> <td>platformDomainName</td> <td>String(100)</td> <td>N</td> <td>电商平台域名</td> </tr> <tr> <td>17</td> <td>payTime</td> <td>datetime</td> <td>N</td> <td>支付交易时间</td> </tr> <tr> <td>18</td> <td>promotionType</td> <td>String(100)</td> <td>N</td> <td>促销类型</td> </tr> <tr> <td>19</td> <td>sellerEmail</td> <td>String(300)</td> <td>N</td> <td>卖家邮件地址</td> </tr> <tr> <td>20</td> <td>sellerNickname</td> <td>String(100)</td> <td>N</td> <td>卖家昵称</td> </tr> <tr> <td>21</td> <td>sellerAlipayNo</td> <td>String(300)</td> <td>N</td> <td>卖家支付宝账号</td> </tr> <tr> <td>22</td> <td>payEnterpriseCustomsCode</td> <td>String(20)</td> <td>N</td> <td>支付企业的海关注册登记编号</td> </tr> <tr> <td>23</td> <td>payEnterpriseCheckCode</td> <td>String(20)</td> <td>N</td> <td>支付企业的国检注册登记编号</td> </tr> <tr> <td>24</td> <td>payEnterpriseName</td> <td>String(100)</td> <td>N</td> <td>支付企业名称</td> </tr> <tr> <td>25</td> <td>storeCode</td> <td>String(50)</td> <td>N</td> <td>店铺代码</td> </tr> <tr> <td>26</td> <td>shopWebCode</td> <td>String(100)</td> <td>N</td> <td>购物网站代码</td> </tr> <tr> <td>27</td> <td>enterpriseName</td> <td>String(100)</td> <td>N</td> <td>电商企业的海关注册登记名称</td> </tr> <tr> <td>28</td> <td>enterpriseCustomsCode</td> <td>String(20)</td> <td>N</td> <td>电商企业的海关注册登记编号</td> </tr> <tr> <td>29</td> <td>enterpriseCheckCode</td> <td>String(20)</td> <td>N</td> <td>电商企业的国检注册登记编号</td> </tr> <tr> <td>30</td> <td>enterpriseCrossCode</td> <td>String(20)</td> <td>N</td> <td>电商企业的跨境平台注册登记编号</td> </tr> <tr> <td>31</td> <td>platformName</td> <td>String(100)</td> <td>N</td> <td>电商平台的海关注册登记名称</td> </tr> <tr> <td>32</td> <td>platformCustomsCode</td> <td>String(20)</td> <td>N</td> <td>电商平台的海关注册登记编号</td> </tr> <tr> <td>33</td> <td>platformCheckCode</td> <td>String(20)</td> <td>N</td> <td>电商平台的国检注册登记编号</td> </tr> <tr> <td>34</td> <td>partZoneCode</td> <td>String(32)</td> <td>N</td> <td>分区码</td> </tr> <tr> <td>35</td> <td>portCode</td> <td>String(32)</td> <td>N</td> <td>口岸</td> </tr> </tbody> </table> <h3>元素&lt;响应&gt;</h3> <table> <thead> <tr> <th style="text-align: center;">序号</th> <th style="text-align: center;">字段名</th> <th style="text-align: center;">类型(约束)</th> <th style="text-align: center;">必填</th> <th style="text-align: center;">字段说明</th> <th style="text-align: left;">描述</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">1</td> <td style="text-align: center;">msg</td> <td style="text-align: center;">String (200)</td> <td style="text-align: center;">否</td> <td style="text-align: center;">信息</td> <td style="text-align: left;">提示信息</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">succ</td> <td style="text-align: center;">String (10)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">状态码</td> <td style="text-align: left;">返回成功或失败信息(ok/fail)</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">result</td> <td style="text-align: center;">String (/)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">数据</td> <td style="text-align: left;">数据</td> </tr> </tbody> </table> <h3><strong>元素&lt;响应&gt;result</strong></h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>customerOrderNo</td> <td>String</td> <td>订单号</td> </tr> <tr> <td>2</td> <td>sfWaybillNo</td> <td>String</td> <td>运单号</td> </tr> <tr> <td>3</td> <td>childWaybillNoList</td> <td>List&lt;String&gt;</td> <td>子运单号</td> </tr> <tr> <td>4</td> <td>agentWaybillNo</td> <td>String</td> <td>代理/服务商运单号</td> </tr> <tr> <td>5</td> <td>directionCode</td> <td>String</td> <td>流向代码</td> </tr> <tr> <td>6</td> <td>agentCode</td> <td>String</td> <td>代理编号</td> </tr> </tbody> </table> <h3><strong>请求示例</strong></h3> <pre><code class="language-json">{ &amp;quot;addServiceInfoList&amp;quot;: [], &amp;quot;companyId&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;customerOrderNo&amp;quot;: &amp;quot;kts_api20210701840182504&amp;quot;, &amp;quot;customerOrderNoTwo&amp;quot;: &amp;quot;IUOP-test2-20102911702344&amp;quot;, &amp;quot;customsInfo&amp;quot;: { &amp;quot;aesNo&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;businessRemark&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;customsBatch&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;harmonizedCode&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;senderReasonContent&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;tradeCondition&amp;quot;: &amp;quot;&amp;quot; }, &amp;quot;declaredCurrency&amp;quot;: &amp;quot;USD&amp;quot;, &amp;quot;declaredValue&amp;quot;: 10, &amp;quot;interProductCode&amp;quot;: &amp;quot;INT0007&amp;quot;, &amp;quot;orderExtendInfo&amp;quot;: { &amp;quot;isSelfPick&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;isSignBack&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;signBackWaybillNo&amp;quot;: &amp;quot;&amp;quot; }, &amp;quot;orderOperateType&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;parcelInfoList&amp;quot;: [ { &amp;quot;amount&amp;quot;: 0.1, &amp;quot;brand&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;currency&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;goodsCode&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;goodsDesc&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;goodsUrl&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;hsCode&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;iPhone&amp;quot;, &amp;quot;originCountry&amp;quot;: &amp;quot;SG&amp;quot;, &amp;quot;productCustomsNo&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;productRecordNo&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;quantity&amp;quot;: 1, &amp;quot;stateBarCode&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;unit&amp;quot;: &amp;quot;个&amp;quot; } ], &amp;quot;parcelQuantity&amp;quot;: 1, &amp;quot;parcelTotalWeight&amp;quot;: 0.5, &amp;quot;parcelVolumeUnit&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;parcelWeightUnit&amp;quot;: &amp;quot;KG&amp;quot;, &amp;quot;paymentInfo&amp;quot;: { &amp;quot;payMethod&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;payMonthCard&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;taxPayMethod&amp;quot;: &amp;quot;2&amp;quot;, &amp;quot;taxPayMonthCard&amp;quot;: &amp;quot;&amp;quot; }, &amp;quot;pickupAppointTime&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;pickupAppointTimeZone&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;pickupType&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;receiverInfo&amp;quot;: { &amp;quot;address&amp;quot;: &amp;quot;新加坡 详细地址&amp;quot;, &amp;quot;cargoType&amp;quot;: 1, &amp;quot;certCardNo&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;certType&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;regionSecond&amp;quot;: &amp;quot;106A&amp;quot;, &amp;quot;company&amp;quot;: &amp;quot;顺丰速运&amp;quot;, &amp;quot;contact&amp;quot;: &amp;quot;李想&amp;quot;, &amp;quot;country&amp;quot;: &amp;quot;SG&amp;quot;, &amp;quot;regionThird&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;email&amp;quot;: &amp;quot;iuop@test.com&amp;quot;, &amp;quot;eori&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;phoneAreaCode&amp;quot;: &amp;quot;65&amp;quot;, &amp;quot;phoneNo&amp;quot;: &amp;quot;54875485&amp;quot;, &amp;quot;postCode&amp;quot;: &amp;quot;536727&amp;quot;, &amp;quot;regionFirst&amp;quot;: &amp;quot;Ah Soo Walk&amp;quot;, &amp;quot;telAreaCode&amp;quot;: &amp;quot;86&amp;quot;, &amp;quot;telNo&amp;quot;: &amp;quot;9516168888&amp;quot;, &amp;quot;vat&amp;quot;: &amp;quot;&amp;quot; }, &amp;quot;remark&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;senderInfo&amp;quot;: { &amp;quot;address&amp;quot;: &amp;quot;306 S BRYN MAWR AVE&amp;quot;, &amp;quot;cargoType&amp;quot;: 1, &amp;quot;certCardNo&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;certType&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;regionSecond&amp;quot;: &amp;quot;11A&amp;quot;, &amp;quot;company&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;contact&amp;quot;: &amp;quot;姓名测试&amp;quot;, &amp;quot;country&amp;quot;: &amp;quot;SG&amp;quot;, &amp;quot;regionThird&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;email&amp;quot;: &amp;quot;iuop@test.com&amp;quot;, &amp;quot;eori&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;phoneAreaCode&amp;quot;: &amp;quot;65&amp;quot;, &amp;quot;phoneNo&amp;quot;: &amp;quot;54875485&amp;quot;, &amp;quot;postCode&amp;quot;: &amp;quot;759973&amp;quot;, &amp;quot;regionFirst&amp;quot;: &amp;quot;Admiralty Road East&amp;quot;, &amp;quot;telAreaCode&amp;quot;: &amp;quot;86&amp;quot;, &amp;quot;telNo&amp;quot;: &amp;quot;9516168888&amp;quot;, &amp;quot;vat&amp;quot;: &amp;quot;&amp;quot; }, &amp;quot;sfWaybillNo&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;version&amp;quot;: &amp;quot;&amp;quot; }</code></pre> <h3><strong>响应示例</strong></h3> <pre><code class="language-json">{     &amp;quot;result&amp;quot;: {         &amp;quot;agentCode&amp;quot;: &amp;quot;&amp;quot;,         &amp;quot;agentWaybillNo&amp;quot;: &amp;quot;&amp;quot;,         &amp;quot;childWaybillNoList&amp;quot;: [             &amp;quot;SF2020293747403&amp;quot;         ],         &amp;quot;customerOrderNo&amp;quot;: &amp;quot;kts_api20210701840182504&amp;quot;,         &amp;quot;directionCode&amp;quot;: &amp;quot;&amp;quot;,         &amp;quot;sfWaybillNo&amp;quot;: &amp;quot;SF1334456581012&amp;quot;     },     &amp;quot;succ&amp;quot;: &amp;quot;ok&amp;quot;,     &amp;quot;msg&amp;quot;: null }</code></pre>

页面列表

ITEM_HTML