gwinn/yandex-market

PHP library for Yandex.Market API

1.1.4 2024-10-24 11:38 UTC

README

Партнерский API Беру предназначен для партнеров, подключенных к маркетплейсу по моделям «Витрина + фулфилмент» и «Витрина + доставка».

  • Для модели «Витрина + фулфилмент» API позволяет управлять ассортиментом и ценами на товары.
  • Для модели «Витрина + доставка» API позволяет управлять ассортиментом, ценами на товары и заказами, а также передавать Беру информацию об остатках на складе.

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

Требования

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

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

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

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

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

Установка

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

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

    {
        "require": {
            "yandex-market/beru-php-partner": "*"
        }
    }
  2. Включите автозагрузчик Composer в код проекта:

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

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

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

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

// Создаем экземпляр клиента с методами управления скрытыми товарами
$hiddenOffersClient = new \Yandex\Beru\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 для моделей подключения «Витрина + фулфилмент» и «Витрина + доставка».