Download the PHP package wishbox/cdek-library without Composer

wishbox/cdek-library

PHP 8.4 client for CDEK API with a modular structure around a shared CdekClient, PSR-18 HTTP support, request DTOs, and basic local validation for order creation.

Requirements

• PHP 8.4+
• PSR-18 HTTP client
• PSR-17 request and stream factories

Installation

This package expects a PSR-18 HTTP client and PSR-17 factories from your application.

Usage

Testing

Current unit tests cover:

• request DTO serialization
• auth token request formatting
• authenticated request building
• automatic token fetch before API calls
• typed async responses for orders(), intakes(), and prints()
• typed order details response for orders()->getByUuid()
• local validation for orders()->create()

Current integration tests cover:

• auth()->getOAuthToken() wrong password handling against CDEK sandbox
• locations()->getRegions() against CDEK sandbox
• locations()->getPostalcodes() against CDEK sandbox
• orders()->create() against CDEK sandbox
• orders()->getByUuid() against CDEK sandbox

To run integration tests against sandbox, set:

If credentials are missing, integration tests are skipped automatically.

Structure

• WishboxCdek\CdekClient - config, auth, shared HTTP requests, PSR-18 integration
• WishboxCdek\Api\AuthApi - OAuth token
• WishboxCdek\Api\LocationApi - cities, regions, postal codes, coordinates
• WishboxCdek\Api\DeliveryPointApi - offices and pickup points
• WishboxCdek\Api\CalculatorApi - tariffs and cost calculation
• WishboxCdek\Api\OrderApi - create, update, get, delete orders
• WishboxCdek\Api\IntakeApi - intake dates and courier intake requests
• WishboxCdek\Api\PrintApi - order receipts, barcode print jobs, and barcode PDF downloads
• WishboxCdek\Api\WebhookApi - webhook subscriptions
• WishboxCdek\Request\... - request DTOs for all public API methods
• WishboxCdek\Response\... - response DTOs for typed API results
• WishboxCdek\Validation\... - local validators for request prechecks
• WishboxCdek\Enum\... - enums for documented CDEK constants

Notes

• Production base URL: https://api.cdek.ru
• Sandbox base URL: https://api.edu.cdek.ru
• If access_token is not passed explicitly, the client will request it automatically using account and password
• Laravel facade Http is not PSR-18 by itself
• Joomla HTTP package can be used as a PSR-18 client
• CreateOrderRequest uses immutable fluent builder-style API: make(...) + with...()
• OrderType::INTERNET_SHOP and OrderType::DELIVERY map to the documented order types ИМ and Доставка
• HttpException handles transport and HTTP-level errors, ApiResponseException handles async business errors from successful CDEK responses with invalid requests[*]
• OrderValidationException is thrown before the HTTP call when local order validation fails
• Async methods like orders()->create(), intakes()->create(), prints()->createOrders(), and prints()->createBarcodes() return typed async response objects with entity and requests
• orders()->getByUuid() returns a typed OrderDetails object with entity and extra
• prints()->downloadBarcodesPdf() returns the raw PDF body for /v2/print/barcodes/{uuid}.pdf
• Built-in local validation currently knows destination rules for tariffs 136, 137, 138, and 139