get.reports.pricechange — ТМЦ: акти переоцінки (Aprc/H_aprc)

Призначення

Повертає зміни цін з актів переоцінки: деталі з Aprc та заголовки з H_aprc, із можливістю фільтрації і вибору операції «дооцінка/уцінка».

Авторизація

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

Параметри params

Поле	Тип	Обов’язково	Опис
date_from	string	так	Дата початку (YYYY-MM-DD).
date_to	string	так	Дата кінця (YYYY-MM-DD).
limit	int	ні	Кількість рядків. За замовчуванням 100, максимум 5000.
offset	int	ні	Зсув для пагінації.
operation	string	ні	Фільтр по напрямку: up (тільки дооцінка), down (тільки уцінка). Якщо не задано — показує всі.
filters	object	ні	Фільтри (точні або LIKE, якщо значення містить %).

Фільтри

Дозволені поля у params.filters: Type (string, допускає %), User (int), Nact (int), Code (string).

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

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

{
  "auth": {
    "login": "<LOGIN>",
    "password": "<PASSWORD>"
  },
  "method": "get.reports.pricechange",
  "params": {
    "date_from": "2026-01-01",
    "date_to": "2026-01-31",
    "limit": 100,
    "offset": 0,
    "operation": "up",
    "filters": {
      "User": 1
    }
  },
  "meta": {
    "user_card": "<USER_CARD>",
    "client_name": "MyIntegration",
    "client_version": "1.0.0"
  },
  "id": "report-pricechange-001"
}

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

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

{
  "ok": true,
  "result": {
    "items": [
      {
        "Code": "4820000000012",
        "Nt": "Кава мелена 250г",
        "Old_price": 85.0,
        "Razn": 4.0,
        "New_price": 89.0,
        "Ei": 1,
        "Quant": 8.0,
        "Sh": 1,
        "Srazn": 32.0,
        "Dopinf": "Переоцінка перед сезоном",
        "Type": "P",
        "UserNt": "Адміністратор",
        "ItemDat": "2026-01-10 10:00:00",
        "ActDat": "2026-01-10 09:59:00",
        "Nact": 77
      }
    ],
    "limit": 100,
    "offset": 0,
    "count": 1,
    "operation": "up"
  },
  "meta": {
    "api_version": "0.1.0",
    "ts": "2026-01-26T12:00:00+00:00"
  },
  "id": "report-pricechange-001"
}

Примітки

• У відповіді Razn та Srazn можуть бути від’ємні (уцінка).

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

• MISSING_DATE_RANGE
• INVALID_DATE
• NO_DATA
• INVALID_FILTERS