Este Web Service Pago_Reversion, es utilizado para realizar dos operaciones, la primera realiza el pago y la segunda la reversión del pago, es importante indicar la acción que se desea realizar para que el proceso se ejecute correctamente.
Para realizar un pago es necesario enviar un parámetro indicando el mismo, el dato que se enviara sera una letra “P“ dentro de la etiqueta. Ejemplo: <PAGO_REVERSION>P</PAGO_REVERSION>.
Para realizar una reversión es necesario enviar un parámetro indicando el mismo, el dato que se enviara sera una letra “R“ dentro de la etiqueta. Ejemplo: <PAGO_REVERSION>R</PAGO_REVERSION>.
...
| Note |
|---|
NOTA: Antes de 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_Pago_Reversionredirect" stopProcessing="true">
<match url="^Pago_Reversion$" />
<action type="Rewrite" url="aInterfazBancos_Pago_Reversion.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 | <PAGOREVERSION> <DATO_1>01010201000102</DATO_1> <DATO_2>2</DATO_2> <DATO_3>3</DATO_3> <CODIGO_PAGO>999</CODIGO_PAGO> <PAGO_ONLINE>1</PAGO_ONLINE> <MONTO_PAGADO>2252.50</MONTO_PAGADO> <EFECTIVO>2252.50</EFECTIVO> <CHEQUES_AJENOS>0</CHEQUES_AJENOS> <BANCO>GT</BANCO> <FECHA_PAGO>31/07/2024</FECHA_PAGO> <PAGO_REVERSION>P</PAGO_REVERSION> <HORA_PAGO>09:28:15</HORA_PAGO> <AGENCIA>120</AGENCIA> <AUT_BCO>16</AUT_BCO> <USUARIO>ADMIN</USUARIO> <TERMINAL>121D</TERMINAL> </PAGOREVERSION> |
| Info |
|---|
NOTA: En este caso necesitamos enviar varios parámetros importantes para que el proceso se ejecute de forma correcta, los otros campos pueden ser llenados según los datos enviados del banco. |
ETIQUETA | PARAMETRO | DESCRIPCIÓN |
|---|---|---|
<DATO_1></DATO_1> | 01010201000102 | Corresponde al ID de la cuenta de crédito en SIFCO |
<MONTO_PAGADO></MONTO_PAGADO> | 2252.50 | Monto que se desea a acreditar al cuenta |
<EFECTIVO></EFECTIVO> | 2000.00 | Corresponde al pago en efectivo puede ser 50% |
<CHEQUES_AJENOS></CHEQUES_AJENOS> | 252.50 | Corresponde al pago en cheque, puede ser 50% |
<FECHA_PAGO></FECHA_PAGO> | 31/07/2024 | Fecha en que se realiza el pago |
<PAGO_REVERSION></PAGO_REVERSION> | “P” o “R” | Indica si esta realizando un pago o la reversión del pago |
<AUT_BCO></AUT_BCO> | 16 | Numero único de identificación del pago |
Al realizar la petición, este nos debe de retornar la informacion de la consulta realizada y un código 200
| Tip |
|---|
Operación realizada con éxito 200 (SUCCESSFUL OPERATION) |
Resultado 1:
| Code Block |
|---|
<RESP_PAGOREVERSION>
<CODIGO_RESPUESTA>000</CODIGO_RESPUESTA>
<DESCRIPCION_RESPUESTA>Operacion Exitosa</DESCRIPCION_RESPUESTA>
</RESP_PAGOREVERSION> |
Resultado 2:
| Code Block |
|---|
<RESP_PAGOREVERSION>
<CODIGO_RESPUESTA>630</CODIGO_RESPUESTA>
<DESCRIPCION_RESPUESTA>Numero de Autorizacion duplicado</DESCRIPCION_RESPUESTA>
</RESP_PAGOREVERSION> |
Resultado 3:
| Code Block |
|---|
<RESP_PAGOREVERSION>
<CODIGO_RESPUESTA>197</CODIGO_RESPUESTA>
<DESCRIPCION_RESPUESTA>Transaccion fuera de horario</DESCRIPCION_RESPUESTA>
</RESP_PAGOREVERSION> |
...
| 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/Pago_Reversion
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).
/Pago_Reversion- 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 | Operacion Exitosa |
001 | Cliente no Existe |
002 | Cuenta no existe, comunicarse con el acreedor |
003 | Error de Comunicacion, intente de nuevo |
70 | Error: Codigo de Saldo no puede Ser vacio |
79 | Error: El monto NO puede ser Negativo |
180 | Error: Fecha Pago Menor a la Fecha Desembolso |
197 | Transaccion fuera de horario |
210 | Error: Pago NO puede ser Mayor al Saldo de Capital |
249 | Error: Prestamo Cancelado, contacte al proveedor |
282 | Numero de Prestamo NO tiene ningun DESEMBOLSO |
287 | El Numero de autorizacion debe ser mayor a cero |
400 | Error: Desconocido, contactar al proveedor |
436 | Error: hay movimientos posteriores |
630 | Numero de Autorizacion duplicado |
631 | El Monto Total NO coincide con el Pago |
762 | Error: # de prestamo no existe o invalido. Validar |
997 | Error: numero de autorizacion incorrecto |
Añadir etiqueta