Download the PHP package gam6itko/ozon-seller without Composer
On this page you can find all versions of the php package gam6itko/ozon-seller. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download gam6itko/ozon-seller
More information about gam6itko/ozon-seller
Files in gam6itko/ozon-seller
Package ozon-seller
Short Description Ozon Seller Api for transhore sales
License MIT
Informations about the package ozon-seller
Ozon-seller API client
Документация Ozon Api
https://docs.ozon.ru/api/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
Использование без Symfony
local dev
Или в docker — на минимальной и на актуальной поддерживаемой версии PHP:
Реализованные методы
Библиотека покрывает 457 из 463 путей текущей спецификации Ozon Seller API.
Чтобы узнать какой класс и метод реализуют запрос на нужный URL, воспользуйтесь скриптом bin/is_realized.php:
output
Скрипт сверяет спеку с библиотекой. Спека читается из файла: по умолчанию var/swagger.json (в
.gitignore), можно передать путь аргументом. Опция --download пробует скачать спеку, но обычно
не срабатывает — docs.ozon.ru закрыт JS-антиботом, поэтому swagger.json нужно сохранить из
браузера. Неудачная загрузка не портит уже сохранённый файл.
Сознательно не реализованы:
/v1/review/{list,info,count,change-status,comment/delete}— Ozon помечает ихdeprecated, вместо них реализованы/v2/review/*;/v1/receipts/upload— принимаетmultipart/form-data, а транспорт библиотеки отправляет только JSON.
Если нужного вам метода нет в библиотеке — не стесняйтесь открыть issue или PR.
Сервисы
Класс сервиса соответствует версии URL: /v3/product/import → Service\V3\ProductService::import.
Одна и та же сущность живёт в нескольких версиях одновременно — берите ту, которая указана в
документации Ozon для нужного метода.
| Что | Классы |
|---|---|
| Товары | V1\ProductService, V2\ProductService, V3\ProductService, V4\ProductService, V5\ProductService |
| Категории и характеристики | V1\DescriptionCategoryService |
| Отправления FBS/FBO/FBP | V{1..6}\Posting\FbsService, V{1,2,3}\Posting\FboService, V1\Posting\FbpService, V{1,2}\Posting\DigitalService |
| Перевозки и грузоместа | V{1,2}\CarriageService, V{1,2}\CargoesService, V1\AssemblyService |
| Поставки FBO | V{1,2,3}\SupplyOrderService, V{1,2}\DraftService, V1\FbpService, V1\SupplierService |
| Склады и доставка | V{1,2}\WarehouseService, V{1,2}\DeliveryMethodService, V{1,2}\DeliveryService, V{1,2}\PolygonService, V{1,2}\ClusterService, V1\PassService |
| Заказы и отмены | V{1,2}\OrderService, V1\CancelReasonService, V2\ConditionalCancellationService |
| Возвраты | V1\ReturnService, V1\ReturnsService, V2\ReturnsService, V3\ReturnService, V1\RemovalService |
| Финансы и отчёты | V{1,2,3}\FinanceService, V{1,2}\ReportService, V1\ReceiptsService, V{1,2}\InvoiceService |
| Акции | V{1,2}\ActionsService, V1\SellerActionsService, V1\DiscountsTaskService, V1\PricingStrategyService |
| Отзывы, вопросы, чаты | V{1,2}\ReviewService, V1\QuestionService, V{1,2,3}\ChatService |
| Аналитика и рейтинги | V{1,2}\AnalyticsService, V1\RatingService, V1\SearchQueriesService |
| Аккаунт | V1\SellerService, V1\BarcodeService, V1\NotificationService, V1\BrandService |
Примеры использования
Больше примеров смотрите в папке tests/Service/
Категории и характеристики
/v1/description-category/tree, /v1/description-category/attribute
Старые V1\CategoriesService и V{2,3}\CategoryService работают со снятыми Ozon
/v1/category/* и помечены @deprecated — в новом коде используйте DescriptionCategoryService.
Отправления FBS
/v3/posting/fbs/list, /v3/posting/fbs/get
Схему crossborder Ozon закрыл: V2\Posting\CrossborderService оставлен для обратной
совместимости, соответствующих путей в спеке больше нет.
Товары
import
/v3/product/import
Список полей, которые принимает import, задаётся в src/config/product_validator_v3.php —
всё лишнее отбрасывается до отправки запроса.