API для фулфилмента: подключение WMS
Обновлено: 2026-10-12
Протокол Nitroseller Fulfillment Protocol 1.3 нужен WMS фулфилмента. Нитроселлер сам забирает каналы, товары, остатки и документы и ведёт по ним складской учёт для маркетплейсов. Отдельного кабинета склада в Нитроселлере нет.
Не путайте с API продавца
Ключи и эндпоинты /api/v1 описаны в обзоре API продавца. Здесь — то, что должна отдавать ваша WMS.
Как подключается клиент
Фулфилмент выдаёт клиенту ключ вида ns_{код}_{40 символов}. Код в ключе должен совпасть с fulfillment.code из GET /meta. Селлер вводит только ключ. Адрес WMS Нитроселлер берёт из справочника фулфилментов по этому коду.
Нитроселлер ходит в вашу WMS с заголовком Authorization: Bearer. Храните у себя хэш ключа. Карточка товара приходит в строке заявки, отдельно запрашивать её не нужно.
Общие правила
Префикс — /api/nitroseller/v1. Списки отвечают {data, next_cursor}. Инкремент — query changed_since в ISO-8601. Удалённое приходит с deleted_at, а не пропадает из ответа. Ошибка — {error: {code, message}}. На 429 отдайте Retry-After: клиент подождёт и повторит. Ориентир по лимиту — 120 запросов в минуту.
GET /meta
Этот метод Нитроселлер вызывает до всего остального.
{
"protocol": "nitroseller-fulfillment",
"version": "1.3",
"wms": { "name": "Example WMS", "version": "2026.10" },
"fulfillment": { "code": "example", "title": "Пример" },
"client": { "id": "218", "title": "ИП Иванова" },
"capabilities": ["channels", "items", "stocks", "documents", "warehouses", "boxes", "requests"]
}
fulfillment.title становится названием фулфилмента у селлера. warehouses желателен: без него некуда положить остаток. boxes и requests необязательны. Без requests селлер не сможет отправить заявку на приёмку или отгрузку.
Эндпоинты
| Метод и путь | Зачем |
|---|---|
GET /channels |
Каналы продаж, в том числе без ключа маркетплейса |
GET /items |
Товары и штрихкоды |
GET /warehouses |
Склады: основной и дополнительные |
GET /stocks |
Остаток по складу: всего, резерв, доступно |
GET /documents |
Приёмки и отгрузки |
GET /documents/{type}/{id}/boxes |
Раскладка коробок и КИЗ |
POST /requests |
Заявка клиента из Нитроселлера |
GET /requests |
Статусы заявок |
Вебхуков нет. Нитроселлер сам опрашивает WMS. Карточка товара приходит в строке заявки. Метод POST /api/fulfillment/v1/products остаётся для протокола 1.2.