Saltar al contenido principal

​
Descripción

Los consumos son el registro de energía, combustibles o actividad (ej. km recorridos). A partir de ellos se calculan las emisiones según GHG Protocol.

​
Endpoints

MétodoRutaDescripción
GET/api/v1/consumptionsListar consumos
GET/api/v1/consumptions/{id}Obtener un consumo
POST/api/v1/consumptionsCrear o actualizar consumo
GET/api/v1/consumptions/dashboardDashboard de consumos

​
Tipos de consumos

  • Facturas: Electricidad, calor, combustibles, agua, residuos
  • Vehículos: Consumo de flota
  • Encuestas: Datos de actividad manual

​
Campos requeridos para crear consumo

  • id (UUID)
  • entityId (invoice, vehicle o survey answer)
  • categoryId (de GET /api/v1/categories)
  • startDate, endDate (ISO 8601)
  • companyId, buildingId
  • quantity, unitType (kWh, l, km, etc.)

​
Ejemplo

curl -X POST "https://www.manglai.io/api/v1/consumptions" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "entityId": "invoice-123",
    "categoryId": "668f3fcb-7fb0-4b65-b77d-9303c551632f",
    "startDate": "2024-01-01T00:00:00.000Z",
    "endDate": "2024-01-31T23:59:59.999Z",
    "companyId": "1b1e07a7-083d-4831-a1d2-84b6e93a1572",
    "buildingId": "7fef7760-f9e7-4de9-ae35-8c37db65e4a3",
    "quantity": 1500.5,
    "unitType": "kWh"
  }'