Emisiones logísticas GLEC / ISO 14083

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",
        "toc": "road-level3-packed_ftl_ambient"
      }
    ]
  }'

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`
`toc`	`string`	Clasificación TOC del tramo según GLEC v3.2 / ISO 14083. Ver Clasificación TOC

Si tienes la flota registrada en Manglai, puedes usar vehicleId directamente y omitir vehicleType, transportType y vehicleTransportSize.

Clasificación TOC (GLEC v3.2 / ISO 14083)

El campo toc (Transport Operation Category) clasifica la operación de transporte de un tramo según el tipo de carga y el régimen de temperatura. Cuando lo envías, Manglai aplica el factor de emisión específico de esa operación definido por el GLEC Framework v3.2 e ISO 14083, en lugar del factor medio del tipo de vehículo. Es el método de cálculo más preciso disponible. Puntos clave:

Se envía dentro de cada tramo (actions[]), como string. No existe a nivel de servicio.
Es opcional: si no lo envías, las emisiones se calculan por los métodos de consumo y distancia.
El valor debe pertenecer al mismo modo de transporte que el vehículo del tramo (ver tabla siguiente).

Formato del identificador

Todos los valores siguen el patrón:

<modo>-level<nivel>-<clasificación>

Parte	Valores	Significado
`modo`	`road`, `train`, `sea`, `inland_waterway`	Modo de transporte del tramo
`nivel`	`level1`, `level2`, `level3`	Nivel de detalle de la clasificación
`clasificación`	p. ej. `packed_ftl_ambient`	Tipo de carga, operación y temperatura

Los tres niveles corresponden a la jerarquía del GLEC Framework:

Nivel 1 — Media del sector: no conoces el tipo de carga. Factor medio de todo el modo de transporte.
Nivel 2 — Media por tipo de carga: sabes si la carga es empaquetada o a granel (y si va a temperatura ambiente o controlada), pero no la operación concreta.
Nivel 3 — Operación específica: conoces la operación exacta (carga completa, grupaje, cisterna, tipo de buque…). Es el factor más preciso.

Envía siempre el nivel más alto que puedas justificar con datos reales: nivel 3 si conoces la operación, nivel 2 si solo conoces el tipo de carga.

Qué familia de valores usar según el vehículo

`vehicleType` del tramo	Familia de valores `toc`
`hgv_diesel`, `hgv_refrigerated_diesel`, `vans`	`road-*`
`train`	`train-*`
`cargo_ship`, `sea_tanker`	`sea-*`
Barcazas fluviales	`inland_waterway-*`
`flight`	No aplica: los vuelos no tienen clasificación TOC

Si envías un valor de una familia que no corresponde al vehículo del tramo (p. ej. un toc de tren en un tramo de camión), no existirá factor de emisión para esa combinación y el tramo no tendrá emisión calculada por el método TOC.

Valores válidos — Carretera (`road`)

Carga empaquetada:

Nivel	Valor	Significado
1	`road-level1-overall_sector_average`	Media del sector
2	`road-level2-packed_average_ambient`	Empaquetada · Promedio · T. ambiente
2	`road-level2-packed_average_temperature_controlled`	Empaquetada · Promedio · T. controlada
3	`road-level3-packed_ftl_ambient`	Empaquetada · Carga completa · T. ambiente
3	`road-level3-packed_ftl_temperature_controlled`	Empaquetada · Carga completa · T. controlada
3	`road-level3-packed_partial_load_ambient`	Empaquetada · Carga parcial · T. ambiente
3	`road-level3-packed_partial_load_temperature_controlled`	Empaquetada · Carga parcial · T. controlada
3	`road-level3-packed_groupage_ambient`	Empaquetada · Grupaje · T. ambiente
3	`road-level3-packed_groupage_temperature_controlled`	Empaquetada · Grupaje · T. controlada

Carga a granel:

Nivel	Valor	Significado
2	`road-level2-bulk_average_ambient`	Granel · Promedio · T. ambiente
2	`road-level2-bulk_average_temperature_controlled`	Granel · Promedio · T. controlada
3	`road-level3-bulk_tank_truck_ambient`	Granel · Cisterna · T. ambiente
3	`road-level3-bulk_tank_truck_temperature_controlled`	Granel · Cisterna · T. controlada
3	`road-level3-bulk_tank_truck_dedicated_ambient`	Granel · Cisterna dedicada · T. ambiente
3	`road-level3-bulk_tank_truck_dedicated_temperature_controlled`	Granel · Cisterna dedicada · T. controlada
3	`road-level3-bulk_hopper_silo_ambient`	Granel · Tolva/silo · T. ambiente
3	`road-level3-bulk_hopper_silo_temperature_controlled`	Granel · Tolva/silo · T. controlada
3	`road-level3-bulk_hopper_silo_dedicated_ambient`	Granel · Tolva/silo dedicado · T. ambiente
3	`road-level3-bulk_hopper_silo_dedicated_temperature_controlled`	Granel · Tolva/silo dedicado · T. controlada
3	`road-level3-bulk_tank_container_ambient`	Granel · Contenedor cisterna · T. ambiente
3	`road-level3-bulk_tank_container_temperature_controlled`	Granel · Contenedor cisterna · T. controlada
3	`road-level3-bulk_tank_container_dedicated_ambient`	Granel · Contenedor cisterna dedicado · T. ambiente
3	`road-level3-bulk_tank_container_dedicated_temperature_controlled`	Granel · Contenedor cisterna dedicado · T. controlada

Valores válidos — Tren (`train`)

Nivel	Valor	Significado
1	`train-level1-overall_sector_average`	Media del sector
2	`train-level2-container_train_intermodal_average`	Tren contenedor (intermodal) · Media
3	`train-level3-container_train_intermodal_diesel`	Tren contenedor (intermodal) · Diésel
3	`train-level3-container_train_intermodal_electric`	Tren contenedor (intermodal) · Eléctrico
2	`train-level2-blocktrain_rtc_average`	Block train RTC · Media
3	`train-level3-blocktrain_rtc_diesel`	Block train RTC · Diésel
3	`train-level3-blocktrain_rtc_electric`	Block train RTC · Eléctrico
2	`train-level2-single_wagon_train_rtc_average`	Vagón único RTC · Media
3	`train-level3-single_wagon_train_rtc_diesel`	Vagón único RTC · Diésel
3	`train-level3-single_wagon_train_rtc_electric`	Vagón único RTC · Eléctrico

Valores válidos — Marítimo (`sea`)

Todos los valores marítimos son de nivel 3 (por tipo de buque y tamaño):

Valor	Significado
`sea-level3-chemical_tanker_0_4999_dwt`	Quimiquero · 0–4.999 DWT
`sea-level3-chemical_tanker_5000_9999_dwt`	Quimiquero · 5.000–9.999 DWT
`sea-level3-chemical_tanker_10000_19999_dwt`	Quimiquero · 10.000–19.999 DWT
`sea-level3-chemical_tanker_20000_39999_dwt`	Quimiquero · 20.000–39.999 DWT
`sea-level3-chemical_tanker_40000_plus_dwt`	Quimiquero · 40.000+ DWT
`sea-level3-general_cargo_0_4999_dwt`	Carga general · 0–4.999 DWT
`sea-level3-general_cargo_5000_9999_dwt`	Carga general · 5.000–9.999 DWT
`sea-level3-general_cargo_10000_19999_dwt`	Carga general · 10.000–19.999 DWT
`sea-level3-general_cargo_20000_plus_dwt`	Carga general · 20.000+ DWT
`sea-level3-gas_tanker_0_49999_cbm`	Gasero · 0–49.999 CBM
`sea-level3-gas_tanker_50000_99999_cbm`	Gasero · 50.000–99.999 CBM
`sea-level3-gas_tanker_100000_199999_cbm`	Gasero · 100.000–199.999 CBM
`sea-level3-gas_tanker_200000_plus_cbm`	Gasero · 200.000+ CBM
`sea-level3-container_iso_tank_ambient`	Contenedor ISO tanque · T. ambiente
`sea-level3-container_iso_tank_temp_controlled`	Contenedor ISO tanque · T. controlada
`sea-level3-container_20_foot_ambient`	Contenedor 20’ · T. ambiente
`sea-level3-container_20_foot_temp_controlled`	Contenedor 20’ · T. controlada
`sea-level3-container_40_foot_ambient`	Contenedor 40’ · T. ambiente
`sea-level3-container_40_foot_temp_controlled`	Contenedor 40’ · T. controlada

Valores válidos — Fluvial (`inland_waterway`)

Nivel	Valor	Significado
2	`inland_waterway-level2-bulk_tanker_average`	Granelero/tanquero · Media
3	`inland_waterway-level3-tanker_barge_liquid`	Barcaza tanque · Líquidos
3	`inland_waterway-level3-tanker_barge_gas`	Barcaza tanque · Gas
2	`inland_waterway-level2-container_vessel_average`	Buque contenedor · Media
3	`inland_waterway-level3-container_vessel_110m`	Buque contenedor · 110 m
3	`inland_waterway-level3-container_vessel_135m`	Buque contenedor · 135 m
2	`inland_waterway-level2-dry_barge_average`	Gabarra seca · Media

Crear un servicio con TOC

Ejemplo de un tramo por carretera con carga empaquetada a camión completo y temperatura ambiente (nivel 3):

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",
    "companyId": "1b1e07a7-083d-4831-a1d2-84b6e93a1572",
    "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",
        "mode": "external",
        "vehicleType": "hgv_diesel",
        "transportType": "articulated",
        "vehicleTransportSize": "40_t_gvw",
        "from": "Granada, Spain",
        "to": "Barcelona, Spain",
        "distance": "842.021",
        "load": 18000,
        "loadUnit": "kg",
        "toc": "road-level3-packed_ftl_ambient"
      }
    ]
  }'

En la respuesta, la emisión calculada por este método aparece en sourceEmission.toc (total del servicio) y en actions[].sourceEmission.toc (por tramo), junto a las de los métodos de consumo (energy) y distancia (distance).

Añadir TOC a servicios ya registrados

El POST funciona como upsert: si el id ya existe, reemplaza el servicio completo y recalcula todas sus emisiones. Para añadir toc a servicios ya subidos, el flujo es:

Recupera el servicio con el GET (conserva su id y los id de cada tramo).
Añade el campo toc a cada elemento de actions[].
Reenvía el documento completo con el mismo id — no solo el campo nuevo: los campos que no reenvíes se perderán.

# 1. Recuperar el servicio (puedes filtrar por externalId de tu sistema)
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\
&externalId=EXP-2024-001" \
  -H "Authorization: Bearer TU_TOKEN_AQUI"

# 2. Reenviar el servicio completo con "toc" añadido en cada tramo
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",
    "companyId": "1b1e07a7-083d-4831-a1d2-84b6e93a1572",
    "clientId": "d0486f00-d1fc-4f96-95d3-155b038e98a7",
    "externalId": "EXP-2024-001",
    "startDate": "2024-07-03",
    "endDate": "2024-07-18",
    "from": "Granada, Spain",
    "to": "Barcelona, Spain",
    "actions": [
      {
        "id": "ba7b8856-2ee7-43b4-ae42-9017a0bc273b",
        "mode": "external",
        "vehicleType": "hgv_diesel",
        "transportType": "articulated",
        "vehicleTransportSize": "40_t_gvw",
        "from": "Granada, Spain",
        "to": "Barcelona, Spain",
        "distance": "842.021",
        "load": 18000,
        "loadUnit": "kg",
        "toc": "road-level3-packed_ftl_ambient"
      }
    ]
  }'

Reenvía siempre todos los campos que devolvió el GET (distancia, consumo, matrícula…). El POST no hace una actualización parcial: sobreescribe el servicio con exactamente lo que envíes.

Introducción

API REST

Guías de integración

Ejemplos

MCP (Model Context Protocol)

MCP Tools

Integraciones MCP

Listar servicios logísticos

Parámetros

Crear un servicio logístico

Campos del servicio

Campos de cada tramo (action)

Clasificación TOC (GLEC v3.2 / ISO 14083)

Formato del identificador

Qué familia de valores usar según el vehículo

Valores válidos — Carretera (`road`)

Valores válidos — Tren (`train`)

Valores válidos — Marítimo (`sea`)

Valores válidos — Fluvial (`inland_waterway`)

Crear un servicio con TOC

Añadir TOC a servicios ya registrados

Más información

​Listar servicios logísticos

​Parámetros

​Crear un servicio logístico

​Campos del servicio

​Campos de cada tramo (action)

​Clasificación TOC (GLEC v3.2 / ISO 14083)

​Formato del identificador

​Qué familia de valores usar según el vehículo

​Valores válidos — Carretera (road)

​Valores válidos — Tren (train)

​Valores válidos — Marítimo (sea)

​Valores válidos — Fluvial (inland_waterway)

​Crear un servicio con TOC

​Añadir TOC a servicios ya registrados

​Más información

Listar servicios logísticos

Parámetros

Crear un servicio logístico

Campos del servicio

Campos de cada tramo (action)

Clasificación TOC (GLEC v3.2 / ISO 14083)

Formato del identificador

Qué familia de valores usar según el vehículo

Valores válidos — Carretera (`road`)

Valores válidos — Tren (`train`)

Valores válidos — Marítimo (`sea`)

Valores válidos — Fluvial (`inland_waterway`)

Crear un servicio con TOC

Añadir TOC a servicios ya registrados

Más información