> ## Documentation Index
> Fetch the complete documentation index at: https://developers.manglai.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Viajes de negocio

> Sincroniza los viajes corporativos de tus empleados y obtén las emisiones de Scope 3 por tipo de transporte

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:

```bash theme={null}
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

```json theme={null}
{
  "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.

```bash theme={null}
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                  |

<Tip>
  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.
</Tip>

## 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:

```bash theme={null}
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

* [Referencia completa del endpoint Business Travels →](/api-reference)
* [Autenticación →](/authentication)
* [GHG Protocol — Scope 3 Category 6](https://ghgprotocol.org/scope-3-technical-calculation-guidance)