La **API de EnvioXEnvio (ExE)** permite gestionar de forma completa el proceso de cotización y contratación de servicios de transporte para tus envíos, tanto a nivel nacional como internacional.

### 📦 Funcionalidades principales

- **Tarifas**  
  Crear tarifas inmediatas indicando origen, destino y características de la carga.  
  Consultar el listado de tarifas creadas ('GET /rates') o recuperar una tarifa específica ('GET /rates/{id}').

- **Pedidos**  
  Crear pedidos a partir de una tarifa ('POST /orders') o manualmente con todos los datos.  
  Consultar todos los pedidos o uno concreto ('GET /orders', 'GET /orders/{id}').

- **Direcciones**  
  Gestionar direcciones reutilizables para recogida o entrega ('GET', 'POST', 'PUT', 'GET /addresses/{id}').

- **Autenticación**  
  Todas las rutas requieren una clave de API en el header. Puedes usar:
  
  - Entorno de **producción**:
    ```
    x-api-key: TU_CLAVE_DE_PRODUCCION
    ```

  - Entorno de **test**:
    ```
    test-api-key: TU_CLAVE_DE_TEST
    ```

  > ⚠️ No incluyas ambas en la misma petición. Usa solo una.

---

### 🧪 Entorno de pruebas (modo test)

El modo test permite probar todas las funcionalidades de la API sin afectar tus datos reales.  
Utiliza una base de datos independiente y permite crear tarifas, pedidos y direcciones simuladas.

Para solicitar una clave de test, contacta con nuestro equipo:  
👉 [https://envioxenvio.es/contacto](https://envioxenvio.es/contacto)

---

### 🔧 Datos que componen una tarifa

Las tarifas se definen mediante:

- **Origen / Destino**: ciudad, código postal, país (formato ISO 3166-1 alpha-2).  
- **Cargas ('loads')**: unidades, dimensiones (largo, ancho, alto), peso, y si es remontable.  
- **Extras**: carga lateral, plataforma elevadora (pickup y entrega), mercancía ADR, envío no transferible...

> ℹ️ A partir de la versión **1.0.1**, ya **no es necesario enviar** los campos `shipmentType` ni `expressVehicleType`. Se calculan automáticamente en base a las cargas.

**Ejemplo de creación de tarifa:**

```json
{
  "originPostalCode": "08001",
  "originCountry": "ES",
  "destinationPostalCode": "28001",
  "destinationCountry": "ES",
  "loads": [
    {
      "units": 1,
      "length": 120,
      "width": 100,
      "height": 150,
      "weight": 300,
      "isRemontable": true
    }
  ],
  "pickupTailLift": false,
  "deliveryTailLift": true,
  "isAdr": false,
  "lateralLoad": false,
  "nonTransferable": false,
  "rateType": "rate_by_loads"
}
```

---

### 📘 Histórico de versiones

- **v1.0.2** *(actual — 26 de junio de 2025, 13:31)*  
  - Añadido soporte para modo test mediante `test-api-key`  
  - Documentado cómo usar el entorno de pruebas sin afectar los datos reales  
  - Mejora de validaciones y descripción más clara

- **v1.0.1** *(25 de junio de 2025, 17:07)*  
  - Eliminados los campos `shipmentType` y `expressVehicleType` del body: ahora se calculan automáticamente en base a las cargas

- **v1.0.0** *(8 de junio de 2024, 21:34)*  
  - Versión inicial de la API: creación y consulta de tarifas, órdenes y direcciones

ExE API

Integra nuestra API en tu sistema y empieza a disfrutar de todas las ventajas que ofrece Envio x Envio. Cotización instantánea, gestión de envíos, seguimiento y mucho más.

API de Envio x Envio - La transitaria digital de Europa

Referencia de la API

Contratación de transporte instantánea a toda Europa

¿A qué esperas? És gratis y sin registros

¿Todavía no has probado nuestro cotizador instántaneo?

Nos adaptamos a tus condiciones de pago. Paga por recibo domiciliado o transferencia bancaria.

FACILIDAD DE PAGOS

Deja que nuestros algoritmos y nuestros automatismos trabajen por ti, sin margen de error.

GESTIÓN EXCELENTE

Plantamos 1 árbol por cada envío que realizamos! Así compensamos las emisiones de CO2.

SOMOS VERDES

Presupuesta tu mismo cualquier servicio de transporte terrestre. Sin esperas!

PRECIOS INSTANTANEOS

Contamos con una amplia red de acuerdos en toda Europa, Transitorios, Fletistas, Almacenes...

GARANTÍAS INTERNACIONALES

Sea la hora que sea, contrata grupaje internacional de manera Online, fácil, rápida y segura.

CONTRATACIÓN SIN ESPERAS

A tu disposición documentos de Entrega, CMR's y Albaranes escaneados en tu Área de Cliente.

DOCUMENTACIÓN ONLINE

Puedes consultar la situación y trazabilidad de tus envíos con total fiabilidad desde tu Área Cliente.

SEGUIMIENTO ONLINE

Todas nuestras ventajas a tu disposición

Obtén insights valiosos a través de análisis de datos avanzados.

Analítica de datos

Realiza múltiples cotizaciones de manera eficiente.

Cotizaciones de forma masiva

Accede y gestiona toda la documentación relacionada con tus envíos.

Documentación, CMRs y PODs

Registra y gestiona tus órdenes de carga fácilmente.

Grabar Órdenes de Carga

Obtén cotizaciones en tiempo real para tus envíos.

Cotizaciones Instantáneas

Sigue el estado y la ubicación de tus envíos en tiempo real.

Estado de tus envíos y tracking

Beneficios de integrar nuestra API en tu sistema:

Integrate con nuestro sistema instantaneo de precios de grupaje a toda Europa, alimentado con IA.