`get.reports.itogpok` — Підсумкові показники (в цінах продажу)

get.reports.itogpok — Підсумкові показники: у цінах продажу

Призначення

Повертає набір «підсумкових показників» за період (як у MFC), використовуючи шаблони запитів з таблиці Itog_reports.

Авторизація

  • Логін/пароль: так.
  • meta.user_card: обов’язково.

Параметри params

ПолеТипОбов’язковоОпис
date_from string так Дата початку (YYYY-MM-DD).
date_to string так Дата кінця (YYYY-MM-DD).

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

Мокап: mockups/reports/get.reports.itogpok/request.json

{
  "auth": {
    "login": "<LOGIN>",
    "password": "<PASSWORD>"
  },
  "method": "get.reports.itogpok",
  "params": {
    "date_from": "2026-01-01",
    "date_to": "2026-01-31"
  },
  "meta": {
    "user_card": "<USER_CARD>",
    "client_name": "MyIntegration",
    "client_version": "1.0.0"
  },
  "id": "report-itogpok-001"
}

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

Мокап: mockups/reports/get.reports.itogpok/response.ok.json

{
  "ok": true,
  "result": {
    "period": {
      "from": "2026-01-01",
      "to": "2026-01-31"
    },
    "year": "2026",
    "items": [
      {
        "ind": 1,
        "title": "Виручка",
        "value": 12345.67
      },
      {
        "ind": 2,
        "title": "Собівартість",
        "value": 8000.0
      },
      {
        "ind": 3,
        "title": "Прибуток",
        "value": 4345.67
      }
    ],
    "count": 3
  },
  "meta": {
    "api_version": "0.1.0",
    "ts": "2026-01-26T12:00:00+00:00"
  },
  "id": "report-itogpok-001"
}

Примітки

  • Звіт працює тільки в межах одного календарного року (бо всередині підставляється %YR).
  • У відповіді елементи мають поля ind, title, value.

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

  • MISSING_DATE_RANGE
  • INVALID_DATE
  • NO_DATA

На цій сторінці