Skip to content
On this page

/report

Кінцева точка /report повертає дані звітів - ті самі розрахунки, що й відповідні звіти в інтерфейсі.

Методи

  • /report/warehousebalance - залишки по складах
  • /report/agentturnover - відомість за розрахунками з контрагентами

GET /report/warehousebalance/?{date}&{store}&{supplier}

Залишки товарів у розрізі склад × товар (в інтерфейсі: Запаси → Звіти → Залишки по складах).

Параметри запиту (всі необов'язкові):

  • date - залишки на кінець вказаної дати, формат 2026-08-31. Без параметра - поточні.
  • store - UID складу (Store).
  • supplier - UID постачальника партії (Agent).
json
{
   "success" : true,
   "data": {
      "date": "2026-08-31T00:00:00",
      "rows": [
         {
            "store":  { "uid": "....", "name": "Основний склад" },
            "entity": { "uid": "....", "name": "Товар", "article": "A-1", "unit": "шт" },
            "qty": 5,
            "price": 100,
            "sum": 500
         }
      ]
   }
}
{
   "success" : true,
   "data": {
      "date": "2026-08-31T00:00:00",
      "rows": [
         {
            "store":  { "uid": "....", "name": "Основний склад" },
            "entity": { "uid": "....", "name": "Товар", "article": "A-1", "unit": "шт" },
            "qty": 5,
            "price": 100,
            "sum": 500
         }
      ]
   }
}
  • qty - залишок (кількість)
  • price - середня ціна залишку
  • sum - сума залишку (за обліковою вартістю)

Повертаються тільки позиції з ненульовим залишком.

GET /report/agentturnover/?{accCode}&{from}&{to}&{agent}

Початковий/кінцевий залишок та обороти за період за рахунком у розрізі контрагентів (в інтерфейсі: Закупівлі → Звіти → Відомість за розрахунками з постачальниками - це accCode=631; Продажі → Звіти для покупців - accCode=361).

Параметри запиту:

  • accCode - код рахунку (напр. "631" - розрахунки з постачальниками, "361" - розрахунки з покупцями). Обов'язковий.
  • from - початок періоду, формат 2026-08-01. Обов'язковий.
  • to - кінець періоду. Обов'язковий.
  • agent - UID контрагента (Agent), необов'язковий фільтр.
json
{
   "success" : true,
   "data": {
      "accCode": "631",
      "from": "2026-08-01T00:00:00",
      "to": "2026-08-31T00:00:00",
      "rows": [
         {
            "agent": { "uid": "....", "name": "Постачальник" },
            "balanceStartDb": 0,
            "balanceStartCr": 0,
            "dbSum": 0,
            "crSum": 500,
            "balanceEndDb": 0,
            "balanceEndCr": 500
         }
      ],
      "total": {
         "balanceStartDb": 0,
         "balanceStartCr": 0,
         "dbSum": 0,
         "crSum": 500,
         "balanceEndDb": 0,
         "balanceEndCr": 500
      }
   }
}
{
   "success" : true,
   "data": {
      "accCode": "631",
      "from": "2026-08-01T00:00:00",
      "to": "2026-08-31T00:00:00",
      "rows": [
         {
            "agent": { "uid": "....", "name": "Постачальник" },
            "balanceStartDb": 0,
            "balanceStartCr": 0,
            "dbSum": 0,
            "crSum": 500,
            "balanceEndDb": 0,
            "balanceEndCr": 500
         }
      ],
      "total": {
         "balanceStartDb": 0,
         "balanceStartCr": 0,
         "dbSum": 0,
         "crSum": 500,
         "balanceEndDb": 0,
         "balanceEndCr": 500
      }
   }
}
  • balanceStartDb / balanceStartCr - залишок на початок періоду (дебет / кредит)
  • dbSum / crSum - обороти за період
  • balanceEndDb / balanceEndCr - залишок на кінець періоду
  • total - підсумки по всіх рядках

Повертаються тільки контрагенти, у яких є залишок або обороти.