Saltar al contenido principal
Registra los viajes de negocio de tus empleados y Manglai calculará automáticamente las emisiones de Scope 3 — Categoría 6 (Viajes de negocio) según el GHG Protocol. Esto incluye vuelos, trenes, taxis, vehículos de empresa y cualquier desplazamiento corporativo con su huella de carbono asociada.

​
Listar viajes de negocio

GET /api/v1/business-travels Obtén todos los viajes registrados de una empresa: 
curl -X GET "https://www.manglai.io/api/v1/business-travels\
?companyId=1b1e07a7-083d-4831-a1d2-84b6e93a1572" \
  -H "Authorization: Bearer TU_TOKEN_AQUI"

​
Parámetros

ParámetroRequeridoDescripción
companyIdSíID de la empresa
buildingIdsNoFiltrar por edificio o sede
pageNoNúmero de página
limitNoResultados por página

​
Respuesta

{
  "data": [
    {
      "id": "7f4e2100-ab34-4d12-b8c3-112233445566",
      "employeeId": "e1234567-abcd-4ef0-8901-fedcba987654",
      "origin": "Madrid, Spain",
      "destination": "London, UK",
      "transportType": "flight",
      "date": "2024-04-10",
      "emissions": {
        "co2e": 187.4,
        "unit": "kg"
      }
    }
  ],
  "total": 42,
  "page": 1
}

​
Crear o actualizar un viaje de negocio

POST /api/v1/business-travels Este endpoint es idempotente: si ya existe un viaje con el mismo id, se actualiza. Si no existe, se crea. 
curl -X POST "https://www.manglai.io/api/v1/business-travels" \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "7f4e2100-ab34-4d12-b8c3-112233445566",
    "companyId": "1b1e07a7-083d-4831-a1d2-84b6e93a1572",
    "employeeId": "e1234567-abcd-4ef0-8901-fedcba987654",
    "origin": "Madrid, Spain",
    "destination": "London, UK",
    "transportType": "flight",
    "travelClass": "economy",
    "date": "2024-04-10",
    "returnTrip": true
  }'

​
Campos

CampoTipoRequeridoDescripción
iduuidSíIdentificador único del viaje
companyIduuidSíID de la empresa
employeeIduuidNoID del empleado que realiza el viaje
originstringSíCiudad o aeropuerto de origen
destinationstringSíCiudad o aeropuerto de destino
transportTypestringSíTipo de transporte (ver tabla de valores)
travelClassstringNoClase del viaje: economy, business, first (para vuelos)
datedateSíFecha del viaje (YYYY-MM-DD)
returnTripbooleanNoSi incluye el viaje de vuelta (true / false)

​
Tipos de transporte disponibles

ValorDescripción
flightVuelo comercial
trainTren de pasajeros
carVehículo de empresa o alquiler
taxiTaxi o VTC
busAutobús
ferryFerry o barco
Para vuelos, Manglai calcula la distancia automáticamente a partir del origen y destino (ciudad o código IATA). Puedes también proporcionar la distancia directamente si la conoces.

​
Dashboard de viajes de negocio

GET /api/v1/business-travels/dashboard Obtén un resumen agregado de las emisiones por tipo de transporte y periodo: 
curl -X GET "https://www.manglai.io/api/v1/business-travels/dashboard\
?companyId=1b1e07a7-083d-4831-a1d2-84b6e93a1572\
&startDate=2024-01-01\
&endDate=2024-12-31" \
  -H "Authorization: Bearer TU_TOKEN_AQUI"

​
Más información