From b6be281f59195bb46ac4c5d837f8d4916fb69013 Mon Sep 17 00:00:00 2001 From: marianozunino Date: Mon, 5 May 2025 22:18:19 -0300 Subject: [PATCH] Add Home --- Home.md | 90 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 Home.md diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..d610625 --- /dev/null +++ b/Home.md @@ -0,0 +1,90 @@ +# Servicio de Simulación de Documentos Digitalizados + +Este documento explica cómo utilizar el servicio de simulación de documentos digitalizados para fines educativos. El servicio genera información ficticia de personas basada en números de documentos de identidad (cédulas). + +## Características principales + +- Generación de datos personales ficticios deterministas (siempre los mismos para la misma cédula) +- Simulación de errores y advertencias controladas mediante patrones en los números de cédula +- Generación de edades específicas basadas en los últimos dígitos de la cédula + +## Cómo generar errores y advertencias específicos + +El servicio utiliza los **dos primeros dígitos** de la cédula para determinar si ocurre un error o una advertencia: + +| Dos primeros dígitos | Resultado generado | +| -------------------- | -------------------------------------------- | +| 11 | Error - Persona inexistente | +| 12 | Error - Límite de consultas excedido | +| 13 | Error - Número de cédula anulado | +| 14 | Advertencia - Datos de persona a regularizar | +| 15 | Advertencia - Documento hurtado o extraviado | +| Otros | Sin errores ni advertencias | + +Por ejemplo, si consulta la cédula `11.234.567-8`, el servicio devolverá un error indicando que la persona no existe. + +## Cómo obtener cédulas con edades específicas + +La edad de la persona generada se determina por los **últimos dos dígitos** de la cédula: + +- Para una persona de 25 años: use una cédula que termine en "25" +- Para una persona de 18 años: use una cédula que termine en "18" +- Para una persona de 65 años: use una cédula que termine en "65" + +Por ejemplo, la cédula `4.321.025-9` generará una persona que tiene 25 años. + +## Ejemplos de uso + +### Ejemplos de cédulas que generan errores: + +- `11.234.567-8`: Error - Persona inexistente +- `12.345.678-9`: Error - Límite de consultas excedido +- `13.456.789-0`: Error - Número de cédula anulado + +### Ejemplos de cédulas que generan advertencias: + +- `14.567.890-1`: Sin error, con advertencia - Datos a regularizar +- `15.456.789-0`: Sin error, con advertencia - Documento hurtado/extraviado +- `56.789.123-4`: Sin error, sin advertencia (no comienza con 11-15) + +### Ejemplos de cédulas con edades específicas: + +- `4.321.018-9`: Persona de 18 años +- `5.678.930-3`: Persona de 30 años +- `6.789.045-1`: Persona de 45 años +- `7.890.175-8`: Persona de 75 años + +### Combinando características: + +- `15.467.825-7`: Persona de 25 años con advertencia de documento hurtado +- `14.418.965-3`: Persona de 65 años con advertencia de datos a regularizar + +## Otros datos generados + +Además de la edad, el servicio genera determinísticamente para cada cédula: + +- Nombres y apellidos +- Sexo (basado en el número de cédula) +- Fecha de nacimiento (basada en la edad) +- Nacionalidad +- Nombres completos para la cédula +- Identificadores de solicitud y respuesta + +## Notas importantes + +1. Los datos generados son ficticios y no corresponden a personas reales. +2. El servicio es determinista: la misma cédula siempre generará los mismos datos. +3. Para edades de 0-9, asegúrese de incluir un cero delante (por ejemplo, "05" para 5 años). +4. Para cédulas sin dígitos suficientes, el sistema puede comportarse de manera inesperada. + +## Formato de parámetros requeridos + +Para realizar una consulta válida, debe proporcionar los siguientes parámetros: + +- `NroDocumento`: Número de cédula (requerido) +- `NroSerie`: Número de serie del documento (requerido) +- `Organismo`: Código del organismo solicitante (requerido) +- `ClaveAcceso1`: Clave de acceso (requerida) +- `TipoDocumento`: Tipo de documento (opcional) + +La ausencia de cualquiera de los parámetros requeridos resultará en un error de "Parámetros incorrectos".