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

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

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

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


一、业务综述

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


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



二、对接渠道

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


image.webp



三、查看对接文档

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

image.webp


四、API对接前指引

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

德邦快递:合作接入流程


image.webp



如何获取客户编码?

image.webp



2、API快速入门

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

根据API快速入门,进行操作:

image.webp


image.webp

image.webpimage.webp

image.webp

image.webp

image.webp


3、登录,查看信息并妥善保存接口使用的信息(重要)

image.webp

image.webp


客户编码:

CompanyCode:

sign值:

appkey:


(以上四个参数是对接请求必录的参数,请一定要谨记!)



4、接口配置API

接口配置,即您要对接的德邦快递接口;


一般情况下,想要实现快递的需求;

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


image.webp

image.webp

image.webp


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



关联后,如下图所示:

image.webp

五、工具准备apifox

Apifox:

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


1、登录Apifox网页版

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

image.webp


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

image.webp


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

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

详见下述:

image.webp


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

一般是“(新)下单服务接口”、“(新)标准轨迹查询”,“快递电子运单筛单接口”;


下面具体介绍下:(附上报文)



六、联调接口

1、(新)下单服务接口API联调测试


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


image.webp


录入接口提供的连接地址,如何获取?

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

image.webp

image.webp



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

image.webp


image.webp



image.webp


注意:logisticID:是sign值+流水号,测试环境里流水号随意;

image.webp



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

image.webp



(新)下单服务接口请求报文

{"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"}


image.webp


摘要验证失败原因:
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”参数,重新发送,直到成功;

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


image.webp



(新)下单服务接口返回报文:

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




快递运单号

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

DPK6450265433369


logisticID

HWJQ888666555889

image.webp



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


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

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

然后,修改传参发送下即可;


image.webp





新轨迹查询接口请求报文

{"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"
}


image.webp

.



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


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

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

然后,修改传参发送下即可;

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


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

customerCode:

orderSource:

logisticID:


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




image.webp




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

{"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"}


image.webp


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

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





六、查看API状态

每个接口只要用apifox调通一遍即可完成联调!


image.webp



七、申请上线


全部联调玩点击申请上线即可

如果有面单的,需要上传面单审核,如果有对接人,可以提交无面单审核;

image.webp


感谢分享!

点赞,收藏!


非常细节

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

德邦快递API联调测试经验分享一、业务综述 很多商贸类企业,经常会收发快递,在使用ERP系统的时候想要单独二开对接,调取德邦快递...
点击下载文档
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息