全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
发货
接口地址: http://api.vv-tool.com/tool/erps/dd-send
接口介绍: 商家可以将“正在配货”或者“等待发货”的订单修改为“已发货”,商家可以批量处理多张发货订单。本接口支持自发订单(包括 COD 和非 COD 订单),暂时不支持当当代发订单(包括 COD 和非 COD 订单)。对于“买 A 赠多”促销,需要处理主商品和赠品每次。
a)如果订单当前状态是“正在配货”,则实际发货商品数量,以商家在本接口录入的商品数量为准
b)如果订单当前状态是“等待发货”,则实际发货商品数量,以商家在后台页面操作“标记配货完成”时录入的商品数量为准
c)参与了“多买多折”促销的商品,只能全部发货。
d) 不支持网络课程订单发货,只能一次发货,不支持拆分包裹发货,品信息缺少则按照缺货处理
支持最大订单量:50
支持的数据格式:XML
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
变量名称 | 变量命名 | 变量类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|---|
发货 XML 文件 | sendGoods | file | 是 | <input type=file.. | 发货的 XML 文件,具体内容请参考“发货 XML 文件格式说明” |
订单列表信息 | OrdersList | - | 是 | 订单列表信息含多张订单信息(OrderInfo) | |
订单信息 | OrderInfo | - | 是 | 每张订单信息含:订单 ID 物流公司名称 物流公司编码 物流公司电话 物流单号 发货清单 | |
订单 ID | orderID | long | 是 | 12345678 | |
物流公司名称 | logisticsName | string | 是 | 申通快递 | 物流公司的中文名称:30 个汉字(60 个字符)内 |
物流公司编码 | logisticsNameAb | string | 是 | STO | 物流公司编码,用于匹配推荐物流,误填将影响物流信息展示,如果是表格中的物流,请按照表格中给出的物流公司编码填写,否则填写 99999 |
物流公司电话 | logisticsTel | string | 是 | 010-01234567 | 20 个字符内 |
物流单号 | logisticsOrderID | string | 是 | A2345555555 | 30 个字符内 |
全发标示 | sendAll | bool | - | true 全发 false 非全发 | 此节点未传数据或者非全发的情况会关注 SendGoodsList 下数据 全发情况下 SendGoodsList 节点及子节点可为空 如果标示全发,会忽略 SendGoodsList 中信息 |
发货清单 | SendGoodsList | - | 是 | 发货清单含若干商品信息(ItemInfo):用户购物清单中有多少商品种类数,发货清单中必须返回多少种 | |
商品信息 | ItemInfo | - | 是 | 每个商品信息(ItemInfo)含:商品标识符 发货数量 | |
商品标识符 | itemID | long | 是 | 23242526 | 商品标识符 |
发货数量 | sendGoodsCount | int | 是 | 3 | |
商品明细编号 | productItemId | int | 是 | 12345678001 | 同订单详情接口返回的商品清单列表中的 productItemId (即接口 dangdang.order.details.get 返回信息中的 productItemId 属性 |
所属商品集合促销编号 | belongProductsPromoID | int | - | 商品所属的商品集合促销编号(新旧系统,该字段皆可为空)。 新系统:若所发商品不属于任何商品集合促销,则该字段为空; 若所发商品属于某商品集合促销,则该字段记录商品所属的商品集合促销编号 旧系统兼容问题:由于商家原因导致部分发货,系统默认优先发的商品是:所有优惠均摊后,优惠额度最高的商品 | |
sn 编码 | serialNumbers | string | 否 | sn123 | sn 编码(有 sn 编码的必须填写品信息) |
版本 | vvtype | int | 是 | 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2 |
请求示例
<?xml version="1.0" encoding="GBK"?>
<request>
<functionID>dangdang.order.goods.send</functionID>
<time>2009-03-20 15:10:50</time>
<OrdersList>
<OrderInfo>
<orderID>1719544796</orderID>
<logisticsName>申通快递</logisticsName>
<logisticsTel>010-45675233</logisticsTel>
<logisticsOrderID>3784938759</logisticsOrderID>
<SendGoodsList>
<ItemInfo>
<itemID>1719544796</itemID>
<sendGoodsCount>1</sendGoodsCount>
<belongProductsPromoID>< /belongProductsPromoID>
<productItemId>139123712371927</productItemId>
</ItemInfo>
<ItemInfo>
<itemID>1719544796</itemID>
<sendGoodsCount>2</sendGoodsCount>
<belongProductsPromoID >225</belongProductsPromoID>
<productItemId>139123712371927</productItemId>
</ItemInfo>
<ItemInfo>
......
</ItemInfo>
</SendGoodsList>
</OrderInfo>
<OrderInfo>
......
</OrderInfo>
......
</OrdersList>
</request>
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
响应参数
变量名称 | 变量命名 | 变量类型 | 说明 |
---|---|---|---|
订单列表 | OrdersList | - | 订单列表信息含若干订单信息(OrderInfo) |
订单信息 | OrderInfo | - | 每张订单信息含: 订单号 订单操作码 订单操作结果信息 |
订单号 | orderID | string | |
订单操作码 | orderOperCode | - | 0,39-44,500,605 |
订单操作结果信息 | orderOperation | - | 操作结果信息为下列中的一种:0 :操作成功 |
处理结果 | Result | int | 只有操作失败时,才返回“处理结果”例子 1:<\result><\opercode>100</\opercode><\operation> 没有上传 XML 文件 </\operation></result> |
操作码 | operCode | int | 100-103,601 |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"withholding_money":1,
"data": {
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |