Identificadores estables: qué se puede usar como clave

Una integración que guarda infracciones en su propia base tiene que elegir, en algún momento, qué columna manda. Esa decisión parece menor y después ordena todo lo demás: si dos consultas del mismo día devuelven un hecho o dos, si un webhook actualiza o inserta, si la conciliación contable cierra. Cuando está mal elegida, el síntoma aparece meses más tarde: registros duplicados que ya nadie puede separar con confianza.

Una infracción llega con varios candidatos encima —número de acta, dominio, identificador del proveedor, documento del titular— y ninguno alcanza solo. Conviene separar dos familias. El identificador natural es el que la fuente ya usa para nombrar algo del mundo: un acta, un vehículo, una persona. La clave sustituta es un valor opaco que emitimos nosotros y que no significa nada fuera de nuestro esquema.

Tres preguntas antes de elegir una clave

Antes de fijar una columna conviene responder tres cosas:

• en qué ámbito es único, porque un número puede no repetirse dentro de un organismo y sí entre organismos;
• si cambia con el tiempo, porque un valor que se corrige, se reformatea o se reasigna no es una clave sino un atributo;
• si viene siempre, porque un campo opcional que falta en una respuesta parcial deja filas sin identidad.

Fallar en cualquiera de las tres no descarta al campo como dato. Lo descarta como clave.

El número de acta necesita un ámbito

El número de acta es el identificador natural más obvio y el más fácil de usar mal. Rara vez es único fuera del organismo que lo emitió: dos autoridades pueden asignar la misma numeración y, dentro de una, conviven series, años o tipos de documento.

La forma defendible es una clave compuesta: autoridad emisora, serie cuando existe y número completo. La autoridad debería entrar con un código del catálogo y no con el nombre visible, por los motivos que tratamos en códigos estables para jurisdicciones.

El número se guarda como texto: los ceros iniciales forman parte de la identidad y no sobreviven a una conversión numérica, como desarrollamos en identificadores como texto.

El dominio identifica al vehículo, no a una infracción

El dominio es cómodo porque todos lo tienen a mano, pero no identifica una infracción ni dice por sí solo quién era el titular en la fecha del hecho. El régimen registral prevé el trámite de transferencia: el titular cambia sin que el vehículo deje de ser el mismo. El vínculo entre un dominio y una persona es una observación con fecha, no una constante.

Tampoco tiene una forma única. La disposición nacional que ordenó la progresión del dominio Mercosur mantuvo la codificación anterior de tres letras y tres números, incluso al reponer la chapa vieja, y pidió a los organismos que interactúan con el registro automotor que adecuaran sus sistemas. Una clave que asuma un solo patrón deja afuera vehículos legítimos.

El CUIT o el documento del titular suman otro problema: identifican a una persona, y una clave se repite en rutas, logs, métricas y exportaciones.

La clave sustituta: opaca, propia y sin significado

Por eso lo habitual es emitir una clave propia por cada infracción observada y dejar los identificadores naturales como atributos, con su origen y su fecha.

Un identificador opaco

RFC 9562 define los UUID e incluye variantes ordenables por momento de creación, útiles cuando la clave también funciona como índice. Dos advertencias del propio documento importan acá: la unicidad global no se garantiza sin un esquema de conocimiento compartido, y alcanza con que la clave sea única dentro de tu base cuando esa unicidad global no hace falta; y no hay que suponer que un UUID sea difícil de adivinar ni usarlo como un valor cuya sola posesión habilite el acceso. Una clave no autoriza; la autorización se resuelve aparte y en cada solicitud.

Una clave derivada

Si la clave se calcula como hash de varios campos hay que decidir dos cosas. La primera es la serialización: el mismo contenido tiene que producir siempre los mismos bytes, el problema que resuelve el esquema de canonicalización de JSON. La segunda, más importante, es qué campos entran: sólo los que la fuente no rectifica. Si el monto o el estado participan del cálculo, una corrección genera una clave nueva y el registro corregido aparece como una infracción distinta.

Qué verificar antes de congelar la clave

La decisión se puede probar antes de producción. Reprocesá un lote ya cargado y verificá que no aparezca ninguna fila nueva. Simulá una rectificación de monto y otra de estado, y comprobá que la clave no se mueva. Simulá una respuesta parcial y confirmá que las filas sin identificador natural queden marcadas como identidad provisoria en lugar de fusionarse por parecido.

Cuando la fuente no ofrece ningún identificador, la salida honesta no es inventar una equivalencia sino declararla: registro separado, relación probable y motivo. El criterio para no unir de más lo tratamos en deduplicar eventos en el receptor.

Una clave estable no es la que se ve más prolija en el esquema. Es la que podés sostener sin cambiarla cuando la fuente cambie de formato, corrija un dato o deje de responder.

Preguntas frecuentes

¿Puedo usar el número de acta como clave primaria?

Sólo si lo combinás con la autoridad que lo emitió y con la serie cuando existe. Un mismo número puede repetirse entre organismos, y dentro de un mismo organismo pueden convivir series, años o tipos de documento distintos.

¿Sirve el dominio para identificar a quién responde por una multa?

No. El dominio identifica al vehículo. El régimen registral prevé el trámite de transferencia, así que la relación entre un dominio y una persona es una observación con fecha y puede cambiar sin que cambie el vehículo.

¿Es seguro usar un UUID como control de acceso a un recurso?

No. Es razonable como identificador, pero RFC 9562 pide no suponer que un UUID sea difícil de adivinar y desaconseja usarlo como un valor cuya sola posesión habilite el acceso. La autorización tiene que verificarse en cada solicitud, con clave o sin ella.

¿Qué campos pueden entrar en una clave derivada por hash?

Sólo los que la fuente no rectifica. Si el monto o el estado participan del cálculo, una corrección produce una clave distinta y el registro corregido entra como si fuera una infracción nueva.

Notas relacionadas