Сервис заказа

Размещает заказ в системе «ПартКом».

HTTP метод
POST
URL запроса
/engine/api/v1/order
Заголовки запроса (request headers)
Authorization: Basic [кодированная в base64 строка логин:пароль]
Accept: application/json
Content-type: application/json
Параметры запроса
Данные отправляются стокой JSON в raw формате. Строка содержит объект, со следующими параметрами:
flagTest
Флаг, указывающий на то, что запрос отправляется в тестовом режиме: заказ не будет оправлен в работу. Если флаг не передан, то будет использовано значение true.
orderItems
Коллекция объектов заказа со следующей структурой:
  • detailNum - артикул детали;
  • makerId - уникальный идентификатор производителя в системе «ПартКом»;
  • description - описание детали;
  • price - цена в рублях без копеек;
  • providerId - уникальный идентификатор поставщика в системе «ПартКом»;
  • quantity - заказываемое количество
  • comment - комментарий к заказу
  • reference - идентификатор заказа в вашей системе. По нему можно будет отслеживать изменение состояния заказа, подробнее в разделе "История заказа"

Ответ
В ответе возвращается строка JSON  с коллекцией объектов orderItem, содержащую только детали с ошибками заказа (несоответствие цены, отсутствие в наличии).
Детали, прошедшие проверку, не содержатся в возвращаемой коллекции.
Признаком того, что заказ полностью ушел в работу, является пустая возвращаемая коллекция.

Объект orderItem имеет следующую структуру:
  • detailNum - артикул детали;
  • makerId - уникальный идентификатор производителя в системе «ПартКом»;
  • description - описание детали;
  • price - цена в рублях без копеек;
  • providerId - уникальный идентификатор поставщика в системе «ПартКом»;
  • quantity - заказываемое количество
  • comment - комментарий к заказу
  • errorCode - код ошибки
  • errorMessage - текст ошибки


Коды и описание ошибок
  1. Не указан номер детали
  2. Не указан идентификатор производителя детали
  3. Не указана цена
  4. Не указан номер склада
  5. Не указано количество
  6. Идентификатор производителя должен быть целым числом
  7. Цена должна быть целым числом
  8. Номер склада должен быть целым числом
  9. Количество должно быть целым числом
  10. Предложение не актуально и недоступно для заказа
  11. Требуемое количество недоступно
  12. Изменение цены