Типы разработчиков и роли
Кто может создать приложение SP-API, что спрашивает регистрация, какие роли может получить приложение и как работают ограниченные роли.
Как публикует Amazon
Каждое утверждение на этой странице пересказывает публичную документацию Amazon из раздела Источники.
Приватные и публичные приложения
Приватное приложение
- Кто пользуется: только собственная организация разработчика.
- Авторизация: самостоятельная.
- Публикация: не публикуется.
Публичное приложение
- Кто пользуется: любой продавец или вендор.
- Авторизация: продавцы или вендоры авторизуют его через OAuth (см. Selling partner).
- Публикация: обязано быть опубликовано в Selling Partner Appstore по Solution Provider Portal Agreement.
Регистрация
- Регистрацию проходит основной пользователь аккаунта (primary account user).
- Приватному приложению продавца нужен профессиональный аккаунт продавца (professional selling account) в Seller Central; индивидуальные аккаунты не подходят.
- Перед регистрацией разработчик:
- изучает Acceptable Use Policy, Data Protection Policy и Solution Provider Portal Agreement (см. Защита данных и хранение);
- определяет, какие роли запросить;
- если он публичный разработчик, выполняет требования Amazon к сайту.
- Заявка профиля разработчика ограничена 500 словами и должна быть оригинальным текстом, а не копией политик Amazon.
- На её вопросы о мерах безопасности отвечает команда, отвечающая за защиту данных. Документ Amazon Key Security Control Guidance объясняет, как эти меры соотносятся с требованиями Data Protection Policy.
- Каждый пользователь Solution Provider Portal также проходит проверку личности.
Роли
Роль — это набор операций. Приложение может вызывать только операции выданных ему ролей.
- Account Information Service Provider — сведения об аккаунте selling partner, включая сведения о бизнесе продавца.
- Amazon Fulfillment — операции фулфилмента Amazon и службы доставки, такие как Fulfillment by Amazon (FBA).
- Amazon Warehousing and Distribution — операции с отгрузками и запасами AWD.
- Brand Analytics — аналитические отчёты магазина Amazon, например метрики эффективности продавцов и вендоров.
- Buyer Communication — операции обмена сообщениями с покупателями Amazon.
- Buyer Solicitation — операции запроса отзывов у покупателей.
- Direct-to-Consumer Shipping (Restricted) — операции отправки заказов напрямую покупателям.
- Finance and Accounting — операции составления бухгалтерской и финансовой отчётности.
- Inventory and Order Tracking — операции анализа и управления запасами.
- Notifications in Seller Central — операции отправки адресных уведомлений продавцам в Seller Central.
- Payment Initiation Service Provider — операции, запускающие выплату на способ зачисления продавца.
- Pricing — операции определения цен и автоматизации ценообразования.
- Product Listing — операции создания и управления товарными листингами.
- Professional Services (Restricted) — операции дополнительных услуг, таких как сборка и установка.
- Selling Partner Insights — операции получения сведений об аккаунте и показателях selling partner.
- Tax Invoicing (Restricted) — операции формирования налоговых счетов по требованиям налогового законодательства.
- Tax Remittance (Restricted) — операции расчёта и перечисления налога с продаж.
Запрос роли
- Роли запрашиваются в профиле разработчика. Amazon рассматривает запрос и одобряет или отклоняет его; отклонённый запрос можно исправить и подать снова.
- Роль должна быть одобрена в профиле разработчика, прежде чем её можно добавить в приложение.
- После того как новая роль одобрена и добавлена в приложение, selling partner должен авторизовать приложение заново, чтобы новые access token несли эту роль.
Ограниченные роли и персональные данные
Персональные данные
Четыре роли с пометкой (Restricted) — Direct-to-Consumer Shipping, Professional Services, Tax Invoicing и Tax Remittance — дают доступ к персональным данным (PII) покупателей Amazon. Работа с PII влечёт дополнительные требования раздела 2 Data Protection Policy (см. Защита данных и хранение).
Операции, возвращающие ограниченные данные, вызываются с Restricted Data Token (RDT) из Tokens API вместо обычного access token. Например:
getOrders,getOrder,getOrderItemsиgetOrderBuyerInfoиз Orders API;getReportDocumentиз Reports API для ограниченных отчётов;- операции отправлений Merchant Fulfillment.
RDT выдаётся на ограниченные ресурсы, названные в запросе.