Versions Compared

Key

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

...

Code Block
{
  "ApDoc_Tipo": 2,
  "ApDoc_Clase": 1,
  "Llave": "1",
  "url": "https://si.ua.es/es/documentos/documentacion/pdf-s/mozilla12-pdf.pdf"
}

...

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

Información detallada de los campos a enviar

CAMPO

DESCRIPCIÓN

EJEMPLO

ApDoc_Tipo

Este campo presenta representa el código de la configuración que se creo en SIFCO, el cual es de tipo numérico, dicha configuración se vera reflejada en Clientes, Préstamos o cuentas de ahorro, todo según la configuración deseada.

ApDoc_Clase

Este campo representa los tipos de configuración aplicada, por ejemplo si lo queremos aplicar en clientes o en préstamos.

Image Added

Llave

Este campo puede ser compuesto por un elemento o varios, dependerá del tipo de documento electrónico que necesite cargar.

  1. Código de cliente = 525

  2. Número de Préstamo = 01010110000149

  3. Solicitud de crédito = 1|1|25 (Código empresa, Código sucursal y Número de solicitud)

url

Este campo representa la ubicación donde se encuentra el documento.

https://eqpro.es/wp-content/uploads/2018/11/Ejemplo.pdf

Info

Tipos de Clases ("ApDoc_Clase").

Nombre

Descripción

Valor

Cliente

Cliente

1

SolicitudIndividual

Solicitud Individual

2

Garantia

Garantía

3

SolicitudGrupal

Solicitud Grupal

4

Préstamo

Préstamo

5

Ahorros

Ahorros

6

Grupo

Grupo

7

SolicitudCambioBeneficiario

Solicitud Cambio Beneficiario

8

OperacionInusual

Documento para operaciones inusuales

9

ProductoFactoring

Producto de Factoring

10

Tip

EJEMPLO #1

Tipo de Mensaje HTTP

Ejemplo

REQUEST

Code Block
{
  "ApDoc_Tipo": 10,
  "ApDoc_Clase": 5,
  "Llave": "01010110000149",
  "url": "https://eqpro.es/wp-content/uploads/2018/11/Ejemplo.pdf"
}

200 (Successful operation)

Operación Exitosa

Code Block
{
    "Mensaje": "(610) Documento cargado correctamente: 16e7025e-4bb6-4359-8372-551fd5033b54 Content: "
}

200 (Successful operation)

Operación Exitosa

En este caso el número de préstamo no existe

Code Block
{
    "Mensaje": "(762) No. de Prestamo de Crédito No Existe...!!!"
}

...

Warning

Errores que pudieran ser por una mala configuración o parámetros incorrectos.

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

...

(lightbulb) La URL esta compuesta de la siguiente manera:

(tick) https://test.sifco.org/Instancia/rest/WSApCargaDocumentosLista

  1. https://test.sifco.org - el nombre del dominio (según lo proporcionado por SIFCO).

  2. /Instancia - El nombre de la instancia instalada en el servidor de SIFCO.

  3. /rest - nombre del parámetro con el que se ingresa

  4. /WSApCargaDocumentosLista- Nombre del WEB SERVICE

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

...

(lightbulb) 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:

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.