Versions Compared

Key

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

Este WEB Service, es un de los fundamentales de este grupo de API’s REST full, debido a que permite la creación de solicitud de préstamo individual, el cual incluye también Garantías y calificadores adicionales los cuales son datos definidos por el usuario.

...

Code Block
{
    "ConsultaFormaIdentificar": 1,
    "ConsultaValorIdentificador": "85",
    "WSSolicitud": {}
}

...

NOTA: el VALUE OAuth se debe obtener primero el token de conexión, dirigirse hacia el siguiente documento y seguir las instrucciones.

...

Tip

EJEMPLO #1

Expand
titleJSON CREAR SOLICITU DE CREDITO INDIVIDUAL
Code Block
{
    "ConsultaFormaIdentificar": 1,
    "ConsultaValorIdentificador": "85",
    "WSSolicitud": {
        "Empresa": 1,
        "Sucursal": 1,
        "Numero": 0,
        "Producto": 11,
        "Subproducto": 1,
        "Cliente": 0,
        "ClienteDireccionCorrelativo": 1,
        "OficialCreditos": "admin",
        "FechaSolicitud": "2021-01-25",
        "EstadoSolicitud": 0,
        "UsuarioRegistra": 0,
        "UsuarioModifica": 0,
        "FechaModificacion": "0000-00-00",
        "FechaAprobacion": "0000-00-00",
        "FechaFormalizacion": "0000-00-00",
        "InversionPais": 0,
        "InversionDepartamento": 0,
        "InversionMunicipio": 0,
        "InversionZona": 0,
        "InversionDestino": 1,
        "Grupo": 0,
        "Cupo": 0,
        "MontoSolicitado": 10000,
        "MontroAprobado": 0.0,
        "CodigoAprobacion": 0,
        "TasaBaseInteresCorriente": 24,
        "SpreadInteresCorriente": 0,
        "TasaBaseInteresMora": 300,
        "SpreadInteresMora": 0,
        "Plazo": 6,
        "PlazoFactor": 1,
        "DiasGracia": 2,
        "FechaVencimiento": "2021-07-25",
        "TipoCompromiso": 4,
        "FrecuenciaPagoCapital": 1,
        "FrecuenciaPagoInteres": 0,
        "FechaPrimerPagoCapital": "2021-02-25",
        "FechaPrimerPagoInteres": "2021-02-25",
        "ValorCuota": 103.33,
        "FormaDesembolso": 1,
        "GarantiaTipo": 1,
        "GarantiaDescripcion": "Descripcion de garantia falsa.",
        "PreNumero": 0        
    }
}
Tip

EJEMPLO #2

Info

En este ejemplo estamos enviando 3 garantías, puede enviar una o las que sean necesarios, sobre todo que esten creadas en la plataforma.

Expand
titleJSON CREAR SOLICITUD DE CRÉDITO INDIVIDUAL, APLICANDO GARANTÍAS Y CALIFICADORES ADICIONALES
Code Block
{
    "ConsultaFormaIdentificar": 1,
    "ConsultaValorIdentificador": "85",
    "WSSolicitud": {
        "Empresa": 1,
        "Sucursal": 1,
        "Numero": 0,
        "Producto": 11,
        "Subproducto": 1,
        "Cliente": 0,
        "ClienteDireccionCorrelativo": 1,
        "OficialCreditos": "admin",
        "FechaSolicitud": "2021-01-25",
        "EstadoSolicitud": 0,
        "UsuarioRegistra": 0,
        "UsuarioModifica": 0,
        "FechaModificacion": "0000-00-00",
        "FechaAprobacion": "0000-00-00",
        "FechaFormalizacion": "0000-00-00",
        "InversionPais": 0,
        "InversionDepartamento": 0,
        "InversionMunicipio": 0,
        "InversionZona": 0,
        "InversionDestino": 1,
        "Grupo": 0,
        "Cupo": 0,
        "MontoSolicitado": 10000,
        "MontroAprobado": 0.0,
        "CodigoAprobacion": 0,
        "TasaBaseInteresCorriente": 24,
        "SpreadInteresCorriente": 0,
        "TasaBaseInteresMora": 300,
        "SpreadInteresMora": 0,
        "Plazo": 6,
        "PlazoFactor": 1,
        "DiasGracia": 2,
        "FechaVencimiento": "2021-07-25",
        "TipoCompromiso": 4,
        "FrecuenciaPagoCapital": 1,
        "FrecuenciaPagoInteres": 0,
        "FechaPrimerPagoCapital": "2021-02-25",
        "FechaPrimerPagoInteres": "2021-02-25",
        "ValorCuota": 103.33,
        "FormaDesembolso": 1,
        "GarantiaTipo": 1,
        "GarantiaDescripcion": "Descripcion de garantia falsa.",
        "PreNumero": 0,
        "Garantias": [
            {
                "GarantiaCorrelativo": 0,
                "GarantiaTipoCodigo": 1,
                "GarantiaTipoDescripcion": "",
                "GarantiaDescripcion": "Descripcion de garantia falsa.",
                "GarantiaValor": 27190.00,
                "GarantiaValorGarantizado": 27190.00,
                "GarantiaPais": 0,
                "GarantiaDepartamento": 0,
                "GarantiaMunicipio": 0,
                "GarantiaZona": 0,
                "GarantiaDireccion": ""
            },
            {
                "GarantiaCorrelativo": 0,
                "GarantiaTipoCodigo": 1,
                "GarantiaTipoDescripcion": "",
                "GarantiaDescripcion": " falsa.",
                "GarantiaValor": 27190.00,
                "GarantiaValorGarantizado": 27190.00,
                "GarantiaPais": 0,
                "GarantiaDepartamento": 0,
                "GarantiaMunicipio": 0,
                "GarantiaZona": 0,
                "GarantiaDireccion": ""
            },
            {
                "GarantiaCorrelativo": 0,
                "GarantiaTipoCodigo": 1,
                "GarantiaTipoDescripcion": "",
                "GarantiaDescripcion": "Descripcio.",
                "GarantiaValor": 27190.00,
                "GarantiaValorGarantizado": 27190.00,
                "GarantiaPais": 0,
                "GarantiaDepartamento": 0,
                "GarantiaMunicipio": 0,
                "GarantiaZona": 0,
                "GarantiaDireccion": ""
            }
        ],
        "CalificadoresAdicionales": [
            {
                "CodigoCalificador": 154,
                "ValorCalificador": "33990.00"
            },
            {
                "CodigoCalificador": 155,
                "ValorCalificador": "6800"
            }
        ]        
    }
}

Tip

200 (SUCCESSFUL OPERATION)

Expand
titleSOLICITUD DE CREDITO INDIVIDUAL CREADA CON EXITO
Code Block
    "Salida": "{
          \"SoCrEmpCodigo\":1,\"SoCrSucCodigo\":1,\"SoCrNumero\":857,
          \"ApPrdCod\":11,\"ApPrdNombre\":\"CREDITO AUTOMATICO\",
          \"ApPrdNombre_N\":0,
          \"ApPrdTipProd\":2,
          \"ApPrdTipProd_N\":0,
          \"ApColCod\":1,
          \"ApColDes\":\"CREDITO AUTOMATICO\",
          \"ApColDes_N\":0,
          \"ApColAport\":\"N\",
          \"ApColAport_N\":0,
          \"ApColMontMaximo\":10000.0000,
          \"ApColMontMaximo_N\":0,
          \"ApColVeces\":0.0000,
          \"ApColVeces_N\":0,
          \"ApColTasaFoV\":\"F\",
          \"ApColTasaFoV_N\":0,
          \"ApColFacPlazo\":1,
          \"ApColFacPlazo_N\":0,
          \"ApColPlazo\":24,
          \"ApColPlazo_N\":0,
          \"ApMonCod\":1,
          \"ApMonCod_N\":0,
          \"ApMonNombre\":\"QUETZAL\",
          \"ApMonSimbolo\":\"\",
          \"ApMonSimbolo_N\":1,\"ApColEstado\":true,\"ApColEstado_N\":0,
          \"ApColTCInt\":3,\"ApColTCInt_N\":0,\"ApColTCMora\":6,
          \"ApColTCMora_N\":0,\"ApColTNInt\":\"TASA CREDITO AUTOMATICO       \",
          \"ApColTNMora\":\"TASA MORATORIA                \",\"ApColMes\":0,
          \"ApColMes_N\":0,\"ApColAno\":1,\"ApColAno_N\":0,
          \"ApColTMax\":999.9900,\"ApColTMax_N\":0,\"SoCrMonCod\":1,
          \"SoCrMonNombre\":\"QUETZAL                       \",
          \"SoCrMonSimbolo\":\"Q\",
          \"SoCrFecha\":\"2021-01-25\",
          \"SoCrNombre\":\"JUAN CARLOS HERRERA HERNANDEZ\",
          \"SoCrCliDir\":85,\"SoCrCliDir_N\":0,
          \"SoCrCliDNom\":\"JUAN CARLOS HERRERA HERNANDEZ\",
          \"SoCrCliPromotor\":\"admin\",\"SoCrCliPromotor_N\":0,\"SoCrDirCor\":1,
          \"SoCrDirCor_N\":0,\"SoCrDirDes\":\"BARRIO LA LIBERTAD\",
          \"SoCrDirDes_N\":0,\"SoCrDirTipo\":1,\"SoCrPrmCod\":\"admin\",
          \"SoCrPrmNom\":\"Administrator User\",
          \"ApGarClaCod\":1,\"ApGarClaDes\":\"FIDUCIARIA                    \",
          \"SoCrGarantia\":\"Descripcion de garantia falsa.\",
          \"SoCrGarantia_N\":0,\"ApGrDCod\":1,\"ApGrDCod_N\":0,
          \"ApGrDDes\":\"GASTOS PERSONALES                                 \",
          \"SoCrPaiCod\":0,\"SoCrPaiCod_N\":1,\"SoCrPaiNombre\":\"\",
          \"SoCrRegCod\":0,\"SoCrRegCod_N\":1,
          \"SoCrRegDes\":\"\",\"SoCrDepCod\":0,\"SoCrDepCod_N\":1,
          \"SoCrDepDes\":\"\",\"SoCrMunCod\":0,\"SoCrMunCod_N\":1,
          \"SoCrMunDes\":\"\",\"SoCrMonSolicitado\":10000,
          \"SoCrTasaFoV\":\"F\",\"SoCrTasaBase\":24.000000,
          \"SoCrBaseMora\":300.000000,
          \"SoCrSpreCorr\":0,
          \"SoCrSpreMora\":0,\"SoCrFacPlazo\":1,
          \"SoCrPeriodo\":\"M\",\"SoCrNumPeriodos\":1,
          \"SoCrPlazo\":6,\"SoCrFecVencimiento\":\"0000-00-00\",\"SoCrTipCom\":4,
          \"SoCrFreCCod\":1,\"SoCrFreCDes\":\"01 MENSUAL          \",
          \"SoCrFreCPer\":\"M\",\"SoCrFreCNumPeriodos\":1,\"SoCrFreICod\":1,
          \"SoCrFreIDes\":\"01 MENSUAL          \",\"SoCrFreIPer\":\"M\",
          \"SoCrFreINumPeriodos\":1,\"SoCrFecCap\":\"2021-02-25\",
          \"SoCrFecInt\":\"2021-02-25\",\"SoCrNumCuotas\":0,\"SoCrValCuota\":1691.67,
          \"SoCrForDes\":1,\"SoCrEstado\":1,\"SoCrUsuCrea\":\"admin\",
          \"SoCrUsuCreaNombre\":\"Administrator User\",\"SoCrUsuMod\":\"\",
          \"SoCrUsuMod_N\":1,\"SoCrUsuModNombre\":\"\",
          \"SoCrFecModificacion\":\"0000-00-00\",\"ApEtpCod\":1,\"ApEtpCod_N\":0,
          \"ApEtpDes\":\"Esperando Información Solicitud                   \",
          \"SoCrNumFlujo\":\"\",\"SoCrMonAprobado\":0,
          \"SoCrFecAprobacion\":\"0000-00-00\",\"SoCrFecAprobacion_N\":1,
          \"ApAprCod\":0,\"ApAprCod_N\":1,\"ApAprDes\":\"\",\"ApAprLimites\":\"\",
          \"ApAprMinimo\":0,\"ApAprMinimo_N\":1,\"ApAprMaximo\":0,\"ApAprMaximo_N\":1,
          \"SoCrCreNumero\":\"\",\"SoCrUltGarantia\":0,\"SoCrCliReferencia\":\"\",
          \"SoCrExtInt\":\"\",\"SoCrDiasGracia\":2,\"SoCrForCheque\":\"\",
          \"SoCrForTransferencia\":\"\",\"SoCrForTransferencia_N\":0,\"SoCrGrupo\":0,
          \"SoCrGrupo_N\":1,\"SoCrNumCreditos\":0,\"SoCrNumCreditos_N\":0,
          \"SoCrFecIngreso\":\"0000-00-00T00:00:00\",\"SoCrFecIngreso_N\":0,
          \"SoCrFecFormalizacion\":\"0000-00-00T00:00:00\",
          \"SoCrFecFormalizacion_N\":0,\"SoCrFecHoraAprobacion\":\"0000-00-00T00:00:00\",
          \"SoCrFecHoraAprobacion_N\":0,
          \"SoCrCiclo\":0,
          \"SoCrFecDesembolso\":\"0000-00-00\",
          \"SoCrFormaPago\":0,\"SoCrPlanilla\":0,
          \"SoCrCtaDeposito\":0,\"SoCrFormaDesembolso\":0,
          \"SoCrCtaDesembolso\":0,\"SoCrReferencia\":\"\",
          \"SoCrDescripcionDenegada\":\"\",\"SoCrDescripcionDenegada_N\":0,
          \"CupoSolCreditoCod\":0,\"CupoSolCreditoCod_N\":1,
          \"CupoSolCreditoFecVen\":\"0000-00-00\",
          \"CupoSolCreditoDisponible\":0,\"CupoObligatorio\":0,
          \"CupoObligatorio_N\":0,\"Mode\":\"UPD\",\"Initialized\":0,
          \"SoCrEmpCodigo_Z\":1,\"SoCrSucCodigo_Z\":1,\"SoCrNumero_Z\":857,
          \"ApPrdCod_Z\":11,\"ApPrdNombre_Z\":\"CREDITO AUTOMATICO            \",
          \"ApPrdTipProd_Z\":2,\"ApColCod_Z\":1,\"ApColDes_Z\":\"CREDITO AUTOMATICO\",
          \"ApColAport_Z\":\"N\",\"ApColMontMaximo_Z\":10000.0000,
          \"ApColVeces_Z\":0.0000,\"ApColTasaFoV_Z\":\"F\",
          \"ApColFacPlazo_Z\":1,\"ApColPlazo_Z\":24,\"ApMonCod_Z\":1,
          \"ApMonNombre_Z\":\"QUETZAL\",
          \"ApMonSimbolo_Z\":\"\",\"ApColEstado_Z\":true,
          \"ApColTCInt_Z\":3,\"ApColTCMora_Z\":6,
          \"ApColTNInt_Z\":\"TASA CREDITO AUTOMATICO       \",
          \"ApColTNMora_Z\":\"TASA MORATORIA                \",
          \"ApColMes_Z\":0,\"ApColAno_Z\":1,\"ApColTMax_Z\":999.9900,
          \"SoCrMonCod_Z\":1,\"SoCrMonNombre_Z\":\"QUETZAL\",
          \"SoCrMonSimbolo_Z\":\"Q  \",\"SoCrFecha_Z\":\"2021-01-25\",
          \"SoCrNombre_Z\":\"JUAN CARLOS HERRERA HERNANDEZ\",
          \"SoCrCliDir_Z\":85,
          \"SoCrCliDNom_Z\":\"JUAN CARLOS HERRERA HERNANDEZ\",
          \"SoCrCliPromotor_Z\":\"admin\",\"SoCrDirCor_Z\":1,
          \"SoCrDirDes_Z\":\"BARRIO LA LIBERTAD\",\"SoCrDirTipo_Z\":1,
          \"SoCrPrmCod_Z\":\"admin\",
          \"SoCrPrmNom_Z\":\"Administrator User\",
          \"ApGarClaCod_Z\":1,
          \"ApGarClaDes_Z\":\"FIDUCIARIA\",
          \"SoCrGarantia_Z\":\"Descripcion de garantia falsa.\",\"ApGrDCod_Z\":1,
          \"ApGrDDes_Z\":\"GASTOS PERSONALES                                 \",
          \"SoCrPaiCod_Z\":0,\"SoCrPaiNombre_Z\":\"\",\"SoCrRegCod_Z\":0,
          \"SoCrRegDes_Z\":\"\",\"SoCrDepCod_Z\":0,\"SoCrDepDes_Z\":\"\",
          \"SoCrMunCod_Z\":0,\"SoCrMunDes_Z\":\"\",\"SoCrMonSolicitado_Z\":10000,
          \"SoCrTasaFoV_Z\":\"F\",\"SoCrTasaBase_Z\":24.000000,\"SoCrBaseMora_Z\":300.000000,
          \"SoCrSpreCorr_Z\":0,\"SoCrSpreMora_Z\":0,\"SoCrFacPlazo_Z\":1,\"SoCrPeriodo_Z\":\"M\",
          \"SoCrNumPeriodos_Z\":1,\"SoCrPlazo_Z\":6,\"SoCrFecVencimiento_Z\":\"0000-00-00\",
          \"SoCrTipCom_Z\":4,\"SoCrFreCCod_Z\":1,\"SoCrFreCDes_Z\":\"01 MENSUAL          \",
          \"SoCrFreCPer_Z\":\"M\",\"SoCrFreCNumPeriodos_Z\":1,\"SoCrFreICod_Z\":1,
          \"SoCrFreIDes_Z\":\"01 MENSUAL          \",\"SoCrFreIPer_Z\":\"M\",
          \"SoCrFreINumPeriodos_Z\":1,\"SoCrFecCap_Z\":\"2021-02-25\",
          \"SoCrFecInt_Z\":\"2021-02-25\",\"SoCrNumCuotas_Z\":0,\"SoCrValCuota_Z\":1691.67,
          \"SoCrForDes_Z\":1,\"SoCrEstado_Z\":1,\"SoCrUsuCrea_Z\":\"admin\",
          \"SoCrUsuCreaNombre_Z\":\"Administrator User\",\"SoCrUsuMod_Z\":\"\",
          \"SoCrUsuModNombre_Z\":\"\",\"SoCrFecModificacion_Z\":\"0000-00-00\",
          \"ApEtpCod_Z\":1,\"ApEtpDes_Z\":\"Esperando Información Solicitud                   \",
          \"SoCrNumFlujo_Z\":\"\",
          \"SoCrMonAprobado_Z\":0,
          \"SoCrFecAprobacion_Z\":\"0000-00-00\",
          \"ApAprCod_Z\":0,
          \"ApAprDes_Z\":\"\",
          \"ApAprLimites_Z\":\"\",
          \"ApAprMinimo_Z\":0,
          \"ApAprMaximo_Z\":0,
          \"SoCrCreNumero_Z\":\"\",
          \"SoCrUltGarantia_Z\":0,
          \"SoCrCliReferencia_Z\":\"\",
          \"SoCrExtInt_Z\":\"\",
          \"SoCrDiasGracia_Z\":2,
          \"SoCrForCheque_Z\":\"\",
          \"SoCrForTransferencia_Z\":\"\",
          \"SoCrGrupo_Z\":0,
          \"SoCrNumCreditos_Z\":0,
          \"SoCrFecIngreso_Z\":\"0000-00-00T00:00:00\",
          \"SoCrFecFormalizacion_Z\":\"0000-00-00T00:00:00\",
          \"SoCrFecHoraAprobacion_Z\":\"0000-00-00T00:00:00\",
          \"SoCrCiclo_Z\":0,
          \"SoCrFecDesembolso_Z\":\"0000-00-00\",
          \"SoCrFormaPago_Z\":0,
          \"SoCrPlanilla_Z\":0,
          \"SoCrCtaDeposito_Z\":0,
          \"SoCrFormaDesembolso_Z\":0,
          \"SoCrCtaDesembolso_Z\":0,
          \"SoCrReferencia_Z\":\"\",
          \"SoCrDescripcionDenegada_Z\":\"\",
          \"CupoSolCreditoCod_Z\":0,
          \"CupoSolCreditoFecVen_Z\":\"0000-00-00\",
          \"CupoSolCreditoDisponible_Z\":0,
          \"CupoObligatorio_Z\":0}",
    "Resultado": "OK",
    "Messages": []
}

...

Code Block
Authorization: 
OAuth f2a9ec34-cf83-46f5-8862-f78ac03670d1!171380a787a9152688ab61a94d66e0eb77...


(blue star) Error #3

Mala configuración de encabezados (Headers).

El Codigo 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.

...

(lightbulb) Revisar los Headers, e4 identificar si son corrects.

Ejemplo:

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

(blue star) 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.

(blue star) Error #5

Errores por parametros.

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.

...

CONFIGURACIONES ADICIONALES PARA EL CORRECTO FUNCIONAMIENTO DEL WEB SERVICE

...