Este Web Service, es uno de los fundamentales de este grupo de API’s RESTful debido a que el mismo permite la consulta, el ingreso o la actualización de préstamos, incluyendo todos sus datos claves. Además de quedar registrado en la Aplicación SIFCO WEB, como un préstamo en estado pendiente. Adicionalmente se debe indicar que las opciones de Consulta, Ingreso o Actualización depende del parámetro Modo.
Modo Modo de Acceso al Cliente en el Sistema. | |
|---|---|
Valor | Significado |
DSP | Permite Obtener toda la información del préstamo cargada en el Sistema. |
INS | Permite Incluir un préstamo en el Sistema. |
UPD | Permite Actualizar solos los campos de Datos Generales del préstamo en el Sistema. |
Modelo de Datos de este Web Service | Web Service a Constantes del Sistema Relacionados |
|---|---|
WSIngresarPrestamoInput | |
Modo | Constantes asociadas a variables preestablecidas por la Aplicación SIFCO WEB. |
ConsultaNumero | Número de préstamo a visualizar o actualizar. Al ingresar no llenar esta información. |
WSIngresarPrestamoInput >WSCrPrestamo_SDT | |
PreEmpCodigo | Código de Empresa del Préstamo |
PreSucCodigo | Código de Sucursal del Préstamo |
PrePrdCod | Código del Producto en Préstamo |
ApColCod | Código SubProducto Colocación |
PreMonedaCod | Moneda en que se concedió el crédito |
PreCliCod | Código Cliente |
PreDirCor | Correlativo de Dirección Cliente |
PreAprCod | Código Aprobación Préstamo |
PreGarCod | Código Garantía Préstamo |
ApOrgCod | Código de Origen de Fondos |
PreGrDCod | Gran División Destino Préstamo |
PrePaiCod | Pais Inversión Préstamo |
PreRegCod | Región Inversión Préstamo |
PreDepCod | Departamento Inversión Préstamo |
PreMunCod | Municipio Inversión Préstamo |
CupNumero | Código del Cupo |
PreFacPlazo | Factor del Plazo |
PreFreCCod | Frecuencia Pago Capital |
PreFreCPlanilla | Frecuencia Pago Planilla |
PreCtaNumero | Número Cuenta Captaciones |
ApCaCCod | Código de Categoría de Crédito |
ApEstCod | Código de Estado |
PreUsuCod | Usuario que Ingresa Préstamo |
PreUsuMod | Usuario que Modificó Préstamo |
PreNumeroRefinanciamiento | Número de préstamo de refinanciamiento |
PrestamoInversionistas | Código del cliente en SIFCO |
PrestamoInversionistaPorcentajeMonto | Monto asignado al inversionista |
PrestamosInversionistasPromotorPorcentaje | % de Comisión Externa |
PrestamosInversionistasAgentePorcentaje | % Gestión del Préstamo |
PrestamosInversionistasContratoFlexible | ¿Tiene un contrato flexible?: |
EJEMPLOS DE REQUEST Y RESPONSE, PARA LOS SERVICIOS RESTful BAJO PROTOCOLO HTTP.
A continuación se muestra una tabla con un ejemplo de una Solicitud y un Respuesta para este Web Service.
METODO POST
Este método para este Web Service en especifico permite la Creación de Prestamos en la Aplicación SIFCO WEB.
A continuación se mostraran tres ejemplos de uso de este Web Service, uno para cada valor del parámetro Modo, dado a su relevancia para este Web Service en particular.
EJEMPLO #1
El siguiente ejemplo consulta los datos de un cliente en la Aplicación SIFCO WEB, con el Parámetro Modo : “DSP“
Tipo de Mensaje HTTP | Ejemplo |
|---|---|
REQUEST | URL: https://test.sifco.org/democoopgt/rest/WSIngresarPrestamo HEADERS: content-type: application/json authorization: OAuth f2a9ec34-cf83-46f5-8862-f78........ genexus-agent: SmartDevice Application BODY: {
"Modo": "DSP",
"ConsultaNumero":"01011102038142",
"Prestamo":{}
}
|
200 (Successful operation) Operación Exitosa | {
"PrestamoNumero": "01011102038142",
"PrestamoInfo": {},
"Messages": [],
"Result": ""
}
|
400 (Bad Request). Solicitud Errada | {
"error": {
"code": "string",
"message": "string"
}
}
|
401 (This service needs an Authorization Header) (No Autenticado, asociado normalmente a que no se respetaron las cabeceras obligatorias para el consumo de este Web Service, para mayores detalles consultar (Configuración de Seguridad para Obtener Token de Acceso y Consumir de los Web Services) ). | {
"error": {
"code":"0",
"message":"This service needs an Authorization Header"
}
}
{
"CodigoCliente":"",
"ConsultaResultados":[],
"Messages":[],
"Result":""
}
|
404 (Not Found). | Respuesta Vacía (Web Service, no encontrado ) |
EJEMPLO #2
El siguiente ejemplo inserta un préstamo en la Aplicación SIFCO WEB, con el Parámetro Modo : “INS”
Tipo de Mensaje HTTP | Ejemplo |
|---|---|
REQUEST | URL: https://test.sifco.org/democoopgt/rest/WSIngresarPrestamo HEADERS: content-type: application/json authorization: OAuth f2a9ec34-cf83-46f5-8862-f78........ genexus-agent: SmartDevice Application BODY:
{
"Modo": "INS",
"ConsultaNumero":"",
"Prestamo":{
"PreEmpCodigo": 1,
"PreSucCodigo": 1,
"PreSoCrNumero": "0",
"PrePrdCod": 11,
"ApColCod": 2,
"PreMonedaCod": 1,
"PreNombre": "RODRIGO JOSE MORALES CASTELLANOS",
"PreCliCod": "3448",
"PreDirCor": 1,
"PrePrmCod": "admin",
"PreAprCod": 2,
"PreGarCod": 2,
"ApOrgCod": 1,
"PreFecAprobacion": "2020-07-31",
"PreFecConcesion": "2020-07-31",
"PreFecEscritura": "2020-07-31",
"PreGrDCod": 13,
"PrePaiCod": 320,
"PreRegCod": 0,
"PreDepCod": 0,
"PreMunCod": 0,
"PreMonOriginal": "1000.00",
"PreMonTotal": "500.00",
"CupNumero": "0",
"PreTasaFoV": "F",
"PreTasaBase": "18.0000",
"PreBaseMora": "6.0000",
"PreSpreCorr": "0.0000",
"PreSpreMora": "0.0000",
"PreFacPlazo": 10,
"PrePlazo": 12,
"PreFecVencimiento": "2021-07-31",
"PreTipCom": 1,
"PreFreCCod": 10,
"PreFreICod": 10,
"PreFec1Cap": "2020-08-31",
"PreFec1Int": "2020-08-31",
"PreDiaPago": 0,
"PreFreCPlanilla": 10,
"PreNumCuotas": 0,
"PreValCuota": "0.00",
"PreCuotaDefinidaUsuario": "0.00",
"PreForDes": 1,
"PrePrimerDesembolso": "2020-07-31",
"PreForPago": 1,
"PreAsigBoleta": "N",
"PreCtaNumero": "",
"ApCaCCod": 1,
"ApEstCod": "1",
"PreFecModulo": "2020-07-31",
"PreFecAdicion": "2020-10-07",
"PreUsuCod": "admin",
"PreFecModificacion": "0000-00-00",
"PreUsuMod": "admin",
"PreFecPCap": "2020-08-31",
"PreFecPInt": "2020-08-31",
"PreFecUCap": "0000-00-00",
"PreFecUInt": "0000-00-00",
"PreMarDesembolsar": "3000.00",
"PreSusInts": "N",
"PreFecSuspension": "0000-00-00",
"PreSalCapital": "0.00",
"PreCapAtrasado": "0.00",
"PreIntMes": "0.00",
"PreIntAcumulado": "0.00",
"PreIntVencido": "0.00",
"PreIntAnticipado": "0.00",
"PreIntMora": "0.00",
"PreUltGar": 0,
"PreUltPri": 0,
"PreUltCam": "0",
"PreUltAbo": "0",
"PreNumCont": "",
"PreReferencia": "Prueba 3",
"PreAnulado": "",
"CrCiclo": 0,
"CrDiasGracia": 0,
"CrDiasPGracia": 0,
"PreComentario": "generado por el web service 3",
"PreEstado": false,
"PreMensaje": 399,
"PreTipoCredito": 0,
"PreNumeroRefinanciamiento": "",
"PreMontoCapitalRefinanciamiento": "0.00",
"PreMontoInteresRefinanciamiento": "0.00",
"PreMontoOtrosRefinanciamiento": "0.00",
"PreIntDevengado": "0.00",
"PrestamosInversionistasPromotorPorcentaje": "10",
"PrestamosInversionistasAgentePorcentaje": "10",
"PrestamosInversionistasContratoFlexible": false,
"CalificadoresAdicionales": [
{
"CodigoCalificador": 154,
"ValorCalificador": "Catalogo primero"
}
],
"Inversionistas": [
{
"PrestamoInversionistas": 3,
"PrestamoInversionistaPorcentajeMonto": 15
}
]
}
}
|
200 (Successful operation) Operación Exitosa | {
"PrestamoNumero": "01011102038153",
"PrestamoInfo": {},
"Messages": [],
"Result": "Prestamo Creado Exitosamente"
}
|
400 (Bad Request). Solicitud Errada | {
"error": {
"code": "string",
"message": "string"
}
}
|
401 (This service needs an Authorization Header) (No Autenticado, asociado normalmente a que no se respetaron las cabeceras obligatorias para el consumo de este Web Service, para mayores detalles consultar (Configuración de Seguridad para Obtener Token de Acceso y Consumir de los Web Services) ). | {
"error": {
"code":"0",
"message":"This service needs an Authorization Header"
}
}
{
"CodigoCliente":"",
"ConsultaResultados":[],
"Messages":[],
"Result":""
}
|
404 (Not Found). | Respuesta Vacía (Web Service, no encontrado ) |
EJEMPLO #3
El siguiente ejemplo consulta los datos de un préstamo en la Aplicación SIFCO WEB, con el Parámetro Modo : “UPD“
Tipo de Mensaje HTTP | Ejemplo |
|---|---|
REQUEST | URL: https://test.sifco.org/democoopgt/rest/WSIngresarPrestamo HEADERS: content-type: application/json authorization: OAuth f2a9ec34-cf83-46f5-8862-f78........ genexus-agent: SmartDevice Application BODY: {
"Modo": "UPD",
"ConsultaNumero":"01011102038153",
"Prestamo":{
"PreEmpCodigo": 1,
"PreSucCodigo": 1,
"PreSoCrNumero": "0",
"PrePrdCod": 11,
"ApColCod": 2,
"PreMonedaCod": 1,
"PreNombre": "RODRIGO JOSE MORALES CASTELLANOS",
"PreCliCod": "3448",
"PreDirCor": 1,
"PrePrmCod": "admin",
"PreAprCod": 2,
"PreGarCod": 2,
"ApOrgCod": 1,
"PreFecAprobacion": "2020-07-31",
"PreFecConcesion": "2020-07-31",
"PreFecEscritura": "2020-07-31",
"PreGrDCod": 13,
"PrePaiCod": 320,
"PreRegCod": 0,
"PreDepCod": 0,
"PreMunCod": 0,
"PreMonOriginal": "1000.00",
"PreMonTotal": "500.00",
"CupNumero": "0",
"PreTasaFoV": "F",
"PreTasaBase": "18.0000",
"PreBaseMora": "6.0000",
"PreSpreCorr": "0.0000",
"PreSpreMora": "0.0000",
"PreFacPlazo": 10,
"PrePlazo": 12,
"PreFecVencimiento": "2021-07-31",
"PreTipCom": 1,
"PreFreCCod": 10,
"PreFreICod": 10,
"PreFec1Cap": "2020-08-31",
"PreFec1Int": "2020-08-31",
"PreDiaPago": 0,
"PreFreCPlanilla": 10,
"PreNumCuotas": 0,
"PreValCuota": "0.00",
"PreCuotaDefinidaUsuario": "0.00",
"PreForDes": 1,
"PrePrimerDesembolso": "2020-07-31",
"PreForPago": 1,
"PreAsigBoleta": "N",
"PreCtaNumero": "",
"ApCaCCod": 1,
"ApEstCod": "1",
"PreFecModulo": "2020-07-31",
"PreFecAdicion": "2020-10-07",
"PreUsuCod": "admin",
"PreFecModificacion": "0000-00-00",
"PreUsuMod": "admin",
"PreFecPCap": "2020-08-31",
"PreFecPInt": "2020-08-31",
"PreFecUCap": "0000-00-00",
"PreFecUInt": "0000-00-00",
"PreMarDesembolsar": "3000.00",
"PreSusInts": "N",
"PreFecSuspension": "0000-00-00",
"PreSalCapital": "0.00",
"PreCapAtrasado": "0.00",
"PreIntMes": "0.00",
"PreIntAcumulado": "0.00",
"PreIntVencido": "0.00",
"PreIntAnticipado": "0.00",
"PreIntMora": "0.00",
"PreUltGar": 0,
"PreUltPri": 0,
"PreUltCam": "0",
"PreUltAbo": "0",
"PreNumCont": "",
"PreReferencia": "Prueba 3",
"PreAnulado": "",
"CrCiclo": 0,
"CrDiasGracia": 0,
"CrDiasPGracia": 0,
"PreComentario": "generado por el web service 3",
"PreEstado": false,
"PreMensaje": 399,
"PreTipoCredito": 0,
"PreNumeroRefinanciamiento": "",
"PreMontoCapitalRefinanciamiento": "0.00",
"PreMontoInteresRefinanciamiento": "0.00",
"PreMontoOtrosRefinanciamiento": "0.00",
"PreIntDevengado": "0.00",
"PrestamosInversionistasPromotorPorcentaje": "10",
"PrestamosInversionistasAgentePorcentaje": "10",
"PrestamosInversionistasContratoFlexible": false,
"Inversionistas": [
{
"PrestamoInversionistas": 3,
"PrestamoInversionistaPorcentajeMonto": 550
},
{
"PrestamoInversionistas": 4,
"PrestamoInversionistaPorcentajeMonto": 100
}
,
{
"PrestamoInversionistas": 5,
"PrestamoInversionistaPorcentajeMonto": 100
}
]
}
}
|
200 (Successful operation) Operación Exitosa | {
"PrestamoNumero": "01011102038153",
"PrestamoInfo": {},
"Messages": [],
"Result": "Actualización Exitosa"
}
|
400 (Bad Request). Solicitud Errada | {
"error": {
"code": "string",
"message": "string"
}
}
|
401 (This service needs an Authorization Header) (No Autenticado, asociado normalmente a que no se respetaron las cabeceras obligatorias para el consumo de este Web Service, para mayores detalles consultar (Configuración de Seguridad para Obtener Token de Acceso y Consumir de los Web Services) ). | {
"error": {
"code":"0",
"message":"This service needs an Authorization Header"
}
}
{
"CodigoCliente":"",
"ConsultaResultados":[],
"Messages":[],
"Result":""
}
|
404 (Not Found). | Respuesta Vacía (Web Service, no encontrado ) |
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.
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.
RESPETE LOS ENCABEZADOS OBLIGATORIOS para que pueda consumir el WEB SERVICE respectivo.
Content-Type: application/json Authorization: OAuth f2a9ec34-cf83-46f5-8862-f78ac03670d1!171380a787a9152688ab61a94d66e0eb77... GENEXUS-AGENT: SmartDevice Application
EN CASO DE ERROR HTTP 401 (Not Authenticated)
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.