SIF América S.A. Proyecto NICARAGUA. Especificación de la Mensajería XML. Versión 1.1

Transcripción

1 SIF América S.A. Proyecto NICARAGUA Especificación de la Mensajería XML Versión 1.1

2 Revisiones Fecha Versión Descripción Autor 25/08/ Primera versión Pablo Andrés Alves 01/09/ Revisión control de calidad Verónica Benvenuto Confidencial SIF América S.A. Página 2/7

3 Contenido 1. Presentación del Sub-Sistema de Mensajería Breve descripción Funciones principales del Sub-Sistema de Mensajería : Actores involucrados Primarios Secundarios Estándares y protocolos Empaquetado SOAP 1.1 (Document) Datos de identificación 6 3. Esquema de seguridad para la mensajería Seguridad en el canal de comunicación Identificación del emisor Permisos de ejecución 6 4. Procesamiento de los mensajes Mensaje de reporte de anomalías en una operación. 7 Confidencial SIF América S.A. Página 3/7

4 Especificación de la Mensajería XML 1. Presentación del Sub-Sistema de Mensajería 1.1 Breve descripción El Sub-Sistema de Mensajería es el módulo encargado de administrar y controlar el flujo de información entre el propio Sistema Aduanero y las entidades externas (Agentes de Aduana, Transportistas, Depositarios, Bancos, Entidades Públicas), que tengan necesidad de interactuar con éste por un medio electrónico de intercambio de información Funciones principales del Sub-Sistema de Mensajería : 1) Administrar y auditar el flujo de mensajes entre la Aduana y los actores externos. 2) Establecer la identidad de los emisores y controlar los permisos correspondientes en el módulo de seguridad. 3) Controlar la recepción, la ejecución y la respuesta en tiempo y forma de todos los mensajes enviados al sistema. 4) Balancear la carga de procesamiento entre mensajes asincrónicos y sincrónicos. 1.2 Actores involucrados Primarios. Los principales actores que se conectarán por medio de la mensajería son los auxiliares de la función pública aduanera : Agentes de Aduana, Transportistas, Depositarios Secundarios. El sub-sistema de mensajería también servirá para interfacear con otras entidades o sistemas que requieren algún tipo de servicio particular : Sistemas internos existentes en la Aduana, Entidades Bancarias, Reparticiones del Estado, Aduanas de otros países, Terceros Organismos nacionales e internacionales. 2. Estándares y protocolos El formato que tendrán los mensajes a transmitir a la Aduana será el dado por la especificación XML ( El protocolo de comunicación que se utilizará para la transmisión de los mensajes al Sub-Sistema de mensajería será el protocolo HTTPS (HTTP con SSL) sobre TCP/IP. Confidencial SIF América S.A. Página 4/7

5 2.1 Empaquetado SOAP 1.1 (Document) El sistema de mensajería utilizará el estándar SOAP ( como protocolo de transmisión de los mensajes con formato XML (Protocolo definido para el esquema Web-Services). Especificación : Ejemplo de empaquetado SOAP : <?xml version='1.0' encoding='utf-8'?> <soapenv:envelope xmlns:soapenv=" xmlns:wsa=" <soapenv:header> <wsse:security xmlns:wsse=" 1.0.xsd" soapenv:mustunderstand="1"> <wsse:usernametoken xmlns:wsu=" wsu:id="usernametoken "> <wsse:username>codigousuario</wsse:username> <wsse:password Type=" </wsse:usernametoken> </wsse:security> <wsa:to> Url del Servicio Aduanero de Mensajería </wsa:to> <wsa:messageid> urn:uuid: (IdentificaciónDefinido por el sistema emisor) </wsa:messageid> <wsa:action>urn:invokeservice</wsa:action> </soapenv:header> <soapenv:body> <ana:call xmlns:ana=" ana:service="servicename"> </ana:call> </soapenv:body> </soapenv:envelope> XML MESSAGE Confidencial SIF América S.A. Página 5/7

6 2.1.1 Datos de identificación <username> : Código único de identificación aduanera. Obligatorio. Numérico(5) <password> : Clave personal del usuario. Obligatorio. Alfanumérico(15) <servicename> : Nombre del servicio de negocio a invocar. Obligatorio. Alfanumérico(15) <XML MESSAGE> : Mensaje a enviar, acorde a la especificación del servicio de negocio invocado. 3. Esquema de seguridad para la mensajería La seguridad en el envío de mensajes estará definida en 3 niveles : 1) Canal de comunicación, 2) Identificación del emisor y 3) Permisos de ejecución 3.1 Seguridad en el canal de comunicación Para dar seguridad al canal de comunicación desde la PC o Servidor del emisor hasta el Servidor de la Aduana, se requerirá establecer una conexión SSL previo al envío del mensaje. 3.2 Identificación del emisor Para la identificación del emisor se requerirá el envío de su Código único aduanero de identificación y la clave correspondiente, los mismos serán otorgados por la Administración Central del Sistema. El usuario podrá posteriormente modificar su clave. 3.3 Permisos de ejecución Se controlarán a nivel aplicativo los permisos de ejecución habilitados para el usuario emisor y su habilitación general en el sistema. Así mismo se registrarán todos los llamados y las respuestas originadas luego del procesamiento de los servicios de negocio. 4. Procesamiento de los mensajes El sistema de mensajería procesará información en forma permanente de todos los auxiliares de la función pública. Es posible que algunos mensajes queden encolados momentáneamente, haciendo que su procesamiento en el sistema sea realizado con posterioridad a su recepción. Cuando esto ocurre, se dice que el mensaje está pendiente de procesamiento. El sistema en estos casos devuelve una respuesta del tipo TRN-PEND (Transacción Pendiente) al emisor del mensaje, asignándole un número único de identificación a la transacción enviada. El emisor podrá consultar y recuperar en otro momento, dicha operación, a través del mensaje TRN-REC (Recupero de Transacción) con el número de transacción asignado previamente. SI se realiza el procesamiento del mensaje en el momento de su recepción, el sistema retornará directamente al emisor el mensaje de respuesta correspondiente al mensaje enviado. Confidencial SIF América S.A. Página 6/7

7 El sistema asigna un número de transacción único a cada operación, sin importar el momento del procesamiento del mismo. Esto permite una auditoría detallada de su recepción, su procesamiento y respuesta al emisor. 4.1 Mensaje de reporte de anomalías en una operación. El sistema de mensajería de la aduana recibe los mensajes enviados por los auxiliares de la función pública en todo momento. En algunos casos, el procesamiento de los mismos puede generar o derivar en el rechazo de la operación debido a controles funcionales que impiden el correcto registro de los datos. Cuando esto ocurre, el sub-sistema de mensajería genera como respuesta el mensaje de reporte de errores correspondiente que permitirá al emisor del mensaje corregir y/o completar la información original, para luego enviar nuevamente su mensaje actualizado. Confidencial SIF América S.A. Página 7/7