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.
JEMPLOS DE REQUEST Y RESPONSE, PARA LOS SERVICIOS RESTful BAJO PROTOCOLO HTTP.
| 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 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
...
KEY
...
VALUE
...
Content-Type
...
application/json
...
Authorization
...
OAuth e12cbbcf-0042-4e30-96b3-c66d356c742b!d39d795cf5d242231636419b57079163144ef487087e5f2142e21dfbbaf66009ef5b7b27404978
...
GENEXUS-AGENT
...
SmartDevice Application
...
| Code Block |
|---|
{
"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
...
NumeroPrestamo
...
"01011062084082"
...
Representa el número del préstamo a aprobar.
RESPUESTA:
| Tip |
|---|
200 (SUCCESSFUL OPERATION) |
| Expand | ||
|---|---|---|
| ||
|
EJEMPLO 2:
Cuando al número de préstamo si es correcto pero aun no a sido desembolsado.
...
PARÁMETRO
...
VALOR
...
DESCRIPCIÓN
...
NumeroPrestamo
...
"01010101000750"
...
Representa el número del préstamo a aprobar.
RESPUESTA:
| Tip |
|---|
200 (SUCCESSFUL OPERATION) |
| Expand | ||
|---|---|---|
| ||
|
EJEMPLO 3:
Cuando al número de préstamo si posee estado de cuenta.
...
PARÁMETRO
...
VALOR
...
DESCRIPCIÓN
...
NumeroPrestamo
...
"01010206101060"
...
Representa el número del préstamo a aprobar.
RESPUESTA:
| Tip |
|---|
200 (SUCCESSFUL OPERATION) |
...
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.
| 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 la consulta del estado de cuenta de un préstamo en especifico dentro de la Aplicación SIFCO WEB.
URL= https://test.sifco.org/sifco/rest/WSCrEstadoCuenta |
|---|
KEY | VALUE |
|---|---|
Content-Type | application/json |
Authorization | OAuth e12cbbcf-0042-4e30-96b3-c66d356c742b!d39d795cf5d242231636419b57079163144ef487087e5f2142e21dfbbaf66009ef5b7b27404978 |
GENEXUS-AGENT | SmartDevice Application |
| Code Block |
|---|
{
" |
...
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:
| Tip |
|---|
200 (SUCCESSFUL OPERATION) |
| Expand | ||
|---|---|---|
| ||
|
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:
| Tip |
|---|
200 (SUCCESSFUL OPERATION) |
| Expand | ||
|---|---|---|
| ||
|
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:
| Tip |
|---|
200 (SUCCESSFUL OPERATION) |
| Expand | ||
|---|---|---|
| ||
|
...
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.
| Info |
|---|
INFORMACIÓN Para identificar el MENSAJE DE ERROR remitirse a la pagina de (Listado de Mensajes), donde se describe el listado de mensajes que arroja las API’s REST de la Aplicación SIFCO WEB, con su respectiva Descripción. |
| Note |
|---|
NO DEBE OLVIDAR Antes de consumir este Web Service, debe consultar cada una de los WS descritos en Web Services de Consulta de Categorías Generales, dado a que en ellos se listan los valores ya cargados de un conjunto de parámetros necesarios para ingresar un cliente al sistema, y dichos parámetros deben coincidir con los ya existentes en el para evitar errores y/o inconsistencias durante el ingreso de clientes, igualmente se debe respetar las constantes ya definida en el sistema, indicadas en la pagina de Constantes asociadas a variables preestablecidas en la Aplicación SIFCO WEB. |
| Note |
|---|
RESPETE LOS ENCABEZADOS OBLIGATORIOS para que pueda consumir el WEB SERVICE respectivo. |