playlist_add_checkRequisition. Заявки на закупку

Метод возвращает заявки на пополнение запасов точек продаж: статус, сводные показатели и, при необходимости, состав заявки. Заявки можно только читать: создаются они в панели управления.

Все параметры, кроме ключа apikey и формата format, принимаются и в адресной строке, и в теле POST.

GET https://[компания].myvirtualpos.ru/api/requisition?apikey=MySecret&warehouse_id=4&status=NEW&with_items=1

Условия объединяются по «и». Заявки возвращаются по возрастанию ид. Без id метод возвращает только основные заявки: дочерние (сформированные из сводных) не выдаются. Даты передаются строго в формате ГГГГММДД, иначе метод вернёт ошибку Incorrect date format.

Статус хранится в поле status.

В старых данных может встречаться также значение DRAFT (черновик).

Пустые значения в JSON приходят как null, в XML — как пустой элемент.

Сводные показатели (summary)

Состав заявки (items, каждая строка в объекте item)

{
  "success": 1,
  "type": "requisition",
  "flexfields": { "attribute1": "Дата поставки" },
  "count": 1,
  "requisitions": [
    {
      "requisition": {
        "id": 9,
        "status": "NEW",
        "warehouse_id": 4,
        "ext_warehouse_id": "WH-4",
        "created_date": "2026-07-04 11:49:04",
        "type": null,
        "summary": {
          "item_count": "2",
          "item_quantity": "2.000",
          "amount_cogs": "232.32",
          "amount_inflow": "0.00"
        },
        "attribute1": "2026-07-10",
        "items": [
          {
            "item": {
              "item_name": "Шампунь для волос 250 мл",
              "ext_item_id": "SKU-178",
              "item_id": 178,
              "quantity_ordered": "1.000"
            }
          }
        ]
      }
    }
  ]
}

Тот же ответ при format=xml (сокращённо):

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <success>1</success>
  <type>requisition</type>
  <flexfields><attribute1>Дата поставки</attribute1></flexfields>
  <count>1</count>
  <requisitions>
    <requisition>
      <id>9</id>
      <status>NEW</status>
      <warehouse_id>4</warehouse_id>
      <summary>
        <item_count>2</item_count>
        <item_quantity>2.000</item_quantity>
        <!-- остальные сводные показатели -->
      </summary>
      <items>
        <item><item_id>178</item_id><quantity_ordered>1.000</quantity_ordered></item>
      </items>
    </requisition>
  </requisitions>
</root>

Ошибка авторизации и общие ошибки описаны в статье Общие сведения.

Если по условиям ничего не найдено (в том числе при неизвестном статусе), метод возвращает успешный ответ с count равным 0 и пустым списком requisitions.