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"
