Manglai calcula las emisiones de tus operaciones logísticas siguiendo el estándar GLEC Framework e ISO 14083, el marco de referencia internacional para la huella de carbono del transporte de mercancías.
Puedes registrar servicios con vehículos propios (flota interna), vehículos de terceros o clasificaciones genéricas por tipo de transporte (camión, vuelo, tren, furgoneta).
Listar servicios logísticos
GET /api/v1/service-footprint/glec
Obtén todos los servicios logísticos registrados en un periodo:
curl -X GET "https://www.manglai.io/api/v1/service-footprint/glec\
?companyId=1b1e07a7-083d-4831-a1d2-84b6e93a1572\
&startDate=2024-01-01\
&endDate=2024-12-31" \
-H "Authorization: Bearer TU_TOKEN_AQUI"
Parámetros
| Parámetro | Requerido | Descripción |
|---|
companyId | Sí | ID de la empresa |
startDate | Sí | Fecha de inicio del periodo (formato YYYY-MM-DD) |
endDate | Sí | Fecha de fin del periodo (formato YYYY-MM-DD) |
supplierId | No | Filtrar por proveedor de transporte |
vehicleId | No | Filtrar por vehículo concreto |
externalId | No | Filtrar por ID externo (referencia de tu sistema) |
Crear un servicio logístico
POST /api/v1/service-footprint/glec
Registra un servicio de transporte con uno o más tramos (acciones). Manglai calcula automáticamente las emisiones CO₂e de cada tramo siguiendo GLEC / ISO 14083.
curl -X POST "https://www.manglai.io/api/v1/service-footprint/glec" \
-H "Authorization: Bearer TU_TOKEN_AQUI" \
-H "Content-Type: application/json" \
-d '{
"id": "c5b87f15-33ed-4522-90eb-d23473ab911d",
"clientId": "d0486f00-d1fc-4f96-95d3-155b038e98a7",
"startDate": "2024-07-03",
"endDate": "2024-07-18",
"from": "Granada, Spain",
"to": "Barcelona, Spain",
"actions": [
{
"id": "ba7b8856-2ee7-43b4-ae42-9017a0bc273b",
"externalId": "SHIP-001",
"mode": "internal",
"vehicleType": "hgv_diesel",
"transportType": "articulated",
"vehicleTransportSize": "40_t_gvw",
"from": "Granada, Spain",
"to": "Barcelona, Spain",
"distance": "842.021",
"load": 18000,
"loadUnit": "kg"
}
]
}'
Campos del servicio
| Campo | Tipo | Requerido | Descripción |
|---|
id | uuid | Sí | Identificador único del servicio |
clientId | uuid | Sí | ID del cliente o proveedor de transporte |
startDate | date | Sí | Inicio del servicio (YYYY-MM-DD) |
endDate | date | Sí | Fin del servicio (YYYY-MM-DD) |
from | string | No | Origen del servicio |
to | string | No | Destino del servicio |
externalId | string | No | Referencia en tu sistema externo |
Campos de cada tramo (action)
| Campo | Tipo | Descripción |
|---|
id | uuid | Identificador único del tramo |
mode | internal | external | Flota propia o subcontratada |
vehicleType | string | hgv_diesel, vans, flight, train |
transportType | string | rigid, articulated, average, freighter, bellyFreight |
vehicleTransportSize | string | Tamaño del vehículo, p. ej. 40_t_gvw |
from / to | string | Origen y destino del tramo |
distance | string | Distancia en km |
load | number | Carga transportada |
loadUnit | kg | mt | Unidad de la carga |
vehicleId | uuid | ID de vehículo propio (alternativo a vehicleType) |
energyQuantity | string | Consumo real de energía o combustible |
energyQuantityUnit | string | l, kg, kwh, l/km, kg/km, kwh/km |
Si tienes la flota registrada en Manglai, puedes usar vehicleId directamente y omitir vehicleType, transportType y vehicleTransportSize.
