Especificación Tecnica

Web Service de carga de archivós

Especificación Técnica
1
Introducción:

El presente documento brinda una especificación técnica acerca del Web Service de carga de
archivos. El objetivo del mismo es brindar a los clientes una vía alternativa y flexible para
realizar las cargas de archivos a Equifax.

Generalidades:

Previo a invocar el Web Service se debe contar con un usuario habilitado en el sistema y contar
con el privilegio de realizar cargas.

URL del servicio:

https://www.equifax.com.py/WsUpload/WsUploadFile.asmx

Operación a invocar:
WSUploadFiles

WSDL:
https://www.equifax.com.py/WsUpload/WsUploadFile.asmx?wsdl

Ejemplo invocación SOAP :

https://www.equifax.com.py/WsUpload/WsUploadFile.asmx?op=WSUploadFiles

Parámetros de entrada y salida:

Entrada/Salida Nombre Tipo de dato Requerido Descripción

Entrada xlAfiliado long Si Número de cliente
Entrada xsUsuario string Si Nombre de usuario
Entrada xsPass string Si Password
Binario como arreglo de
Entrada xabData byte[] Si bytes.
Especifica si estamos
enviando información de
Personas Físicas, Personas
Jurídicas o ninguna(valores
Entrada xsTipoFicha string No posibles F, J o vacío)

Nombre original del archivo

con su respectiva extensión,
los archivos de Base Positiva
Entrada xsNomArchivo string Si deben ser extensión ZIP
Valores posibles:
8 - Solicitudes.
14 - Altas de Base Positiva.
15 - Actualizaciones de Base
Entrada xiTipoOp int Si Positiva.

Especificación Técnica
2
 16 - Inclusión de
Morosidades.
30 - Eliminación de
Morosidades.
52 - Personas de diseño
Flexible
53 - Empresas de diseño
Flexible
54 - Altas de diseño Flexible
55 - Actualización de diseño
Flexible
Comentario, especialmente
útil para indicar el periodo al
Entrada xsComentario string No que refiere la información
MD5 de los datos en
xabData, no es obligatorio, si
se envía se chequea al
recibirlo y se acepta el
Entrada xsMD5 string No archivo si coinciden
String en formato XML
Salida WSUploadFileResult string - resultado de consumir el WS

Archivos:
De acuerdo al tipo de operación se esperan los siguientes archivos:

- Altas y Actualizaciones de Base Positiva: .csv o .txt comprimido con extensión .zip

- Inclusión y Eliminación de Morosidades: archivo de texto con extensión .mor

- Personas, Empresas, Altas y Actualizaciones del diseño Flexible: .csv o .txt comprimido con
extensión .zip

Interpretación de la salida:
La salida del WebService es un string con formato XML.
Siempre se especifica un resultado con sus dos valores posibles “Transaccion exitosa” o
“Transaccion fallida” indicando si la carga se pudo realizar correctamente o no.

En caso de éxito, se especifica el identificador de carga para que el cliente pueda realizar la
trazabilidad de la misma.

Especificación Técnica
3
En caso que la transacción sea fallida, se retorna un código de error y una descripción del
mismo.

Códigos de error:

Código Error
52 Al iniciar sesión, verifique afiliado/usuario/password y reintente
55 Se produjo un error interno de ejecución, reintente o solicite soporte.
59 Error abriendo la sesión
60 El usuario no posee privilegios para ejecutar esta operación
62 Campo de entrada incorrecto: NombreCampo
75 No coincide el MD5 recibido con el del archivo
76 Nombre de archivo invalido

Especificación Técnica
4