isolucion Data Connector      

6.0.25.05.02.18
  • Accionista
  • Actividad Economica
  • Area
  • Ausentismo
  • Cargo
  • Centros de costo
  • Cliente
  • Ciudad
  • Denuncia
  • Departamentos
  • Documento
  • Equipo
  • Familia
  • Financiera
  • Funcionarios
  • Furat
  • Furel
  • Furil
  • Grupos
  • Grupo Usuario
  • Indicador
  • Información Financiera
  • Listado Maestro
  • Medición
  • Objetivo
  • Oficina
  • Origen Recursos
  • Pais
  • Plantilla documental
  • PQR
  • Proceso
  • Productos
  • Proveedores
  • Registros
  • Roles de usuario
  • SLF Canal
  • Sucursales
  • Tercero
  • Tipo Acción
  • Tipo De Relación
  • Tipo Documento
  • Tipo Identificación
  • Tipo Persona
  • Tipo Problema
  • Usuario

  • Obtener
  • Crear
  • Actualizar

EQUIPOS Request information


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


URI parameters

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

[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.

EQUIPOS 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 Equipos 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 Equipos registrados en el sistema. En el caso de respuesta no exitosa el valor es nulo.

Sample Ok Response:

{
"StatusCode": 200,
"Message": "Lista de equipos obtenida exitosamente.",
"Entity": "[{\"NomEquipo\":\"Pantalla de trabajo 19\",\"MarcaDeEquipo\":null,\"Modelo\":\"\",\"Descripcion\":\"\",\"Cuidados\":\"\",\"Serial\":\"\",\"Placa\":\"EQ-2098\",\"Localizacion\":\"\",\"Oficina\":null,\"Usuario\":null,\"FechaCompra\":\"1900-01-01T00:00:00\",\"CantidadCalibracion\":0,\"CantidadMantenimiento\":0,\"Activo\":1},{\"NomEquipo\":\"Pantalla de trabajo\",\"MarcaDeEquipo\":null,\"Modelo\":\"Serie5\",\"Descripcion\":\"LCD 42 pulgadas\",\"Cuidados\":\"\",\"Serial\":\"\",\"Placa\":\"EQ-2098\",\"Localizacion\":\"\",\"Oficina\":null,\"Usuario\":null,\"FechaCompra\":\"1900-01-01T00:00:00\",\"CantidadCalibracion\":0,\"CantidadMantenimiento\":0,\"Activo\":1},{\"NomEquipo\":\"Pantalla\",\"MarcaDeEquipo\":null,\"Modelo\":\"Serie5\",\"Descripcion\":\"LCD 42 pulgadas\",\"Cuidados\":\"\",\"Serial\":\"\",\"Placa\":\"EQ-2098\",\"Localizacion\":\"\",\"Oficina\":null,\"Usuario\":null,\"FechaCompra\":\"1900-01-01T00:00:00\",\"CantidadCalibracion\":0,\"CantidadMantenimiento\":0,\"Activo\":1}]"
        }

Sample ERROR Response:

{
    "StatusCode": 401,
    "Message": "Unauthorized : *DESCRIPCION ERROR NO AUTORIZADO*.",
    "Entity": null
}
{
    "StatusCode": 500,
    "Message": "InternalServerError : La solicitud no fue procesada.",
    "Entity": null
}

EQUIPOS Request information


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


URI parameters

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

[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.

Body parameters

Nombre del campo Formato Tamaño Descripción Obligatorio
NomEquipo Texto varchar(255) Nombre del equipo. No puede existir previamente. Si.
Placa Texto varchar(255) Placa del equipo. No.
Serial Texto varchar(255) Serial del equipo. No.
Modelo Texto varchar(255) Modelo del equipo. No.
Activo Booleano [1,0] Activo:1 , Inactivo:0. Indica si el equipo se encuentra activo o no. No.
FechaCompra Fecha. ISO8601 yyyy-MM-ddTHH:mm:ss Fecha de la compra del equipo. No.
Descripcion Texto varchar(4000) Descripción del equipo. No.
CantidadCalibracion Numérico int Cuidadeos del equipoo. No.
CantidadMantenimiento Numérico int Cantidad de mantenimiento del equipo. No.
Oficina Texto varchar(255) Oficina a la que pertenece el equipo. Lista de valores, sino existe se crea con el valor enviado. No.
Usuario Texto varchar(255) Usuario responsable del equipo. Debe existir previamente en el sistema. No.
Cuidados Texto varchar(4000) Cuidados del equipo. No.
Localizacion Texto varchar(255) Localización del equipo. No.

Request Formats

application/json/

Sample:

{"NomEquipo":"Celular Samsung 9+","Modelo":"9+","Descripcion":"","Cuidados":"","Serial":"","Placa":"EQ-2101","Localizacion":"","Oficina":null,"Usuario":null,"FechaCompra":null,"CantidadCalibracion":"","CantidadMantenimiento":"","Activo":null}

EQUIPOS 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 Equipo 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": " El Equipo ha sido creado exitosamente.",
"Entity": "{\"NomEquipo\":\"Celular Samsung 9+\",\"Modelo\":\"9+\",\"Descripcion\":\"\",\"Cuidados\":\"\",\"Serial\":\"\",\"Placa\":\"EQ-2101\",\"Localizacion\":\"\",\"Oficina\":null,\"Usuario\":null,\"FechaCompra\":null,\"CantidadCalibracion\":null,\"CantidadMantenimiento\":null,\"Activo\":null}"
}

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
}

EQUIPOS Request information


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


URI parameters

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

[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.

Body parameters

Nombre del campo Formato Tamaño Descripción Obligatorio
NomEquipo Texto varchar(255) Nombre del equipo. Debe existir previamente. Se usa para identificar al equipo a actualizar. No puede ser modificado. Si.
Placa Texto varchar(255) Placa del equipo. No.
Serial Texto varchar(255) Serial del equipo. No.
Modelo Texto varchar(255) Modelo del equipo. No.
Activo Booleano [1,0] Activo:1 , Inactivo:0. Indica si el equipo se encuentra activo o no. No.
FechaCompra Fecha. ISO8601 yyyy-MM-ddTHH:mm:ss Fecha de la compra del equipo. No.
Descripcion Texto varchar(4000) Descripción del equipo. No.
CantidadCalibracion Numérico int Cuidadeos del equipoo. No.
CantidadMantenimiento Numérico int Cantidad de mantenimiento del equipo. No.
Oficina Texto varchar(255) Oficina a la que pertenece el equipo. Lista de valores, sino existe se crea con el valor enviado. No.
Usuario Texto varchar(255) Usuario responsable del equipo. Debe existir previamente en el sistema. No.
Cuidados Texto varchar(4000) Cuidados del equipo. No.
Localizacion Texto varchar(255) Localización del equipo. No.

Request Formats

application/json/

Sample:

{"NomEquipo":"Pantalla X","Modelo":"Serie5","Descripcion":"LCD 42 pulgadas","Cuidados":"","Serial":"","Placa":"EQ-2098","Localizacion":"","Oficina":null,"Usuario":"PRUEBA DOS_52","FechaCompra":null,"CantidadCalibracion":null,"CantidadMantenimiento":null,"Activo":1}

EQUIPOS 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 Equipo 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": "El Equipo ha sido actualizado exitosamente.",
"Entity": "{\"NomEquipo\":\"Pantalla X\",\"Modelo\":\"Serie5\",\"Descripcion\":\"LCD 42 pulgadas\",\"Cuidados\":\"\",\"Serial\":\"\",\"Placa\":\"EQ-2098\",\"Localizacion\":\"\",\"Oficina\":null,\"Usuario\":\"PRUEBA DOS_52\",\"FechaCompra\":null,\"CantidadCalibracion\":null,\"CantidadMantenimiento\":null,\"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
}