Родной Фулфилмент · Интеграция по API

Интеграция с вашей учётной системой

Если у вас 1С, МойСклад или собственная система, вам не нужно заходить в кабинет руками: остатки, заявки и статусы забираются программно. Эта страница — для вашего разработчика, чтобы он оценил объём работы до того, как вы подпишете договор.

Коротко о том, с чем работать

Доступ

База: https://app.mpfit.ru/api
Формат: REST, OpenAPI 3.0.3
Авторизация: Bearer-токен
Лимит: 120 запросов в минуту, остаток — в заголовках X-RateLimit-*
Пагинация: курсорная, по last_id

Ключ

Вы получаете токен типа «Селлер» — он видит только вашу компанию и ничего чужого. Сгенерировать можно самостоятельно: профиль своей компании → вкладка «API интеграция» → «Сгенерировать ключ». Просить нас не нужно, и отозвать ключ вы тоже можете сами.

Что реально можно забрать

POST /v1/products/listкаталог товаров с баркодами и категориями

POST /v1/products/stocksостатки по складам: свободно, забронировано и сколько можно собрать

POST /v1/arrivals/createсоздать заявку на приёмку из вашей системы

POST /v1/arrivals/listсписок приёмок и их статусы

POST /v1/orders/listзаказы на отгрузку с составом, габаритами и услугами

GET /v1/orders/{id}один заказ целиком, включая статус на стороне площадки

POST /v1/analytics/storage/listпосуточная аналитика хранения — можно считать биллинг у себя

POST /v1/cim-codesкоды маркировки «Честного знака»

В остатках отдельно приходят три числа: free — свободно, booked — забронировано под заказы, can_collect — сколько единиц можно собрать прямо сейчас (для наборов это считается из компонентов). Именно третье число обычно и нужно, чтобы не продать то, чего фактически не соберётся.

Статусы заказа

NEWPRODUCTS_RESERVEDEQUIPMENTREADY_TO_SHIPSHIPPEDDELIVERYCOMPLETEREJECTCANCELARCHIVE

Вместе со статусом приходит и «сырой» статус площадки с русским названием, а для Wildberries — ещё и статус поставщика, для Ozon и Яндекс Маркета — подстатус. То есть вы видите не только нашу картину, но и то, что происходит на стороне маркетплейса.

Вебхуки: не опрашивать, а получать

Вместо опроса раз в минуту можно подписаться на события — система сама постучится к вам: arrival.created, arrival.status_changed, shipment.created, shipment.status_changed и ping для проверки связи.

Подпись — HMAC-SHA256 в заголовке X-MPFIT-Signature, окно валидности 5 минут. Если ваш сервер не ответил 2xx за 5 секунд, будет 7 повторов с нарастающим интервалом: через минуту, 5 минут, полчаса, 2 часа, 6 часов и 12 часов. Требования к адресу жёсткие: только https на 443 порту, публичный адрес, валидный сертификат, без редиректов и без логина с паролем в URL.

Честная оговорка про ФБС

Заявки на приёмку и отгрузки ФБО прилетают мгновенно, а заказы ФБС приходят пачкой раз в полчаса — с тем статусом, который был на момент отправки. Промежуточные переходы в этой пачке теряются. Если ваша логика завязана на каждое изменение статуса ФБС-заказа, закладывайте опрос /v1/orders/list, а не только вебхуки.

Спецификация открыта без авторизации, ваш разработчик может изучить её до всякого договора: app.mpfit.ru/openapi.yaml. Подключение вебхуков делается через поддержку системы — это займёт день, а не неделю.

Обсудить интеграцию→ Что видно в кабинете без всякого API