fact_checkInventory. Инвентаризации

Метод возвращает документы «Инвентаризация» вместе со строками: сверку фактических остатков с учётными по точке продаж. Документы можно только читать: создание и изменение через API не поддерживаются.

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

GET https://[компания].myvirtualpos.ru/api/inventory?apikey=MySecret&days=90&warehouse_id=6&withitems=1

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

Статус документа (status)

Тип инвентаризации (type)

Состояние строки (state)

Поле state содержит русское название, а не код.

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

{
  "success": 1,
  "type": "inventory",
  "days_limit": 90,
  "count": 1,
  "inventories": [
    {
      "inventory": {
        "id": 9906,
        "warehouse_id": 6,
        "status": "CLOSED",
        "docnum": null,
        "docdate": "2026-09-06 00:00:00",
        "comment": "Ежемесячная инвентаризация",
        "created_date": "2026-09-06 18:50:05",
        "created_by": 44,
        "last_update_date": "2026-09-06 20:03:56",
        "last_update_by": 44,
        "external_id": null,
        "type": "G",
        "guid": "F9825B9C-3F35-7114-1F44-7AF7B82BEC6C",
        "warehouse_external_id": "WH-6",
        "items": [
          {
            "item": {
              "id": 144630297,
              "inventory_id": 9906,
              "item_id": 2313,
              "onhand_id": 14794,
              "quantity_initial": "1105.000",
              "quantity": "1300.000",
              "lot_number": null,
              "cogs": "0.64",
              "price": "5.00",
              "cogs_initial": "0.64",
              "expir_date": "0000-00-00",
              "expir_date_initial": "0000-00-00",
              "guid": "62315839-83C9-11EF-9186-00155DCD4602",
              "item_external_id": "ITEM-2313",
              "item_name": "Перчатки полиэтиленовые",
              "state": "Излишек"
            }
          }
        ]
      }
    }
  ]
}

В примере для краткости опущены гибкие поля attribute1…attribute15 и служебные поля создания и изменения.

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

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <success>1</success>
  <type>inventory</type>
  <days_limit>90</days_limit>
  <count>1</count>
  <inventories>
    <inventory>
      <id>9906</id>
      <status>CLOSED</status>
      <!-- остальные поля шапки -->
      <items>
        <item>
          <id>144630297</id>
          <item_id>2313</item_id>
          <quantity_initial>1105.000</quantity_initial>
          <quantity>1300.000</quantity>
          <state>Излишек</state>
          <!-- остальные поля строки -->
        </item>
      </items>
    </inventory>
  </inventories>
</root>

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

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