Subida de facturas

Manglai permite subir facturas de suministros (electricidad, gas, agua, combustibles, residuos…) y calcular automáticamente la huella ambiental asociada mediante IA. El proceso es simple: subes el archivo y la plataforma extrae los datos y genera los consumos correspondientes.

¿Qué calcula Manglai?

A partir de una factura, Manglai calcula:

Huella de carbono — emisiones de CO₂e por consumo energético o de combustibles
Huella hídrica — consumo y estrés hídrico asociado
Gestión de residuos — impacto ambiental por tipo y método de tratamiento

Subir una factura con escaneo IA

POST /api/v1/invoices/upload-invoice Este endpoint acepta un archivo en multipart/form-data. La IA de Manglai extrae automáticamente el proveedor, periodo, consumo y coste.

curl -X POST "https://www.manglai.io/api/v1/invoices/upload-invoice" \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -F "companyId=1b1e07a7-083d-4831-a1d2-84b6e93a1572" \
  -F "file=@factura-electricidad-enero-2024.pdf"

Respuesta

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "electricity",
  "companyId": "1b1e07a7-083d-4831-a1d2-84b6e93a1572",
  "startDate": "2024-01-01T00:00:00.000Z",
  "endDate": "2024-01-31T23:59:59.999Z",
  "totalCost": 1240.50,
  "currency": "EUR",
  "status": "scanned",
  "emissions": {
    "co2e": 342.8,
    "unit": "kg"
  }
}

Crear una factura manualmente

Si prefieres introducir los datos directamente sin escaneo, usa POST /api/v1/invoices:

curl -X POST "https://www.manglai.io/api/v1/invoices" \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "electricity",
    "companyId": "1b1e07a7-083d-4831-a1d2-84b6e93a1572",
    "totalCost": 1240.50,
    "currency": "EUR",
    "startDate": "2024-01-01T00:00:00.000Z",
    "endDate": "2024-01-31T23:59:59.999Z"
  }'

Campos requeridos

Campo	Tipo	Descripción
`id`	`uuid`	Identificador único de la factura (generado por ti)
`type`	`string`	Tipo de factura: `electricity`, `heat`, `fuel`, `water`, `wastes`, `others`…
`companyId`	`uuid`	ID de la empresa a la que pertenece la factura
`totalCost`	`number`	Coste total de la factura
`currency`	`string`	Moneda: `EUR`, `USD`, etc.
`startDate`	`date`	Inicio del periodo de consumo
`endDate`	`date`	Fin del periodo de consumo

Para facturas de tipo wastes, también son necesarios wasteType y wasteDisposalMethod.

Listar facturas

GET /api/v1/invoices

curl -X GET "https://www.manglai.io/api/v1/invoices?companyId=1b1e07a7-083d-4831-a1d2-84b6e93a1572" \
  -H "Authorization: Bearer TU_TOKEN_AQUI"

Introducción

API REST

Guías de integración

Ejemplos

MCP (Model Context Protocol)

MCP Tools

Integraciones MCP

¿Qué calcula Manglai?

Subir una factura con escaneo IA

Respuesta

Crear una factura manualmente

Campos requeridos

Listar facturas

Más información

​¿Qué calcula Manglai?

​Subir una factura con escaneo IA

​Respuesta

​Crear una factura manualmente

​Campos requeridos

​Listar facturas

​Más información

¿Qué calcula Manglai?

Subir una factura con escaneo IA

Respuesta

Crear una factura manualmente

Campos requeridos

Listar facturas

Más información