Isolucion Data Connector

PROVEEDORES Request information

Obtiene la lista de proveedores existentes en el sistema ISOLUCIÓN.

URI parameters

HTTP GET: https://[service_address]/api/Proveedores/

[service_address]: Dirección disponible para conectividad con el API, debe validarse con su proveedor de ISOLUCIÓN.

GET Request HTTP Headers

Header	Ejemplo	Descripción
Authorization	Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==	Para la autorización sobre el API es necesario un usuario y contraseña, este usuario debe ser creado en el modulo de Usuarios de Isolucion, se recomienda crear un usuario único para la integración. Una vez creado el usuario se debe cifrar en base64 de la siguiente manera NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Referencias The 'Basic' HTTP Authentication Scheme Esquema de autenticación Basic
apiKey	YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost	Llave otorgada para el uso del API.
Content-Type	application/json	Tipo de contenido enviado en la solicitud.

Header

Ejemplo

Descripción

Authorization

Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Para la autorización sobre el API es necesario un usuario y contraseña, este usuario debe ser creado en el modulo de Usuarios de Isolucion, se recomienda crear un usuario único para la integración.

Una vez creado el usuario se debe cifrar en base64 de la siguiente manera

NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Referencias
The 'Basic' HTTP Authentication Scheme
Esquema de autenticación Basic

apiKey

YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost

Llave otorgada para el uso del API.

Content-Type

application/json

Tipo de contenido enviado en la solicitud.

Query string parameters

Si requiere paginar los registros se deben enviar estos parametros por query string.

HTTP GET: https://[service_address]/api/[metodo]?RegistroActual=0&TamanoPagina=20

[service_address]: Dirección disponible para conectividad con el API, debe validarse con su proveedor de ISOLUCIÓN.

[metodo]: Hace referencia al objeto de isolucion que queremos consultar (Funcionarios, Mediciones, Cargos, etc).

Nombre del campo	Formato	Tamaño	Descripción	Obligatorio
RegistroActual	Númerico		Indice del registro en el cual se encuentra la consulta. Indice inicial debe ser 0.	Si.
TamanoPagina	Númerico		Cantidad total de registros que se quiere traer. Si el tamaño es 0 se consultaran todos los datos	Si.

Proveedores Response Information

Resource Description

Respuesta en Formato JSON a la solicitud de obtener los datos registrados en el sistema.

Response Formats

application/json/

Campo	Ejemplo	Descripción
StatusCode	"StatusCode":200	Códigos HTTP de respuesta indicando si fue exitoso o no el request realizado. [200,500] Exito,Error.
Message	"Message":"Lista de Proveedores obtenida exitosamente."	Descripción de la respuesta exitosa o mensaje de error enviado por el servidor.
Entity	"Entity": [[{data1},{data2}...],null]	Formato JSON con el listado de Proveedores registrados en el sistema. En el caso de respuesta no exitosa el valor es nulo.

Sample Ok Response:

{
"StatusCode": 200,
"Message": "Lista de proveedores obtenida exitosamente.",
"Entity": "[{\"IdProveedor\":1,\"NomProveedor\":\"Proveedores qa09092019\",\"CodTipoIdentificacion\":2,\"NumeroIdentificacion\":null,\"Contacto\":null,\"Telefono\":null,\"Email\":\"oscar.roncancio@isolucion.com.co\",\"Fax\":null,\"Direccion\":null,\"CodPais\":null,\"CodigoInternoProveedor\":\"\",\"BienesServicios\":\"\",\"CodObjetoSocial\":null,\"VigenciaSociedad\":\"\",\"CodNivelRiesgo\":null,\"CodTamanoCompania\":null,\"CatalogosDisponibles\":\"\",\"CodMarca\":null,\"CodProducto\":null,\"Telefono2\":\"\",\"Telefono3\":\"\",\"LovSexo\":\"\",\"CodClasificacionTributaria\":null,\"CodCiudad\":null,\"PeriodoPago\":null,\"ActividadEconomica\":null,\"FormaPago\":null,\"CodTipoPersona\":null,\"Declarante\":null,\"AgenteRetenedor\":null,\"Autorretenedor\":null,\"CodigoBanco\":null,\"NombreBanco\":null,\"CodTipoCuenta\":null,\"NumeroCuenta\":null,\"ValorMaximoPago\":null,\"Activo\":1,\"EsNivelGlobal\":0,\"EmailAdicional\":\"\",\"ScoringSarlaft\":2,\"CodOrigenRecursos\":null,\"CodActividaEconomica\":null,\"CodSLFCanal\":null,\"CodCiudad\":null,\"FechaScoring\":null,\"Sucursales\":\"1,3\"EsPEP\":false}]"
        }

Sample ERROR Response:

{
    "StatusCode": 401,
    "Message": "Unauthorized : *DESCRIPCION ERROR NO AUTORIZADO*.",
    "Entity": null
}

{
    "StatusCode": 500,
    "Message": "InternalServerError : La solicitud no fue procesada.",
    "Entity": null
}

PROVEEDORES Request information

Crea un proveedor en el sistema ISOLUCIÓN a través de esta opción.

URI parameters

HTTP POST: https://[service_address]/api/Proveedores/

[service_address]: Dirección disponible para conectividad con el API, debe validarse con su proveedor de ISOLUCIÓN.

POST Request HTTP Headers

Header	Ejemplo	Descripción
Authorization	Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==	Para la autorización sobre el API es necesario un usuario y contraseña, este usuario debe ser creado en el modulo de Usuarios de Isolucion, se recomienda crear un usuario único para la integración. Una vez creado el usuario se debe cifrar en base64 de la siguiente manera NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Referencias The 'Basic' HTTP Authentication Scheme Esquema de autenticación Basic
apiKey	YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost	Llave otorgada para el uso del API.
Content-Type	application/json	Tipo de contenido enviado en la solicitud.

Header

Ejemplo

Descripción

Authorization

Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Una vez creado el usuario se debe cifrar en base64 de la siguiente manera

NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Referencias
The 'Basic' HTTP Authentication Scheme
Esquema de autenticación Basic

apiKey

YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost

Llave otorgada para el uso del API.

Content-Type

application/json

Tipo de contenido enviado en la solicitud.

Body parameters

Nombre del campo	Formato	Tamaño	Descripción	Obligatorio
TipoIdentificacion	Texto	varchar(255)	Nombre del tipo documento, sino existe se crea con el valor enviado.	Si.
NumeroIdentificacion	Texto	varchar(20)	Número de identificación.	Si.
Nombre	Texto	varchar(255)	Nombre completo del proveedor.	Si.
Contacto	Texto	varchar(80)	Correo electronico.	No.
Telefono	varchar(30)		Telefono.	No.
Email	Texto	varchar(250)	Email.	No.
Fax	Texto	varchar(30)	Fax.	No.
Direccion	Texto	varchar(255)	Direccion.	No.
Pais	Texto	varchar(100)	Pais de trabajo del proveedor, sino existe se crea con el valor enviado.	No.
Activo	Booleano [1,0]		Activo:1 , Inactivo:0. Indica si el proveedor se encuentra activo o no.	No.
CodActividadEconomica	Entero	int	Codigo de la actividad economica a la que se dedica el proveedor. Debe existir previamente.	No.
CodOrigenRecursos	Entero	int	Codigo delorigen de los recursos del proveedor. Debe existir previamente.	No.
CodSLFCanal	Entero	int	Codigo del canal por el que el cliente conocio la empresa. Debe existir previamente	No.
CodCiudad	Entero	int	Codigo de la Ciudad, debe existir en Isolucion (Ver Objeto ciudad)	No.
EsNivelGlobal	Entero	int	Indica si el cliente es de nivel global (1) o pertenece a alguna sucursal (0)	Si (Para empresas con multicompañia)
Sucursales	Texto	varchar(255)	Lista de sucursales a las que pertenece el cliente	Si (Para empresas con multicompañia)

Request Formats

application/json/

Sample:

{  
                          "TipoIdentificacion": "Pasaporte",
                          "NumeroIdentificacion": "14231",
                          "Nombre": "sample string 8",
                          "Contacto": "sample string 5",
                          "Telefono": "sample string 7",
                          "Email": "sample string 8",
                          "Fax": "sample string 9",
                          "Direccion": "sample string 10",
                          "Pais": "Colombia",
                          "Activo": "1",
                          "CodActividadEconomica":2,
                          "CodOrigenRecursos":2,
                          "CodSLFCanal":17,
                          "CodCiudad" : 1,
                          "EsNivelGlobal":0,
                          "Sucursales":"1,3"                                    
}

PROVEEDORES Response Information

Resource Description

Respuesta en Formato JSON a la solicitud de creación en el sistema.

Response Formats

application/json/

Campo	Ejemplo	Descripción
StatusCode	"StatusCode":200	Códigos HTTP de respuesta indicando si fue exitoso o no el request realizado. [200,400,500] Exito,Error.
Message	"Message":"El proveedor ha sido creado exitosamente."	Descripción de la respuesta exitosa o mensaje de error enviado por el servidor.
Entity	"Entity": [[{data1},{data2}...],null]	Formato JSON con los datos creados en el sistema. En el caso de respuesta no exitosa el valor es nulo.

Sample OK Response:

{
                                "StatusCode": 200,
                                "Message": "Proveedor creado",
                                "Entity": "{\"IdProveedor\":558,\"TipoIdentificacion\":\"Pasaporte\",\"NumeroIdentificacion\":\"14231\",\"Nombre\":\"sample string 8\",\"Contacto\":\"sample string 5\",\"Telefono\":\"sample string 7\",\"Email\":\"sample string 8\",\"Fax\":\"sample string 9\",\"Direccion\":\"sample string 10\",\"Pais\":\"Colombia\",\"Activo\":\"1\",\"CodActividadEconomica\":2,\"CodOrigenRecursos\":2,\"CodSLFCanal\":17,\"EsNivelGlobal\":0,\"Sucursales\":\"3\"}"
                                }

Sample ERROR Response:

{
    "StatusCode": 400,
    "Message": "Bad Request : *DESCRIPCION DEL ERROR PARAMETRO ENTRADA ERRADO*.",
    "Entity": null
}

{
    "StatusCode": 401,
    "Message": "Unauthorized : *DESCRIPCION ERROR NO AUTORIZADO*.",
    "Entity": null
}

{
    "StatusCode": 500,
    "Message": "InternalServerError : La solicitud no fue procesada.",
    "Entity": null
}

PROVEEDORES Request information

Actualiza un proveedor en el sistema ISOLUCIÓN a través de esta opción.

URI parameters

HTTP PUT: https://[service_address]/api/proveedores/

[service_address]: Dirección disponible para conectividad con el API, debe validarse con su proveedor de ISOLUCIÓN.

PUT Request HTTP Headers

Header	Ejemplo	Descripción
Authorization	Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==	Para la autorización sobre el API es necesario un usuario y contraseña, este usuario debe ser creado en el modulo de Usuarios de Isolucion, se recomienda crear un usuario único para la integración. Una vez creado el usuario se debe cifrar en base64 de la siguiente manera NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Referencias The 'Basic' HTTP Authentication Scheme Esquema de autenticación Basic
apiKey	YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost	Llave otorgada para el uso del API.
Content-Type	application/json	Tipo de contenido enviado en la solicitud.

Header

Ejemplo

Descripción

Authorization

Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Una vez creado el usuario se debe cifrar en base64 de la siguiente manera

NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Referencias
The 'Basic' HTTP Authentication Scheme
Esquema de autenticación Basic

apiKey

YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost

Llave otorgada para el uso del API.

Content-Type

application/json

Tipo de contenido enviado en la solicitud.

Body parameters

Nombre del campo	Formato	Tamaño	Descripción	Obligatorio
TipoIdentificacion	Texto	varchar(255)	Nombre del tipo documento, sino existe se crea con el valor enviado.	Si.
NumeroIdentificacion	Texto	varchar(20)	Número de identificación.	Si.
Nombre	Texto	varchar(255)	Nombre completo del proveedor.	Si.
Contacto	Texto	varchar(80)	Correo electronico.	No.
Telefono	varchar(30)		Telefono.	No.
Email	Texto	varchar(250)	Email.	No.
Fax	Texto	varchar(30)	Fax.	No.
Direccion	Texto	varchar(255)	Direccion.	No.
Pais	Texto	varchar(100)	Pais de trabajo del proveedor, sino existe se crea con el valor enviado.	No.
Activo	Booleano [1,0]		Activo:1 , Inactivo:0. Indica si el proveedor se encuentra activo o no.	No.
CodActividadEconomica	Entero	int	Codigo de la actividad economica a la que se dedica el proveedor. Debe existir previamente.	No.
CodOrigenRecursos	Entero	int	Codigo delorigen de los recursos del proveedor. Debe existir previamente.	No.
CodSLFCanal	Entero	int	Codigo del canal por el que el cliente conocio la empresa. Debe existir previamente	No.
CodCiudad	Entero	int	Codigo de la Ciudad, debe existir en Isolucion (Ver Objeto ciudad)	No.
EsNivelGlobal	Entero	int	Indica si el cliente es de nivel global (1) o pertenece a alguna sucursal (0)	Si (Para empresas con multicompañia)
Sucursales	Texto	varchar(255)	Lista de sucursales a las que pertenece el cliente	Si (Para empresas con multicompañia)

Request Formats

application/json/

Sample:

{  
                          "TipoIdentificacion": "Pasaporte",
                          "NumeroIdentificacion": "1423",
                          "Nombre": "sample string 4",
                          "Contacto": "sample string 5",
                          "Telefono": "sample string 7",
                          "Email": "sample string 8",
                          "Fax": "sample string 9",
                          "Direccion": "sample string 10",
                          "Pais": "Colombia",
                          "Activo": "1",
                          "CodActividadEconomica":2,
                          "CodOrigenRecursos":2,
                          "CodSLFCanal":17,
                          "CodCiudad": 1,
                          "EsNivelGlobal":0,
                          "Sucursales":"3,1"
}

Proveedores Response Information

Resource Description

Respuesta en Formato JSON a la solicitud de actualización en el sistema.

Response Formats

application/json/

Campo	Ejemplo	Descripción
StatusCode	"StatusCode":200	Códigos HTTP de respuesta indicando si fue exitoso o no el request realizado. [200,400,404,500] Exito,Error.
Message	"Message":"El Proveedor ha sido actualizado exitosamente."	Descripción de la respuesta exitosa o mensaje de error enviado por el servidor.
Entity	"Entity": [[{data1},{data2}...],null]	Formato JSON con los datos actualizados en el sistema. En el caso de respuesta no exitosa el valor es nulo.

Response Formats

application/json/

Sample OK Response:

{
                                "StatusCode": 200,
                                "Message": "Proveedor actualizado.",
                                "Entity": "{\"IdProveedor\":0,\"TipoIdentificacion\":\"Pasaporte\",\"NumeroIdentificacion\":\"1423\",\"Nombre\":\"sample string 4\",\"Contacto\":\"sample string 5\",\"Telefono\":\"sample string 7\",\"Email\":\"sample string 8\",\"Fax\":\"sample string 9\",\"Direccion\":\"sample string 10\",\"Pais\":\"Colombia\",\"Activo\":\"1\",\"CodActividadEconomica\":2,\"CodOrigenRecursos\":2,\"CodSLFCanal\":17,\"EsNivelGlobal\":0,\"Sucursales\":\"3,1\"}"
                        }

Sample ERROR Response:

{
    "StatusCode": 400,
    "Message": "Bad Request : *DESCRIPCION DEL ERROR PARAMETRO ENTRADA ERRADO*.",
    "Entity": null
}

{
    "StatusCode": 401,
    "Message": "Unauthorized : *DESCRIPCION ERROR NO AUTORIZADO*.",
    "Entity": null
}

{
    "StatusCode": 404,
    "Message": "Not Found : *DESCRIPCION ERROR ELEMENTO NO EXISTE*.",
    "Entity": null
}

{
    "StatusCode": 500,
    "Message": "InternalServerError : La solicitud no fue procesada.",
    "Entity": null
}

PROVEEDORES Request information

Obtiene un proveedor por documento y tipo de documento existentes en el sistema ISOLUCIÓN.

URI parameters

HTTP GET: https://[service_address]/api/Proveedores/tipodocumento/[codTipoDocumento]/documento/[numeroDocumento]

[service_address]: Dirección disponible para conectividad con el API, debe validarse con su proveedor de ISOLUCIÓN.

[codTipoDocumento]: Identificador del Tipo de documento del cual se quiere traer la informacion del proveedor.

[numeroDocumento]: Número de documento del cual se quiere traer la informacion del proveedor.

GET Request HTTP Headers

Header	Ejemplo	Descripción
Authorization	Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==	Para la autorización sobre el API es necesario un usuario y contraseña, este usuario debe ser creado en el modulo de Usuarios de Isolucion, se recomienda crear un usuario único para la integración. Una vez creado el usuario se debe cifrar en base64 de la siguiente manera NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Referencias The 'Basic' HTTP Authentication Scheme Esquema de autenticación Basic
apiKey	YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost	Llave otorgada para el uso del API.
Content-Type	application/json	Tipo de contenido enviado en la solicitud.

Header

Ejemplo

Descripción

Authorization

Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Una vez creado el usuario se debe cifrar en base64 de la siguiente manera

NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Referencias
The 'Basic' HTTP Authentication Scheme
Esquema de autenticación Basic

apiKey

YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost

Llave otorgada para el uso del API.

Content-Type

application/json

Tipo de contenido enviado en la solicitud.

Proveedores Response Information

Resource Description

Respuesta en Formato JSON a la solicitud de obtener los datos registrados en el sistema.

Response Formats

application/json/

Campo	Ejemplo	Descripción
StatusCode	"StatusCode":200	Códigos HTTP de respuesta indicando si fue exitoso o no el request realizado. [200,400,404,500] Exito,Error.
Message	"Message":"Prooveedor obtenido exitosamente.."	Descripción de la respuesta exitosa o mensaje de error enviado por el servidor.
Entity	"Entity": [{data1}]	Formato JSON con el Proveedor registrado en el sistema. En el caso de respuesta no exitosa el valor es nulo.

Sample Ok Response:

{
    "StatusCode": 200,
    "Message": "Prooveedores obtenido exitosamente.",
    "Entity": "{\"Id_Tercero\":9,\"NomTercero\":\"NELSON ROKEFELLER\",\"CodTipoidentificacion\":4,\"NumDocumento\":\"12345678\",\"Telefono\":null,\"Email\":null,\"CodTipoDeRelacion\":1,\"CodTipoPersona\":2,\"Porcentaje\":4,\"Activo\":1}"
}

Sample ERROR Response:

{
    "StatusCode": 400,
    "Message": "Bad Request : *DESCRIPCION DEL ERROR PARAMETRO ENTRADA ERRADO*.",
    "Entity": null
}

{
    "StatusCode": 401,
    "Message": "Unauthorized : *DESCRIPCION ERROR NO AUTORIZADO*.",
    "Entity": null
}

{
    "StatusCode": 404,
    "Message": "Not Found : *DESCRIPCION ERROR ELEMENTO NO EXISTE*.",
    "Entity": null
}

{
    "StatusCode": 500,
    "Message": "InternalServerError : La solicitud no fue procesada.",
    "Entity": null
}

PROVEEDORES Request information

Relaciona un tercero existente a un provedor en el sistema ISOLUCIÓN.

URI parameters

HTTP POST: https://[service_address]/api/Proveedores/[idProveedor]/Tercero

[service_address]: Dirección disponible para conectividad con el API, debe validarse con su proveedor de ISOLUCIÓN.

[idProveedor]: Identificador único de proveedor (id) en isolucion (Ver Objeto proveedor)..

POST Request HTTP Headers

Header	Ejemplo	Descripción
Authorization	Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==	Para la autorización sobre el API es necesario un usuario y contraseña, este usuario debe ser creado en el modulo de Usuarios de Isolucion, se recomienda crear un usuario único para la integración. Una vez creado el usuario se debe cifrar en base64 de la siguiente manera NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Referencias The 'Basic' HTTP Authentication Scheme Esquema de autenticación Basic
apiKey	YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost	Llave otorgada para el uso del API.
Content-Type	application/json	Tipo de contenido enviado en la solicitud.

Header

Ejemplo

Descripción

Authorization

Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Una vez creado el usuario se debe cifrar en base64 de la siguiente manera

NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Referencias
The 'Basic' HTTP Authentication Scheme
Esquema de autenticación Basic

apiKey

YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost

Llave otorgada para el uso del API.

Content-Type

application/json

Tipo de contenido enviado en la solicitud.

Body parameters

Nombre del campo	Formato	Tamaño	Descripción	Obligatorio
IdTercero	Entero	int	Identificador único de tercero (id) en isolucion (Ver Objeto tercero).	Si.
Porcentaje	Entero	Int)	Participacion de tercero en la relación con su contraparte	No.
TipoRelacion	Entero	Int	Identificador único de tipo de relacion (id) en isolucion (Ver Objeto tipo relación) .	Si.

Request Formats

application/json/

Sample:

{
    "IdTercero": 12,
    "Porcentaje": 30,
    "TipoRelacion": 3
}

Proveedores Response Information

Resource Description

Respuesta en Formato JSON a la solicitud de obtener los datos registrados en el sistema.

Response Formats

application/json/

Campo	Ejemplo	Descripción
StatusCode	"StatusCode":200	Códigos HTTP de respuesta indicando si fue exitoso o no el request realizado. [200,400,500] Exito,Error.
Message	"Message":"Tercero relacionado agregado correctamente"	Descripción de la respuesta exitosa o mensaje de error enviado por el servidor.
Entity	"Entity": [{data1}]	Formato JSON con el Tercero registrado en el sistema. En el caso de respuesta no exitosa el valor es nulo.

Sample Ok Response:

{
    "StatusCode": 200,
    "Message": "Tercero relacionado agregado correctamente.",
    "Entity": "{\"Id_Tercero\":9,\"Porcentaje\":22,\"IdContraparte\":2,\"TipoRelacion\":4,\"TipoContraparte\":1}"
}

Sample ERROR Response:

{
    "StatusCode": 400,
    "Message": "Bad Request : *DESCRIPCION DEL ERROR PARAMETRO ENTRADA ERRADO*.",
    "Entity": null
}

{
    "StatusCode": 401,
    "Message": "Unauthorized : *DESCRIPCION ERROR NO AUTORIZADO*.",
    "Entity": null
}

{
    "StatusCode": 500,
    "Message": "InternalServerError : La solicitud no fue procesada.",
    "Entity": null
}

PROVEEDORES Request information

Elimina relación de un tercero existente a un provedor en el sistema ISOLUCIÓN.

URI parameters

HTTP DELETE: https://[service_address]/api/Proveedores/[idProveedor]/Tercero/[idTercero]/TipoRelacion/[idTipoRelacion]

[service_address]: Dirección disponible para conectividad con el API, debe validarse con su proveedor de ISOLUCIÓN.

[idProveedor]: Identificador único de proveedor (id) en isolucion (Ver Objeto proveedor).

[idTercero]: Identificador único de tercero (id) en isolucion (Ver Objeto tercero).

[idTipoRelacion]: Identificador único de tipo de relacion en isolucion (Ver Objeto tipo relación) .

DELETE Request HTTP Headers

Header	Ejemplo	Descripción
Authorization	Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==	Para la autorización sobre el API es necesario un usuario y contraseña, este usuario debe ser creado en el modulo de Usuarios de Isolucion, se recomienda crear un usuario único para la integración. Una vez creado el usuario se debe cifrar en base64 de la siguiente manera NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Referencias The 'Basic' HTTP Authentication Scheme Esquema de autenticación Basic
apiKey	YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost	Llave otorgada para el uso del API.
Content-Type	application/json	Tipo de contenido enviado en la solicitud.

Header

Ejemplo

Descripción

Authorization

Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Una vez creado el usuario se debe cifrar en base64 de la siguiente manera

NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Referencias
The 'Basic' HTTP Authentication Scheme
Esquema de autenticación Basic

apiKey

YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost

Llave otorgada para el uso del API.

Content-Type

application/json

Tipo de contenido enviado en la solicitud.

Proveedores Response Information

Resource Description

Respuesta en Formato JSON a la solicitud de obtener los datos registrados en el sistema.

Response Formats

application/json/

Campo	Ejemplo	Descripción
StatusCode	"StatusCode":200	Códigos HTTP de respuesta indicando si fue exitoso o no el request realizado. [200,400,500] Exito,Error.
Message	"Message":"Tercero relacionado agregado correctamente"	Descripción de la respuesta exitosa o mensaje de error enviado por el servidor.
Entity	"Entity": [{data1}]	Formato JSON con el Tercero registrado en el sistema. En el caso de respuesta no exitosa el valor es nulo.

Sample Ok Response:

{
    "StatusCode": 200,
    "Message": "Tercero relacionado eliminado correctamente",
    "Entity": "{\"Id_Tercero\":9,\"NomTercero\":\"NELSON ROKEFELLER\",\"CodTipoidentificacion\":4,\"NumDocumento\":\"12345678\",\"Telefono\":null,\"Email\":null,\"CodTipoDeRelacion\":1,\"CodTipoPersona\":2,\"Porcentaje\":4,\"Activo\":1}"
}

Sample ERROR Response:

{
    "StatusCode": 400,
    "Message": "Bad Request : *DESCRIPCION DEL ERROR PARAMETRO ENTRADA ERRADO*.",
    "Entity": null
}

{
    "StatusCode": 401,
    "Message": "Unauthorized : *DESCRIPCION ERROR NO AUTORIZADO*.",
    "Entity": null
}

{
    "StatusCode": 404,
    "Message": "Not Found : *DESCRIPCION ERROR ELEMENTO NO EXISTE*.",
    "Entity": null
}

{
    "StatusCode": 500,
    "Message": "InternalServerError : La solicitud no fue procesada.",
    "Entity": null
}

PROVEEDORES Request information

Obtiene la lista de proveedores existentes en el sistema ISOLUCIÓN.

Similar a Obtener, incluye la propiedad InfoPortalContrapartes que contiene la información diligenciada en el/los formulario(s) de Contrapartes.

URI parameters

HTTP GET: https://[service_address]/api/Proveedores/ext/

[service_address]: Dirección disponible para conectividad con el API, debe validarse con su proveedor de ISOLUCIÓN.

GET Request HTTP Headers

Header	Ejemplo	Descripción
Authorization	Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==	Para la autorización sobre el API es necesario un usuario y contraseña, este usuario debe ser creado en el modulo de Usuarios de Isolucion, se recomienda crear un usuario único para la integración. Una vez creado el usuario se debe cifrar en base64 de la siguiente manera NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ== Referencias The 'Basic' HTTP Authentication Scheme Esquema de autenticación Basic
apiKey	YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost	Llave otorgada para el uso del API.
Content-Type	application/json	Tipo de contenido enviado en la solicitud.

Header

Ejemplo

Descripción

Authorization

Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Una vez creado el usuario se debe cifrar en base64 de la siguiente manera

NombreUsuario:Contraseña el resultado debe ser algo parecido a Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Cuando se tenga este dato se debe enviar en el encabezado de la petición de la siguiente manera Basic Tm9tYnJlVXN1YXJpbzpDb250cmFzZcOxYQ==

Referencias
The 'Basic' HTTP Authentication Scheme
Esquema de autenticación Basic

apiKey

YWJjZDEyMzQYWJjZDEyMzQYWJjZDEyMzQ-localhost

Llave otorgada para el uso del API.

Content-Type

application/json

Tipo de contenido enviado en la solicitud.

Query string parameters

Si requiere paginar los registros se deben enviar estos parametros por query string.

HTTP GET: https://[service_address]/api/[metodo]/ext?RegistroActual=0&TamanoPagina=20

[service_address]: Dirección disponible para conectividad con el API, debe validarse con su proveedor de ISOLUCIÓN.

[metodo]: Hace referencia al objeto de isolucion que queremos consultar (Funcionarios, Mediciones, Cargos, etc).

Nombre del campo	Formato	Tamaño	Descripción	Obligatorio
RegistroActual	Númerico		Indice del registro en el cual se encuentra la consulta. Indice inicial debe ser 0.	Si.
TamanoPagina	Númerico		Cantidad total de registros que se quiere traer. Si el tamaño es 0 se consultaran todos los datos	Si.

Proveedores Response Information

Resource Description

Respuesta en Formato JSON a la solicitud de obtener los datos registrados en el sistema.

Response Formats

application/json/

Campo	Ejemplo	Descripción
StatusCode	"StatusCode":200	Códigos HTTP de respuesta indicando si fue exitoso o no el request realizado. [200,500] Exito,Error.
Message	"Message":"Lista de Proveedores obtenida exitosamente."	Descripción de la respuesta exitosa o mensaje de error enviado por el servidor.
Entity	"Entity": [[{data1},{data2}...],null]	Formato JSON con el listado de Proveedores registrados en el sistema. En el caso de respuesta no exitosa el valor es nulo.

Sample Ok Response:

{
"StatusCode": 200,
"Message": "Lista de proveedores obtenida exitosamente.",
"Entity": "[...
    {
        "IdProveedor": 74,
        "NomProveedor": "Isolución",
        "CodTipoIdentificacion": 1,
        "NumeroIdentificacion": "123456789",
        "Contacto": "info@isolucion.com",
        "Telefono": "123456789",
        "Email": "info@isolucion.com",
        "Fax": "123456789",
        "Direccion": "Carrera 7 # 77-70",
        "CodigoInternoProveedor": null,
        "BienesServicios": null,
        "CodObjetoSocial": null,
        "VigenciaSociedad": null,
        "CodNivelRiesgo": null,
        "CodTamanoCompania": null,
        "CatalogosDisponibles": null,
        "CodMarca": null,
        "CodProducto": null,
        "Telefono2": null,
        "Telefono3": null,
        "LovSexo": null,
        "CodClasificacionTributaria": null,
        "CodigoCiudad": null,
        "PeriodoPago": null,
        "ActividadEconomica": null,
        "FormaPago": null,
        "CodTipoPersona": 1,
        "Declarante": null,
        "AgenteRetenedor": null,
        "Autorretenedor": null,
        "CodigoBanco": null,
        "NombreBanco": null,
        "CodTipoCuenta": null,
        "NumeroCuenta": null,
        "ValorMaximoPago": null,
        "Activo": 1,
        "EsNivelGlobal": 1,
        "EmailAdicional": null,
        "Sucursales": null,
        "InfoPortalContrapartes": [
            {
                "camposSimples": {
                    "Datos generales": {
                        "Tipo Identificación": "1",
                        "Identificación": "123456789",
                        "Tipo Persona": "1",
                        "Nombre o Razón social": "Isolución",
                        "Teléfono": "123456789",
                        "Fax": "301230920252",
                        "Email": "info@isolucion.com",
                        "Sitio web": "http://bills/contrapartes/formulario-solicitud",
                        "Dirección": "Carrera 7 # 77-70",
                        "Ciudad / Departamento / País": "1338",
                        "Código postal": 1234567890,
                        "Tamaño de la empresa": "Microempresa",
                        "Número de empleados": 50,
                        "Canal": "5"
                    },
                    "Representante legal": {
                        "Nombre": "Representante Legal - Isolución",
                        "Tipo Identificación": null,
                        "Identificación": "",
                        "Lugar de expedición": "",
                        "Teléfono": "",
                        "Email": "info@isolucion.com",
                        "Ciudad / Departamento / País": "",
                        "Dirección": "",
                        "Código postal": null,
                        "¿Por su cargo o actividad maneja recursos públicos?": "",
                        "¿Por su cargo o actividad ejerce algún grado de poder público?": "",
                        "¿Por su actividad u oficio goza usted de reconocimiento público general?": "",
                        "¿Existe algún vínculo entre usted y una persona considerada públicamente expuesta?": "",
                        "¿Usted o la persona jurídica que representa ha celebrado contratos con entidades estatales?": "",
                        "¿Usted o la persona jurídica que representa tiene algún asociado o accionista considerado persona expuesta políticamente?": "",
                        "¿Está obligado a tributar en un país diferente al que vive?": "",
                        "Explicaciones preguntas": ""
                    },
                    "Representante legal suplente": {
                        "Nombre": "Representante Legal Suplente - Isolución",
                        "Tipo Identificación": null,
                        "Identificación": "",
                        "Lugar de expedición": "",
                        "Teléfono": "",
                        "Email": "info@isolucion.com",
                        "Ciudad / Departamento / País": "",
                        "Dirección": "",
                        "Código postal": null,
                        "¿Por su cargo o actividad maneja recursos públicos?": "",
                        "¿Por su cargo o actividad ejerce algún grado de poder público?": "",
                        "¿Por su actividad u oficio goza usted de reconocimiento público general?": "",
                        "¿Existe algún vínculo entre usted y una persona considerada públicamente expuesta?": "",
                        "¿Usted o la persona jurídica que representa ha celebrado contratos con entidades estatales?": "",
                        "¿Usted o la persona jurídica que representa tiene algún asociado o accionista considerado persona expuesta políticamente?": "",
                        "¿Está obligado a tributar en un país diferente al que vive?": "",
                        "Explicaciones preguntas": ""
                    },
                    "Contacto e información comercial": {
                        "Nombre del contacto": "Contacto - Isolución",
                        "Cargo": "",
                        "Tipo Identificación": null,
                        "Identificación": "",
                        "Lugar de expedición": "",
                        "Teléfono": "",
                        "Email": "info@isolucion.com",
                        "Dirección": "",
                        "Ciudad / Departamento / País": "",
                        "Código postal": "",
                        "Condiciones de pago": null
                    },
                    "Composición accionaria": {
                    },
                    "Terceros relacionados": {
                    },
                    "Información tributaria": {
                        "Actividad económica CIIU a 4 dígitos": "777",
                        "Email facturación electrónica": "",
                        "Agente retenedor de IVA": "",
                        "Autorretenedor de Impuesto de Renta": "",
                        "Entidad sin ánimo de lucro": "",
                        "Resolución entidad sin ánimo de lucro": "",
                        "Gran contribuyente": "",
                        "Resolución Gran contribuyente": "",
                        "Retenedor o Agente retenedor ICA": "",
                        "Maneja topes de retención en la fuente": "",
                        "Responsable de IVA": "",
                        "Régimen especial ZOMAC": "",
                        "Régimen especial ZESE": "",
                        "Régimen especial CI": ""
                    },
                    "Información financiera": {
                        "Fecha Información financiera": "2025-09-04",
                        "Fecha Actualización": "2025-09-12",
                        "Fecha Creación": "2025-09-20",
                        "Activo Corriente": "$12.345.678.901.234,56",
                        "Activo No Corriente": "$23.456.789.012.345,67",
                        "Pasivo Corriente": "$34.567.890.123.456,78",
                        "Pasivo No Corriente": "$45.678.901.234.567,89",
                        "Total Patrimonio": "$56.789.012.345.678,90",
                        "Utilidad Neta": "$67.890.123.456.789,01",
                        "Ingresos Mensuales": "$78.901.234.567.890,12",
                        "Egresos Mensuales": "$89.012.345.678.901,23",
                        "Otros Ingresos Mensuales": "$90.123.456.789.012,34"
                    },
                    "Personas autorizadas para solicitar servicios (Proveedores)": {
                    },
                    "Información de pagos": {
                        "Días de pago": "",
                        "Condiciones de pago": null
                    },
                    "Operaciones internacionales y activos virtuales": {
                        "¿Realiza transacciones en moneda extranjera?": "",
                        "Tipo de operaciones en moneda extranjera": null,
                        "Observaciones operaciones en moneda extranjera": "",
                        "¿La empresa realiza o realizó alguna actividad u operación con activos virtuales?": "",
                        "¿Con cuáles activos virtuales?": ""
                    },
                    "Referencias comerciales": {
                    },
                    "Declaración de origen de fondos": {
                        "Declaración de origen de fondos": "",
                        "Actividad de origen de fondos": "4"
                    },
                    "Autorización de manejo de información": {
                        "Autorización de manejo de información": ""
                    },
                    "Autorización de tratamiento de datos personales": {
                        "Autorización de tratamiento de datos personales": ""
                    },
                    "Políticas de control de riesgos": {
                        "Políticas de control de riesgos": ""
                    }
                },
                "camposGrupo": {
                    "Composición accionaria::Socios": [
                        {
                            "Socios::Razón social o nombre completo": "Composición Accionaria - Isolución",
                            "Socios::Tipo Identificación": "1",
                            "Socios::Identificación": "123456789",
                            "Socios::Nacionalidad": null,
                            "Socios::Porcentaje de participación": "",
                            "Socios::¿Es PEP?": "",
                            "Socios::Observaciones": ""
                        }
                    ],
                    "Terceros relacionados::Persona": [
                        {
                            "Persona::Razón social o nombre completo": "Tercero - Isolución",
                            "Persona::Tipo Identificación": "2",
                            "Persona::Identificación": "123456789",
                            "Persona::Nacionalidad": null,
                            "Persona::¿Es PEP?": "",
                            "Persona::Cargo en la entidad": "",
                            "Persona::Observaciones": ""
                        }
                    ],
                    "Personas autorizadas para solicitar servicios (Proveedores)::PersonasAutorizadas": [
                        {
                            "PersonasAutorizadas::Nombre": "Solicitar Servicios - Isolución",
                            "PersonasAutorizadas::Teléfono": "",
                            "PersonasAutorizadas::Email": "info@isolucion.com",
                            "PersonasAutorizadas::Cargo": "",
                            "PersonasAutorizadas::AutorizadaPara": ""
                        }
                    ],
                    "Información de pagos::PersonasAutorizadas": [
                        {
                            "PersonasAutorizadas::Nombre": "Información de Pagos - Isolución",
                            "PersonasAutorizadas::Teléfono": "",
                            "PersonasAutorizadas::Email": "info@isolucion.com",
                            "PersonasAutorizadas::Cargo": "",
                            "PersonasAutorizadas::AutorizadaPara": ""
                        }
                    ],
                    "Operaciones internacionales y activos virtuales::¿Posee productos financieros en el exterior?": [
                        {
                            "¿Posee productos financieros en el exterior?::Tipo de Producto": "Operaciones Internaciones - Isolución",
                            "¿Posee productos financieros en el exterior?::Número de identificación del producto": "",
                            "¿Posee productos financieros en el exterior?::Entidad": "Entidad - Isolución",
                            "¿Posee productos financieros en el exterior?::Monto": "",
                            "¿Posee productos financieros en el exterior?::Ciudad": "",
                            "¿Posee productos financieros en el exterior?::País": "",
                            "¿Posee productos financieros en el exterior?::Moneda": ""
                        }
                    ],
                    "Referencias comerciales::Referencia": [
                        {
                            "Referencia::Nombre persona": "Referencia Comercial - Isolución",
                            "Referencia::Empresa": "",
                            "Referencia::Teléfono": "",
                            "Referencia::Email": "info@isolucion.com",
                            "Referencia::Cargo": "",
                            "Referencia::Relación": ""
                        }
                    ]
                }
            }
        ]
    },
...]"
        }

Sample ERROR Response:

{
    "StatusCode": 401,
    "Message": "Unauthorized : *DESCRIPCION ERROR NO AUTORIZADO*.",
    "Entity": null
}

{
    "StatusCode": 500,
    "Message": "InternalServerError : La solicitud no fue procesada.",
    "Entity": null
}

isolucion Data Connector

PROVEEDORES Request information

URI parameters

GET Request HTTP Headers

Query string parameters

Proveedores Response Information

Resource Description

Response Formats

application/json/

PROVEEDORES Request information

URI parameters

POST Request HTTP Headers

Body parameters

Request Formats

application/json/

PROVEEDORES Response Information

Resource Description

Response Formats

application/json/

PROVEEDORES Request information

URI parameters

PUT Request HTTP Headers

Body parameters

Request Formats

application/json/

Proveedores Response Information

Resource Description

Response Formats

application/json/

Response Formats

application/json/

PROVEEDORES Request information

URI parameters

GET Request HTTP Headers

Proveedores Response Information

Resource Description

Response Formats

application/json/

PROVEEDORES Request information

URI parameters

POST Request HTTP Headers

Body parameters

Request Formats

application/json/

Proveedores Response Information

Resource Description

Response Formats

application/json/

PROVEEDORES Request information

URI parameters

DELETE Request HTTP Headers

Proveedores Response Information

Resource Description

Response Formats

application/json/

PROVEEDORES Request information

URI parameters

GET Request HTTP Headers

Query string parameters

Proveedores Response Information

Resource Description

Response Formats

application/json/