Tools — Consumptions - Manglai API Documentation

Available Tools

Tool	Kind	Description
`list_consumptions`	Data	Consumption records in a date range
`list_consumptions_by_external_id`	Data	Consumptions by external id
`list_invoices`	Data	Invoice line items (paginated)
`get_invoice_summary`	Data	Invoices dashboard summary
`get_electricity_by_cup`	Data	Electricity invoices by CUP
`get_expenses_summary`	Data	Expenses / cost dashboard
`list_purchases_goods_and_services`	Data	Purchased goods and services rows
`get_purchases_goods_and_services_summary`	Data	Purchases dashboard
`list_business_travels`	Data	Business travel trips
`get_business_travel_summary`	Data	Travel dashboard
`list_logistics`	Data	Supplier logistics consumption rows (/saas/logistics)
`list_vehicle_consumptions`	Data	Fleet vehicle consumption rows (/saas/vehicles)
`get_vehicles_consumption_summary`	Data	Fleet consumption and emissions summary
`create_invoice`	Action	Create or update facility invoice(s). One record or `{ records: [...] }` (max 50)
`create_expense`	Action	Create or update purchase expense(s). One record or `{ records: [...] }` (max 25)
`create_business_travel`	Action	Create or update business travel record(s). One record or `{ records: [...] }` (max 100)
`create_vehicle_consumption`	Action	Create vehicle consumption record(s). One record or `{ records: [...] }` (max 50)

Action tools require userConfirmed: false then userConfirmed: true after approval.

Batch create actions

For JSON imports without a spreadsheet, pass multiple items in one call:

{
  "records": [
    { "...": "first record fields" },
    { "...": "second record fields" }
  ],
  "userConfirmed": true
}

Rules:

One tool call per import — do not loop create_* or spawn parallel agents for the same load.
Spreadsheets or 100+ rows → use apply_excel_bulk (integrations skill) with source.type=attachment.
Above per-tool caps → chunk into multiple { records } calls or switch to apply_excel_bulk.
Batch responses are compact: total, succeeded, failed, errorsSample (not full per-row payloads).

Usage Examples

"How much electricity did we consume in 2024?"
→ list_consumptions({ startDate: "2024-01-01", endDate: "2024-12-31" })
→ get_invoice_summary({ startDate: "2024-01-01", endDate: "2024-12-31" })

"List electricity invoices for this quarter"
→ get_electricity_by_cup({ startDate: "2024-10-01", endDate: "2024-12-31" })

"Business travel emissions by transport type"
→ get_business_travel_summary({ startDate: "2024-01-01", endDate: "2024-12-31" })

Use summary tools for dashboards and list_* tools for row-level detail.