get.cash.operations.list — Інкасації та внесення

Призначення

Повертає список касових операцій інкасації та внесення коштів з таблиці Kas_report.

Метод навмисно показує саме “рухи грошей” між касами/джерелами і за замовчуванням не показує продажі (рядки з Com1 = "Продажа" тощо).

HTTP

• URL: https://api13.arm20.com/ (ваш домен)
• Метод: POST
• Content-Type: application/json

Авторизація

• Потрібні логін/пароль: так (як в онлайн статистиці).
• meta.user_card: так.

Параметри params

• date_from (string, опц.) — дата початку (YYYY-MM-DD). Якщо не задано, береться період за останні 7 днів.
• date_to (string, опц.) — дата кінця (YYYY-MM-DD). Якщо не задано, береться поточна дата.
• type (string, опц.) — тип операцій:
  • all — інкасації + внесення (за замовчуванням)
  • incasso — тільки інкасації (Com1 = "Инкассация")
  • deposit — тільки внесення (Com1 = "Внесение")
• filters (object, опц.) — фільтри по полях Kas_report:
  • Kas (string) — назва каси. Підтримує % (LIKE).
  • Kasm (number) — касове місце (як в БД).
  • User (number) — користувач (Users.Ind).
  • Ndoc (string) — номер документа. Підтримує % (LIKE).
• limit (number, опц.) — кількість рядків.
• offset (number, опц.) — зсув.

Приклад запиту

Мокап: mockups/cash/get.cash.operations.list/request.json

{
  "auth": {
    "login": "<LOGIN>",
    "password": "<PASSWORD>"
  },
  "method": "get.cash.operations.list",
  "params": {
    "date_from": "2026-01-01",
    "date_to": "2026-01-31",
    "type": "all",
    "filters": {
      "Kas": "%касса%"
    },
    "limit": 100,
    "offset": 0
  },
  "meta": {
    "user_card": "<USER_CARD>",
    "client_name": "MyIntegration",
    "client_version": "1.0.0"
  },
  "id": "cash-ops-001"
}

Приклад відповіді (успіх)

Мокап: mockups/cash/get.cash.operations.list/response.ok.json

{
  "ok": true,
  "result": {
    "items": [
      {
        "Dat": "2026-01-10 10:20:52",
        "Kas": "Безналичная касса N1",
        "Kasm": 0,
        "Sum": "-12.00",
        "Old": "68095.63",
        "User": 15,
        "UserNt": "Администратор",
        "Com1": "Инкассация",
        "Com2": "В кассу:Безналичная касса N2",
        "Tdoc": "Расходно-кассовый",
        "Ndoc": "ВИ-2"
      }
    ],
    "limit": 100,
    "offset": 0,
    "count": 1,
    "period": {
      "from": "2026-01-01",
      "to": "2026-01-31"
    },
    "type": "all"
  },
  "meta": {
    "api_version": "0.1.2",
    "ts": "2026-01-26T12:00:00+00:00"
  },
  "id": "cash-ops-001"
}

Примітки

• Для повного журналу касових рухів (включно з продажами) використовуйте звіт get.reports.cash_operations.
• Поле Sum може бути від’ємним (інкасація) або додатним (внесення).

Типові помилки

• INVALID_PARAMS — неправильне значення params.type.