phoenix-lib/marketplace-php-partner

PHP library of Partners Marketplace API.

3.2.1 2023-06-25 19:21 UTC

This package is auto-updated.

Last update: 2024-12-07 11:35:13 UTC


README

Магазинам, работающим с Яндекс.Маркетом по моделям 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.