韵达快递对接测试

最新推荐文章于 2024-12-25 22:50:27 发布

chajintao

最新推荐文章于 2024-12-25 22:50:27 发布

阅读量851

点赞数

分类专栏： # 物流sdk对接文章标签： spring java intellij idea postman json

本文链接：https://blog.csdn.net/weixin_49203025/article/details/124328896

版权

这篇博客详细介绍了如何进行韵达快递的API对接测试，包括注册、认证、订阅API、导入jar包等准备工作，并重点讲解了预估运费、电子面单下单、散件下单及取消散件订单接口的测试开发，涉及Java环境下的接口调用和测试结果分析。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

韵达快递对接测试

1 对接准备

1.1 注册

使用手机号即可注册

1.2 认证

需要进行企业认证，输入公司名称，公司地址，所属行业，统一社会信用代码，三件合一证件

等待审核，审核成功之后进行控制台

显示基本信息（生产环境、测试环境），以及订阅列表

其中APPKEY，APPSECRET最为重要。

1.3 订阅API

点击新增订阅，可订阅API，共有10条，我是全部订阅

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-04va2JSJ-1650538090712)(C:\Users\Administrator\AppData\Roaming\Typora\typora-user-images\image-20220421095623627.png)]

1.4 导入jar包

下载jar包，kfpt-sdk-java地址为：https://openapi.yundaex.com/openapi-gateway/SDK-JAVA/kfpt-sdk-1.0.0.jar

java源码下载地址：https://openapi.yundaex.com/openapi-gateway/SDK-JAVA/kfpt-sdk.zip

PHP下载地址：https://openapi.yundaex.com/openapi-gateway/SDK-JAVA/openapi-demo-php-1.0.0.php

1.5 准备完成，进行联调测试

2 测试开发

2.1 依赖注入

将jar包导入resources下的lib中，在pom.xml注入

<!--尝试对接韵达-->
        <dependency>
            <groupId>yunda.sdk</groupId>
            <artifactId>yd</artifactId>
            <version>1.0</version>
            <scope>system</scope>
            <systemPath>${
   project.basedir}/src/main/resources/lib/kfpt-sdk-1.0.0.jar</systemPath>
        </dependency>

2.2 预估运费接口

该接口只有一级地址–一级地址，还有重量，三个参数，对接要慎重

2.2.1 预估运费参数

package com.hc.store.yunda;

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;

/**
 * @author chajintao
 * @date 2022/4/21 9:06
 */
@ApiModel("预估运费参数")
@Data
public class YdFreightParam {
   
    @ApiModelProperty("寄件人省份/直辖市")
    private String startCity;
    @ApiModelProperty("收件人省份/直辖市")
    private String endCity;
    @ApiModelProperty("重量（kg）")
    private String weight;
}

2.2.2 @Test

@RequestMapping("/dd")
    public String dd(){
   
        YdFreightParam yd = new YdFreightParam();
        yd.setStartCity("山东省");
        yd.setEndCity("安徽省");
        yd.setWeight("2.00");

        String serverUrl = "https://openapi.yundaex.com/openapi-api/v1/order/getFreightInfo";

        String jsonParams = JSON.toJSONString(yd);
        String result = OpenApiHttpUtils.doPostJson(serverUrl,jsonParams,appKey,appSecret);
        System.out.println(result);
        return result;
    }

2.2.3 result

{
   
    "code": "0000",
    "message": "请求成功",
    "result": true,
    "data": 17.0
}

2.3 电子面单下单接口

2.3.1 下单参数

参数	类型	必填	说明
appid	String	true	合作社appid(等同于app-key)
partner_id	String	true	韵达白马账户（合作网点提供）
secret	String	true	联调密码（合作网点）
orders	List	true	订单详情