Оформление отгрузки FBS с использованием API

1. После получения заказа с маркетплейса оформить заказ на сайте StripMag.ru (см. инструкции по оформлению заказа Wildberries, Яндекс.Маркет, Озон)
2. До 14:00 текущего дня оформить заявку на отгрузку FBS заказов на сайте StripMag.ru или с помощью API (инструкция ниже).

Оформление отгрузки FBS с использованием API

Для работы с API необходим API-ключ. Чтобы получить API-ключ (ApiKey) в личном кабинете на сайте StripMag.ru перейдите в раздел Выгрузки.

• Запросы отправляются методом POST
• Рабочая среда: https://api.p5s.ru/fbs.php

Параметры запроса:

• apiKey - все запросы должны содержать ApiKey. Этот параметр идентифицирует Вас у нас в системе и по нему мы понимаем от кого пришел запрос.
• testMode - не обязательный параметр. Может принимать значения 0 и 1. Если параметр имеет значение 1, т.е. тестовый режим включен, то запросы принимаются, данные проверяются и выдается ответ о валидности данных, но сам заказ не размещается. По умолчанию этот параметр равен 0.
• action - обязательный параметр, может принимать значения:
  • add - добавление заказа/заказов в отгрузку FBS
  • send - отправка отгрузки FBS на сборку (отправить можно только одну отгрузку для одного маркетплейса в день)
  • info - получение информации об отгрузке FBS
• orders - номер/номера заказов, которые необходимо добавить в отгрузку FBS, обязательный параметр при action=add. При добавлении нескольких заказов их номера перечисляются через запятую.
• assemblyPullId - номер отгрузки FBS. Обязательный параметр при action=send и action=info. При action=add не указывается, т.к. наша система автоматически определит тип заказа и добавит его в соответствующую отгрузку FBS.
• deliveryType - способ доставки отгрузки FBS, обязательный параметр при action=send, может принимать значения:
  • 1 - доставка отгрузки силами Поставщика счастья
  • 4 - самовывоз из офиса м. Автозаводская
• file - файл с документами(акт приема передачи для Яндекса или Озона, ШК поставки для WB), которые предоставляет маркетплейс, обязательный параметр при action=send.

Ответы системы:

По результатам работы система выдает структурированный ответ в формате XML.
Если при добавлении заказов в отгрузку action=add ошибок не было, то результатом будет идентификатор отгрузки:

Если при отправке в отгрузку FBS action=send ошибок не было, то результатом будет:

ResultStatus=1, ResultMsg=OK

Если при получении информации об отгрузке FBS action=info ошибок не было, то результатом будет:

,где:

• Type - тип отгрузки FBS:
• 10 - Яндекс Маркет FBS
• 15 - Wildberries FBS
• 18 - Озон FBS
• Status - текущий статус отгрузки
• 1 - Новая
• 2 - Сборка
• 3 - Готов к отгрузке
• 4 - Отгружено
• 5 - Сдано
• OrderNumbers - номера заказов в отгрузке
• DeliveryType - способ доставки
• 1 - доставка отгрузки силами Поставщика счастья
• 4 - самовывоз из офиса м. Автозаводская
• IsFile - наличие прикрепленного файла акта приема-передачи

Варианты ответов с ошибками:

Если в результате работы система обнаружит ошибку, то ответом будет XML с указанием ошибки:

• Не передан параметр "ApiKey".
• Пользователь не найден по переданному ApiKey.
• Не передан параметр "action".
• Проверьте правильность передаывемых заказов.
• Не передан параметр "fbs" (Номер FBS отгрузки).
• Не передан параметр "deliveryType".
• Отгрузка не в статусе "Новая".
• Отправка отгрузки возможна с 00:01 до 14:00 с понедельника по пятницу.
• В каждом заказе из отгрузки должна быть подгружена этикетка.
• Не все заказы были добавлены в отгрузку, проверьте передаваемые номера заказов.
• Недостаточно средств для отправки отгрузки, пополните лицевой счет.