1. Especificaciones Técnicas integración BVC
1.5. Servicios de la BVC
1.5.2. Diseño de servicios Funcionales
1.5.2.7. Servicio de Notificación de Papeleta
Código y nombre del servicio
S0047- Notificación de Papeleta
Objetivos del servicio
El objetivo principal de este servicio es permitir a la BVC notificar todos
los datos de la papeleta por punta
Así, este servicio tiene como precondición que el proceso de comple-
mentación hubiera terminado exitosamente con las dos puntas de una
operación (punta de venta y punta de compra), para que mediante es-
te servicio se envíen de todas las fracciones la información de la pape-
leta a cada uno de los afiliados participes de la operación, donde se en-
tregaran datos como montos, comisiones, impuestos, totales liquida-
dos, etc.
Características del servicio
Este servicio debe tener las siguientes características:
Característica
Valor
Comentarios
Sincrónico Si
Patrón
Notificación
El BO de la BVC cada vez que detecta que
se complementaron exitosamente las dos
puntas de la operación, envía la notificación
con los datos de liquidación a los afiliados
dueños de la operación.
Capa BackOffice
Frecuencia Por Evento
Necesidad entre-
ga certificada
Si
Tamaño del men-
saje
700 Bytes
Persistencia
Si
Elaborado por: Arquitectura Revisado por: Aprobado por: Vicepresidente de
Las siguientes son las consideraciones que se deben tener para este servicio:
Item
Descripción
Información de
entrada al ser-
vicio
El servicio debe recibir la información de la liquidación
para todas las fracciones de la operación y con esta ge-
nerar un solo XML que le será entregado al afiliado co-
rrespondiente. Debe esperar a que le llegue la informa-
ción de todas las fracciones.
Salida del ser-
vicio
El servicio debe garantizar la entrega de la información al afiliado correspondiente
BackOffice
Es responsabilidad del BackOffice entregar la información
de liquidación de todas las fracciones.
1.5.2.7.2. Diagrama de secuencia
El siguiente es el diagrama de secuencia para el servicio de liquidación de la ope-
ración:
Las especificaciones del mensaje y las reglas de transformación se encuentran de-
talladas en el formato FOI que se relacionan a continuación y los XML y XSD utili-
zados:
¾ BUS_EJ_FOI_FIXMLM002DatosPapeleta
Ejemplo Archivos XML
¾ M002-FIXML-DatosPapeleta.xml
¾ M002-FIXML-DatosPapeleta99.xml
1.5.2.7.3. Proceso en el bus para el uso del servicio
El proceso que debe ejecutar el BUS en la ejecucion de este servicio es el
siguiente:
Espera y recepcion Datos Liquidacion x Fraccion Inicio No Recibidas todas las Fracciones? Generación XML con la informacion de liquidacion de todas las fracciones FIN Si Guardar Datos Liquidación Fracción Notificacion Mensaje Manejo Error Hubo Error? Si No Validacion Datos Hubo Error? Manejo ErrorSi
Elaborado por: Arquitectura Revisado por: Aprobado por: Vicepresidente de
1.5.2.7.4. Pasos del proceso
#
Paso
Tipo Paso
Descripción
1 Espera y re-
cepción datos
liquidación x
fracción
Entrada
En este paso el servicio debe escuchar y recibir los XMLs
con la información de liquidación por fracción. Debe agru-
parlos por Folio, Fecha de la operación y Afiliado. El campo
TotNoAllocs indica el número total de fracciones para esa
operación que se deben esperar antes de que pueda pa-
sarse a la generación del XML. La información de cada
fracción debe estar contenida por el BUS para que se pue-
da generar el XML de salida con toda la información reque-
rida. En caso de que pasen mas de 2 minutos desde el en-
vió de la primera fracción y no se hubiera recibido el total
de las fracciones se debe generar una alerta al rol definido
por la BVC.
2 Validación de
datos
Validación
En este paso el proceso valida que todos los datos recibi-dos por el proceso estén correctos y que los campos re-
queridos estén diligenciados.
3 Guardar Datos
Liquidación
Fracción
Procesa-
miento
El BUS debe guardar la información de cada fracción para después de recibir todas las fracciones poder agruparla y
generar el XML completo.
4 Recibidas to-
das las frac-
ciones
Condicional Luego se valida si el BO ha enviado toda la información de
liquidación para las fracciones de la operación. Es decir si
el numero de fracciones recibidos para una operación es
igual a TotNoAllocs, Si no, sigue esperando por las fraccio-
nes restantes, de lo contrario pasa al siguiente paso.
5 Generación
XML con la in-
formación de
todas las frac-
ciones
Procesa-
miento
Una vez recibe todas las tramas con la información de la liquidación para todas las fracciones, genera un XML con
dicha información agrupada según el FOI indicado.
6 Envío Notifica-
ción
Envío
Esta caja se encarga de notificarle al afiliado respectivo, el XML con toda la información de la liquidación de todas las
fracciones.
7 Hubo Error?
Condición
Detecta si al realizar el envió se genero algún error.
8 Manejo Error
Error
Si hubo error esta caja se debe encargar de generar un
log, alertar al administrador y guardar el mensaje para
después republicarlo si es el caso.
1.5.2.7.5. Escenarios de prueba (Unitarias de desa-
rrollo)
Escenario 1: Entrega liquidación una fracción
# 0001
Nombre de la prueba Entrega liquidación una fracción Tipo de Operación Convenida o cruzada
Tipo de Operaciones por punta
Entera
Mercado Acciones Numero Fracciones
Punta Compra y Venta
Resultado Esperado XML con la liquidación de la fracción Descripción Pa-
so
Descripción Resultado esperado
1 El BO envía la trama de liqui- dación una vez termina exi- tosamente el proceso de complementación 2 El BUS recibe la trama y
realiza reglas de transforma- ción
3 El BUS genera el XML En este escenario el BO de
la BVC después de com- plementar exitosamente una operación con una sola fracción, envía la in- formación de liquidación para cada una de las pun- tas. El bus debe escuchar la trama con la informa- ción de la liquidación y luego generar el XML con la información recibida.
4 El BUS envía el XML al solici- tante
XML con la información de la liquidación, con la especifica- ción contenida en el FOI “PL_FOI_S0047_v0.9_20070 625_M002_FIXML_Datos liquidacion.xls”
Elaborado por: Arquitectura Revisado por: Aprobado por: Vicepresidente de
Escenario 2: Entrega liquidación varias fracciones
# 0002
Nombre de la prueba Entrega liquidación varias fracciones Tipo de Operación Convenida o cruzada
Tipo de Operaciones por pun- ta
Fraccionada
Mercado Acciones
Numero Fracciones 10
Punta Compra y venta
Resultado Esperado XML con la información de liquidación de todas las fracciones
Descripción Pa-
so
Descripción Resultado esperado
1 El BO envía las trama de liquida- ción una vez termina exitosamen- te el proceso de complementación 2 El BUS recibe y espera todas las
tramas asociadas a la operación y realiza reglas de transformación 3 El BUS genera el XML con la in-
formación de todas las fracciones relacionadas a la operación En este escenario el BO de la BVC
después de complementar exito- samente una operación con una sola fracción, envía la información de liquidación para cada una de las puntas. El bus debe escuchar la trama con la información de la liquidación y luego generar el XML con la información recibida.
4 El BUS envía el XML al solicitante XML con la informa- ción de la liquidación, con la especificación contenida en el FOI
Escenario 3: Entrega liquidación varias fracciones
varias operaciones
# 0003
Nombre de la prueba Entrega liquidación varias fracciones varias operaciones Tipo de Operación Convenida o cruzada
Tipo de Operaciones por punta
Entera y fraccionada
Mercado Acciones Numero Fracciones
Punta Compra
Resultado Esperado XML con la aceptación de la complementación
Descripción Paso Descripción Resultado esperado 1 El BO envía las trama de
liquidación una vez termina exitosamente el proceso de complementación, de dife- rentes operaciones al mismo tiempo.
2 El BUS recibe, espera y agru- pa todas las tramas por ope- ración y punta y realiza re- glas de transformación 3 El BUS genera los diferentes
XML con la información de todas las fracciones relacio- nadas a cada punta de cada operación, que se envió con- currentemente
En esta prueba se com- plementan varias opera- ciones con varias fraccio- nes al mismo tiempo, para que se genere información de liquidación de diferentes operaciones concurrente- mente. El bus debe agru- par correctamente la in- formación de la liquidación para cada operación y afi- liado, y generar los XML pertinentes.
4 El BUS envía los diferentes XML a los receptores relacio- nados en las puntas de las diferentes operaciones.
XMLs con la información de la liquidación para cada punta de cada operación, con la especifica- ción contenida en el FOI
Elaborado por: Arquitectura Revisado por: Aprobado por: Vicepresidente de
Escenario 4: Alarma por retraso en la entrega de to-
da la información de liquidación
# 0004
Nombre de la prueba Generación de alarma por retraso en la entrega de toda la información de liquidación
Tipo de Operación Convenida o cruzada Tipo de Operaciones por pun-
ta
fraccionada
Mercado Acciones
Numero Fracciones 10
Punta Compra
Resultado Esperado Alarma al Administrador
Descripción Paso Descripción Resultado
esperado 1 El BO envía las trama de liquidación una
vez termina exitosamente el proceso de complementación, de una operación fraccionada, menos una de las fraccio- nes
2 El BUS recibe, espera y agrupa todas las tramas por la operación, faltándole una por recibir.
En esta prueba consiste en que el BackOffice inicie el envió de la información de liquidación para una operación fraccionada, pero le quede faltando una fracción. Después de 2 minutos, el Bus debe generar una alerta indicán- dole al administrador del error para que se tomen las medidas correspondiente, procedimental- mente.
3 Después de 2 minutos se genera una alarma indicándole al administrador del retrazo de la información
Generación de alarma al adminis- trador
Escenario 5: Trama de liquidación Incorrecta
# 0005
Nombre de la prueba Trama de liquidación Incorrecta Tipo de Operación Convenida o cruzada
Tipo de Operaciones por pun- ta
Entera
Mercado Acciones
Numero Fracciones 1
Punta Compra
Resultado Esperado Alarma al Administrador
Descripción Paso Descripción Resultado esperado 1 El BO envía las trama de liquidación Generación de alarma
al administrador En esta prueba consiste en que el
BackOffice envía una trama de liquidación con una longitud dife- rente a la establecida. El servicio debe validar la longitud de la estructura y generar una alarma indicando el error.
Escenario 6: Datos Requeridos Incompletos
# 0006
Nombre de la prueba Datos requeridos incompletos Tipo de Operación Convenida o cruzada Tipo de Operaciones por pun-
ta
Entera
Mercado Acciones
Numero Fracciones 1
Punta Compra
Resultado Esperado Alarma al Administrador
Descripción Paso Descripción Resultado esperado En esta prueba consiste en que el
BackOffice envía una trama de
1 El BO envía las trama de liqui- dación
Generación de alarma al administrador
Elaborado por: Arquitectura Revisado por: Aprobado por: Vicepresidente de liquidación con alguno de los
datos requeridos sin ningún va- lor. El servicio debe validar que se encuentren los datos requeri- dos y generar una alarma indi- cando el error.
Escenario 7: Datos no corresponden con el Esquema
XML
# 0007
Nombre de la prueba Los datos de la trama no corresponden con el esquema XML definido Tipo de Operación Convenida o cruzada
Tipo de Operaciones por pun- ta
Entera
Mercado Acciones
Numero Fracciones 1
Punta Compra
Resultado Esperado Alarma al Administrador
Descripción Paso Descripción Resultado esperado 1 El BO envía las trama de liqui-
dación
Generación de alarma al administrador
Esta prueba consiste en que el BackOffice envía una trama de liquidación con un campo con un valor invalido (por ejemplo Side = Z). El servicio valida que este valor no se permita para el cam- po y generar una alarma indican- do el error.