Principiante

Conexión a la API eCMR

Guía paso a paso para registrar tu empresa, obtener credenciales y configurar tus datos maestros.

1. Registrar tu empresa

POST /auth/register 📖
{ "accountType": "company", "socialName": "Mi Empresa SL", "user": { ... }, "address": { ... } }
💡 Tip: Guarda el token JWT de la respuesta. Lo necesitarás para autenticarte.

2. Iniciar sesión (JWT)

POST /auth/login 📖
{ "email": "juan@miempresa.com", "password": "SecurePass123!" }

Incluye el token en todas las peticiones: Authorization: Bearer <token>

3. Obtener API Key (M2M)

Para integraciones automáticas sin intervención humana, crea una API Key con rol específico:

POST /apikeys 📖
{ "type": "admin" }

Usa la API Key como query param: ?apikey=CLAVE_API

4. Configurar datos maestros

Completar perfil

PUT /company_data/ 📖
{ "socialName": "Mi Empresa SL", "hasSign": true }

Direcciones

POST /addresses/ 📖
{ "name": "Almacén Principal", "addressGoogleMaps": { ... }, "isDefault": true }

Conductores

POST /drivers/ 📖
{ "name": "Carlos", "lastname": "López", "email": "carlos@empresa.com", "dni": "12345678A" }

Vehículos

POST /vehicles/ 📖
{ "plate": "1234ABC", "vehicle_type": "tir", "shipping_type": "dry" }

5. Verificar conexión

GET /addresses/ 📖
Authorization: Bearer <token>

Si recibes un 200 OK con tu lista de direcciones, ¡la conexión está operativa!

v3.0.0