asunto: documento servicio de consulta de estado de las … · 2019-02-25 · 1. servicio de...
TRANSCRIPT
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
DOCUMENTO INFORMATIVO Fecha: 06 febrero 2019
DOCUMENTO RENTA VARIABLE Versión: 01
Página 3 de 12
La información contenida en el presente documento es de carácter confidencial y de uso exclusivo CRCC S.A
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
DOCUMENTO INFORMATIVO Fecha: 06 febrero 2019
DOCUMENTO RENTA VARIABLE Versión: 01
Página 4 de 12
La información contenida en el presente documento es de carácter confidencial y de uso exclusivo CRCC S.A
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
DOCUMENTO INFORMATIVO Fecha: 06 febrero 2019
DOCUMENTO RENTA VARIABLE Versión: 01
Página 5 de 12
La información contenida en el presente documento es de carácter confidencial y de uso exclusivo CRCC S.A
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
DOCUMENTO INFORMATIVO Fecha: 06 febrero 2019
DOCUMENTO RENTA VARIABLE Versión: 01
Página 6 de 12
La información contenida en el presente documento es de carácter confidencial y de uso exclusivo CRCC S.A
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
DOCUMENTO INFORMATIVO Fecha: 06 febrero 2019
DOCUMENTO RENTA VARIABLE Versión: 01
Página 7 de 12
La información contenida en el presente documento es de carácter confidencial y de uso exclusivo CRCC S.A
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
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header
xmlns:liq="http://camaraderiesgo/schema/LiquidacionContadoCRCC">
</soapenv:Header>
<soapenv:Body
DOCUMENTO INFORMATIVO Fecha: 06 febrero 2019
DOCUMENTO RENTA VARIABLE Versión: 01
Página 8 de 12
La información contenida en el presente documento es de carácter confidencial y de uso exclusivo CRCC S.A
xmlns:liq="http://camaraderiesgo/schema/LiquidacionContadoCRCC">
<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
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header
xmlns:liq="http://camaraderiesgo/schema/LiquidacionContadoCRCC"></soapenv
:Header>
<soapenv:Body
xmlns:liq="http://camaraderiesgo/schema/LiquidacionContadoCRCC">
<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
DOCUMENTO INFORMATIVO Fecha: 06 febrero 2019
DOCUMENTO RENTA VARIABLE Versión: 01
Página 9 de 12
La información contenida en el presente documento es de carácter confidencial y de uso exclusivo CRCC S.A
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.
DOCUMENTO INFORMATIVO Fecha: 06 febrero 2019
DOCUMENTO RENTA VARIABLE Versión: 01
Página 10 de 12
La información contenida en el presente documento es de carácter confidencial y de uso exclusivo CRCC S.A
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
DOCUMENTO INFORMATIVO Fecha: 06 febrero 2019
DOCUMENTO RENTA VARIABLE Versión: 01
Página 11 de 12
La información contenida en el presente documento es de carácter confidencial y de uso exclusivo CRCC S.A
1.9. Diagrama De Conexión del SFTP
Diagrama 2. Diagrama de Conexión del SFTP
DOCUMENTO INFORMATIVO Fecha: 06 febrero 2019
DOCUMENTO RENTA VARIABLE Versión: 01
Página 12 de 12
La información contenida en el presente documento es de carácter confidencial y de uso exclusivo CRCC S.A
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