WSCrEstadoCuenta
- H. Samuel Casuy D.
Este WEB Service, es un de uso secundario de este grupo de API’s REST full, debido a que permite la Consulta del estado de cuenta de un Préstamo, adicional reflejara respuestas si en caso la consulta del mismo no se cumple.
Es de suma importancia enviar los parámetros correctos para la conexión como los parámetros mínimos para que los recargos libres de un préstamo o credito pueda crearse con éxito, de lo contrario le mostrará diferentes errores.
Modelo de Datos de este Web Service | Web Service a Constantes del Sistema Relacionados |
|---|---|
WSCrEstadoCuentaInput |
|
NumeroPrestamo | Número de préstamo a consultar. Al ingresar llenar esta información. |
WSIngresarPrestamoInput >PlanPagos_EstadoCuenta_SDT | Descripción |
CrMoNuMov | Número del Movimiento Créditos |
CrMoUsuCod | Usuario Efectúa Transacción |
CrMoTrxCod | Tipo de Transacción Efectuada |
CrMoTrxDes | Descripción Transacción |
CrMoFeTrx | Fecha de Transacción Créditos |
CrMoHoTrx | Hora de Transacción Créditos |
CrMoFeVal | Fecha Valor de la Transacción |
CrMoCoSup | Supervisor que Autoriza Transacción |
CrMoEstado | Estado de la Transacción |
CrMoFoPa | Forma de Pago |
CrMoFoDesembolso | Forma de Desembolso |
CrMoNuOrigen | Número de Movimiento Original |
CrMoParConta | Partida en Credito (No. Ref.) |
BaCtaCod | Código de Cuenta Bancaria |
BaTiMovCod | Código de Tipo de Movimiento |
BaMovNum | Número del Movimiento |
BaBanNombre | Nombre del Banco |
CrMoReferencia | Referencia |
CrMoNumDoc | Numero de Documento de Movimiento |
CrMoFacturaSerie | Serie de la factura |
CrMoFacturaCorrelativo | Correlativo de la factura |
CrMoDetalleFormaPago | Detalle Forma de pago |
CrMoDesembolsoDeduccionesPorcentajeBit | Bitácora del cambio de valores a los porcentajes en las deducciones del desembolso |
CrMoDesembolsoInstrucciones | Instrucciones especiales para el desembolso |
CrMoDeSalCod | Código de Saldo Detalle Movimiento |
ApSalDes | Descripción |
CrMoDeValor | Valor del detalle de Transacción |
JEMPLOS DE REQUEST Y RESPONSE, PARA LOS SERVICIOS RESTful BAJO PROTOCOLO HTTP.
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 la consulta del estado de cuenta de un préstamo en especifico dentro de la Aplicación SIFCO WEB.
POST
URL= https://test.sifco.org/sifco/rest/WSCrEstadoCuenta |
|---|
HEADERS
KEY | VALUE |
|---|---|
Content-Type | application/json |
Authorization | OAuth e12cbbcf-0042-4e30-96b3-c66d356c742b!d39d795cf5d242231636419b57079163144ef487087e5f2142e21dfbbaf66009ef5b7b27404978 |
GENEXUS-AGENT | SmartDevice Application |
BODY
{
"NumeroPrestamo":"01010101000560"
}
Configuración de Seguridad para Obtener Token de Acceso y Consumir de los Web Services
El WEB SERVICE, puede tener 2 respuestas , esto depende de que falte al momento de que se realice la consulta del estado de cuenta.
EJEMPLO 1:
Cuando el préstamo no es correcto.
PARÁMETRO | VALOR | DESCRIPCIÓN |
|---|---|---|
|
| Representa el número del préstamo a aprobar. |
RESPUESTA:
EJEMPLO 2:
Cuando al número de préstamo si es correcto pero aun no a sido desembolsado.
PARÁMETRO | VALOR | DESCRIPCIÓN |
|---|---|---|
|
| Representa el número del préstamo a aprobar. |
RESPUESTA:
EJEMPLO 3:
Cuando al número de préstamo si posee estado de cuenta.
PARÁMETRO | VALOR | DESCRIPCIÓN |
|---|---|---|
|
| Representa el número del préstamo a aprobar. |
RESPUESTA:
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://test.sifco.org/Instancia/rest/WSCrEstadoCuenta
https://test.sifco.org - el nombre del dominio (según lo proporcionado por SIFCO).
/Instancia - El nombre de la instancia instalada en el servidor de SIFCO.
/rest - nombre del parámetro con el que se ingresa
/WSCrEstadoCuenta - Nombre del WEB SERVICE
Error #2
Cuando existe errores del Token de conexión.
El código de error es 401 Token no encontrado
“Similar a 403 Forbidden, pero específicamente para usar cuando la autenticación es posible pero ha fallado o aún no se ha proporcionado. La respuesta debe incluir un campo de encabezado WWW-Authenticate que contenga un desafío aplicable al recurso solicitado.”
Token invalido o modificado
Por favor validar que esta colocando los Encabezados Adecuadamente, y de persistir el problema dirigirse a la Pagina (Configuración de Seguridad para Obtener Token de Acceso y Consumir de los Web Services), para generar nuevamente su Token de Acceso, y/o verificar problemas con su acceso al API REST.
Ejemplo:
Error #3
Mala configuración de encabezados (Headers).
El Código de error es 401 This service needs an Authorization Header
“Similar to 403 Forbidden, but specifically for use when authentication is possible but has failed or not yet been provided. The response must include a WWW-Authenticate header field containing a challenge applicable to the requested resource.”
Revisar los Headers, e identificar si son correctos.
Ejemplo:
Error #4
Servicios web no disponibles.
El Código de error es 500, indica que los servicios no están disponibles. Consultar a SIFCO, si en caso los servidores no están disponibles o la instancia no fue instalada correctamente.
Error #5
Errores por parámetros.
revisar cada parámetro enviado, existen varios errores en cuanto a los datos que no se envían correctamente, la respuesta se muestra al final del Json indicando cual fue el error percibido.
(c) 2020 por SIFC.O, S.A.