Tools — Consumos - Manglai API Documentation

Tools disponibles

Tool	Tipo	Descripción
`list_consumptions`	Datos	Consumos en un rango de fechas
`list_consumptions_by_external_id`	Datos	Consumos por id externo
`list_invoices`	Datos	Líneas de factura (paginado)
`get_invoice_summary`	Datos	Resumen de facturas
`get_electricity_by_cup`	Datos	Facturas de electricidad por CUPS
`get_expenses_summary`	Datos	Dashboard de costes / gastos
`list_purchases_goods_and_services`	Datos	Compras de bienes y servicios
`get_purchases_goods_and_services_summary`	Datos	Dashboard de compras
`list_business_travels`	Datos	Viajes de negocio
`get_business_travel_summary`	Datos	Dashboard de viajes
`list_logistics`	Datos	Consumos de logística de proveedores (/saas/logistics)
`list_vehicle_consumptions`	Datos	Consumos de flota (/saas/vehicles)
`get_vehicles_consumption_summary`	Datos	Resumen de consumo y emisiones de flota
`create_invoice`	Acción	Crear o actualizar factura(s) de instalación. Un registro o `{ records: [...] }` (máx. 50)
`create_expense`	Acción	Crear o actualizar gasto(s) de compra. Un registro o `{ records: [...] }` (máx. 25)
`create_business_travel`	Acción	Crear o actualizar viaje(s) de negocio. Un registro o `{ records: [...] }` (máx. 100)
`create_vehicle_consumption`	Acción	Crear consumo(s) de vehículo. Un registro o `{ records: [...] }` (máx. 50)

Las tools de acción piden userConfirmed: false y luego userConfirmed: true tras la aprobación.

Creación por lotes

Para importar JSON sin Excel, envía varios registros en una sola llamada:

{
  "records": [
    { "...": "campos del primer registro" },
    { "...": "campos del segundo registro" }
  ],
  "userConfirmed": true
}

Reglas:

Una llamada por importación — no repitas create_* en bucle ni lances agentes paralelos para la misma carga.
Hojas de cálculo o 100+ filas → usa apply_excel_bulk (skill integrations) con source.type=attachment.
Por encima del límite por tool → trocea en varias llamadas { records } o usa apply_excel_bulk.
La respuesta del lote es compacta: total, succeeded, failed, errorsSample (sin devolver todos los objetos).

Ejemplos

"¿Cuánta electricidad consumimos en 2024?"
→ list_consumptions({ startDate: "2024-01-01", endDate: "2024-12-31" })
→ get_invoice_summary({ startDate: "2024-01-01", endDate: "2024-12-31" })

"Lista las facturas de electricidad de este trimestre"
→ get_electricity_by_cup({ startDate: "2024-10-01", endDate: "2024-12-31" })

"Emisiones de viajes de negocio por medio de transporte"
→ get_business_travel_summary({ startDate: "2024-01-01", endDate: "2024-12-31" })

Usa las tools de resumen para dashboards y las list_* para el detalle por fila.