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.
...
| Note |
|---|
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. |
| Code Block |
|---|
<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.
| Info |
|---|
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
| Note |
|---|
NOTA: recuerde siempre consultar la URL de conexión, la antes mencionada es referencial |
Para este webservice no necesitamos encabezados
KEY | VALUE |
|---|---|
message | <CONSULTA> <DATO_1>01010201000102</DATO_1> <DATO_2>0</DATO_2> <DATO_3>0</DATO_3> <CODIGO_PAGO>0</CODIGO_PAGO> </CONSULTA> |
| Info |
|---|
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. |
Al realizar la petición, este nos debe de retornar la información de la consulta realizada y un código 200
| Tip |
|---|
Operación realizada con éxito 200 (SUCCESSFUL OPERATION) |
Resultado 1:
| Code Block |
|---|
<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:
| Code Block |
|---|
<RESP_CONSULTA>
<CODIGO_RESPUESTA>001</CODIGO_RESPUESTA>
<DESCRIPCION_RESPUESTA>Cuenta no existe, comunicarse con el acreedor</DESCRIPCION_RESPUESTA>
</RESP_CONSULTA> |
...
| Warning |
|---|
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:
...
| Info |
|---|
CODIGOS DE RESPUESTA |
CÓDIGO | DESCRIPCIÓN |
|---|---|
000 | Consulta Exitosa |
001 | Cuenta no existe, comunicarse con el acreedor |