90 lines
3.9 KiB
Markdown
90 lines
3.9 KiB
Markdown
# 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".
|