达达快递接入流程和开发文档

达达API是一组提供配送服务的API，通过调用这些API可以实现订单创建、查询、取消、妥投等功能。以下是Java达达API的详细介绍和示例代码：

接入流程

相关定义

1.开发者：主要是负责接口的对接和联调；

2.商户：负责门店的经营，包括创建门店、账号管理、订单管理等；

3.开发者和商户关系：开发者必须和商户进行绑定后，才能为该商户提供技术服务，包括创建订单、查询订单等；

4.source_id：商户ID，商户在开放平台的唯一标识id，为接口对接过程中关键信息；

5.appkey：开发者账号创建后，系统自动创建的应用程序的ID，为开发者应用程序的唯一标识ID；

6.appsecret：开发者账号创建后，系统自动创建的应用程序的秘钥，在一定技术条件下保证所有接口数据传输的可靠性；

7.联调sourceid：达达测试环境提供的用于测试阶段联调使用的商户ID；

8.联调门店ID：达达测试环境提供的用于测试阶段联调使用的门店ID。

接入方案

入驻流程

1.创建开发者账号：获取appkey和appsecret；

2.开发应用：根据开发文档进行开发接入；

3.接口联调：登录开发者账号使用联调工具进行接口调试；

4.创建商户账号：获取source_id；

5.商户账号充值：需提前充值或联系品牌业务经理进行账户授信；

6.商户账号和开发者账号绑定：开发者必须和商户进行绑定后，才能为该商户提供接口操作；

7.应用上线：切换线上域名和商户ID进行发单。

1.创建开发者账号

2.开发应用

推荐根据物流基础场景接入相关接口，详见业务流程； 开发api调用规范、接口签名及具体接口业务参数，详见接口文档。

3.接口联调

使用联调环境达达域名、联调商户ID及门店ID进行发单等相关操作，在联调工具中完成订单状态流转。

4.创建商户账号及门店

创建商户账号

新建门店

注册并登录商户账号后，在商户管理中心创建门店，其中门店编码作为商户侧系统和达达系统发单交互的门店标识；已有达达快送企业版APP账号的商户，可以APP账号对应的门店绑定到已注册的商户账号下。

5.商户账号充值

在线上发单前需完成线上充值

6.商户账号和开发者账号绑定

方式一：开发者在达达开放平台管理中心发起绑定

开发者登录开发者账号发起绑定商户申请，商户登录商户账号进行审核，审核通过则绑定成功。

方式二：开发者提供授权页面绑定商户

开发者通过对接达达开放平台商户账号授权流程，在自有系统提供给商户授权页面，商户进入授权页面完成账号登录并授权，授权成功则该商户账号与提供授权的开发者绑定成功。

7.应用上线

在系统联调通过后，切换达达线上域名、线上商户ID及门店ID进行发单等相关操作。

首先需要在达达开放平台申请开发者账号并创建应用，获取appKey和appSecret。

使用Java开发工具，像其他Java SDK一样，通过Maven或Gradle构建应用程序，并添加以下依赖项:

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>dada-sdk</artifactId>
    <version>1.0.5</version>
</dependency>

创建DadaClient对象并设置appKey和appSecret

DadaClient client = new DadaClient(appKey, appSecret, baseUrl);

调用相应的API接口，例如创建订单：

Order order = new Order();
order.setShopNo("11047003");
order.setOriginId(String.valueOf(System.currentTimeMillis()));
order.setCityCode("010");
order.setCargoPrice(new BigDecimal("10"));
order.setIsPrepay(0);
order.setReceiverName("张三");
order.setReceiverAddress("北京市朝阳区望京SOHO塔1 B座 20层");
order.setReceiverPhone("13800000000");
order.setCallback(StringUtils.EMPTY);

Result<OrderAddResult> result = client.addOrder(order);
if (result.isSuccess()) {
    System.out.println("创建订单成功：" + result.getData());
} else {
    System.err.println("创建订单失败：" + result.getMsg() + ", code=" + result.getCode());
}

这段代码创建了一个订单对象，并使用客户端调用addOrder接口添加订单。如果成功，将返回包含订单号的 OrderAddResult 对象，否则将返回错误消息。

示例项目demo代码请参考链接：http://newopen.imdada.cn/#/development/file/guide

此示例项目包括基本的订单管理和回调处理功能，可以帮助您快速开始使用Java达达API。