Guía técnica para implementación del WSDL como entidad de destino

D O C U M E N T O
T É C N I C O
G U Í A D E U S O D E L W D S L E N T I D AD D E S T I N O
SERIE DE NORMAS Y PROCEDIMIENTOS
BORRADOR DOCUMENTO TÉCNICO
GUÍA DE USO DEL WDSL – ENTIDAD
DESTINO
SERIE DE NORMAS Y PROCEDIMIENTOS
BORRADOR DOCUMENTO TECNICO – IPLEMENTACIÓN WSDL ENTIDAD DESTINO
Tabla de contenido
1. Introducción ...................................................................................... 1
2. Alcance ............................................................................................. 1
3. Términos empleados .......................................................................... 2
4. Dirección de recursos ........................................................................ 2
5. Configuración del URL destino ......................................................... 2
6. Archivos para generar la clase del WSDL .......................................... 2
7. Generación de la clase ....................................................................... 2
BORRADOR DOCUMENTO TECNICO – IPLEMENTACIÓN WSDL ENTIDAD DESTINO
Sistema Nacional de Pagos Electrónicos
Sistemas de Pagos - BCCR
Año 2013
1. Introducción
El contenido de este documento describe de manera técnica la guía de uso del WDSL para
que una entidad actue como destino del servicio de Pagos Monedero Bancario (PMB).
En particular, el objetivo de este documento es servir a los departamentos de informática de
cada entidad bancaria como guía de implementación del WDSL cómo entidad de destino para
agilizar la participación de las mismas en el servicio.
2. Alcance
Este documento explica los elementos técnicos para que una entidad pueda implementar el
WSDL y así logre servir como destino a los servicios de negocio de Pagos Monedero
Bancario (PMB).
Confidencialidad: Público
Edición N° 0
1
BORRADOR DOCUMENTO TECNICO – IPLEMENTACIÓN WSDL ENTIDAD DESTINO
3. Términos empleados
Para los fines del presente documento, se entenderá por:

BCCR: Banco Central de Costa Rica.

SINPE: Sistema Nacional de Pagos Electrónicos.

PMB: Servicio de Pagos Monedero Bancario.

WCF: Windows Comunication Foundation, es un marco tecnológico de trabajo para la
creación de aplicaciones orientadas a servicios, en nuestro caso es la tecnología utilizada
para la comunicación entre las entidades participantes y el Banco Central.

WSDL: Web Services Description Language
4. Dirección de recursos
En la siguiente dirección web podrá acceder a todos los recursos necesarios para la
implementación del WSDL como una entidad cliente.
http://varela/documentacion/SERVICIOS%20EN%20TIEMPO%20REAL/ENTIDAD%20DESTIN
O/Pruebas%20Monedero%20Bancario/WCF%20Destino/
5. Configuración del URL destino
El servicio implementado por la entidad en el destino debe publicarse en un IIS utilizando la
tenología WCF de Microsoft. El URL de este WCF debe estar asegurado mediante el
certificado digital asignado al nodo.
El URL y el CN del subject del certificado deben de configurarse dentro de las parámetros del
SINPE para iniciar la puesta en marcha del servicio.
Esta configuración debe hacerse por medio del Centro de Operaciones del SINPE.
6. Archivos para generar la clase del WSDL
A continuación se detallan los archivos necesarios para generar la clase con la cual se debe
implementar el WSDL, estos pueden ser accedidos desde la dirección de recursos.
bccr.sinpe.pmb.destino.wsdl
bccr.sinpe.pmb.destino.xsd
bccr.sinpe.pmb.si.model.xsd
schemas.microsoft.com.2003.10.Serialization.xsd
7. Generación de la clase
Para la generación de la clase necesaria para la implementación se debe usar la herramienta
svcutil.exe en la línea de comandos del Visual Studio. Prmero se debe navegar hasta la
Confidencialidad: Público
Edición N° 0
2
BORRADOR DOCUMENTO TECNICO – IPLEMENTACIÓN WSDL ENTIDAD DESTINO
carpeta donde se encuentren los archivos necesarios descritos en la sección anterior y
seguidamente ejectuar la sintaxis especificada a continuación:
svcutil bccr.sinpe.pmb.destino.wsdl bccr.sinpe.pmb.destino.xsd
bccr.sinpe.pmb.si.model.xsd
schemas.microsoft.com.2003.10.Serialization.xsd
Esto genera los siguientes dos archivos dentro de la misma carpeta:
MonederoBancario.cs, output.config
La acción queda ilustrada en la siguiente figura en donde los archivos son colocados a manera
de ejemplo en una carpeta llamada WSDL en la unidad E:
El output.config debe ser usado para crear el web.config del proyecto y del archivo
MonederoBancario.cs debe ser usada la interfaz IMonederoBancario como contrato para
implementar el proyecto.
Confidencialidad: Público
Edición N° 0
3