Обновление для мерчантов

Ссылка на метод API

POST /marketplace/{qwqerId}/merchant

Описание

При регистрации маркетплейса в нашей системе была введена роль Agent.

Эта роль предназначена для маркетплейсов с множеством продавцов, которые отправляют товары на склады независимо друг от друга.

Таким маркетплейсам теперь обязательно регистрировать под собой мерчантов (продавцов) и выполнять вызовы API от их имени (например, при создании Receipt). Использование простого items.sellerId больше не рекомендуется.

Каждому мерчанту (аналогично маркетплейсу) система присваивает уникальный идентификатор qwqerId. Он используется во всех API-запросах для однозначной идентификации мерчанта.

🔑 Важно!

На время тестирования ещё разрешено вызывать методы API, указывая qwqerId агента вместо мерчанта.

Однако при создании Receipt и Sale обязательно используйте qwqerId именно мерчанта (тот, что был присвоен при его регистрации).

Это необходимо для корректного сопоставления receipts, items, invoices с конкретным мерчантом, а также для отправки инвойсов на его email.

Flow со стороны маркетплейса

1. При создании Receipt от имени мерчанта проверьте, зарегистрирован ли он (имеет ли qwqerId).
2. Если нет — создайте мерчанта с полной требуемой информацией.
3. Сохраните полученный qwqerId в вашей базе данных.
4. Продолжите процесс создания Receipt.

Изменения и новые требования

• Поле items.sellerId — @deprecated. Указывать его больше не требуется. Вместо него используется полноценная сущность Merchant с qwqerId.

• Для выставления счетов каждый item теперь должен содержать обязательный набор Specs.

• В callback URL Receipt и callback URL Sale добавлен параметр qwqerId, чтобы маркетплейс мог идентифицировать мерчанта и со своей стороны.

• Метод get storage list by seller external id, связанный с items.sellerId, также @deprecated и в будущем будет заменён на аналог без параметра seller/{sellerId}.