InterfazBancos_ConsultaSaldo

Este Web Service Consulta, es utilizado para realizar la consulta del crédito, el cual nos retornara el saldo que necesita pagarse incluyendo el nombre de la cuenta a la que se realizó la consulta, en caso de agregar un número de crédito incorrecto, este nos indicará que la cuenta no existe.

NOTA: Antes re realizar pruebas es importante configurar la regla que ayudara a realizar la interacción con el sistema SIFCO y el banco, es impórtate agregar la siguiente regla al archivo llamado web.config que se encuentra en la raíz del aplicativo SIFCO.

<rule name="aInterfazBancos_ConsultaSaldoredirect" stopProcessing="true">
	<match url="^Consulta$" />
	<action type="Rewrite" url="aInterfazBancos_ConsultaSaldo.aspx" />
</rule>

EJEMPLOS DE REQUEST Y RESPONSE, PARA LOS SERVICIOS RESTful BAJO PROTOCOLO HTTPS.

La herramienta utilizada para realizar pruebas de conexión es POSTMAN. A continuación se mostraran los parámetros de conexión.

EL MÉTODO A UTILIZAR ES DE TIPO POST

Este método para este Web Service en específico permite manda un correo a un asesor con la información del nuevo afiliado en la Aplicación SIFCO WEB.

POST

URL= https://sifco-test-web-01.sifco.local/tuinstancia/Consulta

URL= https://sifco-test-web-01.sifco.local/tuinstancia/Consulta

NOTA: recuerde siempre consultar la URL de conexión, la antes mencionada es referencial

HEADERS

Para este webservice no necesitamos encabezados

BODY

KEY	VALUE

KEY

VALUE

message

<DATO_1>01010201000102</DATO_1>

<DATO_2>0</DATO_2>

<DATO_3>0</DATO_3>

<CODIGO_PAGO>0</CODIGO_PAGO>

</CONSULTA>

NOTA: En este caso necesitamos enviar un parámetro en el XML, el cual debe ser el número de la cuenta a consultar en la etiqueta DATO_1, este número nos retornara la información de la cuenta del cliente con los datos de pago.

Imagen de referencia

Al realizar la petición, este nos debe de retornar la información de la consulta realizada y un código 200

Operación realizada con éxito 200 (SUCCESSFUL OPERATION)

Resultado 1:

<RESP_CONSULTA>
    <DATO_RESP_1>01010201000102</DATO_RESP_1>
    <DATO_RESP_2>ALMA MAGALY RAMÍREZ LÓPEZ </DATO_RESP_2>
    <DATO_RESP_3> </DATO_RESP_3>
    <DATO_RESP_4> </DATO_RESP_4>
    <DATO_RESP_5> </DATO_RESP_5>
    <DATO_RESP_6> </DATO_RESP_6>
    <SALDO>2252.5</SALDO>
    <TVALIDACION>6</TVALIDACION>
    <CODIGO_RESPUESTA>000</CODIGO_RESPUESTA>
    <DESCRIPCION_RESPUESTA>Consulta Exitosa</DESCRIPCION_RESPUESTA>
</RESP_CONSULTA>

Resultado 2:

<RESP_CONSULTA>
    <CODIGO_RESPUESTA>001</CODIGO_RESPUESTA>
    <DESCRIPCION_RESPUESTA>Cuenta no existe, comunicarse con el acreedor</DESCRIPCION_RESPUESTA>
</RESP_CONSULTA>

Errores que pudieran ser por una mala configuración o parámetros incorrectos.

Error #1

Cuando la URL no se agrego correctamente.

El código de error será 404 not Found, con el siguiente mensaje:

“No se pudo encontrar el recurso solicitado, pero es posible que vuelva a estar disponible en el futuro. Se permiten solicitudes posteriores por parte del cliente.“

La URL esta compuesta de la siguiente manera:

https://sifco-test-web-01.sifco.local/tuinstancia/Consulta

https://sifco-test-web-01.sifco.local - el nombre del dominio (según lo proporcionado por SIFCO).
/tuinstancia- El nombre de la instancia instalada en el servidor de SIFCO.
/rest - nombre del parámetro con el que se ingresa (En este caso no utilizamos).
/Consulta - Nombre del WEB SERVICE

Error #2

Cuando la regla no esta creada en el archivo web.config

El código de error será 404 not Found, con el siguiente mensaje:

CODIGOS DE RESPUESTA

CÓDIGO	DESCRIPCIÓN

CÓDIGO	DESCRIPCIÓN
000	Consulta Exitosa
001	Cuenta no existe, comunicarse con el acreedor