Любой селлер на Amazon сталкивается с проблемой: ручное управление листингами, ценами и заказами на нескольких маркетплейсах — ад, особенно при обороте сотен SKU. Ошибки в цене (на 0.01$ дешевле — потеря продажи, дороже — бойкот), несинхронизированный инвентарь (продали на сайте, а на Amazon уже нет), опоздание с обработкой заказов (метрики падают). Мы автоматизируем это через Amazon Selling Partner API (SP-API) — современную замену устаревшему MWS. Наш опыт: интеграции для магазинов с каталогом до 50 000 товаров и 3+ регионами. Гарантируем стабильную работу без просадок по метрикам — наш стек тестирован тысячами продавцов. Средняя экономия от автоматизации — 150 000–300 000 ₽ в год за счёт сокращения ручного труда и снижения ошибок. Окупаемость интеграции составляет 2–3 месяца.
Аутентификация SP-API
SP-API использует AWS Signature Version 4 и OAuth2 (Login with Amazon). Для работы нужны IAM-роль и refresh token. Типичный код на Python:
import boto3
from sp_api.api import Products, Orders, Inventories
from sp_api.base import Marketplaces, Credentials
credentials = Credentials(
refresh_token = os.environ['SP_REFRESH_TOKEN'],
lwa_app_id = os.environ['LWA_APP_ID'],
lwa_client_secret = os.environ['LWA_CLIENT_SECRET'],
aws_access_key = os.environ['AWS_ACCESS_KEY'],
aws_secret_key = os.environ['AWS_SECRET_KEY'],
role_arn = os.environ['SP_API_ROLE_ARN'],
)
Создание/обновление листинга
from sp_api.api import Listings
listings = Listings(credentials=credentials, marketplace=Marketplaces.DE)
def upsert_listing(product: dict) -> None:
listing_body = {
'productType': product['amazon_product_type'],
'attributes': {
'item_name': [{'value': product['name'], 'language_tag': 'de_DE'}],
'brand': [{'value': product['brand']}],
'description': [{'value': product['description'], 'language_tag': 'de_DE'}],
'list_price': [{
'currency': 'EUR',
'value': product['price'],
}],
'main_product_image_locator': [{'media_location': product['main_image']}],
},
}
listings.put_listings_item(
sellerId=SELLER_ID,
sku=product['sku'],
marketplaceIds=[Marketplaces.DE.marketplace_id],
body=listing_body,
)
Как SP-API решает проблему синхронизации цен и остатков?
Amazon не позволяет напрямую загружать цены и остатки из вашего склада — всё должно идти через API. Мы используем два основных инструмента:
from sp_api.api import Pricing, FbaInventory
pricing = Pricing(credentials=credentials, marketplace=Marketplaces.US)
pricing.get_competitive_pricing(Asins=[asin])
fba = FbaInventory(credentials=credentials, marketplace=Marketplaces.US)
summary = fba.get_inventory_summaries(granularityType='Marketplace', granularityId=Marketplaces.US.marketplace_id)
Это позволяет обновлять цены в зависимости от конкурентов и своевременно сообщать о недостатке товара на FBA.
Почему SP-API лучше MWS?
| Критерий | MWS | SP-API |
|---|---|---|
| Протокол | SOAP/XML | REST/JSON |
| Аутентификация | Простой токен | AWS SigV4 + LWA OAuth2 |
| Уведомления | Polling | Push через SQS |
| Регионы | Один endpoint отдельно | Единая авторизация, разные endpoints |
SP-API даёт в 3 раза меньше ошибок тайм-аута и поддерживает больше конечных точек (например, A+ Content, FBA Inbound).
Отказоустойчивость и уведомления
Используем ретраи с exponential backoff, пул токенов и мониторинг квот SP-API. Если Amazon возвращает TooManyRequests, очередь запросов не теряется — данные сохраняются в Redis и постепенно отправляются. Мы также настраиваем SQS для уведомлений о новых заказах:
from sp_api.api import Notifications
notif = Notifications(credentials=credentials)
notif.create_subscription(
notificationType='ORDER_CHANGE',
body={
'payloadVersion': '1.0',
'destinationId': SQS_QUEUE_ARN,
}
)
Согласно документации SP-API (https://developer-docs.amazon.com/sp-api/docs), push-уведомления доставляются менее чем за 5 секунд.
Получение заказов
from sp_api.api import Orders as SpOrders
from datetime import datetime, timedelta
orders_api = SpOrders(credentials=credentials, marketplace=Marketplaces.DE)
orders = orders_api.get_orders(
MarketplaceIds=[Marketplaces.DE.marketplace_id],
CreatedAfter=(datetime.utcnow() - timedelta(hours=24)).isoformat(),
OrderStatuses=['Pending', 'Unshipped'],
)
Специфика регионов
Amazon имеет региональные endpoint'ы: sellingpartnerapi-na.amazon.com (US/CA/MX), sellingpartnerapi-eu.amazon.com (EU/UK/IN), sellingpartnerapi-fe.amazon.com (JP/AU). У каждого свои marketplace_id. В проекте мы автоматически определяем регион по ASIN или указываем вручную.
Процесс интеграции и сроки
| Этап | Длительность, дни | Детали |
|---|---|---|
| Аналитика | 2–3 | Изучаем ассортимент, регионы, текущие болевые точки |
| Проектирование | 3–5 | Выбираем архитектуру (монолит или микросервисы), решаем вопросы IAM |
| Разработка | 10–15 | Кодим, покрываем unit- и интеграционными тестами с песочницей Amazon |
| Тестирование | 3–5 | На staging с реальными данными (без влияния на продакшен) |
| Деплой | 2–3 | Выкатка в production, мониторинг 48 часов |
Ориентировочный срок: 20–30 рабочих дней (в зависимости от количества регионов и сложности логистики). Стоимость рассчитывается индивидуально — мы не называем цену без знакомства с проектом.
Как настроить аутентификацию SP-API за 5 шагов?
- Зарегистрируйте аккаунт разработчика на Amazon Developer Portal.
- Создайте IAM-пользователя с политикой
AmazonSellingPartnerAPIFullAccess. - Зарегистрируйте SP-API приложение и получите LWA-клиентские ключи.
- Выполните OAuth2-авторизацию для получения refresh token.
- Настройте роли IAM и сохраните credentials в защищённом хранилище (AWS Secrets Manager).
Типичные ошибки при самостоятельной интеграции
- Неверная IAM-роль — приложение не получает доступ к данным.
- Отсутствие ретраев при лимитах квот — теряются заказы.
- Игнорирование разницы в налоговых правилах регионов (например, VAT в EU).
- Неправильный парсинг ответов — вылетает при изменении схемы Amazon.
Мы закладываем обработку всех этих кейсов и даём гарантию на код.
Как мы ускоряем выход на рынок?
Благодаря готовым шаблонам и библиотекам, мы сокращаем типовую интеграцию на 40%. Например, настройка листингов для нового региона занимает 1 день вместо 3. Это подтверждает практика: один из клиентов с 20 000 SKU вышел на Amazon UK за 2 недели.
Свяжитесь с нами для предварительной оценки вашего проекта — подготовим прототип за 2 дня. Закажите пилотную интеграцию на одном регионе: убедитесь в качестве и окупаемости.