实物商品批量发货/取消接口

需求场景

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

接口地址

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

results matching ""

    No results matching ""