Dígito verificador DNI chino

Cuerpos sin dígitos, longitudes incorrectas, entrada vacía y caracteres ilegales se rechazan con un error claro invalid_input. Úselo gratis en el navegador o llame a la API del KIT; ambos caminos comparten la misma aritmética modular pura, sin ida y vuelta de red y sin registros almacenados de personas vivas.

Cómo se calcula el dígito verificador del DNI de residente chino

Como el algoritmo es aritmética modular entera pura con pesos fijos, los mismos diecisiete dígitos producen siempre el mismo carácter de control en cada plataforma—navegador, Worker o arnés de pruebas fuera de línea—por eso la capacidad se entrega como motor parse de nivel A y no como llamada a un modelo.

Cómo calcular el dígito de control o validar un ID completo

Envíe un campo id que contenga solo dígitos en el cuerpo y, al validar, un carácter final que sea dígito o X. El modo validate espera exactamente dieciocho caracteres. Esa forma facilita mostrar «usted escribió X, se esperaba Y» en una UI de KYC o registro sin una segunda petición. Cadenas vacías, id ausente, valores de modo inválidos y longitudes incorrectas (por ejemplo dieciséis o diecinueve caracteres) fallan antes de cualquier suma ponderada y no se facturan. Recuerde que un dígito de control correcto solo demuestra buena formación aritmética bajo ISO 7064 MOD 11-2: no demuestra que la persona exista en registros civiles ni que el documento esté activo. Espacios, guiones, puntos y otra puntuación se rechazan como entrada no ID con invalid_input para que un formulario nunca acepte un valor limpiado en silencio: elimine el formato en su cliente si el usuario pega una cadena con espacios o guiones. El modo compute es el predeterminado: proporcione exactamente diecisiete dígitos base; el motor devuelve check_digit como un solo carácter del cero al nueve o X, id como el número completo de dieciocho caracteres, length dieciocho y algorithm iso7064_mod11_2. La respuesta indica valid true solo cuando el carácter final coincide con expected_check_digit recalculado; siempre incluye base (los primeros diecisiete dígitos), check_digit tal como se envió, expected_check_digit y el id canónico formado por base más el carácter esperado. Como la ruta es parse pura, sin reloj, fuente aleatoria ni red, la misma entrada produce siempre el mismo JSON en la herramienta gratuita del navegador y en la API. A $0.002 por solicitud exitosa puede proteger importaciones masivas de CRM, auditorías de archivos de socios y barreras de formulario sin negociar un nivel personalizado.

Dónde encajan los dígitos de control del ID chino en flujos de producto reales

Los flujos de alta de fintech y marketplaces que aceptan clientes de la China continental suelen pedir el ID de residente pronto; validar el dígito de control al salir del campo reduce envíos fallidos y tickets de soporte sin llamar a un registro nacional en cada pulsación. Los sistemas de nómina, RR. HH. y campus que importan CSV de empleados o estudiantes deben poner en cuarentena las filas cuyo decimoctavo carácter ya no coincida, lo que detecta tanto ediciones humanas como errores de uno en generadores previos. No trate un dígito de control correcto como prueba de identidad legal o residencia: solo demuestra que la cadena de dieciocho caracteres está bien formada aritméticamente bajo la regla oficial del ID de residente chino, el mismo criterio de honestidad que aplica a cualquier herramienta de checksum de documentos nacionales. Los portales de telecomunicaciones, viajes y hostelería que usan el ID como clave ciudadana pueden bloquear el avance hasta que valid sea true y mostrar expected_check_digit cuando el dígito sea incorrecto. Los trabajos de calidad de datos recalculan expected_check_digit para cada columna de ID en una exportación y marcan desajustes antes de llegar a facturación o reporting fiscal. En todo flujo el contrato es el mismo: diecisiete dígitos para compute o dieciocho caracteres para validate, JSON estructurado que puede probar con goldens, comportamiento idéntico gratis en el navegador o con saldo prepago del KIT, y fallo honesto cuando la entrada no es una cadena de ID bien formada. Combine la comprobación con sus propias reglas de código de área y rango de fechas de nacimiento si la política del producto lo exige; este endpoint se limita deliberadamente a la comprobación modular para que la API siga siendo pequeña, estable y fácil de probar con goldens a $0.002 por llamada exitosa.