gwinn/boxberry-sdk

Boxberry API implementation

v1.0.5 2024-06-21 13:07 UTC

Requires

• php: >=7.3.0
• ext-json: *
• guzzlehttp/guzzle: ^6.5
• jms/serializer: ^1.1|^3.28
• psr/http-client: ^1.0
• symfony/validator: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.18
• neur0toxine/pock: ^0.12.2
• phpmd/phpmd: ^2.5
• phpstan/phpstan: ^0.11|^1.8
• phpunit/phpunit: ^6.5|^9.0
• squizlabs/php_codesniffer: ^3.5

MIT

• Alexander Lushpai
• Vladimir Kolchin
• Angelina Pekhova

• json
• rest
• api

README

SDK службы доставки Boxberry

Методы

• ListCities. Список городов доставки
• ListCitiesFull. Список городов доставки (полный)
• ListPoints. Список ПВЗ
• ListPointsShort. Коды всех отделений Boxberry c датой последнего изменения
• PointsDescription. Расширенная информация о ПВЗ
• PointsForParcels. Список пунктов приема посылок
• ListZips. Список почтовых индексов для КД
• ZipCheck. Проверка почтового индекса для КД
• CourierListCities. Список городов КД
• DeliveryCosts. Калькулятор стоимости доставки
• DeliveryCalculation. Новый калькулятор стоимости доставки (РФ/Страны ЕАЭС)
• ParselCreate. Создать/обновить заказ
• ParselSend. Формирование акта приема-передачи посылок.
• CancelOrder. Отзыв или удаление посылки
• ChangeOrderDetails. Изменение данных посылки
• ChangeOrderStorageDate. Изменение срока хранения посылки
• ChangeOrderIssue. Изменение типа выдачи посылки
• ChangeOrderDeliveryType. Измение параметров доставки
• CreateIntake. Заявка на курьерский забор посылок.
• ListStatuses. Статусы посылки
• ListStatusesFull. Расширенный список статусов посылки
• ListServices. Стоимость начисленных услуг
• ParselCheck. Ссылка на печатную форму этикетки.
• ParselStory. Список трекинг-кодов посылок с расширенной информацией
• ParselSendStory. Список созданных актов приема-передачи
• OrdersBalance. Информация по заказам, которые фактически переданы на доставку, но еще не доставлены клиенту.
• ParselList. Список трекинг-кодов посылок, не включенных в акт приема-передачи
• ParcelInfo. Получение информации о заказах
• WarehouseCreate. Добавление склада
• WarehouseDelete. Удаление склада
• WarehouseInfo. Информация о складе
• WarehouseUpdate. Обновление склада

Требования

PHP 7.3 или выше.

Установка

composer require Gwinn/boxberry-sdk

Примеры использования

$yourHttpClientFactory = new \Gwinn\Boxberry\Factory\HttpClientFactory();
$apiClientFactory = new \Gwinn\Boxberry\Factory\ApiClientFactory($yourHttpClientFactory);
$boxberryClient = $apiClientFactory->create(API_TOKEN);

$listCitiesRequest = new \Gwinn\Boxberry\Model\Request\Geography\ListCitiesRequest();
$listCitiesRequest->countryCode = '643';

try{
    // получение городов
    $response = $boxberryClient->listCities($listCitiesRequest);
}catch (ApiException $exception){
    echo $exception->getMessage();
    exit(255);
}

$yourHttpClientFactory = new \Gwinn\Boxberry\Factory\HttpClientFactory();
$apiClientFactory = new \Gwinn\Boxberry\Factory\ApiClientFactory($yourHttpClientFactory);
$boxberryClient = $apiClientFactory->create(API_TOKEN);

$parcel = new \Gwinn\Boxberry\Model\Request\OrderInfo\ParcelInfoRequest\Parcel();
$parcel->orderId = '123';
$parcelInfoRequest = new \Gwinn\Boxberry\Model\Request\OrderInfo\ParcelInfoRequest();
$parcelInfoRequest->parcels = [$parcel];

try{
    // получение информации о посылке
    $response = $boxberryClient->parcelInfo($parcelInfoRequest);
}catch (ApiException $exception){
    echo $exception->getMessage();
    exit(255);
}