Производителям и поставщикам

Обмен по HTTPS, данные — JSON в UTF-8. Доступ привязывается к учётной записи Мосавтошины; ключ передаётся в заголовке авторизации. Ниже указаны рекомендуемые пути на сервере поставщика.

Обязательные поля заявки: request_id — уникальный идентификатор запроса; order_id и order_position_id — наши номера заказа и позиции; warehouse_id — склад поставщика; supplier_code — код из прайс-листа; qty — положительное целое количество; expected_price_with_vat — ожидаемая цена за единицу с НДС; currency — валюта, в примере RUB.

Коды товаров, складов и идентификаторы передаются строками с сохранением ведущих нулей. При изменении цены возвращается PRICE_CHANGED с актуальной ценой; резерв по новой цене создаётся после согласования отдельной заявкой.

{
  "request_id": "MA-123456-1",
  "order_id": "123456",
  "order_position_id": "987654",
  "warehouse_id": "MSK-01",
  "supplier_code": "SUP-123456",
  "qty": 4,
  "expected_price_with_vat": 7990.00,
  "currency": "RUB"
}

Пример заявки JSON

Каждый ответ содержит request_id, status, warehouse_id и supplier_code. Для подтверждённого резерва также обязательны reserve_number, фактически зарезервированное qty, цена за единицу price_with_vat, currency и срок expires_at в формате ISO 8601 с часовым поясом.

• pending — заявка принята, результат ещё ожидается.
• confirmed — товар фактически зарезервирован на указанном складе в запрошенном количестве.
• rejected — резерв не создан; обязательны error_code и понятное описание message.
• cancelled — резерв снят; expired — срок резерва истёк.

Рекомендуемые ошибки: UNKNOWN_WAREHOUSE, UNKNOWN_PRODUCT, INSUFFICIENT_STOCK, PRICE_CHANGED, INVALID_REQUEST, REQUEST_CONFLICT. При нехватке товара возвращается available_qty по выбранному складу, при изменении цены — actual_price_with_vat и currency. Для неверного запроса отсутствующие коды могут быть null; причина указывается в ответе.

Повтор одинаковой заявки с тем же request_id в рамках нашей учётной записи должен возвращать результат исходной операции, не создавая новый резерв. Изменение данных под тем же идентификатором возвращает REQUEST_CONFLICT. Проверка наличия и создание резерва должны исключать резервирование одних и тех же свободных единиц двумя одновременными заявками.

При тайм-ауте Мосавтошина проверяет результат по исходному request_id. Отсутствие ответа не считается отказом и не является основанием для новой заявки с другим идентификатором. Успешный HTTP-ответ с pending также не означает, что товар уже зарезервирован.

Подтверждение JSON · Отказ JSON

Поставщик размещает FTP-сервер и предоставляет Мосавтошине отдельный доступ. Мосавтошина загружает заявки в order/; поставщик размещает подтверждения в job/, отказы — в error/. Защищённый транспорт FTPS или SFTP согласуется при подключении.

Один файл содержит одну товарную позицию на одном складе. Имя заявки и ответа одинаковое: request_id.xml, например MA-123456-1.xml. Файлы XML в UTF-8 сначала загружаются как .tmp, затем переименовываются в .xml; обрабатываются только полностью загруженные файлы.

В XML используются те же поля и правила, что и в API; корневой элемент — data, операция заявки — action=reserve. Поле warehouse_id обязательно. Примеры заявки и ответа приведены ниже.

Поставщик обрабатывает новые файлы с согласованным интервалом; рекомендуемый интервал — одна минута. До появления ответа заявка ожидает подтверждения. Для каждой заявки публикуется один итоговый результат: confirmed в job/ либо rejected в error/. Пустой файл не является подтверждением: ответ должен содержать результат, склад, количество и данные резерва либо причину отказа.

Повторная загрузка с тем же request_id не создаёт новый резерв. Обработанные заявки архивируются, ответы хранятся не менее 30 дней; срок хранения и порядок очистки согласуются при подключении. Для отмены передаётся отдельная заявка с action=cancel, новым request_id, исходными reserve_number, warehouse_id и supplier_code. В job/ возвращается cancelled после снятия резерва; при отказе — rejected в error/ с причиной, исходный резерв сохраняет свой статус.

Заявка XML · Подтверждение XML · Отказ XML