Diseñá una ficha, no una respuesta gigante
El alta de un vehículo puede combinar clasificación, controles técnicos y campañas de recall. Cada capacidad tiene su propia identidad, fecha y posible estado. Unir todos los JSON sin modelo produce una estructura difícil de actualizar y auditar.
Creá una ficha del vehículo con módulos independientes. La ficha referencia el resultado vigente de cada módulo y conserva el historial mínimo necesario para explicar cambios.
Separá hechos, señales y decisiones
Una respuesta de una fuente es una observación con contexto. La decisión de habilitar un vehículo, pedir documentación o derivar a revisión pertenece a la empresa y debe quedar en otra capa.
Esta separación evita presentar una API como autoridad legal y permite modificar reglas internas sin alterar la evidencia recibida. También facilita que una persona revise casos ambiguos antes de aplicar consecuencias.
Modelá vigencia y ausencia de forma explícita
Un dato observado ayer y uno consultado hace seis meses no deberían verse iguales. Guardá fecha de observación, capacidad, versión y estado de la solicitud junto al resultado necesario para la operación.
Ausencia de resultado no significa incumplimiento. Puede representar una entrada inválida, una fuente no disponible, una cobertura distinta o simplemente que el contrato no devuelve esa señal. La interfaz tiene que distinguir esos escenarios.
Construí el alta por etapas
Una primera etapa valida identificadores y crea la ficha. La segunda ejecuta capacidades independientes. La tercera evalúa reglas empresariales y separa aprobados, observados y casos para revisión.
Para cargas masivas, este diseño permite que un problema en una capacidad no bloquee todo el lote. También hace posible reconsultar sólo la señal que venció, sin reconstruir la identidad del vehículo.
- Identidad vehicular preservada.
- Estado y fecha por capacidad.
- Decisión empresarial separada del dato.
- Revisión humana para casos no concluyentes.
Fuentes y referencias
Contenido informativo para diseño de integraciones. No constituye asesoramiento legal, regulatorio ni financiero.
