Инструкция по загрузке через API
Запросы могут отправляться по протоколу HTTP методом GET или POST.
Формат запроса: http://api.forin.ru/order.php?ApiKey=****&INN=*&....., 11111111-brand-2-100"
ApiKey - все запросы должны содержать ApiKey. Этот параметр идентифицирует контрагента (бренд) на сайте и по нему сайт понимает от кого пришел запрос. ApiKey отображается в личном кабинете у главного менеджера при выборе юр. лица.
INN - ИНН контрагента
Direct - цифровой код для адреса доставки
shipp - способ доставки (1 - самовывоз, 2 - доставка по Москве, 3 - транспортная компания по России). По умолчанию параметр = 1
voucher - купон скидки. По умолчанию параметр = 0 ( т.е. купона нет)
order - это обязательный параметр. Он содержит содержать пары вида: < ABP >-<qty>. Пары отделяются друг от друга запятыми.
ABP - это обязательный параметр уникальности товара ID Артикул+Бренд+Упаковка. При этом параметр упаковки может принимать 2 значения: оптовый – 1, розничный – 2. Блоки отделяются друг от друга запятыми.
* Т.к. определение уникальности товара проходит по 3м параметрам, то возможны пропорциональные по скорости задержки в обработке API запроса.
qty - количество товара которое нужно добавить в заказ.
TestModes - не обязательный параметр. Может принимать значения 0 и 1. Если параметр имеет значение 1, т.е. тестовый режим включен, то запросы принимаются, данные проверяются и выдается ответ о валидности данных, но сам заказ не размещается. По умолчанию этот параметр равен 0.
RollsBack - не обязательный параметр. Может принимать значения 1, 2, 3. Параметр указывает системе - что делать в случае если не все запрашиваемые позиции найдены, или какая-то из позиций имеет статус "снято с пр-ва", "под запрос".
Если параметр имеет значение 1, то система разместит заказ в любом случае. Не найденные товары и статусы "снято с пр-ва", "под запрос" будут проигнорированы. А товары количество, которых меньше "мин. партия", будут добавлены в заказ в том количестве, который требует сайт.
Если параметр имеет значение 2, то система разместит заказ в любом случае. Не найденные товары и статусы "снято с пр-ва", "под запрос" будут проигнорированы. А товары количество, которых меньше "мин. партия", так же будут проигнорированы.
Если параметр имеет значение 3, то система разместит заказ только, если найдены все запрашиваемые позиции (т.е. нет товаров со статусами "снято с пр-ва", под запрос") и кол-во заказываемых товаров в каждой позиции больше или равно "мин. партии".
По умолчанию этот параметр равен 1.
Результат работы:
По результатам работы система выдает структурированный ответ в формате XML.
Если заказ размещен корректно, то в ответе будет приведен номер размещенного заказа и его состав.
В случае возникновения ошибок в параметре ErrorItems приводится подробная диагностика по каждой проблемной паре < ABP >-<qty>.
Заказы размещаются с учетом клиентской скидки.
ResultStatus - статус результата выполнения запроса. Может принимать следующие значения:
1 - "Ok", Запрос выполнен успешно. Заказ размещен.
2 - "Bad key", Проверьте корректность Вашего ApiKey.
3 - "Bad order request", Не корректные данные в поле order.
4 - "Order do not placed. Some items not at stock OR some problem in aID.", Заказ не размещен, Либо каких-то товаров недостаточное количество на нашем складе, либо какие-то aID не найдены в нашей системе. (RollsBack = 3)
5 - "TestMode. Data was checked. Order have NOT placed.". Включен тестовый режим. Данные проверены, но заказ не размещается.
6 Bad INN - ИНН контрагента не найден в базе
7 Bad Direct - не корректный адрес доставки
8 The voucher is not found - купон не корректный или уже использован
ResultStatusMsg - текстовое описание статуса результата выполнения запроса.
timestamp - дата/время выполнения запроса в формате "Y-m-d H:i:s".
orderID - номер заказа у нас в системе.
totalSum - полная оптовая стоимость заказа (рубли).
OrderItems - массив, содержащий детальную информацию о составе заказа.
pickupDate - плановая дата отгрузки заказа с нашего склада для товаров со статусами "ожидается" и "под заказ".
ErrorItems - массив, содержащий детальную информацию об ошибках в составе заказа. Параметр передаётся только в случае ошибок в составе заказа.
Параметры orderID, totalSum, OrderItems, pickupDate передаются только в случае успешного выполнения запроса.