全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
加密场景获取交易订单的物流信息(卖家视角)
接口地址: http://api.vv-tool.com/tool/erps/1688get-logistics-info
接口介绍: 获取卖家的订单的物流详情。该接口能查能根据物流单号查看物流详情,包括发件人,收件人,所发货物明细等。由于物流单录入的原因,可能跟踪信息的 API 查询会有延迟,加密场景使用。
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
名称 | 类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
shop_id | string | 是 | 店铺 id | 123 |
order_id | Long | 是 | 订单号 | xxx |
fields | String | 否 | 需要返回的字段,目前有:company.name,sender,receiver,sendgood。返回的字段要用英文逗号分隔开 | company,name,sender,receiver,sendgood |
web_site | String | 是 | 是 1688 业务还是 icbu 业务 | 1688 或者 alibaba |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
名称 | 类型 | 描述 | 示例值 |
---|---|---|---|
result | message:alibaba.logistics.OpenPlatformLogisticsOrder[] | 查询结果 | |
logistics_id | string | 物流信息 i_d | |
logistics_bill_no | string | 物流单号,运单号 | |
order_entry_ids | string | 订单号列表,无子订单的等于主订单编号,否则为对应子订单列表 | 129232515787615400,129232515788615400,129232515789615400,129232515790615400 |
status | string | 物流状态。WAITACCEPT:未受理;CANCEL:已撤销;ACCEPT:已受理;TRANSPORT:运输中;NOGET:揽件失败;SIGN:已签收;UNSIGN:签收异常 | |
logistics_company_id | string | 物流公司 i_d | |
logistics_company_name | string | 物流公司编码 | |
remarks | string | 备注 | |
service_feature | string | service_feature | |
gmt_system_send | string | 发货时间 | |
send_goods | message:alibaba.logistics.OpenPlatformLogisticsSendGood[] | 商品信息 | |
good_name | String | 商品名 | |
quantity | String | 商品数量 | |
unit | String | 商品单位 | |
receiver | message:alibaba.logistics.OpenPlatformLogisticsReceiver | 收件人信息 | |
receiver_name | string | 收件人名字 | |
receiver_phone | string | 收件人电话 | |
receiver_mobile | string | 收件人电话 | |
encrypt | string | 国家编码 | |
receiver_province_code | string | 省编码 | |
receiver_city_code | string | 市编码 | |
receiver_county_code | string | 国家编码 | |
receiver_address | string | 地址 | |
receiver_province | string | 省份 | |
receiver_city | string | 城市 | |
receiver_county | string | 国家 | |
sender | message:alibaba.logistics.OpenPlatformLogisticsSender | 发件人信息 | |
sender_name | string | 发件人姓名 | |
sender_phone | string | 发件人电话 | |
sender_mobile | string | 发件人电话 | |
encrypt | string | 国家编码 | |
sender_province_code | string | 省编码 | |
sender_city_code | string | 城市编码 | |
sender_county_code | string | 国家编码 | |
sender_address | string | 发货人地址 | |
sender_province | string | 省份 | |
sender_city | string | 城市 | |
sender_county | string | 国家 | |
error_code | string | 错误码 | |
error_message | string | 错误信息 | |
ret_codes | string[] | 脱敏信息码 | ["xxx","xxx"] |
withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"withholding_money":1,
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |