Viajes de negocio

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ámetro	Requerido	Descripción
`companyId`	Sí	ID de la empresa
`buildingIds`	No	Filtrar por edificio o sede
`page`	No	Número de página
`limit`	No	Resultados 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

Campo	Tipo	Requerido	Descripción
`id`	`uuid`	Sí	Identificador único del viaje
`companyId`	`uuid`	Sí	ID de la empresa
`employeeId`	`uuid`	No	ID del empleado que realiza el viaje
`origin`	`string`	Sí	Ciudad o aeropuerto de origen
`destination`	`string`	Sí	Ciudad o aeropuerto de destino
`transportType`	`string`	Sí	Tipo de transporte (ver tabla de valores)
`travelClass`	`string`	No	Clase del viaje: `economy`, `business`, `first` (para vuelos)
`date`	`date`	Sí	Fecha del viaje (`YYYY-MM-DD`)
`returnTrip`	`boolean`	No	Si incluye el viaje de vuelta (`true` / `false`)

Tipos de transporte disponibles

Valor	Descripción
`flight`	Vuelo comercial
`train`	Tren de pasajeros
`car`	Vehículo de empresa o alquiler
`taxi`	Taxi o VTC
`bus`	Autobús
`ferry`	Ferry 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"

Introducción

API REST

Guías de integración

Ejemplos

MCP (Model Context Protocol)

MCP Tools

Integraciones MCP

Listar viajes de negocio

Parámetros

Respuesta

Crear o actualizar un viaje de negocio

Campos

Tipos de transporte disponibles

Dashboard de viajes de negocio

Más información

​Listar viajes de negocio

​Parámetros

​Respuesta

​Crear o actualizar un viaje de negocio

​Campos

​Tipos de transporte disponibles

​Dashboard de viajes de negocio

​Más información

Listar viajes de negocio

Parámetros

Respuesta

Crear o actualizar un viaje de negocio

Campos

Tipos de transporte disponibles

Dashboard de viajes de negocio

Más información