Plantillas reutilizables

¿Para qué sirven las plantillas?

Si tu empresa realiza rutas similares con frecuencia (mismos orígenes, destinos, tipos de mercancía o transportistas), las plantillas (ecmr-templates) te permiten precargar toda esa configuración y crear un eCMR en un solo paso.

Cada plantilla pertenece a una compañía y puede contener: direcciones de origen/destino, tipo de vehículo, descripción de mercancía, transportista habitual, etc.

1. Crear una plantilla

POST /ecmr-templates 📖
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "Ruta Madrid-Barcelona",
  "etd_name": "Almacén Madrid",
  "etl_address": "ID_DIR_BARCELONA",
  "vehicle_type": "tir",
  "cargo_description": "Mercancía general en palets",
  "cargo_type": "back"
}

2. Listar y consultar plantillas

GET /ecmr-templates 📖
Authorization: Bearer <token>
# Lista las plantillas de tu compañía

GET /ecmr-templates/all 📖
Authorization: Bearer <token>
# Lista todas las plantillas (admin)

GET /ecmr-templates/{id} 📖
Authorization: Bearer <token>
# Detalle de una plantilla

3. Duplicar plantilla

Para crear variaciones sin partir de cero:

POST /ecmr-templates/duplicate 📖
Authorization: Bearer <token>
Content-Type: application/json

{
  "templateId": "ID_PLANTILLA_ORIGINAL",
  "name": "Ruta Madrid-Barcelona (Express)"
}

4. Actualizar y eliminar

PUT /ecmr-templates/{id} 📖
Authorization: Bearer <token>
Content-Type: application/json

{ "name": "Ruta actualizada", "cargo_description": "Nueva mercancía" }


DEL /ecmr-templates/{id} 📖
Authorization: Bearer <token>

5. Usar plantilla para crear un eCMR

Para crear un eCMR desde una plantilla, usa el campo template en la creación del eCMR:

POST /ecmr
Authorization: Bearer <token>

{
  "template": "ID_PLANTILLA",
  "etd_address": "ID_DIR_ORIGEN",
  "etl_address": "ID_DIR_DESTINO"
}

Los valores predefinidos de la plantilla se aplican automáticamente. Puedes sobrescribir campos específicos en la misma petición.

Resumen de endpoints