api地址:DHL Parcel DE Returns (Post & Parcel Germany)
什么是退货面单
退货面单是客户在寄回商品时要用到的快递面单,面单里面的有两个关键信息
- 发件人(客户)信息:客户决定,包括姓名、电话、地址等
- 收件人(商家)信息:收件人由商家提供给你客户,供客户再寄件时填写。
DHL中,不同国家的面单的样式是不一样的,例如:
从德国发货的面单长这样
从意大利发货的面单长这样
参数说明
{
"receiverId": "收件人id,绑定得业务账号的后台维护的receiverId",
"shipper": {//发件人信息
"name1": "Max Mustermann",
"addressStreet": "Kurfürstendamm",
"addressHouse": "1",
"postalCode": "10719",
"city": "Berlin"
}
}
这里重点说下receiverId,由业务账号在后台维护的收货人id,API根据这个id,能够获取收货人信息,包括:姓名、电话、邮箱、地址。不同的发货国家对应不同的receiverId,如上面所说,API会根据不同的发货国家决定退货面单的样式。
业务账号和APP的关系请参考:DHL Basic Auth(基本认证)
沙盒环境调用API
- 申请API调用权限,参考DHL 申请开发者账号
- 下载API调用postman示例
- 使用沙盒提供的业务账号生成basic auth
- 使用postman测试
沙盒提供的业务账号
postman示例下载
生产环境调用API
和沙盒一样,只是业务账号换成真实的业务账号即可