全部
淘宝
拼多多
抖音
京东
快手
当当
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 未授权店铺 根据返回链接进行扫码授权