reporting

Endpoint- en toolkeuze

Gebruik deze skill om bij een vraag meteen het juiste endpoint en de juiste tool te kiezen, in plaats van te gokken of te improviseren.

Deze skill gaat over de routing, niet over de inhoudelijke analyse. Voor een formele resultatenrekening is resultatenrekening-analyse de juiste skill, voor stuurinformatie en commerciële KPI's is dat management-informatie.

Openstaande debiteuren en crediteuren

• Openstaande debiteuren: Bulk/Cashflow/Receivables, filter Status in [20, 30].
• Openstaande crediteuren: Bulk/Cashflow/Payments (let op: dit endpoint heet "Payments" in de API, ook al gaat het om crediteuren), zelfde filter Status in [20, 30].

Met read_operation:

{
  "service": "Bulk",
  "entity": "Cashflow/Receivables",
  "filters": { "Status": [20, 30] },
  "select": "AccountName,AmountDC,DueDate,InvoiceNumber"
}

Paginatie op Bulk-endpoints. Bulk pagineert alleen via een cursor: skip geeft daar een fout. Neem next_page.page_token uit de vorige respons en geef die mee in de volgende read_operation. top, skip, filters en select worden dan genegeerd, de cursor draagt ze al mee.

{
  "service": "Bulk",
  "entity": "Cashflow/Receivables",
  "page_token": "<next_page.page_token uit de vorige respons>"
}

Omzet, kosten en marge

Gebruik analyze_data op Financial/TransactionLines met een JOIN naar Financial/GLAccounts op GLAccountCode = Code, gefilterd op t1.BalanceType = 'W' (resultatenrekening). Kies daarna de grootboeksoort die bij de vraag hoort:

Vraag	Filter
Omzet	t1.Type = 110
Kosten	t1.Type in (111, 120, 121, 122, 123, 125, 126)
Marge (omzet plus kostprijs)	t1.Type in (110, 111)

Filter je alleen op BalanceType = 'W' en laat je Type weg, dan tel je de hele resultatenrekening bij elkaar op en presenteer je omzet en kosten door elkaar als één bedrag.

Meerdere boekjaren. Voeg dan ook t0.Type != 310 toe. De jaarafsluiting boekt elke W&V-rekening van een afgesloten jaar tegen zichzelf terug, waardoor dat jaar zonder dit filter op ongeveer nul uitkomt.