get.reports.artrep — ТМЦ: рух товару по артикулу

Призначення

Повертає рух конкретного товару (code) за період: каса (річна таблиця YYYY), накладні (YYYY N) та складові (YYYY S).

Авторизація

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

Параметри params

Поле	Тип	Обов’язково	Опис
date_from	string	так	Дата початку (YYYY-MM-DD).
date_to	string	так	Дата кінця (YYYY-MM-DD).
code	string	так	Код товару (Main.Code).
limit	int	ні	Кількість рядків (за замовчуванням 100, максимум 5000).
offset	int	ні	Зсув для пагінації.

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

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

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

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

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

{
  "ok": true,
  "result": {
    "items": [
      {
        "Code": "4820000000012",
        "Nt": "Кава мелена 250г",
        "Ss": 55.0,
        "Nac": 35.0,
        "Price": 89.0,
        "Ei": 1,
        "Oldq": 10.0,
        "Qmi": 2.0,
        "Newq": 8.0,
        "Qss": 110.0,
        "Qprice": 178.0,
        "Nc": 1001,
        "Nn": "Чек №1001",
        "Dat": "2026-01-05 14:22:11",
        "Src": "cash"
      }
    ],
    "limit": 200,
    "offset": 0,
    "count": 1,
    "tables": {
      "cash": [
        "2026"
      ],
      "nakl": "2026N",
      "sost": "2026S"
    }
  },
  "meta": {
    "api_version": "0.1.0",
    "ts": "2026-01-26T12:00:00+00:00"
  },
  "id": "report-artrep-001"
}

Примітки

• Звіт працює тільки в межах одного календарного року.
• Поле Src показує джерело рядка: cash, nakl або sost.
• У відповіді є tables з переліком реально використаних таблиць.

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

• MISSING_DATE_RANGE
• INVALID_DATE
• MISSING_CODE
• NO_DATA