move_to_inboxInflow. Поступления

Методы для работы с документами «Поступление»: получение документов вместе со строками, создание и изменение документов и их строк, массовая загрузка, принятие на склад и откат принятия, удаление, загрузка накладных файлами в формате CSV.

Статус хранится в поле status. Документ проходит четыре этапа:

Статус можно сменить параметром status в методах update и batchUpdate либо отдельным методом accepting. Переход в accept или complete принимает документ на склад. Назад по цепочке статус этими методами вернуть нельзя: для отката принятого документа используйте rollback (только из статуса accept).

GET https://[компания].myvirtualpos.ru/api/inflow?apikey=MySecret&datefrom=20260901&dateto=20260930&withitems=1

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

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

Основное

Точка продаж и поставщик

Документы-основания

Строки (при withitems=1: список items, каждая строка в объекте item; зависит от настроенных гибких полей товарного остатка)

Корректировка (при withadjustment=1, объект adjustment; пустой список, если корректировки нет)

{
  "success": 1,
  "type": "inflow",
  "count": 1,
  "days_limit": 30,
  "inflows": [
    {
      "inflow": {
        "id": 21230,
        "warehouse_id": 6,
        "supplier_id": 145,
        "waybill": "118",
        "docdate": "2026-09-01 00:00:00",
        "status": "accept",
        "comment": "Поставка сентября",
        "created_date": "2026-09-01 10:14:02",
        "created_by": null,
        "last_update_date": "2026-09-01 10:20:11",
        "last_update_by": null,
        "external_id": "1C-321",
        "accept_date": "2026-09-01 00:00:00",
        "factura_invoice_num": "",
        "factura_invoice_date": null,
        "UPD_num": "",
        "UPD_date": null,
        "correction_num": null,
        "guid": "803AD8B6-688C-11E7-849D-74D435EE6043",
        "supplier_external_id": "S-212",
        "supplier_name": "Мой поставщик",
        "supplier_inn": "1234567890",
        "supplier_kpp": "111",
        "supplier_type": 2,
        "supplier_readonly_inflow": 0,
        "warehouse_external_id": "WH-111",
        "items": [
          {
            "item": {
              "line_id": 252894,
              "item_id": 431,
              "item_ext_id": "ITEM-431",
              "item_name": "Открытка с шоколадом",
              "quantity": "68.000",
              "quantity_expected": "68.000",
              "barcode": null,
              "price": "65.0000",
              "amount": "4420.00",
              "manuf_date": null,
              "expir_date": null,
              "lot_number": null,
              "external_id": null,
              "vat_rate": "20.00",
              "vat_sum": "736.67",
              "sum_minus_vat": "3683.33",
              "guid": "3A148213-7184-B497-9C31-566F439CED63",
              "onhand_id": 171567
            }
          }
        ],
        "adjustment": [],
        "amount": "4420.00"
      }
    }
  ]
}

В примере для краткости опущены гибкие поля attribute1…attribute15 и связанные документы (parent_id, request_id и другие).

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

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <success>1</success>
  <type>inflow</type>
  <count>1</count>
  <inflows>
    <inflow>
      <id>21230</id>
      <warehouse_id>6</warehouse_id>
      <docdate>2026-09-01 00:00:00</docdate>
      <status>accept</status>
      <!-- остальные поля шапки -->
      <items>
        <item>
          <line_id>252894</line_id>
          <item_id>431</item_id>
          <quantity>68.000</quantity>
          <!-- остальные поля строки -->
        </item>
      </items>
      <adjustment/>
      <amount>4420.00</amount>
    </inflow>
  </inflows>
  <days_limit>30</days_limit>
</root>

POST https://[компания].myvirtualpos.ru/api/inflow/update?apikey=MySecret&external_id=1C-321&create_if_not_exist=1
warehouse_id=6&supplier_id=145&waybill=118&docdate=2026-09-01&comment=Test

Изменяются только переданные параметры, остальные остаются прежними. Строки документа этим методом не меняются — для этого есть updateItems и batchUpdate.

{"success":1,"id":"21230","isnew":"1"}

Метод создаёт документы вместе со строками одним запросом. Данные передаются в параметре batch в формате XML, поэтому используйте POST.

POST https://[компания].myvirtualpos.ru/api/inflow/batchUpdate?apikey=MySecret
batch=<root><inflows>...</inflows></root>

Структура batch:

<root>
  <inflows>
    <inflow>
      <external_id>1C-321</external_id>
      <waybill>118</waybill>
      <warehouse_external_id>WH-111</warehouse_external_id>
      <supplier_external_id>S-212</supplier_external_id>
      <docdate>2026-09-01</docdate>
      <comment>Поставка</comment>
      <status>accept</status>
      <items>
        <item>
          <item_ext_id>ITEM-431</item_ext_id>
          <quantity>68</quantity>
          <quantity_expected>68</quantity_expected>
          <cogs>65</cogs>
          <lot_number>A1</lot_number>
        </item>
      </items>
    </inflow>
  </inflows>
</root>

Правила обработки:

• Документ ищется по id, а если его нет — по external_id. Если найти не удалось, создаётся новый черновик с полями из XML. Точка продаж и поставщик задаются кодами warehouse_external_id и supplier_external_id или ид warehouse_id и supplier_id.
• Шапка существующего документа не обновляется: для найденных документов применяются только строки и статус.
• Строка ищется по id строки, а если его нет — по item_ext_id среди строк этого документа. Если строки нет, создаётся новая по item_id или item_ext_id (с учётом lot_number). Поля строки — как в методе updateItems.
• Статус (status) применяется в последнюю очередь, после строк.
• Вся загрузка выполняется в одной транзакции: при любой ошибке не сохраняется ничего.

Ответ: {«success»:1}.

GET https://[компания].myvirtualpos.ru/api/inflow/delete?apikey=MySecret&id=21230

Удалить можно только документ в статусе draft. Ответ: {«success»:1,«id»:21230}.

GET https://[компания].myvirtualpos.ru/api/inflow/accepting?apikey=MySecret&id=21230
GET https://[компания].myvirtualpos.ru/api/inflow/rollback?apikey=MySecret&id=21230

Ответ обоих методов: {«success»:1,«id»:21230}.

• accepting принимает документ из статуса draft сразу в статус accept: добавляет количество из строк в остатки склада, пересчитывает закупочную цену остатка и записывает движение товара. Условия: в документе есть хотя бы одна строка, нет пустых строк без товара, все товары существуют в ассортименте.
• rollback отменяет принятие документа из статуса accept: возвращает остатки к прежним значениям и переводит документ в draft. Документ в статусе complete откатить нельзя.

POST https://[компания].myvirtualpos.ru/api/inflow/updateItems?apikey=MySecret&create_if_not_exist=1
inflow_id=21230&item_id=431&quantity=68&quantity_expected=68&cogs=65

Ответ: {«success»:1,«id»:«252927»,«isnew»:«1»}. id — ид строки, isnew — создана ли строка.

GET https://[компания].myvirtualpos.ru/api/inflow/deleteItems?apikey=MySecret&id=252927

Ответ: {«success»:1,«id»:252927}.

Метод принимает файлы накладных в формате CSV и ставит их в очередь на обработку: поступления создаются из файлов позже, а не в момент вызова. Запрос отправляется методом POST с типом multipart/form-data; можно приложить несколько файлов.

POST https://[компания].myvirtualpos.ru/api/inflow/upload?apikey=MySecret&waybill=118&warehouse_id=6&supplier_id=145&encoding=utf8
file=@nakladnaya.csv

Файл в формате CSV с разделителем «точка с запятой». Первая строка — заголовки столбцов, остальные — строки накладной. Пример:

Количество;Количество ожидаемое;Цена закупки;Цена закупки без НДС;Сумма закупки;Штрихкод;Серия;Годен до;ID товара у Поставщика;Название товара у поставщика;Ставка НДС;Сумма НДС;Сумма без НДС;Производитель поставщика
1;1;556.94;506.31;556.94;5000456022453;ACAT;01.11.2027;10735;Товар 1;10;50.63;506.31;Производитель 1

Набор столбцов зависит от настроек загрузки накладных в вашей системе.

{"success":1,"files":["74e474f98c55579e5f0bc72123da2b68.csv"]}

Ошибка авторизации и общие ошибки описаны в статье Общие сведения. Ошибки методов раздела приходят с кодом HTTP 200 и success равным 0:

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