Sincronización de Choferes y Licencias

En esta sección se documentan los endpoints para sincronizar el catálogo de choferes y los tipos de licencia que poseen o requieren.

1. Tipos de Licencia

POST/transportes/sync/drivers/licenses/types

Crea o actualiza tipos de licencia requeridos para choferes y vehículos.

Caso de uso

Crear catálogo de licencias requeridas para choferes y vehículos.

Campos del Payload

Requeridos

Campo	Tipo	Descripción
`source_id`	string	ID único en el sistema de origen
`source_system`	string	Sistema externo (ej. `external_erp`)
`license_type_code`	string	Código del tipo de licencia (ej. `B2`)
`license_type_description`	string	Descripción del tipo de licencia

Opcionales

Campo	Tipo	Descripción
`is_active`	boolean	Estado activo
`license_type_id`	int	ID interno del tipo

Ejemplos

Request

{
  "source_id": "fleet.license.type:B2",
  "source_system": "external_erp",
  "license_type_code": "B2",
  "license_type_description": "Licencia B2"
}

Response

{
  "ok": true,
  "code": "SYNC_OK",
  "message": "Sync processed successfully.",
  "data": 2,
  "meta": {
    "route": "/transportes/sync/drivers/licenses/types",
    "method": "PostLicenseTypeSync",
    "operation": "upsert",
    "upsert_action": "created",
    "timestamp": "2026-04-07T12:00:00.000Z"
  }
}

2. Choferes

POST/transportes/sync/drivers

Crea o actualiza choferes y los asocia a sede y vehículo.

Caso de uso

Crear/actualizar choferes desde RRHH u el sistema externo.
Asociar chofer a sede y vehículo por source_id.

Dependencias

hub_source_id requiere que la sede exista.
vehicle_source_id requiere que el vehículo exista.

Campos del Payload

Requeridos

Campo	Tipo	Descripción
`source_id`	string	ID único en el sistema de origen
`source_system`	string	Sistema externo
`employee_code`	string	Código del empleado
`national_id`	string	Cédula o identificación nacional

Opcionales

Campo	Tipo	Descripción
`is_active`	boolean	Estado activo
`driver_id`	int	ID interno del chofer
`driver_name`	string	Nombre completo
`hub_id` / `hub_source_id`	int/string	Sede asignada
`hub_model`	string	Modelo del hub
`vehicle_id` / `vehicle_source_id`	int/string	Vehículo asignado
`vehicle_model`	string	Modelo del vehículo
`driver_status_id`	int	Estado del chofer
`phone`	string	Teléfono
`licenses`	array	Licencias del chofer (ver estructura abajo)
`is_external`	boolean	Es chofer externo
`is_enabled`	boolean	Está habilitado para operar

Estructura de cada objeto en licenses:

Campo	Tipo	Descripción
`license_type_code`	string	Código de tipo de licencia (ej. `"B1"`)
`license_expiration_date`	string (ISO 8601)	Fecha de vencimiento (ej. `"2027-12-31T00:00:00.000Z"`)

Ejemplos

Request

{
  "source_id": "hr.employee:401",
  "source_system": "external_erp",
  "employee_code": "EMP-401",
  "national_id": "1-1111-1111",
  "driver_name": "Juan Pérez",
  "phone": "555-0400",
  "hub_source_id": "stock.warehouse:1",
  "hub_model": "stock.warehouse",
  "vehicle_source_id": "fleet.vehicle:12",
  "vehicle_model": "fleet.vehicle",
  "is_enabled": true,
  "is_external": false,
  "licenses": [
    {
      "license_type_code": "B1",
      "license_expiration_date": "2027-12-31T00:00:00.000Z"
    }
  ]
}

Response

{
  "ok": true,
  "code": "SYNC_OK",
  "message": "Sync processed successfully.",
  "data": [
    {
      "driver_id": 25
    }
  ],
  "meta": {
    "route": "/transportes/sync/drivers",
    "method": "PostDriverSync",
    "operation": "upsert",
    "upsert_action": "updated",
    "timestamp": "2026-04-07T12:00:00.000Z"
  }
}

Vehículos y Tipos Restricciones y Paradas