account_balance_walletCashFlow. Движение денежных средств на кассе

Метод возвращает журнал движения наличных денег на кассах: продажи и возвраты за наличные, внесения и выплаты, закрытие смены. Данные можно ограничить кассой, точкой продаж, типом операции и периодом.

Метод только читает данные. Все параметры запроса, кроме ключа apikey и формата format, передаются только в адресной строке (GET): в теле POST-запроса они игнорируются.

GET https://[компания].myvirtualpos.ru/api/cashFlow?apikey=MySecret&days=2&type=income,outcome

В интерфейсе те же данные показаны на странице кассы, вкладка «Движение денежных средств».

Параметры можно сочетать: например, warehouseid=3&type=sale&days=7 вернёт продажи за наличные по точке 3 за неделю.

Тип операции указан в поле type и в параметре type:

Направление показывают поля src_* и dst_*: у операций «в кассу» заполнены только dst_* (получатель — касса), у операций «из кассы» — только src_* (источник — касса).

Ответ содержит общие поля метода, а сами операции — в списке transactions. Каждая операция обёрнута в объект transaction:

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

Операция

Суммы

Суммы передаются строкой с двумя знаками после точки, например «905.00».

Пользователь

Кассы и точки продаж

Смена

Запрос: внесение наличных на кассу, type=income&limit=1.

{
  "success": 1,
  "type": "cashflow",
  "count": 1,
  "transactions": [
    {
      "transaction": {
        "id": 404182,
        "user_id": 6,
        "user_login": "kassir1",
        "user_corp_code": "",
        "created_date": "10.10.2025 17:25:53",
        "last_update_date": "10.10.2025 17:25:53",
        "src_terminal_id": null,
        "dst_terminal_id": 38,
        "src_machine_number": null,
        "dst_machine_number": "0000000001058369",
        "src_warehouse_id": null,
        "dst_warehouse_id": 8,
        "src_warehouse_ext_id": null,
        "dst_warehouse_ext_id": null,
        "type": "income",
        "subtype": "other",
        "cash_before": "0.00",
        "cash_after": "500.00",
        "cash_change": "500.00",
        "comment": "",
        "receipt_id": null,
        "guid": "9731F106-0CDF-D1E2-8C34-A1D1A3C24713",
        "src_terminal_open_datetime": null,
        "dst_terminal_open_datetime": "2025-10-10 17:28:03",
        "src_terminal_session": null,
        "dst_terminal_session": 4
      }
    }
  ]
}

Тот же ответ при format=xml:

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <success>1</success>
  <type>cashflow</type>
  <count>1</count>
  <transactions>
    <transaction>
      <id>404182</id>
      <user_id>6</user_id>
      <user_login>kassir1</user_login>
      <user_corp_code/>
      <created_date>10.10.2025 17:25:53</created_date>
      <last_update_date>10.10.2025 17:25:53</last_update_date>
      <src_terminal_id/>
      <dst_terminal_id>38</dst_terminal_id>
      <src_machine_number/>
      <dst_machine_number>0000000001058369</dst_machine_number>
      <src_warehouse_id/>
      <dst_warehouse_id>8</dst_warehouse_id>
      <src_warehouse_ext_id/>
      <dst_warehouse_ext_id/>
      <type>income</type>
      <subtype>other</subtype>
      <cash_before>0.00</cash_before>
      <cash_after>500.00</cash_after>
      <cash_change>500.00</cash_change>
      <comment/>
      <receipt_id/>
      <guid>9731F106-0CDF-D1E2-8C34-A1D1A3C24713</guid>
      <src_terminal_open_datetime/>
      <dst_terminal_open_datetime>2025-10-10 17:28:03</dst_terminal_open_datetime>
      <src_terminal_session/>
      <dst_terminal_session>4</dst_terminal_session>
    </transaction>
  </transactions>
</root>

Закрытие смены (type=collection): деньги уходят из кассы, поэтому заполнены поля src_*, а остаток после операции равен нулю.

{
  "id": 404215,
  "created_date": "11.02.2026 20:11:52",
  "src_terminal_id": 36,
  "dst_terminal_id": null,
  "src_warehouse_id": 2,
  "dst_warehouse_id": null,
  "type": "collection",
  "subtype": null,
  "cash_before": "2118.00",
  "cash_after": "0.00",
  "cash_change": "-2118.00",
  "receipt_id": null,
  "src_terminal_open_datetime": "2026-02-11 20:04:01",
  "src_terminal_session": 1
}

В примере показаны только основные поля.

Ошибка авторизации и общие ошибки описаны в статье Общие сведения. Для этого метода добавляется одна:

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