物流系统与淘宝1688京东拼多多API接口

冷不防 2024-03-27 16:31 23阅读 0赞

*  seller\_order\_list 获取卖出的商品订单列表

*  seller\_order\_detail 获取卖出的商品订单详情

*  seller\_order\_close 卖家关闭一笔交易

*  seller\_order\_message 获取或修改卖出去的订单备注

*  seller\_auction\_list 商品可上下架商品列表

*  seller\_auction 商品上下架

*  seller\_item\_add 商品上传

*  upload\_img 上传图片到淘宝

*  img2text 图片识别商品接口

*  tbk\_order\_query 淘宝客订单查询

*  item\_list\_weight 批量获取商品信息

*  item\_history\_price 获取商品历史价格信息

*  item\_get\_app 获得淘宝app商品详情原数据

## **淘宝/天猫获取卖出的商品订单列表 API 返回值说明** ##

--------------------

### **seller\_order\_list-获取卖出的商品订单列表** ###

#### **onebound.taobao.seller\_order\_list** ####

公共参数

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:160px;vertical-align:bottom;height:52px;">名称</td> 
 <td style="width:80px;vertical-align:bottom;height:52px;">类型</td> 
 <td style="width:160px;vertical-align:bottom;height:52px;">必须</td> 
 <td style="width:321px;vertical-align:bottom;height:52px;">描述</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">key</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">是</td> 
 <td style="width:321px;vertical-align:top;height:52px;">调用key（必须以GET方式拼接在URL中）</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">secret</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">是</td> 
 <td style="width:321px;vertical-align:top;height:52px;">调用密钥</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">api_name</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">是</td> 
 <td style="width:321px;vertical-align:top;height:52px;">API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">cache</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">result_type</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">lang</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">[cn,en,ru]翻译语言，默认cn简体中文</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">version</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">API版本</td> 
 </tr> 
 </tbody> 
</table>

请求参数

请求参数：page=&tabCode=&dateBegin=&dateEnd=&buyerNick=&itemTitle=&orderId=&lastStartRow=&detail=&page\_size=

参数说明：page:页码

&tabCode:\[waitBuyerPay,waitSend,haveSendGoods,refunding,waitRate,success,closed,before3Months\]

dateBegin:开始时间,dateEnd:结束时间(格式：yyyy-mm-dd hh:ii:ss)

buyerNick:买家昵称，如不填写则为当前登录用户

itemTitle:宝贝标题

orderId:订单编号

lastStartRow:查三个月前订单用到的参数

detail:此参数高级用户才支持

token:SaaS授权

响应参数

Version: Date:

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:120px;vertical-align:bottom;height:52px;">名称</td> 
 <td style="width:80px;vertical-align:bottom;height:52px;">类型</td> 
 <td style="width:80px;vertical-align:bottom;height:52px;">必须</td> 
 <td style="width:240px;vertical-align:bottom;height:52px;">示例值</td> 
 <td style="width:240px;vertical-align:bottom;height:52px;">描述</td> 
 </tr> 
 <tr> 
 <td style="width:120px;vertical-align:middle;height:52px;">order_id</td> 
 <td style="width:80px;vertical-align:top;height:52px;">Bigint</td> 
 <td style="width:80px;vertical-align:top;height:52px;">0</td> 
 <td style="width:240px;vertical-align:top;height:52px;">368830339413001234</td> 
 <td style="width:240px;vertical-align:top;height:52px;">订单号</td> 
 </tr> 
 <tr> 
 <td style="width:120px;vertical-align:middle;height:52px;">deal_time</td> 
 <td style="width:80px;vertical-align:top;height:52px;">Date</td> 
 <td style="width:80px;vertical-align:top;height:52px;">0</td> 
 <td style="width:240px;vertical-align:top;height:52px;">2019-03-06 18:14:25</td> 
 <td style="width:240px;vertical-align:top;height:52px;">处理时间</td> 
 </tr> 
 <tr> 
 <td style="width:120px;vertical-align:middle;height:52px;">buyer_nick</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:80px;vertical-align:top;height:52px;">0</td> 
 <td style="width:240px;vertical-align:top;height:52px;">abc123</td> 
 <td style="width:240px;vertical-align:top;height:52px;">买家昵称</td> 
 </tr> 
 <tr> 
 <td style="width:120px;vertical-align:middle;height:52px;">buyer_name</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:80px;vertical-align:top;height:52px;">0</td> 
 <td style="width:240px;vertical-align:top;height:52px;"><a style="color:#0A6CFF;" href="https://o0b.cn/jennif" rel="nofollow">https://o0b.cn/jennif</a></td> 
 <td style="width:240px;vertical-align:top;height:52px;">买家姓名</td> 
 </tr> 
 <tr> 
 <td style="width:120px;vertical-align:middle;height:52px;">seller_id</td> 
 <td style="width:80px;vertical-align:top;height:52px;">Bigint</td> 
 <td style="width:80px;vertical-align:top;height:52px;">0</td> 
 <td style="width:240px;vertical-align:top;height:52px;">557039353</td> 
 <td style="width:240px;vertical-align:top;height:52px;">卖家id</td> 
 </tr> 
 <tr> 
 <td style="width:120px;vertical-align:middle;height:52px;">goods</td> 
 <td style="width:80px;vertical-align:top;height:52px;">Mix</td> 
 <td style="width:80px;vertical-align:top;height:52px;">0</td> 
 <td style="width:240px;vertical-align:top;height:52px;">[{"goods_name": "爆款PP棉公仔粉红色猪表情毛绒玩具软体羽绒棉可爱猪抱枕弹力女生", "goods_id": "368830339413841880", "goods_image": "<a style="color:#0A6CFF;" href="https:img.alicdn.com/imgextra/i4/557039353/O1CN010aX1Is2Ixi" rel="nofollow">//img.alicdn.com/imgextra/i4/557039353/O1CN010aX1Is2Ixi</a>⼀b0_!!557039353.jpg_sum.jpg", "unit_price": "28.00", "goods_count": "2", "goods_info": "颜色分类：大眼呆蒙;高度：40cm(0.4公斤)", "goods_code": "qb"}]</td> 
 <td style="width:240px;vertical-align:top;height:52px;">商品信息列表</td> 
 </tr> 
 <tr> 
 <td style="width:120px;vertical-align:middle;height:52px;">total_price</td> 
 <td style="width:80px;vertical-align:top;height:52px;">Float</td> 
 <td style="width:80px;vertical-align:top;height:52px;">0</td> 
 <td style="width:240px;vertical-align:top;height:52px;">56.00</td> 
 <td style="width:240px;vertical-align:top;height:52px;">总价</td> 
 </tr> 
 <tr> 
 <td style="width:120px;vertical-align:middle;height:52px;">freight</td> 
 <td style="width:80px;vertical-align:top;height:52px;">Float</td> 
 <td style="width:80px;vertical-align:top;height:52px;">0</td> 
 <td style="width:240px;vertical-align:top;height:52px;"></td> 
 <td style="width:240px;vertical-align:top;height:52px;">运费</td> 
 </tr> 
 <tr> 
 <td style="width:120px;vertical-align:middle;height:52px;">trading_status</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:80px;vertical-align:top;height:52px;">0</td> 
 <td style="width:240px;vertical-align:top;height:52px;">交易成功</td> 
 <td style="width:240px;vertical-align:top;height:52px;">交易状态</td> 
 </tr> 
 <tr> 
 <td style="width:120px;vertical-align:middle;height:52px;">countdown</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:80px;vertical-align:top;height:52px;">0</td> 
 <td style="width:240px;vertical-align:top;height:52px;"></td> 
 <td style="width:240px;vertical-align:top;height:52px;">剩余时间</td> 
 </tr> 
 </tbody> 
</table>

请求示例

*  [Curl][]

*  [PHP][]

*  [PHPsdk][]

*  [JAVA][]

*  [C\#][C]

*  [Python][]

\-- 请求示例 url 默认请求参数已经URL编码处理

curl -i "[https://api-gw.onebound.cn/taobao/seller\_order\_list/?key=<][https_api-gw.onebound.cn_taobao_seller_order_list_key]您自己的apiKey>&secret=<您自己的apiSecret>&page=&tabCode=&dateBegin=&dateEnd=&buyerNick=&itemTitle=&orderId=&lastStartRow=&detail=&page\_size="

错误码解释

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:184px;vertical-align:bottom;height:52px;">状态代码(error_code)</td> 
 <td style="width:257px;vertical-align:bottom;height:52px;">状态信息</td> 
 <td style="width:281px;vertical-align:bottom;height:52px;">详细描述</td> 
 <td style="width:80px;vertical-align:bottom;height:52px;">是否收费</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">0000</td> 
 <td style="width:257px;vertical-align:top;height:52px;">success</td> 
 <td style="width:281px;vertical-align:top;height:52px;">接口调用成功并返回相关数据</td> 
 <td style="width:80px;vertical-align:top;height:52px;">是</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">2000</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Search success but no result</td> 
 <td style="width:281px;vertical-align:top;height:52px;">接口访问成功，但是搜索没有结果</td> 
 <td style="width:80px;vertical-align:top;height:52px;">是</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4000</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Server internal error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">服务器内部错误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">否</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4001</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Network error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">网络错误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">否</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4002</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Target server error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">目标服务器错误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">否</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4003</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Param error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">用户输入参数错误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4004</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Account not found</td> 
 <td style="width:281px;vertical-align:top;height:52px;">用户帐号不存在</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4005</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Invalid authentication credentials</td> 
 <td style="width:281px;vertical-align:top;height:52px;">授权失败</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4006</td> 
 <td style="width:257px;vertical-align:top;height:52px;">API stopped</td> 
 <td style="width:281px;vertical-align:top;height:52px;">您的当前API已停用</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4007</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Account stopped</td> 
 <td style="width:281px;vertical-align:top;height:52px;">您的账户已停用</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4008</td> 
 <td style="width:257px;vertical-align:top;height:52px;">API rate limit exceeded</td> 
 <td style="width:281px;vertical-align:top;height:52px;">并发已达上限</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4009</td> 
 <td style="width:257px;vertical-align:top;height:52px;">API maintenance</td> 
 <td style="width:281px;vertical-align:top;height:52px;">API维护中</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4010</td> 
 <td style="width:257px;vertical-align:top;height:52px;">API not found with these values</td> 
 <td style="width:281px;vertical-align:top;height:52px;">API不存在</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4012</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Please add api first</td> 
 <td style="width:281px;vertical-align:top;height:52px;">请先添加api</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4013</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Number of calls exceeded</td> 
 <td style="width:281px;vertical-align:top;height:52px;">调用次数超限</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4014</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Missing url param</td> 
 <td style="width:281px;vertical-align:top;height:52px;">参数缺失</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4015</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Wrong pageToken</td> 
 <td style="width:281px;vertical-align:top;height:52px;">参数pageToken有误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4016</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Insufficient balance</td> 
 <td style="width:281px;vertical-align:top;height:52px;">余额不足</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4017</td> 
 <td style="width:257px;vertical-align:top;height:52px;">timeout error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">请求超时</td> 
 <td style="width:80px;vertical-align:top;height:52px;">否</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">5000</td> 
 <td style="width:257px;vertical-align:top;height:52px;">unknown error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">未知错误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">否</td> 
 </tr> 
 </tbody> 
</table>

[Curl]: https://open.onebound.cn/help/api/taobao.seller_order_list.html#code-Curl
[PHP]: https://open.onebound.cn/help/api/taobao.seller_order_list.html#code-PHP
[PHPsdk]: https://open.onebound.cn/help/api/taobao.seller_order_list.html#code-PHPsdk
[JAVA]: https://open.onebound.cn/help/api/taobao.seller_order_list.html#code-JAVA
[C]: https://open.onebound.cn/help/api/taobao.seller_order_list.html#code-C_
[Python]: https://open.onebound.cn/help/api/taobao.seller_order_list.html#code-Python
[https_api-gw.onebound.cn_taobao_seller_order_list_key]: https://api-gw.onebound.cn/taobao/seller_order_list/?key=<