Asunto: Documento Servicio de Consulta de Estado de las … · 2019-02-25 · 1. Servicio De...

Bogotá D.C., 25 de febrero de 2019 No. 023

Asunto: Documento Servicio de Consulta de Estado de las Instrucciones de Liquidación del Contado.

Por medio del cual se publica el documento “Servicio de Consulta de Estado de las

Instrucciones de Liquidación del Contado”

DOCUMENTO INFORMATIVO Fecha: 06 febrero 2019

DOCUMENTO RENTA VARIABLE Versión: 01

Página 2 de 12

La información contenida en el presente documento es de carácter confidencial y de uso exclusivo CRCC S.A

CÁMARA DE RIESGO CENTRAL DE CONTRAPARTE DE COLOMBIA S.A.

SERVICIO DE CONSULTA DE ESTADO DE LAS INSTRUCCIONES DE LIQUIDACIÓN DEL

CONTADO



Página 3 de 12


TABLA DE CONTENIDO

1. Servicio De Consulta Del Estado De Liquidación Del Contado .................................................... 4

1.1. Descripción .......................................................................................................................... 4

1.2. Entradas .............................................................................................................................. 5

1.3. Salidas ................................................................................................................................. 5

1.4. Contrato del Servicio ............................................................................................................ 6

1.5. Mensajes de Ejemplo ........................................................................................................... 7

1.6. Códigos de Respuesta ......................................................................................................... 8

1.7. Seguridad ............................................................................................................................ 9

1.8. Requerimientos Conexión Servidor SFTP ......................................................................... 10

1.9. Diagrama De Conexión ...................................................................................................... 11

LISTADO DE DIAGRAMAS

Diagrama 1. Diagrama secuencia del servicio LiquidacionContadoCRCC .......................................... 4

Diagrama 2. Diagrama de Conexión del SFTP .................................................................................. 11

LISTADO DE TABLAS

Tabla 1 Entradas de Servicio LiquidacionContadoCRCC .................................................................... 5

Tabla 2 Salidas de Servicio LiquidacionContadoCRCC ....................................................................... 5



Página 4 de 12


1. Servicio De Consulta Del Estado De Liquidación Del Contado

1.1. Descripción

Este servicio permite consultar la información del estado de las instrucciones de liquidación del

contado del día actual.

En el header de la petición se debe enviar el usuario y la contraseña del usuario que hace la consulta

con el fin validar si cuenta con los respectivos permisos para generar la información del estado

contado.

La invocación de la operación del servicio dispara la consulta de la información, posterior a esto se

genera un archivo plano con la información del estado del contado, el cual a su vez es entregado a

GoAnyWhere para que se transportado al destino definido, una vez se termina este proceso se da la

repuesta al usuario informando que el proceso ha terminado de manera satisfactoria, siendo este el

caso de éxito.

En caso de obtener algún fallo en el proceso descrito, se informara en la respuesta de la invocación

de la operación del servicio.

Diagrama 1. Diagrama secuencia del servicio LiquidacionContadoCRCC



Página 5 de 12


1.2. Entradas Nombre Tipo de

dato Descripción Obligatorio Clase

Usuario Texto Nombre de usuario de Portal

SI Cabecera de mensaje SOAP

Contraseña Contraseña Contraseña de usuario de Portal

SI Cabecera de mensaje SOAP

Tabla 1 Entradas de Servicio LiquidacionContadoCRCC

1.3. Salidas Nombre Tipo de

dato Descripción Obligatorio Clase

Confirmación Texto Confirmación de proceso exitoso o error

SI Cuerpo de respuesta

Tabla 2 Salidas de Servicio LiquidacionContadoCRCC

• Archivo generado – Estado Instrucciones de Liquidación

archivo estados

IL.xlsx

• Nombre del archivo de salida

El nombre del archivo que se genera tendrá la siguiente estructura:

Tipo envío: P: Pantalla, W: WebService Indica que este archivo fue generado desde la

pantalla de Portal o desde el WS

Mercado: CV (Constante)

Entidad origen: Corresponde al miembro por el cual este informe esta filtrado

Año: Corresponde al año de la generación del informe

Mes: Corresponde al mes de la generación del informe

Día: Corresponde al día de la generación del informe



Página 6 de 12


Hora: Corresponde a la hora de la generación del informe

Minuto: Corresponde al minuto de la generación del informe

Segundo: Corresponde al segundo de la generación del informe

Extensión: .TXT (Constante Mayúscula)

Ejemplos:

Ejemplos

|X | XX| XXXX|AAAA|MM|DD |HH |MM |SS |.TXT

|Tipo envío|Mercado|Entidad origen|Año |Mes|Día|Hora|Minuto|Segundo|Extensión

String tipoEnvio P: Pantalla, W: WebService

WCVM02920190221091100.TXT

PCVM00120190222120005.TXT

1.4. Contrato del Servicio

WSDL

LiquidacionContadoCRCC.wsdl

XSD

LiquidacionContadoCRCC.xsd

Endpoint Pruebas Internet

https://camaraderiesgo.com.co/ProcessNovateTradeOSB/Proxy_Services/LiquidacionContadoCRCC?wsdl camaraderiesgo.com.co - 190.144.138.43

Endpoint Producción Internet

https://portal.camaraderiesgo.com.co/ProcessNovateTradeOSB/Proxy_Services/LiquidacionContadoCRCC?wsdl portal.camaraderiesgo.com.co - 201.234.176.34

https://camaraderiesgo.com.co/ProcessNovateTradeOSB/Proxy_Services/LiquidacionContadoCRCC?wsdl

https://camaraderiesgo.com.co/ProcessNovateTradeOSB/Proxy_Services/LiquidacionContadoCRCC?wsdl

https://portal.camaraderiesgo.com.co/ProcessNovateTradeOSB/Proxy_Services/LiquidacionContadoCRCC?wsdl

https://portal.camaraderiesgo.com.co/ProcessNovateTradeOSB/Proxy_Services/LiquidacionContadoCRCC?wsdl



Página 7 de 12


Endpoint Pruebas y Producción Canal Dedicado

Esta pendiente establecer el canal dedicado

1.5. Mensajes de Ejemplo

• Request:

<soapenv:Envelope

xmlns:liq="http://camaraderiesgo/schema/LiquidacionContadoCRCC"

xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

<soapenv:Header>

<wsse:Security xmlns:wsse="http://docs.oasis-

open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"

xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-

wssecurity-utility-1.0.xsd">

<wsse:UsernameToken wsu:Id="UsernameToken-

3E3F20A3266D42C3DE15501579245863">

<wsse:Username>rentavariablewsclient</wsse:Username>

<wsse:Password Type="http://docs.oasis-

open.org/wss/2004/01/oasis-200401-wss-username-token-profile-

1.0#PasswordText">ClaveAsignada</wsse:Password>

</wsse:UsernameToken>

</wsse:Security>

</soapenv:Header>

<soapenv:Body>

<liq:LiquidarContadoReq>?</liq:LiquidarContadoReq>

</soapenv:Body>

</soapenv:Envelope>

Response Exitoso:

<soapenv:Envelope


<soapenv:Header

xmlns:liq="http://camaraderiesgo/schema/LiquidacionContadoCRCC">

</soapenv:Header>

<soapenv:Body



Página 8 de 12



<LiquidarContadoResp>

<ConfirmacionResponse>

<header sentBy="A10" sendTo="CRCC"

creationTimestamp="2019-02-14T14:21:47.869-05:00"/>

<information status="000" description="El archivo se ha

generado exitosamente">

</information>

</ConfirmacionResponse>

</LiquidarContadoResp>

</soapenv:Body>

</soapenv:Envelope>

• Response Error:

<soapenv:Envelope


<soapenv:Header

xmlns:liq="http://camaraderiesgo/schema/LiquidacionContadoCRCC"></soapenv

:Header>

<soapenv:Body


<LiquidarContadoResp>

<ConfirmacionResponse>

<header sentBy="A10" sendTo="CRCC" creationTimestamp="2019-

02-14T14:21:47.869-05:00"/>

<information status="001" description="Error de

autenticación. El usuario y contraseña no coinciden"/>

</ConfirmacionResponse>

</LiquidarContadoResp>

</soapenv:Body>

</soapenv:Envelope>

1.6. Códigos de Respuesta

Configuración de los posibles códigos de respuesta que se obtienen al consumir el servicio.

status description

000 Archivo generado de manera exitosa

001 Error de autenticación. El usuario y contraseña no coinciden

002 Error en la generación del archivo



Página 9 de 12


003 Error en el transporte del archivo

Tabla 3 Código de respuestas

1.7. Seguridad

1. La comunicación entre los miembros y la CRCC es síncrona, lo que significa que por cada petición que se haga, se debe esperar la respuesta en línea.

2. En el ambiente de producción existen 2 medios de acceso a la plataforma de integración: Internet y canales dedicados. Este ambiente provee sus servicios en dos centros de cómputo: CCP y CCA.

3. En el ambiente de pruebas existe 1 medio de acceso a la plataforma de integración: canales dedicados. Este ambiente provee sus servicios en un centro de cómputo: CCA.

4. La comunicación entre los miembros y el sistema de la CRCC se harán mediante servicios web, que serán accedidos vía protocolos seguros de comunicaciones (HTTPS), usando estándares de seguridad de servicios web: WS-Security.

5. El uso del protocolo HTTPS es obligatorio y otorga seguridad a nivel de transporte cifrando la comunicación establecida entre el cliente y el servidor. Se usa el esquema de autenticación one-way SSL. Es responsabilidad del cliente verificar la identidad del servidor de la CRCC.



Página 10 de 12


1.8. Requerimientos Conexión Servidor SFTP

Requerimientos de Conexión del Servidor SFTP para descargar el archivo de Estado Instrucciones

de Liquidación:

Equipo Pentium Intel 4 o superior, sistema operativo Windows 7 / Windows 10 / Windows server 2012

Browser Internet Explorer / Firefox / Chrome

Cliente SFTP WinScp / FileZilla

Conexión por Canal Privado UT Producción

Canal Unión temporal Ancho de Banda 256 Kbps

Permisos puertos Puerto tcp/922, tcp/443

Link Principal https://10.211.27.147/webclient/Login.xhtml

Link Alterno https://10.211.28.49/webclient/Login.xhtml

Conexión Por Internet Producción

Conexión por Internet Acceso Internet

Permisos Puertos Puerto tcp/922, tcp/443

Link principal https://repositorio.camaraderiesgo.com.co/webclient/Login.xhtml

Link Alternos https://repositorio2.camaraderiesgo.com.co/webclient/Login.xhtml

Conexión Por Internet Pruebas

Conexión por Internet Acceso Internet

Permisos Puertos Puerto tcp/922, tcp/443

Link https://rpspruebas.crcc.com.co/webclient/Login.xhtml

Conexión por Canal Privado UT Pruebas

Canal Unión temporal Ancho de Banda 256 Kbps

Permisos puertos Puerto tcp/922, tcp/443

Link https://10.210.28.153/webclient/Login.xhtml

Tabla 4 Requerimientos Conexión Servidor SFTP

https://10.211.27.147/webclient/Login.xhtml





Página 11 de 12


1.9. Diagrama De Conexión del SFTP

Diagrama 2. Diagrama de Conexión del SFTP



Página 12 de 12


CONTROL DEL DOCUMENTO

Información del Documento:

Información

Identificación

Documento

Mediante este documento se describe técnicamente el servicio web de

estado de instrucciones de liquidación del Contado.

Medio de

publicación SharePoint.

Última Fecha

Actualización Ver “Historia del Documento”

Nombre del Archivo: Servicio Web - Estado Instrucciones de Liquidación

Dirigido a: Proyecto Renta Variable

Tipo de Documento: Publica.

Historia del Documento:

Versión Fecha Cambio

1.0 2019/05/15 Versión inicial

Última versión

Elaborado por: Administración de Aplicaciones

Revisado por: Subgerente de Tecnología

Aprobado por: Subgerente de Tecnología

Asunto: Documento Servicio de Consulta de Estado de las … · 2019-02-25 · 1. Servicio De...

Documents

Transcript of Asunto: Documento Servicio de Consulta de Estado de las … · 2019-02-25 · 1. Servicio De...