NDA / Contratos · Plan de implementación

Identificación por país

Habilitar que el representante legal y la compañía puedan registrar su identificación con documentos de varios países, con los tipos que aplican a cada uno y el formato de número correspondiente.

Análisis previo a implementarPendiente de tu confirmación17-sep-2026

1 Punto de partida (buena noticia)

Revisé cómo está construido hoy el campo de identificación. La estructura ya está pensada para varios países: no hay que rehacerla, sino sembrar los datos de cada país y generalizar una pieza de lógica.

Ya resuelto (no se toca)

  • El catálogo de tipos de documento ya guarda el país de cada tipo.
  • El campo ya filtra los tipos según el país elegido y distingue persona natural vs compañía.
  • El "Tipo" ya se activa solo después de elegir país; el "Número" solo después de elegir tipo. Es justo lo que pides.
  • El desplegable de países se arma solo con los países que existan en el catálogo (nombres desde nuestra lista de 211 países).

Lo que está atado a Colombia (a resolver)

  1. El catálogo solo tiene sembrados los 5 tipos de Colombia. Faltan los demás países.
  2. El dígito de verificación está escrito puntual para Colombia + NIT (fórmula DIAN, 9 dígitos). Ningún otro país tiene su lógica de número.
  3. La validación al enviar solo revisa el NIT colombiano; los demás tipos no se validan.

2 Tipos por país (propuesta a confirmar)

Esta es mi propuesta de qué tipos de documento ofrecer en cada país. La armé con lo estándar de cada país, pero como el criterio es tuyo, quiero que la revises y ajustes antes de sembrarla. Marco en verde lo que ya existe.

Representante legal · persona natural

PaísTipos propuestosEstado
ColombiaCédula de ciudadanía, Cédula de extranjería, Pasaporte, PEPYa existe
MéxicoCredencial para votar (INE), CURP, PasaporteNuevo
PerúDNI, Carné de extranjería, PasaporteNuevo
ChileCédula de identidad (RUN), PasaporteNuevo
ArgentinaDNI, PasaporteNuevo
Estados UnidosPasaporte, Licencia de conducir, Social Security Number (SSN)Nuevo

Compañía · persona jurídica

PaísTipo (empresa)Formato del númeroDígito verif.
ColombiaNIT9 dígitos + DVSí (DIAN)
MéxicoRFC (persona moral)12 caracteres alfanuméricosInterno
PerúRUC11 dígitosInterno
ChileRUT8 a 9 dígitos + DVSí (mód. 11)
ArgentinaCUIT11 dígitosSí (mód. 11)
Estados UnidosEIN9 dígitos (XX-XXXXXXX)No
PanamáRUCformato propioA confirmar
Islas CaimánCompany registration no.alfanuméricoNo

"Interno / No" = el número ya incluye su propio control o no lo tiene; el campo DV separado (como el del NIT) solo aplicaría a Colombia, Chile y Argentina.

3 Oportunidad de mejora clave

Hoy la lógica del número vive escrita a mano para el NIT. En vez de repetir ese código país por país, propongo generalizarla una sola vez.

Cada tipo de documento tendría, en el código, su regla de número: un patrón (cuántos dígitos o caracteres, letras o solo números) y, si aplica, su función de dígito de verificación. Así:

  • → Chile (RUT) y Argentina (CUIT) reusan el mismo patrón de dígito de verificación módulo 11 que ya tenemos para el NIT, sin reescribirlo.
  • → Agregar un país nuevo a futuro es solo datos + una regla, no tocar el formulario.
  • → La validación al enviar deja de ser "solo NIT" y pasa a validar el formato de cualquier tipo, con el mismo mensaje claro de error.
Recomendación: las reglas de formato/verificación viven en el código (son lógica, no datos), keyed por país + código de documento. El catálogo de la base de datos sigue guardando solo país, tipo y etiqueta, como hoy.

4 Plan por fases

Cada fase deja algo verificable y no rompe lo que ya funciona (Colombia sigue igual en todo momento).

A

Sembrar los tipos por país

Migración que agrega al catálogo los tipos de cada país (los que confirmes en la sección 2), para representante legal y compañía. Aditiva: no toca lo de Colombia.

supabase/migrations · identification_types
B

Motor de reglas de número

Un mapa de reglas por (país + tipo): patrón del número y función de dígito de verificación opcional. El módulo 11 del NIT se reusa para RUT y CUIT.

$lib nuevo · reusa utils/nit.ts
C

Campo de identificación genérico

El componente deja de tener el NIT escrito a mano y usa la regla del tipo elegido: máscara del número, cuándo mostrar el dígito de verificación, etc. Quitar la auto-selección de país (ahora habrá varios; queda "Elige un país").

ContractIdentificationField.svelte
D

Validación al enviar

Servidor y cliente validan el número contra la regla del tipo (no solo el NIT), con mensaje de error claro por documento inválido.

contrato/[token] · custom validation
E

Lectura legible (mejora)

En el visor de respuestas y el PDF, mostrar el nombre del tipo y del país en texto (hoy salen los códigos crudos, p. ej. "CC (CO)").

visor + PDF de respuesta

5 Dudas para vos

1

Tipos por país: ¿confirmas la propuesta de la sección 2, o ajustas algún tipo? (sobre todo Estados Unidos, Panamá e Islas Caimán, que son menos estándar).

2

Validación: ¿el número inválido debe bloquear el envío (como el NIT hoy), o solo dar formato y dejar pasar? Mi sugerencia: bloquear donde hay dígito de verificación (Colombia, Chile, Argentina) y solo validar largo/formato en el resto.

3

Representante legal: hoy guarda país + tipo + número (número en un campo aparte). ¿Lo dejamos igual para todos los países? Confirmo que sí salvo que quieras algo distinto.

4

Islas Caimán / Panamá (compañía): ¿tienes el formato oficial del número que usan, o lo dejamos como texto libre validando solo que no vaya vacío?

5

Lectura legible (fase E): ¿la incluimos en esta ronda o la dejamos para después? Es una mejora, no un bloqueante.

Siguiente paso: con tus respuestas a estas 5 dudas cierro la lista de tipos y arranco por la fase A. Colombia no cambia en ningún momento.

Ecosistema LPDI · Plan de implementación · Identificación por país en el editor de contratos