#第三方物流API#德邦快递API联调测试经验分享

栏目：云星空知识作者：金蝶来源：金蝶云社区发布：2024-09-16浏览：1

德邦快递API联调测试经验分享

一、业务综述

很多商贸类企业，经常会收发快递，在使用ERP系统的时候想要单独二开对接，调取德邦快递API进行下单，查询等功能操作，上线前，都会进行联调测试；

本文章主要介绍下如何快速联调测试并成功在德邦快递API平台进行API接口的上线；

二、对接渠道

德邦API开放平台：德邦快递-新开放平台 (deppon.com)

三、查看对接文档

进入开放平台，在上方可查看对接文档，可了解德邦快递API的“接入指南”、“对接文档”、“各类接口文档”等；

四、API对接前指引

1、按照合作接入流程进行签约

德邦快递：合作接入流程

如何获取客户编码？

2、API快速入门

签约获取客户编号、并成功注册认证企业后，我们就可以登录平台；

根据API快速入门，进行操作：

3、登录，查看信息并妥善保存接口使用的信息（重要）

客户编码：

CompanyCode：

sign值：

appkey：

（以上四个参数是对接请求必录的参数，请一定要谨记！）

4、接口配置API

接口配置，即您要对接的德邦快递接口；

一般情况下，想要实现快递的需求；

需要使用“（新）下单服务接口”、“（新）标准轨迹查询”，“快递电子运单筛单接口”三个接口一般就够用啦；

那么我们关联一下这三个API，步骤如上：

关联后，如下图所示：

五、工具准备apifox

Apifox：

Apifox - API 文档、调试、Mock、测试一体化协作平台。拥有接口文档管理、接口调试、Mock、自动化测试等功能，接口开发、测试、联调效率，提升 10 倍。最好用的接口文档管理工具，接口自动化测试工具。

1、登录Apifox网页版

点击进入网页，直接使用web版即可；微信直接登录；

2、新建一个“个人项目”

联调测试前，可以查看每个接口的API文档，了解参数和传参要求，以便二开人员开发；

测试的示例代码，查看对接文档；或者在“查看对接进度”点击对应接口的“提交验证”即可查看；

详见下述：

联调的顺序是什么呢？当然是按照寄送快递的业务顺序进行；

一般是“（新）下单服务接口”、“（新）标准轨迹查询”，“快递电子运单筛单接口”；

下面具体介绍下：（附上报文）

六、联调接口

1、（新）下单服务接口API联调测试

在Apifox新建一个“根目录”的“post”连接；

录入接口提供的连接地址，如何获取？

路径：在API开放，点击对应接口的“报文校验”可以查看接口的信息；

根据接口文档的请求参数，在post页签里增加4个请求参数值；

注意：logisticID：是sign值+流水号，测试环境里流水号随意；

生成签名和时间戳，这里一会儿再Post里面需要使用；

（新）下单服务接口请求报文

{"companyCode":"公司编码"
,"customerCode":"客户编码",
"logisticID":"sign值+流水号",
"needTraceInfo":1,
"orderType":"2",
"transportType":"PACKAGE",
"packageInfo":{"cargoName":"货物名","deliveryType":"4","totalNumber":2,"totalVolume":0.01,"totalWeight":10,"packageService":"纸"},"receiver":{"address":"徐泾镇明珠路1018号","city":"上海市","companyName":"德邦快递","county":"青浦区","mobile":"180****2531","name":"AAA","province":"上海","town":"徐泾镇"},"sender":{"address":"崧建路688弄","city":"上海市","companyName":"","county":"青浦区","mobile":"180****3451","name":"AAA","province":"上海","town":"重固镇"},"transportType":"PACKAGE","gmtCommit":"2019-05-20 18:44:19","payType":"1","isOut":"N"}

摘要验证失败原因：
1、平台上MD5+BASE64加密，MD5加密后的数据是全小写的；
2、下面是对1进行不同加密后的结果，可以自己比对下是否一致。（不一致说明加密方法有问题）
     MD5对1加密结果 --- c4ca4238a0b923820dcc509a6f75849b
     BASE64对1加密结果 --- MQ==
     BASE64(MD5())对1解密结果  --- YzRjYTQyMzhhMGI5MjM4MjBkY2M1MDlhNmY3NTg0OWI=
3、参数传递采用http post请求,请求消息头设置：("Content-Type","application/x-www-form-urlencoded;charset=utf-8")；
4、沙箱测试-同步联调接口选择接口测试输入请求报文生成时间戳和签名，看签名是否和本地生产上的签名是否一样;
5、对于params参数中有特殊字符的需要进行url转译。
6、检查调用时appkey是否和平台存在差异。

我们重新再“提交报文”中点击“生成签名和时间戳”再修改传参，发送试下

只要修改了“Parmas”参数的额请求报文，就必须重新再德邦平台的“提交报文”中点击“生成签名和时间戳”

然后根据签名和时间戳，修改“digest”和“timestamp”参数，重新发送，直到成功；

（重新生成签名和时间戳后，不要再德邦平台点击“测试”否则，这里就会提示渠道号或运单号重复）

（新）下单服务接口返回报文：

{
    "result": "true",
    "reason": "成功",
    "mailNo": "DPK6450265433369",
    "logisticID": "HWJQ888666555889",
    "arrivedOrgSimpleName": "上海上海市",
    "resultCode": "1000",
    "uniquerRequestNumber": "25588128328665188"
}

快递运单号

一眼就能看到“mailNo”参数值，那就是我们需要的下单返回的快递运单号！

DPK6450265433369

logisticID

HWJQ888666555889

2、新轨迹查询接口API联调测试

联调方式和上面一样，都是使用在“报文校验”中的“请求报文”，修改后

点击“生成签名和时间戳”再修改传参，到Apifox，新建一个post，重新接入对应的连接地址

然后，修改传参发送下即可；

新轨迹查询接口请求报文

{"mailNo":"DPK6450265433369"}

新轨迹查询接口返回报文

{
    "result": "true",
    "reason": "",
    "resultCode": "1000",
    "responseParam": {
        "trace_list": [
            {
                "city": "**市(测试)",
                "description": "正常签收,签收人类型:本人/同事/门卫 等",
                "site": "【***】营业部",
                "status": "SIGNED",
                "time": "2024-04-13 02:52:02"
            },
            {
                "city": "**市(测试)",
                "description": "此货已滞留，与客户预约改日派送",
                "site": "【***】营业部",
                "status": "ERROR",
                "time": "2024-04-13 05:52:02"
            },
            {
                "city": "**市(测试)",
                "description": "拒绝签收:原因",
                "site": "【***】营业部",
                "status": "FAILED",
                "time": "2024-04-13 02:52:02"
            },
            {
                "city": "**市(测试)",
                "description": "派送中,派送人:**,派送人电话:***********",
                "site": "【***】营业部",
                "status": "SENT_SCAN",
                "time": "2024-04-12 23:52:02"
            },
            {
                "city": "**市(测试)",
                "description": "货物已到达【***营业部】部门",
                "site": "【***】营业部",
                "status": "ARRIVAL",
                "time": "2024-04-12 20:52:02"
            },
            {
                "city": "**市(测试)",
                "description": "运输中,离开【上海市转运中心】,下一站【***营业部】(出发到达对应多个)",
                "site": "****转运中心/营业部/枢纽中心",
                "status": "DEPARTURE",
                "time": "2024-04-12 17:52:02"
            },
            {
                "city": "**市(测试)",
                "description": "您的订单已被收件员揽收,【上海市青浦区***营业部】库存中",
                "site": "上海市转运中心/营业部/枢纽中心",
                "status": "GOT",
                "time": "2024-04-12 15:52:02"
            }
        ],
        "tracking_number": "DPK6450265433369"
    },
    "uniquerRequestNumber": "25588739066369245"
}

3、快递电子运单筛单接口API联调测试

联调方式和上面一样，都是使用在“报文校验”中的“请求报文”，修改后

点击“生成签名和时间戳”，到Apifox，新建一个post，重新接入对应的连接地址

然后，修改传参发送下即可；

这里面有个问题，那就是示例报文中，官方没更新，要比照接口文档，只传必录的就行；

现需要修改的报文参数有：

customerCode：

orderSource：

logisticID：

使用之前的下单时使用的logisticID，orderSource就是companyCode

快递电子运单筛单接口请求报文

{"cargoName":"干果","customerCode":"客户编码","deliveryType":"3","logisticCompanyID":"DEPPON","orderSource":"公司编码","logisticID":"之前传的流水号","serviceType":"2","payType":"0","gmtCommit":"2012-11-27 18:44:19","receiver":{"address":"明珠路1018号","city":"上海市","county":"青浦区","mobile":"15800000000","name":"宝某某","phone":"","province":"上海"},"sender":{"address":"北京中路100号","city":"贵阳市","county":"花溪区","mobile":"15800000001","name":"淘某某","phone":"","province":"贵州省"},"smsNotify":"Y","toNetworkNo":"W01061502","totalNumber":500,"totalVolume":400,"totalWeight":300,"transportType":"PACKAGE","vistReceive":"Y"}

快递电子运单筛单接口返回报文

{
    "logisticID": "HWJQ888666555889",
    "result": "true",
    "reason": "成功",
    "resultCode": "1000",
    "uniquerRequestNumber": "25589569818538331"
}