README

实现与 Dalli 服务 的 API。本 SDK 可以帮助您更快地将 Dalli 服务集成到项目中。

有关与 Dalli API 交互的完整官方描述，请参阅 链接

SDK 功能

• 将订单添加到购物车
• 编辑购物车中的订单
• 通过俄罗斯邮政添加订单
• 显示购物车内容
• 清空购物车
• 发货
• 获取验收单
• 获取付款单
• 获取退货单
• 获取贴纸
• 从购物车获取贴纸
• 查询配送类型
• 查询配送时间段
• 查询订单状态
• 取货点
• 计算配送费用

只有拥有集成服务访问权限的用户才能使用所有 API 方法，这些权限仅在通过电子邮件 it@dalli-service.com 申请时提供。

要求

需要 PHP 7.4 或更高版本。

本 SDK 使用 PSR-18 (HTTP-client) 规范。这意味着可以使用任何支持此规范的 HTTP 客户端作为 HTTP 客户端。如果您的客户端不支持此规范，可以查看 大多数流行 HTTP 客户端的现有适配器

安装

使用 Composer 包管理器进行安装

composer require pankovalxndr/dalli-sdk-php

使用示例（将订单添加到购物车）

$client = new Client(new \GuzzleHttp\Client(), 'my_awsome_token', Endpoint::MSK);

$items = [];
$item = new Item();
$order = new Order();
$receiver = new Receiver();

$receiver->setAddress('ул. Константина Константинопольского, д.1 к1')
    ->setTown('г. Москва')
    ->setPerson('Константин Константинопольский')
    ->setPhone('+7 000 000 00 00')
    ->setDate(new DateTime('2022-12-25'))
    ->setTimeMin('9:00')
    ->setTimeMax('22:00');

$item->setQuantity(2)
    ->setName('Моя тестовая товарная позиция')
    ->setWeight(3.15)
    ->setRetPrice(50.0)
    ->setInshPrice(5.0)
    ->setOriginCountry('RU')
    ->setGtd('10702030')
    ->setSuppCompany('Компания поставщик')
    ->setSuppPhone('+7 000 000 00 00')
    ->setSuppInn('3664069397')
    ->setType(1);
$items[] = $item;

$order->setNumber('sdk-001')
    ->setReceiver($receiver)
    ->setService(1)
    ->setWeight(3.15)
    ->setQuantity(1)
    ->setPayType(PayType::CASH)
    ->setPrice(150.0) // стоимость товарных позиций + стоимость доставки
    ->setPriced(50.0)
    ->setInshPrice(500.0)
    ->setInstruction('Максимально аккуратно')
    ->setItems($items);


$request = new CreateBasketRequest();
$request->addOrder($order);

$response = $client->sendCreateBasketRequest($request);

foreach ($response as $order) {
    $error = $order->getErrors();
    $success = $order->getSuccess();
    if ($success)
        echo $success->getBarcode() . PHP_EOL; // Штрих-код заказа в системе Dalli
}

测试

运行测试

composer test

许可证

本项目根据 MIT 许可证 发布。