ID

PDCC - Historia de usuario

019
Fecha de creación:
Página Página 1 de 8

1. Control de versiones

Versión Descripción de la versión Autor Fecha creación

0.1 Creación del documento Ivonne Chaves 16/07/2020
1.0 Actualización de documento por sesión 17/07 Ivonne Chaves 21/07/2020
1.1 Actualización del documento por revisión técnica Ivonne Chaves 23/07/2020
2.0 Revisión de SIECA Ivonne Chaves 09/09/2020
3.0 Versión Final Ivonne Chaves 23/09/2020
3.1 Cambio set de datos entrada y salida Sandra Sua 12/05/2021

2. Detalles de la Historia de Usuario

DEFINICIÓN

ID: 019-1 Clasificación: ADU Prioridad: 1 Tipo Proceso: Anidado

Título de la Historia de usuario: Petición WS Importadores-Exportadores

Yo como: Sistema Nacional

Necesito una funcionalidad que sirva como intermediaria entre Sistemas Nacionales o
Regionales (SIECA), para que reciba la petición de consulta a fin de trasladar esta
Descripción de la Historia: consulta al país y sistema que sea requerido. La respuesta obtenida deberá ser
almacenada la PDCC.
Tiene como beneficio conectar diferentes sistemas desde la PDCC para transmitir
información a quien la requiera, así mismo almacenarla para la generación de reportería y
estadísticas.
Dependencia de historia de
usuario
Pre-Condiciones:
1. Servicio expuesto por los países para la consulta de desde la PDCC.
2. Esquema para recepción y envío de mensajería JSON entre Sistemas Nacionales y PDCC habilitado.
 ID
PDCC - Historia de usuario
019
Fecha de creación:
Página Página 2 de 8

3. PDCC recibe petición de consulta.

NOTA:
- Hay países que tienen información reservada en cuanto a la consulta de importadores y exportadores, por eso deben
quedar campos (Nombre o razón social, teléfono, domicilio, domicilio fiscal y correo electrónico) de información
sensible en la respuesta como opcionales y se envían respecto a lo que responda cada país.

Descripción del flujo normal:

Ver Imagen:
 ID
PDCC - Historia de usuario
019
Fecha de creación:
Página Página 3 de 8

Prototipo(s): N/A

Descripción detallada:
1. Sistema PDCC recibe una petición de consulta de un país origen.
2. Sistema PDCC identifica el país destino sobre el cual realizará la consulta.
3. Sistema PDCC envía petición al país destino a través de mensaje JSON
4. Sistema Nacional del país destino recibe mensaje JSON
5. Sistema Nacional del país destino ejecuta consulta y retorna respuesta a la PDCC a través de mensaje JSON con la
información asociada al registro consultado.
6. Sistema PDCC recibe respuesta en mensaje JSON sobre la petición realizada al país destino.
7. Sistema PDCC almacena información recibida, y remite al país origen la respuesta recibida sobre la petición.

Reglas de negocio:
- El sistema PDCC debe persistir la información de las consultas para temas de auditoria, reportes y estadísticas.

Set de datos entrada

Entidad
No. Nombre campo Tipo campo Tipo dato Ob. Validaciones
/Categoría Longitud
1 Datos Tipo Documento Drop Down List Alfanumérico Si De la tabla EDIFACT 1153

- Se debe validar contra la tabla, si llega un código

7 diferente a los aceptados, se rechaza con MSJ (Se
ha presentado un error con los datos enviados en
el campo <TIPO_DOCUMENTO >, verifique que los
datos estén correctos e intente de nuevo.)
(Contra que columna de la tabla document_type)
se validara (code?)
 ID
PDCC - Historia de usuario
019
Fecha de creación:
Página Página 4 de 8

Número de identificación del

importador/Exportador a consultar

Se debe validar si el campo llega vacío o null se

30 rechaza con MSJ (el campo
2 Datos Número Documento Text Alfanumérico Si
<NUMERO_DOCUMETO > es obligatorio,
diligéncielo e intente de nuevo.) Se validara
contra la columna document

-Dato que se ingresa en la consulta para saber el

tipo de persona que se consulta

- Si y solo si se permiten los valores consultados

de la tabla o catálogo Clasificación, si la tabla o
catálogo no existe, se debe crear en la DB de la
PDCC
Valores:
-Importador (I)
-Exportador (E)
2 -Importador y exportador (IE)
3 Datos Clasificación Drop Down List Alfanumérico Si
- Se debe validar contra la tabla, si llega un código
diferente a los aceptados, se rechaza con MSJ (Se
ha presentado un error con los datos enviados en
el campo <CLASIFICACION >, verifique que los
datos estén correctos e intente de nuevo.)

Se debe validar si el campo llega vacío o null se

rechaza con MSJ (el campo <CLASIFICACION> es
obligatorio, diligéncielo e intente de nuevo.)

-Del código ISO 3166

- Si y solo si se permiten los valores consultados

de la tabla o catálogo País, si la tabla o catálogo
no existe, se debe crear en la DB de la PDCC.
Valores:
1- GT: Guatemala
2- HN: Honduras
3- SV: El Salvador
4- CR: Costa Rica
5- NI: Nicaragua
4 Datos País Origen Drop Down List Alfanumérico Si
2 6- PA: Panamá

- Se debe validar contra la tabla, si llega un código

diferente a los aceptados, se rechaza con MSJ (Se
ha presentado un error con los datos enviados en
el campo <PAIS_ORIGEN>, verifique que los datos
estén correctos e intente de nuevo.)

Se debe validar si el campo llega vacío o null se

rechaza con MSJ (el campo <PAIS_ORIGEN> es
obligatorio, diligéncielo e intente de nuevo.)
5 Datos País Destino Drop Down List Alfanumérico Si Del código ISO 3166
 ID
PDCC - Historia de usuario
019
Fecha de creación:
Página Página 5 de 8

- Si y solo si se permiten los valores consultados

de la tabla o catálogo País, si la tabla o catálogo
no existe, se debe crear en la DB de la PDCC.
Valores:
1- GT: Guatemala
2- HN: Honduras
3- SV: El Salvador
4- CR: Costa Rica
5- NI: Nicaragua
2 6- PA: Panamá

- Se debe validar contra la tabla, si llega un código

diferente a los aceptados, se rechaza con MSJ (Se
ha presentado un error con los datos enviados en
el campo <PAIS_DESTINO>, verifique que los
datos estén correctos e intente de nuevo.)

Se debe validar si el campo llega vacío o null se

rechaza con MSJ (el campo <PAIS_DESTINO> es
obligatorio, diligéncielo e intente de nuevo.)

Set de datos Respuesta

Entidad
No. Nombre campo Tipo campo Tipo dato Ob. Validaciones
/Categoría Longitud
7
1 Datos Tipo Documento Text Alfanumérico Si  De la tabla EDIFACT 1153
30  Número de identificación del
2 Datos Número Documento Text Alfanumérico Si
importador/Exportador a consultar
Nombre o razón 150 Nombre o razón social del importador/exportador
3 Datos Text Alfanumérico No
social consultado
4 Datos Domicilio 150 Text Alfanumérico No Domicilio del importador/exportador consultado

Domicilio fiscal del importador/exportador

5 Datos Domicilio fiscal 150 Text Alfanumérico No
consultado

Correo electrónico o e-mail del

6 Datos Correo electrónico Text Alfanumérico No
150 importador/exportador consultado
 Numero de contacto del importador/exportador
7 Datos Teléfono Text Numérico No
13 consultado
Clasificación del importador/exportador
consultado
N/A Posibles valores:
8 Datos Clasificación Text Alfanumérico Si
-Importador (I)
-Exportador (E)
-Importador y exportador (IE)
9 Datos País Origen Text Alfanumérico Si País origen de la consulta realizada
Valores:
1- GT: Guatemala
2- HN: Honduras
N/A 3- SV: El Salvador
4- CR: Costa Rica
5- NI: Nicaragua
 ID
PDCC - Historia de usuario
019
Fecha de creación:
Página Página 6 de 8

6- PA: Panamá
País destino de la consulta realizada
Valores:
1- GT: Guatemala
2- HN: Honduras
10 Datos País Destino Text Alfanumérico Si
N/A 3- SV: El Salvador
4- CR: Costa Rica
5- NI: Nicaragua
6- PA: Panamá
Estado del registro consultado
Posibles valores:
N/A -Pendiente de Aprobación (1)
11 Datos Estado Text Alfanumérico No -Activo (2)
-Inactivo (3)
-Existe (4)
-No existe (5)

-Fecha en la que se realiza la consulta

YYYY-MM-
12 Datos Fecha N/A DATETIME Si - Debe recibir formato de la DUCA
DD hh:mm:ss
YYYY-MM-DDTHH:mm:ss

3
13 Respuesta Código Text Alfanumérico SI Código de error, respecto a la información consultada

14 Respuesta Descripción 150 Text Alfanumérico No Descripción personalizada del error presentado

Criterios de Aceptación:
Escenario: [001] Validar que la PDCC envíe JSON, para enrutar una petición de consulta hacia el Sistema Nacional del país
al que corresponda el registro.
Dado: Que se requiere redirigir la consulta a un país.
Cuando: Se ha recibido desde otro país, una petición de consulta perteneciente a un país y a una clasificación bien sea
Importador y/o Exportador.
Entonces: El resultado esperado deberá ser, el enrutamiento de la petición hacia otro país.

Escenario: [002] Validar que la PDCC Reciba JSON, la respuesta de una consulta redirigida.
Dado: Que se espera la respuesta por parte del sistema nacional consultado.
Cuando: Se ha redirigido una petición de consulta de un importador y/o exportador
 ID
PDCC - Historia de usuario
019
Fecha de creación:
Página Página 7 de 8

Entonces: El resultado será recibido y transmitido al país origen de la consulta.

Sistemas a interactuar:

No. Nombre País Convención ISO Nombre del Sistema Datos a enviar a Validaciones
PDCC
1. COSTA RICA CR TICA Ver sección
Detalle set de
2. EL SALVADOR ES SIDUNEA++/WORLD datos del Archivo
XML
3. GUATEMALA GT SAQ’B

4. PANAMA PA SIGA

5. HONDURAS HO SARAH

Reglas de Negocio:
Portal Web Notificaciones, Escritorio del Análisis de la Trazabilidad Módulo de Conexión con Repositorio Auditoria y
de la Avisos y Usuario información de Riesgo Procesos de Documental seguridad
plataforma - Alertas. Operaciones Pago
PDCC

No aplica para No aplica para No aplica para Consulta sobre el No aplica para No aplica No aplica para No aplica para Se debe llevar la
esta historia de esta historia de esta historia de set de datos esta historia de para esta esta historia de esta historia de auditoria de todas
usuario usuario usuario usuario historia de usuario usuario las consultas de
usuario los usuarios en el
sistema

Glosario de Términos:
Observaciones:
Set de datos propuesto, se requiere revisión, validación y aprobación u observaciones.
Documentos Relacionados:
 ID
PDCC - Historia de usuario
019
Fecha de creación:
Página Página 8 de 8

3. Aprobaciones:
Aprobado por
Autor Encargado de aprobación

Fecha aprobación: