Caso de uso: Gestion completa de flota (vehiculos + conductores)
La situacion
Flota del Sur SL acaba de comprar 3 camiones. Necesita registrar los vehiculos, anadir conductores, y tener todo listo para la operativa diaria.
El plan
- Registrar los 3 vehiculos en el sistema
- Anadir los 5 conductores
- Verificar limites diarios de conduccion
- Registrar transportista principal
- Ver dashboard de actividad
Paso 1: Registrar los vehiculos
Documentacion: docs.cargoffer.com/#tag/Vehicles
bash
curl -X POST "https://api.pro.cargoffer.com/api/company/vehicles/" \
-H "Authorization: Bearer *** \
-H "Content-Type: application/json" \
-d '{"plate": "1234ABC", "type": "camion", "brand": "Iveco", "capacity": 24000, "year": 2025}'
curl -X POST "https://api.pro.cargoffer.com/api/company/vehicles/" \
-H "Authorization: Bearer *** \
-H "Content-Type: application/json" \
-d '{"plate": "5678DEF", "type": "camion", "brand": "Scania", "capacity": 26000, "year": 2025}'
curl -X POST "https://api.pro.cargoffer.com/api/company/vehicles/" \
-H "Authorization: Bearer *** \
-H "Content-Type: application/json" \
-d '{"plate": "9012GHI", "type": "furgoneta", "brand": "Mercedes", "capacity": 3500, "year": 2024}'Ver todos los vehiculos registrados:
bash
curl -X GET "https://api.pro.cargoffer.com/api/company/vehicles/" \
-H "Authorization: Bearer <token...**
---
## Paso 2: Anadir conductores (TRANSCEND)
**Documentacion:** [docs.transcend.cargoffer.com/#tag/drivers](https://docs.transcend.cargoffer.com/#tag/drivers)
```bash
curl -X POST "https://back.transcend.cargoffer.com/drivers" \
-H "Authorization: Bearer *** \
-H "Content-Type: application/json" \
-d '{"name": "Manuel Lopez", "license": "C+E", "phone": "609000000"}'
curl -X POST "https://back.transcend.cargoffer.com/drivers" \
-H "Authorization: Bearer *** \
-H "Content-Type: application/json" \
-d '{"name": "Ana Garcia", "license": "C+E", "phone": "609000001"}'Paso 3: Ver limites diarios de conduccion
bash
curl -X GET "https://back.transcend.cargoffer.com/drivers/{id}/daily-limits" \
-H "Authorization: Bearer *** -X GET "https://back.transcend.cargoffer.com/drivers/{id}/hours-history" \
-H "Authorization: Bearer <token...tos limites son utiles para cumplir la normativa y planificar relevos.
---
## Paso 4: Registrar transportista
**Documentacion:** [docs.cargoffer.com/#tag/Truckers](https://docs.cargoffer.com/#tag/Truckers)
```bash
curl -X POST "https://api.pro.cargoffer.com/api/company/truckers/" \
-H "Authorization: Bearer *** \
-H "Content-Type: application/json" \
-d '{"name": "Flota del Sur SL", "taxid": "B12345678", "contact": "954000000"}'Paso 5: Ver dashboard de actividad
bash
curl -X GET "https://api.pro.cargoffer.com/api/company/dashboard/" \
-H "Authorization: Bearer <token...**
---
## Resultado final
- 3 vehiculos registrados (2 camiones + 1 furgoneta)
- 5 conductores activos con limites diarios
- 1 transportista principal dado de alta
- Dashboard operativo con actividad de la flota