Інтеграція інтернет-магазину з СберМегаМаркет (API)

Інтеграція інтернет-магазину з СберМегаМаркет (API)

СберМегаМаркет (зараз частина екосистеми Сбера) — російський маркетплейс з FBS, FBO та DBS моделями. API побудовано на REST/JSON з автентифікацією через API-токен з особистого кабінету продавця.

Автентифікація

class SberMegaMarketClient
{
    public function request(string $method, string $path, array $data = []): array
    {
        return Http::withHeaders([
            'Authorization' => config('services.sbermm.token'),
            'Content-Type'  => 'application/json',
        ])->{strtolower($method)}(
            "https://api.sbermegamarket.ru/api/merchantmanagement/v2{$path}",
            $data
        )->json();
    }
}

Завантаження товарів через YML-фід

СберМегаМаркет приймає YML-фіди (Yandex Marketplace Language) — XML-стандарт:

<?xml version="1.0" encoding="utf-8"?>
<yml_catalog date="2025-03-28 10:00">
  <shop>
    <name>Мій магазин</name>
    <offers>
      <offer id="SKU-001" available="true">
        <name>iPhone 15 Pro 256GB</name>
        <price>89990</price>
        <currencyId>RUR</currencyId>
        <categoryId>101</categoryId>
        <picture>https://example.com/images/iphone.jpg</picture>
        <description>Новий, гарантія 1 рік</description>
        <vendor>Apple</vendor>
        <vendorCode>MTP63ZP/A</vendorCode>
        <count>5</count>
      </offer>
    </offers>
  </shop>
</yml_catalog>

REST API: ціни та залишки

public function updatePricesAndStocks(array $items): void
{
    $offers = array_map(fn($item) => [
        'offerId' => $item['sku'],
        'price'   => $item['price'],
        'stocks'  => [['warehouseId' => $this->warehouseId, 'count' => $item['stock']]],
    ], $items);

    $this->request('POST', '/offers/price-and-stocks', ['offers' => $offers]);
}

Замовлення та підтвердження відправки

public function getOrders(string $dateFrom): array
{
    return $this->request('POST', '/orders/get', [
        'dateFrom' => $dateFrom,
        'statuses' => ['AWAITING_PACKAGING'],
    ])['orders'] ?? [];
}

public function shipOrder(string $orderId, string $trackingNumber, string $carrier): void
{
    $this->request('POST', "/orders/{$orderId}/ship", [
        'trackingNumber' => $trackingNumber,
        'deliveryService' => $carrier,
    ]);
}

Строки

Інтеграція через YML-фід: 2–3 дні. Повна REST-інтеграція: 6–10 робочих днів.