Интеграция интернет-магазина с СберМегаМаркет (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 рабочих дней.