自有商品批量发货接口

优质

小牛编辑

124浏览

2023-12-01

需求场景

针对开发者有自己商品发货平台，想通过自己平台通过接口实现兑吧实物商品的订单批量发货。兑吧服务端开放了批量发货的接口。方便开发者通过接口调用实现自有实物商品的批量发货。

接口地址

1.确认批量发货接口：https://activity.m.duiba.com.cn/sendObject/batchSend?

2.批量取消发货接口：https://activity.m.duiba.com.cn/sendObject/batchCancel?

请求方式

接口支持get和post两种调用方式。因为get请求对请求链接长度限制原因，如果一次请求数量过多，建议使用post方式请求。

请求数量限制

考虑接口处理效率和业务响应时间，一次请求中不能超过50笔订单。

请求参数

确认批量发货请求参数

参数	是否必须	参数类型	参数长度	参数说明
appKey	yes	string	255	应用唯一性标识
expressInfo	yes	string		发货信息，使用utf-8编码
timestamp	yes	long	20	当前时间的时间戳
sign	yes	string	255	MD5签名，参见【签名规则】

请求示例：

https://activity.m.duiba.com.cn/sendObject/batchSend?sign=5293ea6d858aeed2c8eda0c038f4fe2f&appKey=21bPuGyabWsbjFAxtUBbbMqDSX1a&expressInfo=83964955796952C0821|中通快递|1312312312%2C83963479403352C0821|顺丰速运|4332323312311231&timestamp=15450321147570&

批量取消发货请求参数

参数	是否必须	参数类型	参数长度	参数说明
appKey	yes	string	255	应用唯一性标识
orderNums	yes	string		兑吧订单号，长度100个以内
timestamp	yes	long	20	当前时间的时间戳
sign	yes	string	255	签名【签名规则】

请求示例：

https://activity.m.duiba.com.cn/sendObject/batchCancel?sign=4b9f97aa1301d67f16c9750a7196e1b5&appKey=21bPuGyabWsbjFAxtUBbbMqDSX1a&orderNums=83964955796952C0821%2C83963479403352C0821&timestamp=15450327161880&

参数说明

1.expressInfo参数使用说明

每个订单发货信息，主要有，兑吧订单号，快递公司名称，快递单号三个信息，以下列各式组合:单个订单发货，以竖线符号分割，多个订单发货信息之间，用英文逗号分割。最多不超过50组。

格式如下：兑吧订单号1|快递公司名称1|快递单号1,兑吧订单号2|快递公司2|快递单号2,....依次组装。

2.快递公司为约定固定名称，清单选择如下

圆通速递，申通快递，顺丰速运，中通快递，宅急送，韵达快递，天天快递，百世汇通，EMS经济快递，EMS。快捷快递，国通快递，全峰快递，其他

响应参数

参数	是否必须	参数类型	参数长度	参数说明
success	YES	boolean		响应状态，true和false
details	NO	json	255	订单发货结果状态集合
errorMessage	NO	string	255	失败时候返回失败原因

响应示例

{
    "success": true,
    "details": {
        "83964955796952C0821": {
            "success": false,
            "message": "无此订单"
        },
        "83963479403352C0821": {
            "success": false,
            "message": "无此订单"
        }
    }
}

响应details的内容是全部订单状态的json集合，每个订单的状态是一个map对象，其中订单号为map的key，返回结果是订单的value