Revisiones y autorizaciones Registro de cambios

Contenido

Revisiones y autorizaciones 2

Registro de cambios 2

Revisiones 2

Propósito 3

Descripción 3

Condiciones 3

Contratos de Interfaz (Layout) de solicitudes de Entrada al servicio 4

Solicitud de Estados de Cuenta Bancarios 4

Archivos de ejemplo y contrato 4

Elementos del contrato 4

Respuesta de Solicitud de Estados de Cuenta 6

Archivos de ejemplo 6

Definición de elementos de respuesta Acuse de recibió (ACK) 6

Definición de elementos de respuesta Resumen (SUM) 6

Definición de elementos de respuesta Procesado (PRO) 8

Definición de elementos de respuesta de Rechazo (REJ) 12

Definición de elementos de respuesta con Error (Solo para procesos síncronos RESTful) 13

Respuesta de mensajes desconocidos 14

Archivos de ejemplo 14

Definición de elementos de respuesta de mensajes desconocidos 15

Apéndice A 16

Estatus de Solicitudes 16

Códigos de Estatus 16

Caracteres Válidos 17

Códigos de Banco 17

Revisiones y autorizaciones

Registro de cambios

Fecha Autor Versión Referencias del cambio

27/03/17 42090 – Israel Reyes Ramírez 1.0 Versión Inicial

Revisiones

Responsable Versión Puesto Fecha

40756 – Alejandro González Hernández 1.0 Gerente de Servicios Institucionales 27/03/17

Propósito

El presente documento tiene como objetivo definir a detalle los contratos de interfaz que se deben cumplir para establecer comunicación entre GBM y los clientes de la renta TreasuryOutdoor, en específico la funcionalidad de Estados de cuenta bancarios, así como aclarar los mecanismos de comunicación.

Descripción

Condiciones

• Debe existir un enlace directo entre GBM y el cliente de la plataforma Treasury Outdoor.

• La tecnología de intercambio de mensajes es principalmente a través de colas JMS y en algunas funcionalidades son soportadas las peticiones vía RESTful.

• GBM cuenta con un proveedor de colas (Solace ESB)

• El contenido de los mensajes son documentos XML definidos por GBM.

• Todas las solicitudes deben cumplir los contratos de interfaz definidos (Layouts XML) para las solicitudes

Para el intercambio de información se tienen definidas desde el punto de vista de GBM colas de entrada y salida de manera asíncrona o peticiones síncronas en algunos casos.

Cola de Entrada: Cola definida para la entrada de mensajes de solicitudes a GBM.

• Solicitud de estados de cuenta bancarios (Síncrono y asíncrono)

Cola de Salida: Cola definida para entrega de respuestas de las solicitudes promovidas por el cliente de la plataforma

• Respuesta de Solicitud de Estados de cuenta.

o Acuse (ACK)

o Rechazo (REJ)

o Resumen (SUM)

o Procesado (PRO)

o La respuesta “Procesado” puede venir en N mensajes según los estados de cuenta generados y número de transacciones por estado de cuenta:

 Se genera un mensaje de respuesta por un Estado de Cuenta.

 El mensaje de un estado de cuenta sólo permite enviar hasta 50 transacciones en su contenido, si la consulta de estados de cuenta genera en un estado de cuenta con más de 50 transacciones, para ese estado de cuenta existirán N mensajes en múltiplos de 50 transacciones hasta completar el total de las transacciones.

o Error (ERR) (Solo para procesos síncronos RESTful)

o Error Mensajería Solace (Solo para procesos síncronos RESTful)

• Respuesta de mensajes desconocidos

o Error (ERR)

Estados por los que puede una solicitud de estados de cuenta bancarios

Contratos de Interfaz (Layout) de solicitudes de Entrada al servicio

En la definición los elementos se encuentran definidos anteponiendo entre paréntesis las siguientes letras:

- M (mandatorio)

- O (opcional)

- MM (mandatorio, una o más veces)

Solicitud de Estados de Cuenta Bancarios

Solicitud de Estados de Cuenta Bancarios la cual realiza las validaciones correspondientes a la operación interna de GBM, a los contratos del cliente o usuario (Según sea el caso) para posteriormente realizar la obtención de los datos de los estados de cuenta bancarios, segmentación de la información por estado de cuenta y resúmen.

Archivos de ejemplo y contrato

• ../Contratos/01.- EstadoCuentaBancario.xml

Elementos del contrato

• (M) CodigoCliente

• (M) CodigoUsuario

• (M) FechaCliente

• (M) FolioCliente

• (M) FechaEstadoCuenta

• (O) CodigoBanco

• (O) CodigoCuentaBancaria

• (O) Moneda

(M) CodigoCliente.

• Ruta Xml: EstadoDeCuentaBancario /CodigoCliente

• Tipo: Numérico 32 Bits.

• Descripción: Este elemento contiene el código asignado por GBM al cliente que solicita la renta de la plataforma.

(M) CodigoUsuario.

• Ruta Xml: EstadoDeCuentaBancario /CodigoUsuario

• Tipo: Numérico 32 Bits.

• Descripción: Este elemento contiene el código asignado por GBM al usuario del cliente que solicita la renta de la plataforma.

(M) FechaCliente.

• Ruta Xml: EstadoDeCuentaBancario /FechaCliente

• Tipo: Fecha UTC base 0 (Offset – Zero) y en Formato largo ISO 8601 (yyyy-MM-ddTHH:mm:ssZ).

• Descripción: Este elemento contiene la fecha de registro de operación del cliente.

(M) FolioCliente.

• Ruta Xml: EstadoDeCuentaBancario /FolioCliente

• Tipo: Alfanumérico limitado a 50 posiciones. Revisar apéndice A - Caracteres Validos.

• Descripción: Este elemento contiene el folio del cliente para su control interno.

(M) FechaEstadoCuenta

• Ruta Xml: EstadoDeCuentaBancario / FechaEstadoCuenta

• Tipo: Fecha en Formato corto ISO 8601 (yyyy-MM-dd).

• Descripción: Este elemento corresponde a la fecha del estado o estados de cuenta a consultar.

(O) CodigoBanco

• Ruta Xml: EstadoDeCuentaBancario / CodigoBanco

• Tipo: Numérico 32 Bits.

• Descripción: Este elemento contiene el código de banco a consultar. El código de banco es un código que GBM le asigna a cada banco de manera interna. Ver apéndice A: Códigos de banco.

(O) CodigoCuentaBancaria

• Ruta Xml: EstadoDeCuentaBancario / CodigoCuentaBancaria

• Tipo: Alfanumérico (Sólo letras

...