送件侠开放平台

闪时送开放平台


订单状态回调

<h3>触发回调</h3> <p>每次订单状态发生变化时(从运力平台接单起),会对合作方提供的回调url进行回调。</p> <p>注:回调url支持ip或域名,可联系管理员配置开通</p> <h3>签名算法</h3> <p>跟配送平台签名算法一致。使用配送平台的appkey跟secret做签名计算</p> <h3>成功与重试</h3> <p>回调返回字符success 判断为成功,否则为失败 (纯字符,不要json) 请求的超时时间为5秒,5秒内未响应则视为失败 推送失败会进行重试,每次重试时间间隔逐步延长,上限30次 下次推送时间: [当前重试次数*60秒]之后 举例说明: 第一次推送时间 10:14, 下次(第二次)推送时间为60秒后 第二次推送时间 10:15, 下次(第三次)推送时间为90秒后 第三次推送时间 10:17, 下次(第四次)推送时间为120秒后 等差数列求和: 1+2+3+....+29+30=465分钟, 最终会在465分钟后中断重试 开放平台失败重推回调通知不保证时序, 需要接入方自己做幂等处理</p> <h3>回调数据说明</h3> <p>请求方式:post 请求格式:application/x-www-form-urlencoded</p> <table> <thead> <tr> <th>参数名称</th> <th>参数类型</th> <th>是否必定包含</th> <th>参数描述</th> </tr> </thead> <tbody> <tr> <td>appkey</td> <td>String</td> <td>是</td> <td>配送开放平台为每个合作方分配独立的appkey,作为合作方接入认证标识。每个appkey会绑定一个secret,用于计算签名。请妥善保管secret,避免泄密。如果secret意外泄露,可要求重新生成。</td> </tr> <tr> <td>timestamp</td> <td>int</td> <td>是</td> <td>时间戳,时区为GMT+8,即合作方调用接口时距离Epoch(1970年1月1日) 以秒计算的时间(unix-timestamp)</td> </tr> <tr> <td>version</td> <td>String</td> <td>是</td> <td>API协议版本,可选值:1.0。</td> </tr> <tr> <td>sign</td> <td>String</td> <td>是</td> <td>API请求参数的签名计算结果。</td> </tr> <tr> <td>sss_peisong_id</td> <td>String</td> <td>是</td> <td>送件侠订单号</td> </tr> <tr> <td>order_id</td> <td>String</td> <td>是</td> <td>合作方订单号</td> </tr> <tr> <td>status</td> <td>int</td> <td>是</td> <td>订单状态, 2已接单,待取货,3已送出,4已完成,5已取消</td> </tr> <tr> <td>courier_name</td> <td>String</td> <td>是</td> <td>配送员姓名</td> </tr> <tr> <td>courier_phone</td> <td>String</td> <td>是</td> <td>配送员电话</td> </tr> <tr> <td>distance</td> <td>double</td> <td>是</td> <td>配送距离</td> </tr> <tr> <td>third_logistics_order_no</td> <td>String</td> <td>是</td> <td>运力公司订单号</td> </tr> <tr> <td>third_logistics_id</td> <td>String</td> <td>是</td> <td>运力公司标识号 1:达达 2:闪送 3:美团 4:爱跑腿 6:点我达 8:UU跑腿 9:蜂鸟 10:人人 11:顺丰 12:快服务 13:邻趣</td> </tr> <tr> <td>third_logistics_name</td> <td>String</td> <td>是</td> <td>运力公司名称</td> </tr> <tr> <td>is_custom_capacity_order</td> <td>int</td> <td>是</td> <td>是否是自运力账号订单,1:是 0:否</td> </tr> <tr> <td>delivery_fee</td> <td>double</td> <td>是</td> <td>运费</td> </tr> <tr> <td>coupon_fee</td> <td>double</td> <td>是</td> <td>优惠券减免金额</td> </tr> <tr> <td>deduct_fee</td> <td>double</td> <td>是</td> <td>违约费</td> </tr> <tr> <td>fee</td> <td>double</td> <td>是</td> <td>实际费用(该值即账户最终扣掉的金额 )</td> </tr> </tbody> </table> <h3>回调数据DEMO</h3> <pre><code>{ &amp;quot;timestamp&amp;quot;:1591001651, &amp;quot;appkey&amp;quot;:&amp;quot;11111&amp;quot;, &amp;quot;version&amp;quot;:&amp;quot;1.0&amp;quot;, &amp;quot;sss_peisong_id&amp;quot;:&amp;quot;1111&amp;quot;, &amp;quot;order_id&amp;quot;:&amp;quot;33333&amp;quot;, &amp;quot;status&amp;quot;:4, &amp;quot;courier_name&amp;quot;:&amp;quot;张三&amp;quot;, &amp;quot;courier_phone&amp;quot;:&amp;quot;15677714031&amp;quot;, &amp;quot;third_logistics_order_no&amp;quot;:&amp;quot;DH2020060117654331&amp;quot;, &amp;quot;third_logistics_id&amp;quot;:16, &amp;quot;third_logistics_name&amp;quot;:&amp;quot;闪送v5&amp;quot;, &amp;quot;is_custom_capacity_order&amp;quot;:1, &amp;quot;delivery_fee&amp;quot;:&amp;quot;29.76&amp;quot;, &amp;quot;gratuity_fee&amp;quot;:0, &amp;quot;deduct_fee&amp;quot;:&amp;quot;0.00&amp;quot;, &amp;quot;coupon_fee&amp;quot;:&amp;quot;0.00&amp;quot;, &amp;quot;fee&amp;quot;:29.76, &amp;quot;sign&amp;quot;:&amp;quot;3765f1031db06f21b4d0c5f58d833e8eaaae2c0e&amp;quot; }</code></pre> <h3>demo</h3> <pre><code>#可以拿下面的kv至Postman进行模拟调用以验证接口 timestamp:1584773885 appkey:4a296j83334940099ad6ecf6a552de33 version:1.0 sss_peisong_id:1418481 order_id:45302190353174400 status:4 courier_name:谢颂焰 courier_phone:17605915511 third_logistics_order_no:1067163152409034752 third_logistics_id:1 third_logistics_name:达达 delivery_fee:55.80 sign:d6b1f1c57f54cf32be8813821d77e00ca0f76ed5 </code></pre>

页面列表

ITEM_HTML