Versions Compared

Old Version 5

changes.mady.by.user Rodrigo Morales

Saved on

compared with

New Version 6

changes.mady.by.user H. Samuel Casuy D.

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Este Web Service, es uno de los fundamentales de este grupo de API’s RESTfuldebido 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.

...

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

...

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:

Code Block
languagehtml
https://test.sifco.org/democoopgt/rest/WSIngresarPrestamo

HEADERS:

Code Block
languagejson
content-type: application/json
authorization: OAuth f2a9ec34-cf83-46f5-8862-f78........
genexus-agent: SmartDevice Application

BODY:

Code Block
languagejson
{
  "Modo": "DSP",
  "ConsultaNumero":"01011102038142",
  "Prestamo":{}
}

200 (Successful operation)

Operación Exitosa

Code Block
languagejson
{
    "PrestamoNumero": "01011102038142",
    "PrestamoInfo": {},
    "Messages": [],
    "Result": ""
}

400 (Bad Request).

Solicitud Errada

Code Block
languagejson
{
  "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) ).

Code Block
languagejson
{
  "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:

Code Block
languagehtml
https://test.sifco.org/democoopgt/rest/WSIngresarPrestamo

HEADERS:

Code Block
languagejson
content-type: application/json
authorization: OAuth f2a9ec34-cf83-46f5-8862-f78........
genexus-agent: SmartDevice Application

BODY:

Code Block
languagejson
{
  "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"  
  }
}

200 (Successful operation)

Operación Exitosa

Code Block
languagejson
{
    "PrestamoNumero": "01011102038153",
    "PrestamoInfo": {},
    "Messages": [],
    "Result": "Prestamo Creado Exitosamente"
}

400 (Bad Request).

Solicitud Errada

Code Block
languagejson
{
  "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) ).

Code Block
languagejson
{
  "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:

Code Block
languagehtml
https://test.sifco.org/democoopgt/rest/WSIngresarPrestamo

HEADERS:

Code Block
languagejson
content-type: application/json
authorization: OAuth f2a9ec34-cf83-46f5-8862-f78........
genexus-agent: SmartDevice Application

BODY:

Code Block
languagejson
{
  "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"  
  }
}

200 (Successful operation)

Operación Exitosa

Code Block
languagejson
{
    "PrestamoNumero": "01011102038153",
    "PrestamoInfo": {},
    "Messages": [],
    "Result": "Actualización Exitosa"
}

400 (Bad Request).

Solicitud Errada

Code Block
languagejson
{
  "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) ).

Code Block
languagejson
{
  "error": {
    "code":"0",
    "message":"This service needs an Authorization Header"
  }
}
{
  "CodigoCliente":"",
  "ConsultaResultados":[],
  "Messages":[],
  "Result":""
}

404 (Not Found).

Respuesta Vacía (Web Service, no encontrado)

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.

Code Block
languagejson
Content-Type: application/json
Authorization: OAuth f2a9ec34-cf83-46f5-8862-f78ac03670d1!171380a787a9152688ab61a94d66e0eb77...
GENEXUS-AGENT: SmartDevice Application
Warning

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.