vasyag07 / ozon-seller
Ozon Seller Api for transhore sales
Requires
- php: >=7.1
- ext-json: *
- http-interop/http-factory-guzzle: ^1.0
- psr/http-client: ^1.0
Requires (Dev)
- ext-curl: *
- dg/bypass-finals: ^1.2
- guzzlehttp/psr7: ^1.6
- nyholm/psr7: ^1.3
- php-http/guzzle6-adapter: ^2.0
- phpunit/phpunit: ^7.4||^8.0||^9.0
- symfony/http-client: ^4.1||^5.1
- vlucas/phpdotenv: ^5.3
Suggests
- nyholm/psr7: For use with Symfony
- php-http/guzzle6-adapter: For use not with Symfony
- symfony/http-client: For use with Symfony
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-18 02:44:53 UTC
README
Документация Ozon Api
https://docs.ozon.ru/api/seller
Установка
composer require vasyag07/ozon-seller
Для взаимодействия библиотеки с Ozon-Api нужно дополнительно установить реализации PSR-18: HTTP Client и PSR-17: HTTP Factories.
Использование с Symfony
https://symfony.com/doc/current/components/http_client.html#psr-18-and-psr-17
composer require symfony/http-client composer require nyholm/psr7
use Gam6itko\OzonSeller\Service\V1\ProductService; use Symfony\Component\HttpClient\Psr18Client; $config = [$_SERVER['CLIENT_ID'], $_SERVER['API_KEY'], $_SERVER['API_URL']]; $client = new Psr18Client(); $svc = new ProductService($config, $client); //do stuff
Использование без Symfony
composer require php-http/guzzle6-adapter
use Gam6itko\OzonSeller\Service\V1\CategoriesService; use GuzzleHttp\Client as GuzzleClient; use Http\Adapter\Guzzle6\Client as GuzzleAdapter; use Http\Factory\Guzzle\RequestFactory; use Http\Factory\Guzzle\StreamFactory; $config = [ 'clientId' => '<ozon seller client-id>', 'apiKey' => '<ozon seller api-key>', 'host' => 'http://cb-api.ozonru.me/' ]; $client = new GuzzleAdapter(new GuzzleClient()); $requestFactory = new RequestFactory(); $streamFactory = new StreamFactory(); $svc = new CategoriesService($config, $client, $requestFactory, $streamFactory); //do stuff
Реализованные методы
Чтобы узнать какой класс и метод реализуют запрос на нужный URL воспользуйтесь скриптом bin/is_realized.php
php bin/is_realized.php | grep /v2/posting/fbs/get
output
/v2/posting/fbs/get: Gam6itko\OzonSeller\Service\V2\Posting\FbsService::get /v2/posting/fbs/get-by-barcode: NotRealized
Автор не всегда успевает добавлять реализации новых методов. Если нужного вам метода нет в библиотеке, то не стесняйтесь открыть issue или PR.
Примеры использования
Больше примеров смотрите в папке tests/Service/
Categories
use Gam6itko\OzonSeller\Service\V1\CategoriesService; use GuzzleHttp\Client as GuzzleClient; use Http\Adapter\Guzzle6\Client as GuzzleAdapter; $config = [ 'clientId' => '<ozon seller client-id>', 'apiKey' => '<ozon seller api-key>', 'host' => 'http://cb-api.ozonru.me/' //sandbox ]; $adapter = new GuzzleAdapter(new GuzzleClient()); $svc = new CategoriesService($config, $adapter); //Server Response example: https://cb-api.ozonru.me/apiref/en/#t-title_categories $categoryTree = $svc->tree(); //Server Response example: https://cb-api.ozonru.me/apiref/en/#t-title_get_categories_attributes $attributes = $svc->attributes(17038826);
Posting Crossborder
get info
/v2/posting/crossborder/get
use Gam6itko\OzonSeller\Service\V2\Posting\CrossborderService; use GuzzleHttp\Client as GuzzleClient; use Http\Adapter\Guzzle6\Client as GuzzleAdapter; $config = [ 'clientId' => '<ozon seller client-id>', 'apiKey' => '<ozon seller api-key>', 'host' => 'http://cb-api.ozonru.me/' ]; $adapter = new GuzzleAdapter(new GuzzleClient()); $svc = new CrossborderService($config, $adapter); $postingNumber = '39268230-0002-3'; $orderArr = $svc->get($postingNumber); echo json_encode($orderArr);
{
"result": [
{
"address": {
"address_tail": "г. Москва, ул. Центральная, 1",
"addressee": "Петров Иван Владимирович",
"city": "Москва",
"comment": "",
"country": "Россия",
"district": "",
"phone": "+7 495 123-45-67",
"region": "Москва",
"zip_code": "101000"
},
"auto_cancel_date": "2019-11-18T11:30:11.571Z",
"cancel_reason_id": 76,
"created_at": "2019-11-18T11:30:11.571Z",
"customer_email": "petrov@email.com",
"customer_id": 60006,
"in_process_at": "2019-11-18T11:30:11.571Z",
"order_id": 77712345,
"order_nr": "1111444",
"posting_number": "39268230-0002-3",
"products": [
{
"name": "Фитнес-браслет",
"offer_id": "DEP-1234",
"price": "1900.00",
"quantity": 1,
"sku": 100056
}
],
"shipping_provider_id": 0,
"status": "awaiting_approve",
"tracking_number": ""
}
]
}
Список отправлений FBS V4
Для POST /v4/posting/fbs/list используйте Service\V4\Posting\FbsService::list(array $requestData): array.
Метод получает одну страницу и возвращает весь ответ с полями postings, cursor и has_next.
use Gam6itko\OzonSeller\Service\V4\Posting\FbsService; // $config и PSR-18 $client создаются как в примерах выше. $svc = new FbsService($config, $client); $request = [ 'filter' => [ 'since' => '2026-10-20T00:00:00Z', 'to' => '2026-10-21T00:00:00Z', 'statuses' => ['awaiting_packaging', 'awaiting_deliver'], // 'warehouse_ids' => [123456789], ], 'limit' => 100, 'cursor' => '', 'sort_dir' => 'ASC', 'with' => ['analytics_data' => true, 'barcodes' => true], ]; $page = $svc->list($request); $postings = $page['postings']; // Следующая страница — отдельный вызов с тем же фильтром. if ($page['has_next']) { if ('' === $page['cursor'] || $request['cursor'] === $page['cursor']) { throw new \RuntimeException('Ozon вернул пустой или повторяющийся курсор'); } $request['cursor'] = $page['cursor']; $nextPage = $svc->list($request); }
При переходе с V3 замените dir на sort_dir, а offset — на cursor.
Старые параметры dir/offset не преобразуются и не отправляются. Значения sort_dir
asc/desc (в том числе из SortDirection) преобразуются в ASC/DESC.
Поля filter и целочисленный limit от 1 до 100 обязательны; при неверных значениях
выбрасывается LogicException до HTTP-запроса. Период since–to по документации — не больше года.
Новые фильтры включают statuses, warehouse_ids, delivery_method_ids, provider_ids;
вложенные поля filter и with передаются без фильтрации по правилам V3.
Также поддерживается верхнеуровневый translit. Обход страниц выполняет приложение;
следует ограничивать число запросов и проверять продвижение курсора.
Контракт Service\V3\Posting\FbsService::list() сохранён, автоматического перехода на V4 нет.
Список складов V2
Вместо Service\V1\WarehouseService::list() используйте Service\V2\WarehouseService::list(array $requestData = []): array.
Новый метод возвращает страницу ['warehouses' => [...], 'cursor' => '...', 'has_next' => true],
а не прежний массив result. По умолчанию отправляются limit = 10 и cursor = ''.
Можно передать warehouse_ids (не более 200 идентификаторов). limit — целое число от 1 до 200.
Данные сверх ограничения не обрезаются: SDK выбрасывает LogicException.
use Gam6itko\OzonSeller\Service\V2\WarehouseService; $svc = new WarehouseService($config, $client); $request = ['limit' => 100, 'cursor' => '']; $warehouses = []; // Приложение управляет обходом страниц; ограничение защищает от бесконечного цикла. for ($pageNumber = 0; $pageNumber < 1000; ++$pageNumber) { $page = $svc->list($request); $warehouses = array_merge($warehouses, $page['warehouses']); if (!$page['has_next']) { break; } if ('' === $page['cursor'] || $request['cursor'] === $page['cursor']) { throw new \RuntimeException('Ozon вернул пустой или повторяющийся курсор'); } $request['cursor'] = $page['cursor']; } if ($page['has_next']) { throw new \RuntimeException('Превышено ограничение количества страниц складов'); }
Старый метод V1 сохранён с пометкой @deprecated и не перенаправляется на V2.
Асинхронные этикетки FBS
Синхронный Service\V2\Posting\FbsService::packageLabel() устаревает: по сохранённой
документации его отключение назначено на 2 ноября 2026 года. Вместо одного запроса PDF
нужно создать задания, затем получить состояние каждого задания и отдельно скачать готовый файл.
use Gam6itko\OzonSeller\Service\V3\Posting\FbsService as FbsServiceV3; use Gam6itko\OzonSeller\Service\V2\Posting\FbsService as FbsServiceV2; $creator = new FbsServiceV3($config, $client); $reader = new FbsServiceV2($config, $client); $response = $creator->packageLabelCreate(['example-posting-1', 'example-posting-2']); foreach ($response['tasks'] as $task) { // Сохраните task_id и task_type всех заданий, включая big_label и small_label. $state = $reader->packageLabelGet($task['task_id']); // Это JSON: status — объект, error — объект, file_url — ссылка на файл. // Ошибки отдельных отправлений доступны в status.unprinted_postings. if (!empty($state['file_url'])) { $fileUrl = $state['file_url']; // Скачайте файл отдельным HTTP-запросом без Api-Key и Client-Id. } // Если файл ещё не готов, повторите получение состояния позже с тем же task_id. // Обработайте error и задайте предел времени/числа попыток в приложении. }
packageLabelCreate(array $postingNumbers): array отправляет posting_numbers (новое имя во
множественном числе), принимает от 1 до 1000 непустых строк и возвращает весь ответ с tasks.
packageLabelGet(int $taskId): array возвращает весь ответ с status, error, file_url.
Оба метода выполняют по одному запросу, без ожидания готовности, выбора первого задания или скачивания PDF.
Ошибки задания при HTTP 200 сохраняются в ответе; HTTP-ошибки обрабатываются общим транспортом SDK.
Документация рекомендует создавать задания через 45–60 секунд после сборки заказа; SDK не добавляет задержку.
Старый packageLabel() сохранён с прежним возвращаемым типом string и пометкой @deprecated.
Products
import
/v1/product/import
use Gam6itko\OzonSeller\Service\V1\ProductService; use GuzzleHttp\Client as GuzzleClient; use Http\Adapter\Guzzle6\Client as GuzzleAdapter; $config = [ 'clientId' => '<ozon seller client-id>', 'apiKey' => '<ozon seller api-key>', // use prod host by default ]; $adapter = new GuzzleAdapter(new GuzzleClient()); $svcProduct = new ProductService($config, $adapter); $product = [ 'barcode' => '8801643566784', 'description' => 'Red Samsung Galaxy S9 with 512GB', 'category_id' => 17030819, 'name' => 'Samsung Galaxy S9', 'offer_id' => 'REDSGS9-512', 'price' => '79990', 'old_price' => '89990', 'premium_price' => '75555', 'vat' => '0', 'vendor' => 'Samsung', 'vendor_code' => 'SM-G960UZPAXAA', 'height' => 77, 'depth' => 11, 'width' => 120, 'dimension_unit' => 'mm', 'weight' => 120, 'weight_unit' => 'g', 'images' => [ [ 'file_name' => 'https://ozon-st.cdn.ngenix.net/multimedia/c1200/1022555115.jpg', 'default' => true, ], [ 'file_name' => 'https://ozon-st.cdn.ngenix.net/multimedia/c1200/1022555110.jpg', 'default' => false, ], [ 'file_name' => 'https://ozon-st.cdn.ngenix.net/multimedia/c1200/1022555111.jpg', 'default' => false, ], ], 'attributes' => [ [ 'id' => 8229, 'value' => '4747', ], [ 'id' => 9048, 'value' => 'Samsung Galaxy S9', ], [ 'id' => 4742, 'value' => '512 ГБ', ], [ 'id' => 4413, 'collection' => ['1', '2', '13'], ], [ 'id' => 4018, 'complex_collection' => [ [ 'collection' => [ [ 'id' => 4068, 'value' => 'Additional video', ], [ 'id' => 4074, 'value' => '5_-NKRVn7IQ', ], ], ], [ 'collection' => [ [ 'id' => 4068, 'value' => 'Another one video', ], [ 'id' => 4074, 'value' => '5_-NKRVn7IQ', ], ], ], ], ], ], ]; $svcProduct->import($product); // or $svcProduct->import([$product, $product1, $product2, ...]); // or $res = $svcProduct->import(['items' => [$product, $product1, $product2, ...] ]); echo $res['task_id']; // save it for checking by `importInfo`