快递预约寄件（废弃）
<p>[TOC]</p>
<h3>简介</h3>
<ul>
<li>寄送快递时，通过接口预约快递员取件，或者取消取件预约。</li>
</ul>
<h3>接口调用说明</h3>
<h4>请求方式</h4>
<p>如接口没有单独说明，所有接口均为：<strong>POST</strong></p>
<h4>请求格式</h4>
<p>如接口没有单独说明，所有接口均为：<strong>application/form-data</strong></p>
<h4>请求参数</h4>
<p>请求参数包括公共参数和业务参数（业务参数见具体接口说明）
如果请求格式为application/x-www-form-urlencoded的，需要把<strong>公共参数</strong>和<strong>业务参数</strong>一并放在<strong>请求参数</strong>中提交
如果请求格式为application/json的，需要把<strong>公共参数</strong>放在<strong>请求Header</strong>中提交</p>
<p><a name="公共请求参数"></a></p>
<h5>公共请求参数</h5>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>appId</td>
<td>String</td>
<td>是</td>
<td>服务商分配的唯一标识</td>
</tr>
<tr>
<td>timestamp</td>
<td>Long</td>
<td>是</td>
<td>当前时间戳（毫秒）</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>是</td>
<td>签名，详见签名算法说明</td>
</tr>
</tbody>
</table>
<h5>签名算法说明</h5>
<pre><code>sign = sha256(appId + appSecret + timestamp)</code></pre>
<p>用服务商分配的 <strong>appId</strong>、服务商分配的 <strong>appSecret</strong>，当前时间戳（毫秒） <strong>timestamp</strong>，按上述顺序拼接成字符串，再进行 <strong>sha256</strong> 哈希得到。如下：</p>
<pre><code class="language-java">String appId = &quot;xyzxy2121zxyz&quot;；
String timestamp = &quot;1555378976238&quot;；
String appSecret = &quot;efcefcef1121cefcefc1212121&quot;；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h4>返回说明</h4>
<h5>公共返回字段说明</h5>
<p>所有接口均返回以下公共字段：</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>返回码，详见：code返回码说明</td>
</tr>
<tr>
<td>msg</td>
<td>code对应的描述</td>
</tr>
<tr>
<td>charge</td>
<td>计费标志 true为计费，false为不计费</td>
</tr>
<tr>
<td>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data</td>
<td>返回具体结果，object类型，详见data返回字段描述</td>
</tr>
</tbody>
</table>
<p><a name="code返回码说明"></a></p>
<table>
<thead>
<tr>
<th>code</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功</td>
</tr>
<tr>
<td>400</td>
<td>参数错误</td>
</tr>
<tr>
<td>404</td>
<td>接口地址不正确</td>
</tr>
<tr>
<td>500</td>
<td>系统维护，请稍候再试</td>
</tr>
<tr>
<td>601</td>
<td>接口未开通</td>
</tr>
<tr>
<td>602</td>
<td>账号停用</td>
</tr>
<tr>
<td>604</td>
<td>接口停用</td>
</tr>
<tr>
<td>606</td>
<td>调用超限，请稍候再试</td>
</tr>
<tr>
<td>607</td>
<td>ip不在白名单</td>
</tr>
<tr>
<td>609</td>
<td>请求过于频繁，请稍候再试</td>
</tr>
<tr>
<td>610</td>
<td>请求超时</td>
</tr>
<tr>
<td>999</td>
<td>其他，以实际返回为准</td>
</tr>
</tbody>
</table>
<hr />
<h3>预约取件</h3>
<ul>
<li>提供收件人信息、寄件人信息、商品信息等预约快递员上门取件。</li>
</ul>
<h4>请求地址</h4>
<p><code>https://api.jumdata.com/express-order/send</code></p>
<h4>请求格式</h4>
<ul>
<li>application/json</li>
</ul>
<h4>业务参数</h4>
<ul>
<li>样例</li>
</ul>
<pre><code class="language-json">{
&quot;orderCode&quot;: &quot;012657018199&quot;,
&quot;shipperCode&quot;: &quot;SF&quot;,
&quot;payType&quot;: 1,
&quot;expType&quot;: 1,
&quot;sender&quot;: {
&quot;name&quot;: &quot;张三&quot;,
&quot;mobile&quot;: &quot;15018xxxxxx&quot;,
&quot;provinceName&quot;: &quot;上海&quot;,
&quot;cityName&quot;: &quot;上海市&quot;,
&quot;expAreaName&quot;: &quot;青浦区&quot;,
&quot;address&quot;: &quot;明珠路&quot;
},
&quot;receiver&quot;: {
&quot;name&quot;: &quot;Yann&quot;,
&quot;mobile&quot;: &quot;15018xxxxxx&quot;,
&quot;provinceName&quot;: &quot;北京&quot;,
&quot;cityName&quot;: &quot;北京市&quot;,
&quot;expAreaName&quot;: &quot;朝阳区&quot;,
&quot;address&quot;: &quot;三里屯街道&quot;
},
&quot;commodity&quot;: [
{
&quot;goodsName&quot;: &quot;鞋子&quot;
}
],
&quot;weight&quot;: 1.0,
&quot;quantity&quot;: 1,
&quot;remark&quot;: &quot;需要泡沫箱&quot;
}</code></pre>
<p>参数说明</p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>shipperCode</td>
<td>String</td>
<td>是</td>
<td>快递公司编码，详见：<a href="<a href="https://anq-file.oss-cn-hangzhou.aliyuncs.com/support/express/express-order-send-code.xlsx">快递公司编码对照表</a>">https://anq-file.oss-cn-hangzhou.aliyuncs.com/support/express/express-order-send-code.xlsx">快递公司编码对照表</a></a>;</td>
</tr>
<tr>
<td>logisticCode</td>
<td>String</td>
<td>否</td>
<td>快递单号</td>
</tr>
<tr>
<td>payType</td>
<td>String</td>
<td>是</td>
<td>运费支付方式：1 - 现付，2 - 到付，3 - 月结</td>
</tr>
<tr>
<td>customerName</td>
<td>String</td>
<td>否</td>
<td>月结编号</td>
</tr>
<tr>
<td>expType</td>
<td>String</td>
<td>是</td>
<td>快递业务类型，详见：<a href="<a href="https://anq-file.oss-cn-hangzhou.aliyuncs.com/support/express/express-order-send-type.xlsx">快递业务类型</a>">https://anq-file.oss-cn-hangzhou.aliyuncs.com/support/express/express-order-send-type.xlsx">快递业务类型</a></a>;</td>
</tr>
<tr>
<td>isReturnSignBill</td>
<td>String</td>
<td>否</td>
<td>是否要求签回单，0 - 不要求，1 - 要求</td>
</tr>
<tr>
<td>cost</td>
<td>String</td>
<td>否</td>
<td>快递运费</td>
</tr>
<tr>
<td>otherCost</td>
<td>String</td>
<td>否</td>
<td>其他费用</td>
</tr>
<tr>
<td>receiver.company</td>
<td>String</td>
<td>否</td>
<td>收件人公司</td>
</tr>
<tr>
<td>receiver.name</td>
<td>String</td>
<td>是</td>
<td>收件人</td>
</tr>
<tr>
<td>receiver.tel</td>
<td>String</td>
<td>否</td>
<td>电话，电话与手机必填一个</td>
</tr>
<tr>
<td>receiver.mobile</td>
<td>String</td>
<td>否</td>
<td>手机，电话与手机必填一个</td>
</tr>
<tr>
<td>receiver.provinceName</td>
<td>String</td>
<td>是</td>
<td>收件省(如广东省，不要缺少“省”；如是直辖市，请直接传北京、上海等；如是自治区，请直接传广西壮族自治区等)</td>
</tr>
<tr>
<td>receiver.cityName</td>
<td>String</td>
<td>是</td>
<td>收件市(如深圳市，不要缺少“市；如是市辖区，请直接传北京市、上海市等”)</td>
</tr>
<tr>
<td>receiver.expAreaName</td>
<td>String</td>
<td>是</td>
<td>收件区/县(如福田区，不要缺少“区”或“县”)</td>
</tr>
<tr>
<td>receiver.address</td>
<td>String</td>
<td>是</td>
<td>收件人详细地址(不用传省市区)</td>
</tr>
<tr>
<td>sender.company</td>
<td>String</td>
<td>否</td>
<td>发件人公司</td>
</tr>
<tr>
<td>sender.name</td>
<td>String</td>
<td>是</td>
<td>发件人</td>
</tr>
<tr>
<td>sender.tel</td>
<td>String</td>
<td>否</td>
<td>电话，电话与手机必填一个</td>
</tr>
<tr>
<td>sender.mobile</td>
<td>String</td>
<td>否</td>
<td>手机，电话与手机必填一个</td>
</tr>
<tr>
<td>sender.provinceName</td>
<td>String</td>
<td>是</td>
<td>发件省(如广东省，不要缺少“省”；如是直辖市，请直接传北京、上海等；如是自治区，请直接传广西壮族自治区等)</td>
</tr>
<tr>
<td>sender.cityName</td>
<td>String</td>
<td>是</td>
<td>发件市(如深圳市，不要缺少“市；如是市辖区，请直接传北京市、上海市等”)</td>
</tr>
<tr>
<td>sender.expAreaName</td>
<td>String</td>
<td>是</td>
<td>发件区/县(如福田区，不要缺少“区”或“县”)</td>
</tr>
<tr>
<td>sender.address</td>
<td>String</td>
<td>是</td>
<td>发件人详细地址(不用传省市区)</td>
</tr>
<tr>
<td>startDate</td>
<td>String</td>
<td>是</td>
<td>上门揽件开始时间，例：2023-01-01 13:00:00</td>
</tr>
<tr>
<td>endDate</td>
<td>String</td>
<td>是</td>
<td>上门揽件结束时间，例：2023-01-01 17:00:00</td>
</tr>
<tr>
<td>weight</td>
<td>String</td>
<td>否</td>
<td>包裹总重量kg,当选择IsInstallService时必填</td>
</tr>
<tr>
<td>quantity</td>
<td>String</td>
<td>是</td>
<td>包裹数，一个包裹对应一个运单号，如果是大于1个包裹，返回则按照子母件的方式返回母运单号和子运单号</td>
</tr>
<tr>
<td>volume</td>
<td>String</td>
<td>否</td>
<td>包裹总体积m3</td>
</tr>
<tr>
<td>remark</td>
<td>String</td>
<td>否</td>
<td>备注</td>
</tr>
<tr>
<td>commodity.goodsName</td>
<td>String</td>
<td>是</td>
<td>商品名称</td>
</tr>
<tr>
<td>commodity.goodsCode</td>
<td>String</td>
<td>否</td>
<td>商品编码</td>
</tr>
<tr>
<td>commodity.goodsquantity</td>
<td>String</td>
<td>否</td>
<td>商品件数</td>
</tr>
<tr>
<td>commodity.goodsPrice</td>
<td>String</td>
<td>否</td>
<td>商品价格</td>
</tr>
<tr>
<td>commodity.goodsWeight</td>
<td>String</td>
<td>否</td>
<td>商品重量kg</td>
</tr>
<tr>
<td>commodity.goodsDesc</td>
<td>String</td>
<td>否</td>
<td>商品描述</td>
</tr>
<tr>
<td>commodity.goodsVol</td>
<td>String</td>
<td>否</td>
<td>商品体积m3</td>
</tr>
<tr>
<td>warehouseID</td>
<td>String</td>
<td>否</td>
<td>仓库标识(备用字段)</td>
</tr>
<tr>
<td>warehouseAddress</td>
<td>String</td>
<td>否</td>
<td>仓库地址(备用字段)</td>
</tr>
<tr>
<td>callback</td>
<td>String</td>
<td>否</td>
<td>用户自定义回传字段</td>
</tr>
<tr>
<td>memberID</td>
<td>String</td>
<td>否</td>
<td>ERP系统、电商平台等系统或平台类型用户的会员ID或店铺账号等唯一性标识，用于区分其用户</td>
</tr>
<tr>
<td>commodity.installTypeCode</td>
<td>String</td>
<td>否</td>
<td>需送装时，必传安装品类编码(仅支持ShipperCode为SF)</td>
</tr>
<tr>
<td>isInstallService</td>
<td>String</td>
<td>否</td>
<td>送装服务(仅支持ShipperCode为SF)支持以下传值，不填默认为0，0 - 非安装订单，1 - 送装分离，2 - 送装一体</td>
</tr>
<tr>
<td>packingType</td>
<td>String</td>
<td>否</td>
<td>包装类型(快运字段)支持以下传值：0 - 纸，1 - 纤，2 - 木，3 - 托膜，4 - 木托，99 - 其他</td>
</tr>
<tr>
<td>deliveryMethod</td>
<td>String</td>
<td>否</td>
<td>送货方式(快运字段)支持以下传值：0 - 自提，1 - 送货上门（不含上楼），2 - 送货上楼。</td>
</tr>
</tbody>
</table>
<h4>成功返回样例</h4>
<pre><code class="language-json">{
&quot;code&quot;: 200,// 返回码，详见返回码说明
&quot;msg&quot;: &quot;成功&quot;,// 返回码对应描述
&quot;taskNo&quot;: &quot;043439882226367117195632&quot;,// 本次请求号
&quot;charge&quot;: true, // 计费标志
&quot;data&quot;: {
&quot;orderCode&quot;: &quot;012657018199&quot;, //订单编号
&quot;shipperCode&quot;: &quot;SF&quot;, //快递公司编码
&quot;logisticCode&quot;: &quot;615123456789&quot; //快递单号
}
}</code></pre>
<h4>失败返回样例</h4>
<pre><code class="language-json">{
&quot;code&quot;: 400,// 返回码，详见返回码说明
&quot;taskNo&quot;: &quot;255033697205413852131601&quot;,// 本次请求号
&quot;charge&quot;: false,// 计费标志
&quot;msg&quot;: &quot;快递公司编号不能为空&quot;// 返回码对应描述
}</code></pre>
<hr />
<h3>寄件取消</h3>
<h4>请求地址</h4>
<p><code>https://api.jumdata.com/express-order/cancel</code></p>
<h4>业务参数</h4>
<p>参数说明</p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>shipperCode</td>
<td>String</td>
<td>是</td>
<td>快递公司编码</td>
</tr>
<tr>
<td>logisticCode</td>
<td>String</td>
<td>否</td>
<td>快递单号</td>
</tr>
<tr>
<td>orderCode</td>
<td>String</td>
<td>是</td>
<td>订单编号</td>
</tr>
</tbody>
</table>
<h4>成功返回样例</h4>
<pre><code class="language-json">{
&quot;code&quot;: 200,// 返回码，详见返回码说明
&quot;msg&quot;: &quot;成功&quot;, // 返回码对应描述
&quot;taskNo&quot;: &quot;448290834186092138576138&quot;,// 本次请求号
&quot;charge&quot;: false, //计费标志，寄件取消接口不计费
&quot;data&quot;: {}
}
</code></pre>
<h4>失败返回样例</h4>
<pre><code class="language-json">{
&quot;code&quot;: 400,// 返回码，详见返回码说明
&quot;msg&quot;: &quot;订单编号不能为空&quot;, // 返回码对应描述
&quot;taskNo&quot;: &quot;255033697205413852131601&quot;,// 本次请求号
&quot;charge&quot;: false, //计费标志
}</code></pre>