PHP-библиотека партнерского API Яндекс.Маркета для моделей FBY и FBS

Магазинам, работающим с Яндекс.Маркетом по моделям FBY (Fulfillment by Yandex, продажи с фулфилментом Яндекса) и FBS (Fulfillment by Seller, продажи с фулфилментом магазина), Маркет предоставляет партнерский API.

• Для модели FBY API позволяет управлять ассортиментом и ценами на товары.
• Для модели FBS API позволяет управлять ассортиментом, ценами на товары и заказами, а также передавать Маркету информацию об остатках на складе.

Библиотека написана на языке PHP и содержит методы для работы с партнерским API.

• Требования
• Лицензия и условия использования
• Установка
• Пример использования

Требования

• PHP 5.6 или выше.
• Зарегистрированный магазин на маркетплейсе Яндекс.Маркета.
• Зарегистрированное приложение с авторизационным токеном.

Подробнее см. раздел С чего начать в Wiki.

Лицензия и условия использования

Библиотека распространяется по лицензии MIT.

Использование партнерского API регулируется пользовательским соглашением.

Установка

Библиотека устанавливается с помощью пакетного менеджера Composer.

1. Добавьте библиотеку в файл composer.json вашего проекта:

   {
       "require": {
           "yandex-market/marketplace-php-partner": "*"
       }
   }

2. Включите автозагрузчик Composer в код проекта:

   require __DIR__ . '/vendor/autoload.php';

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

Выведем на экран список всех скрытых товаров магазина:

// Указываем авторизационные данные
$clientId = '9876543210fedcbaabcdef0123456789';
$token = '01234567-89ab-cdef-fedc-ba9876543210';

// Создаем экземпляр клиента с методами управления скрытыми товарами
$hiddenOffersClient = new \Yandex\Marketplace\Partner\Clients\HiddenOffersClient($clientId, $token);

// Получаем объект со скрытыми товарами
$hiddenOffersObject = $hiddenOffersClient->getInfo($campaignId);
$result = $hiddenOffersObject->getResult();
// Получаем итератор по скрытым товарам
$hiddenOffers = $result->getHiddenOffers();
// Печатаем информацию о скрытиях
foreach ($hiddenOffers as $hiddenOffer) {
    echo "Comment: " . $hiddenOffer->getComment();
    echo "MarketSku: " . $hiddenOffer->getMarkerSku();
    echo "TtlInHours: " . $hiddenOffer->getTtlInHours();
}

Подробнее см. Wiki и документацию партнерского API для моделей работы FBY и FBS.