Sincronización de Restricciones y Paradas

En esta sección se documentan los endpoints para sincronizar catálogos de soporte operativo: tipos de restricción y tipos de paradas (stops).

1. Tipos de Restricción

POST/transportes/sync/restrictions/types

Sincroniza tipos de restricción legacy para compatibilidad con integraciones existentes.

Caso de uso

Mantener compatibilidad con integraciones que todavía usan restricciones por tipo.

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`)
`restriction_type_description`	string	Descripción del tipo de restricción

Opcionales

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

Ejemplos

Request

{
  "source_id": "smartfleet.restriction_type:1",
  "source_system": "external_erp",
  "restriction_type_description": "Producto restringido"
}

Response

{
  "ok": true,
  "code": "SYNC_OK",
  "message": "Sync processed successfully.",
  "data": 1,
  "meta": {
    "route": "/transportes/sync/restrictions/types",
    "method": "PostRestrictionTypeSync",
    "operation": "upsert",
    "upsert_action": "updated",
    "timestamp": "2026-04-07T12:00:00.000Z"
  }
}

2. Tipos de Parada (Stops)

Los tipos de parada son constantes del sistema y no pueden crearse ni modificarse vía API.

Los stop types (IDs 1–11: INICIO_RUTA, REC_FAC, REC_OC, REC_FPS, REC_TTC, ENT_TTC, REC_DEV, ENT_FAC, ENT_SEDE, FIN_RUTA, ENT_REC) están hardcodeados en la lógica de dispatch y drivers. Modificarlos rompería el flujo operativo.

Los endpoints POST /transportes/stops/types y POST /transportes/sync/stops/types fueron eliminados.

Consultar tipos de parada (solo lectura)

Use los endpoints GET de sync para leer el catálogo:

GET /transportes/sync/stops/types/getAll — lista todos los stop types del tenant
GET /transportes/sync/stops/types/{sourceId} — busca por source_id

Ver Consultas GET para detalles.

Choferes y Licencias Facturas