E-commerce integration with SberMegaMarket API

Online Store Integration with SberMegaMarket (API)

SberMegaMarket (now part of the Sber ecosystem) is a Russian marketplace with FBS, FBO, and DBS models. The API is built on REST/JSON with authentication via API token from the seller's account.

Authentication

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();
    }
}

Product Upload via YML Feed

SberMegaMarket accepts YML feeds (Yandex Marketplace Language) — an XML standard:

<?xml version="1.0" encoding="utf-8"?>
<yml_catalog date="2025-03-28 10:00">
  <shop>
    <name>My Store</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>New, 1-year warranty</description>
        <vendor>Apple</vendor>
        <vendorCode>MTP63ZP/A</vendorCode>
        <count>5</count>
      </offer>
    </offers>
  </shop>
</yml_catalog>

REST API: Prices and Stock

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]);
}

Orders and Shipment Confirmation

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,
    ]);
}

Timeline

YML feed integration: 2–3 days. Full REST integration: 6–10 business days.