PHPackages                             ledc/dada - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. ledc/dada

ActiveLibrary[API Development](/categories/api)

ledc/dada
=========

达达秒送开放平台SDK，首个版本发布于2025年8月1日

v7.4.5(9mo ago)25[1 issues](https://github.com/ledccn/dada-sdk-php/issues)MITPHPPHP >=7.4

Since Aug 2Pushed 9mo agoCompare

[ Source](https://github.com/ledccn/dada-sdk-php)[ Packagist](https://packagist.org/packages/ledc/dada)[ RSS](/packages/ledc-dada/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (7)Used By (0)

说明
==

[](#说明)

达达秒送开放平台SDK，首个版本发布于2025年8月1日

安装
--

[](#安装)

`composer require ledc/dada`

使用说明
----

[](#使用说明)

### 实例化SDK，调用达达接口

[](#实例化sdk调用达达接口)

```
use Ledc\Dada\Config;
use Ledc\Dada\Dada;

// 数据库或环境变量内的配置信息
$config = [
    'appKey' => 'app_key 应用ID',
    'appSecret' => 'app_secret 应用密钥',
    'sourceId' => 'source_id 商户编号',
    'sourceIdTest' => 'source_id 商户编号（测试环境）',
    'shopNoTest' => 'shop_no 门店编号（测试环境）',
    'timeout' => 10,
    'debug' => true,
    'enabled' => true,
];

$dada = new Dada(new Config($config));
```

在创建实例后，所有的方法都可以由IDE自动补全；例如：

```
/** @var \Ledc\Dada\Dada $dada */

// 获取达达秒送HTTP客户端（处理了签名逻辑），可以直接调用达达全部接口
$client = $dada->getClient();

// 封装的商户管理接口
$merchant = $dada->merchant();

// 封装的订单管理接口
$order = $dada->order();

// 封装的账户管理接口
$account = $dada->account();
```

### 创建回调通知报文对象

[](#创建回调通知报文对象)

```
// ThinkPHP 框架示例
$payload = request()->post(false);
// webman 框架示例
$payload = request()->post(null);

// 创建回调通知报文对象
$notify = \Ledc\DaDa\CallbackFactory::create($payload);
```

官方文档
----

[](#官方文档)

回调相关
----

[](#回调相关)

### 订单状态回调

[](#订单状态回调)

创建达达物流订单后，在每次订单状态发生变化时，达达会将状态回调至新增订单接口callback传入的URL，订单状态流转见订单流转。

1. 已取消=5：包括配送员取消、商户取消、客服取消、系统取消（比如：骑士接单后一直未取货）， 此时订单的状态为已取消，可以通过“重新发单”来下发订单；
2. 妥投异常之物品返回中=9：配送员在收货地，无法正常送到用户手中（包括用户电话打不通、客户暂时不方便收件、客户拒收、货物有问题等等）；
3. 创建达达运单失败=1000：表示因为达达内部服务异常，导致下发订单失败。可以通过“新增订单”来下发订单； 4.订单状态回传顺序：配送员自身原因取消运单后重抛场景下，会出现状态重复回传，比如骑士A在待取货状态下取消运单，重抛后会重推待接单状态，重复回传状态原因为1-重新分配骑士；骑士转单场景下，会出现订单状态重推，比如骑士A在待取货状态下转单给骑士B，会重推待取货状态，重复回传状态原因为2-骑士转单，并回传骑士B信息。历史注册开发者系统如支持重复状态回传可在开发助手-应用信息中开启【重复订单状态回调通知】开关，否则不重复回传，新注册开发者默认会回调。

---

1.登陆开发者账户，在【开发助手-日志查询】中可以查询订单回调信息 2.登录开发者账号，在【管理中心-开发助手-联调工具】中联调订单回调

### 骑士申请取消订单

[](#骑士申请取消订单)

骑士异常上报申请取消订单消息通知，该消息默认不通知，如系统及业务侧具备审核能力，请联系业务经理进行开通；回调地址URL请登录开发者账号，在【开发助手-应用信息】中进行配置。

### 门店信息变更通知

[](#门店信息变更通知)

部分门店信息发生变更场景会通过该接口通知，门店状态变更场景说明：

1.门店运力审核流程，如门店运力审核失败则门店自动下线，如审核通过则门店自动上线 2.运营操作门店上下线

---

回调地址URL请登录开发者账号，在【开发助手-应用信息】中进行配置。

捐赠
--

[](#捐赠)

[![reward](reward.png)](reward.png)

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance46

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

6

Last Release

288d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4af14254189bc74029cc40f4206f8006872b0cd092c680201f204a85a490f143?d=identicon)[ledccn](/maintainers/ledccn)

---

Top Contributors

[![ledccn](https://avatars.githubusercontent.com/u/53997080?v=4)](https://github.com/ledccn "ledccn (8 commits)")

### Embed Badge

![Health badge](/badges/ledc-dada/health.svg)

```
[![Health](https://phpackages.com/badges/ledc-dada/health.svg)](https://phpackages.com/packages/ledc-dada)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)