阿芷自动发货

阿芷自动发货


推送订单数据

<h5>简要描述</h5> <ul> <li>推送订单数据</li> <li>接口方向:自动发货系统-&gt;商户</li> </ul> <h5>订单通知说明</h5> <ul> <li>阿芷将以以下规范发送http(s)请求到应用商提供的通知url,应用商收到通知后,校验通知来源,并进行对应的处理。</li> </ul> <h5>请求方式</h5> <ul> <li>post</li> </ul> <h5>请求参数类型</h5> <pre><code>application/json</code></pre> <h5>query参数示例</h5> <table> <thead> <tr> <th style="text-align: left;">字段名</th> <th style="text-align: left;">必选</th> <th>示例</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">timestamp</td> <td style="text-align: left;">是</td> <td>20242316541254387544</td> <td>Long</td> <td>请求时间戳</td> </tr> <tr> <td style="text-align: left;">topic</td> <td style="text-align: left;">是</td> <td>taobao_trade_TradeCreate</td> <td>String</td> <td>通知类型:taobao_trade_TradeCreate 交易创建taobao_trade_TradeBuyerPay买家付款taobao_trade_TradeSellerShip 卖家发货taobao_trade_TradeClose 交易关闭taobao_trade_TradeSuccess交易成功</td> </tr> <tr> <td style="text-align: left;">type</td> <td style="text-align: left;">是</td> <td>NOTIFICATION</td> <td>String</td> <td>固定值”NOTIFICATION”</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td>70844d2139cac3078b9bb2bf1e426d26</td> <td>String</td> <td>签名:将请求参数按照如下规则拼接后使用md5加密后,转化为小写字符串&quot;merchantId=&quot; + 订单的merchantId + &quot;&amp;num=&quot; + 订单的num + &quot;&amp;status=&quot; + 订单的status + &quot;&amp;tid=&quot; + 订单的tid + appToken</td> </tr> </tbody> </table> <pre><code class="language-java">加密示例:merchantId=123456&amp;amp;num=1&amp;amp;status=TRADE_FINISHED&amp;amp;tid=2501489030603812222&amp;amp;42f5be13956d4b6084e17ad3759abb40</code></pre> <h5>请求参数示例</h5> <pre><code>{ &amp;quot;id&amp;quot;: 200093, &amp;quot;createdAt&amp;quot;: &amp;quot;2025-03-18T11:35:35.000+0800&amp;quot;, &amp;quot;updatedAt&amp;quot;: &amp;quot;2025-03-18T11:35:35.000+0800&amp;quot;, &amp;quot;receiveAt&amp;quot;: &amp;quot;2025-03-18T12:04:00.000+0800&amp;quot;, &amp;quot;platform&amp;quot;: 1, &amp;quot;cardValue&amp;quot;: 0, &amp;quot;merchantId&amp;quot;: 2664598521, &amp;quot;extendedFields&amp;quot;: null, &amp;quot;receiverName&amp;quot;: null, &amp;quot;receiverPhone&amp;quot;: null, &amp;quot;receiverMobile&amp;quot;: null, &amp;quot;receiverAddress&amp;quot;: null, &amp;quot;buyerArea&amp;quot;: null, &amp;quot;tid&amp;quot;: 2501489030603818671, &amp;quot;status&amp;quot;: &amp;quot;TRADE_FINISHED&amp;quot;, &amp;quot;sellerNick&amp;quot;: &amp;quot;饭饭的商品&amp;quot;, &amp;quot;buyerNick&amp;quot;: &amp;quot;z**&amp;quot;, &amp;quot;buyerOpenUid&amp;quot;: &amp;quot;AAGIfsVBAOXC4YJlNPppxo6m&amp;quot;, &amp;quot;type&amp;quot;: &amp;quot;fixed&amp;quot;, &amp;quot;buyerMessage&amp;quot;: null, &amp;quot;price&amp;quot;: 0.1, &amp;quot;num&amp;quot;: 1, &amp;quot;totalFee&amp;quot;: 0.1, &amp;quot;payment&amp;quot;: 0.1, &amp;quot;payTime&amp;quot;: &amp;quot;2025-03-18T11:35:38.000+0800&amp;quot;, &amp;quot;postFee&amp;quot;: 0, &amp;quot;tradeFrom&amp;quot;: &amp;quot;WAP,WAP&amp;quot;, &amp;quot;sellerMemo&amp;quot;: null, &amp;quot;sellerFlag&amp;quot;: 0, &amp;quot;creditCardFee&amp;quot;: null, &amp;quot;expandCardExpandPriceUsed&amp;quot;: null, &amp;quot;numIid&amp;quot;: 859316322419, &amp;quot;refundStatus&amp;quot;: &amp;quot;NO_REFUND&amp;quot;, &amp;quot;handleStatus&amp;quot;: 1, &amp;quot;goodsTitle&amp;quot;: &amp;quot;勿拍,测试,ppt2&amp;quot;, &amp;quot;picPath&amp;quot;: &amp;quot;https://img.alicdn.com/bao/uploaded/i4/2664598521/O1CN01QL76TL2CoftRBtqH0_!!2664598521.jpg&amp;quot;, &amp;quot;cardReceiveTime&amp;quot;: null, &amp;quot;profitRate&amp;quot;: null, &amp;quot;appId&amp;quot;: &amp;quot;10088581615&amp;quot;, &amp;quot;skuId&amp;quot;: &amp;quot;5841957459082&amp;quot;, &amp;quot;reserveA&amp;quot;: null, &amp;quot;sourceId&amp;quot;: null, &amp;quot;goodsName&amp;quot;: null, &amp;quot;goodsCode&amp;quot;: null, &amp;quot;skuCode&amp;quot;: null }</code></pre> <h5>请求参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">200093</td> <td>主键id</td> </tr> <tr> <td style="text-align: left;">createdAt</td> <td style="text-align: left;">2025-03-18T11:35:35.000</td> <td>0800</td> </tr> <tr> <td style="text-align: left;">updatedAt</td> <td style="text-align: left;">2025-03-18T11:35:35.000</td> <td>0800</td> </tr> <tr> <td style="text-align: left;">receiveAt</td> <td style="text-align: left;">2025-03-18T12:04:00.000</td> <td>0800</td> </tr> <tr> <td style="text-align: left;">platform</td> <td style="text-align: left;">1</td> <td>平台</td> </tr> <tr> <td style="text-align: left;">cardValue</td> <td style="text-align: left;">100</td> <td>面值</td> </tr> <tr> <td style="text-align: left;">merchantId</td> <td style="text-align: left;">100310</td> <td>商户id</td> </tr> <tr> <td style="text-align: left;">extendedFields</td> <td style="text-align: left;">200093</td> <td>扩展字段</td> </tr> <tr> <td style="text-align: left;">receiverName</td> <td style="text-align: left;">张三</td> <td>收货人姓名</td> </tr> <tr> <td style="text-align: left;">receiverPhone</td> <td style="text-align: left;">18186166888</td> <td>收货人电话</td> </tr> <tr> <td style="text-align: left;">tid</td> <td style="text-align: left;">2501489030603822222</td> <td>淘宝交易编号</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">TRADE_FINISHED</td> <td>交易状态 [详情见订单状态说明](<a href="https://www.showdoc.com.cn/azhi/11558636285381603">https://www.showdoc.com.cn/azhi/11558636285381603</a> &quot;详情见订单状态说明&quot;)</td> </tr> <tr> <td style="text-align: left;">sellerNick</td> <td style="text-align: left;"><strong>**</strong></td> <td>卖家昵称</td> </tr> <tr> <td style="text-align: left;">buyerNick</td> <td style="text-align: left;"><strong>**</strong></td> <td>买家昵称</td> </tr> <tr> <td style="text-align: left;">buyerOpenUid</td> <td style="text-align: left;">AAGIfsVBAOXC4YJlNP222222</td> <td>买家openUid</td> </tr> <tr> <td style="text-align: left;">type</td> <td style="text-align: left;">guarantee_trade</td> <td>交易类型列表,同时查询多种交易类型可用逗号分隔。默认同时查询guarantee_trade,</td> </tr> <tr> <td style="text-align: left;">buyerMessage</td> <td style="text-align: left;">消息</td> <td>买家消息</td> </tr> <tr> <td style="text-align: left;">price</td> <td style="text-align: left;">1.00</td> <td>价格</td> </tr> <tr> <td style="text-align: left;">num</td> <td style="text-align: left;">1</td> <td>数量</td> </tr> <tr> <td style="text-align: left;">totalFee</td> <td style="text-align: left;">1.00</td> <td>应付金额</td> </tr> <tr> <td style="text-align: left;">payment</td> <td style="text-align: left;">1.00</td> <td>子订单实付金额</td> </tr> <tr> <td style="text-align: left;">payTime</td> <td style="text-align: left;">2025-03-18T11:35:35.000</td> <td>0800</td> </tr> <tr> <td style="text-align: left;">postFee</td> <td style="text-align: left;">0.01</td> <td>邮费</td> </tr> <tr> <td style="text-align: left;">tradeFrom</td> <td style="text-align: left;">WAP,WAP</td> <td>交易内部来源。WAP(手机);HITAO(嗨淘);TOP(TOP平台);TAOBAO(普通淘宝);JHS(聚划算)一笔订单可能同时有以上多个标记,则以逗号分隔</td> </tr> <tr> <td style="text-align: left;">sellerMemo</td> <td style="text-align: left;">备注</td> <td>卖家备注</td> </tr> <tr> <td style="text-align: left;">sellerFlag</td> <td style="text-align: left;">1</td> <td>卖家备注旗帜(与淘宝网上订单的卖家备注旗帜对应,只有卖家才能查看该字段)红、黄、绿、蓝、紫</td> </tr> <tr> <td style="text-align: left;">creditCardFee</td> <td style="text-align: left;">0.01</td> <td>使用信用卡支付金额数</td> </tr> <tr> <td style="text-align: left;">expandCardExpandPriceUsed</td> <td style="text-align: left;">null</td> <td>用卡订单所用的权益金</td> </tr> <tr> <td style="text-align: left;">numIid</td> <td style="text-align: left;">859316322222</td> <td>宝贝id</td> </tr> <tr> <td style="text-align: left;">handleStatus</td> <td style="text-align: left;">1</td> <td>处理状态</td> </tr> <tr> <td style="text-align: left;">goodsTitle</td> <td style="text-align: left;">勿拍,测试,ppt2</td> <td>商品标题</td> </tr> <tr> <td style="text-align: left;">picPath</td> <td style="text-align: left;"><a href="https://img.alicdn.com/bao/uploaded/i4/2664598521/O1CN01QL76TL2CoftRBtqH0_!!2664598521.jpg">https://img.alicdn.com/bao/uploaded/i4/2664598521/O1CN01QL76TL2CoftRBtqH0_!!2664598521.jpg</a></td> <td>商品图片路径</td> </tr> <tr> <td style="text-align: left;">cardReceiveTime</td> <td style="text-align: left;">null</td> <td>卡密领取时间</td> </tr> <tr> <td style="text-align: left;">profitRate</td> <td style="text-align: left;">null</td> <td>利润</td> </tr> </tbody> </table> <h5>响应参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">示例</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">200</td> <td>错误码,200表示请求成功</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">SUCESS</td> <td>错误信息,成功返回“SUCESS”</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">null</td> <td>暂不需要</td> </tr> </tbody> </table>

页面列表

ITEM_HTML