WSIngresarSolicitudCredito
- H. Samuel Casuy D.
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.
Es de suma importancia enviar los parametros correctos para la conexión como los parámetros mínimos para que la solicitud de crédito individual pueda crearse con éxito de lo contrario le mostrará diferentes errores
EJEMPLOS 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 parametros de conexion.
EL MÉTODO A UTILIZAR ES DE TIPO POST
Este método para este Web Service en específico permite la Creación de Solicitudes de crédito individual en la Aplicación SIFCO WEB.
POST
URL= https://test.sifco.org/sifco/rest/WSIngresarSolicitudCredito |
|---|
HEADERS
KEY | VALUE |
|---|---|
Content-Type | application/json |
Authorization | OAuth e12cbbcf-0042-4e30-96b3-c66d356c742b!d39d795cf5d242231636419b57079163144ef487087e5f2142e21dfbbaf66009ef5b7b27404978 |
GENEXUS-AGENT | SmartDevice Application |
BODY
{
"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.
Configuración de Seguridad para Obtener Token de Acceso y Consumir de los Web Services
El WEB SERVICE tiene 4 formas de solicitar (BUSCAR) la información del cliente o empresa para crear la solicitud de crédito.
DESCRIPCIÓN | EJEMPLO |
|---|---|
Código del cliente | 2624 |
Número de Identificación Cliente | 1724 71915 1404 |
Número de Referencia cliente | 2990 |
Nombre del Cliente | ROSA RAMOS SÁNCHEZ |
PARÁMETRO | VALOR | DESCRIPCIÓN |
|---|---|---|
| 1 | Código del cliente (SIFCO) |
| 2 | Número de Referencia cliente |
| 3 | Número de Identificación Cliente |
| 4 | Nombre del Cliente |
"TasaBaseInteresCorriente": 24,
"SpreadInteresCorriente": -1,
"TasaBaseInteresMora": 300,
"SpreadInteresMora": -2,
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/WSIngresarPrestamo
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
/WSIngresarPrestamo - Nombre del WEB SERVICE
Error #2
Cuando existe errores del Token de coneccion.
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 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.”
Revisar los Headers, e4 identificar si son corrects.
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 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
Sifco Web además de contemplar la mayoría de datos e información del cliente, considera que se pueden agregar aún más datos creados a la necesidad de nuestros clientes como información complementaria, esto hace que SIFCO WEB sea mucho más completo y que se puede tener toda la información acerca del cliente que sea necesaria.
Para poder utilizar estos campos, se debieron haber configurado en la opción de Configuración previamente.
El documento siguiente muestra cómo se configuran los calificadores adicionales que en esta ocasión son campos definidos por el usuario.
Configuración de campos definidos por el usuario en Solicitud de crédito individual
PASO 1: Buscar en la lista de campos definidos por el usuario
Una vez detectado los códigos del clasificador los agregamos en el JSON, es este caso utilizaremos el código 154 y 155
PASO 2: Visualizar el tipo de dato a enviar dentro del WEb SERVICE
Visualizamos el código y identificamos el tipo de dato en este caso es numérico decimal. adicional debemos identificar si es obligatorio u opcional.
(c) 2020 por SIFC.O, S.A.