Creación de equipos
Esta función permite crear un equipo.
Parámetros de Entrada
Parámetro | Tipo | Descripción |
|---|---|---|
brandId CAMPO OBLIGATORIO | Integer | Identificador numérico de la marca |
calibrationPeriodNum | String | Periodo de calibración en meses. Los posibles valores son: 1, 3, 6, 9, 12, 15, 18, 24, 30, 36, 48, 60, 72, 84, 96, 108 y 120 |
channelQuantity CAMPO OBLIGATORIO | Integer | Número de canales del equipo. Al menos tiene que tener 1. |
customerId CAMPO OBLIGATORIO | Integer | Identificador numérico del cliente |
customerTag | String | Nombre del equipo en el cliente |
customerUserId | Integer | Identificador del usuario del cliente asociado a este equipo |
description | String | Descripción |
externalId | String | Identificador externo del equipo |
itemType CAMPO OBLIGATORIO | String | Tipo de equipo. Los posibles valores son: DEVICE = Dispositivo |
lastCalibrationDate | String | Fecha de la última calibración Formato: aaaa-mm-dd |
modelId CAMPO OBLIGATORIO | Integer | Identificador numérico del modelo |
observations | String | Observaciones |
serialNumber | String | Número de serie |
tag | String | Nombre del equipo en Calibry |
statusId | Integer | Identificador del estado del equipo. Los posibles valores son: 1 En Uso Si no se incluye este parámetro, el equipo se creará con un estado por defecto (configurable). |
Parámetros de Salida
Parámetro | Tipo | Descripción |
|---|---|---|
id | Integer | Identificador interno del equipo |
addedDate | Date | Fecha de alta del equipo |
brandId | Integer | Identificador numérico de la marca |
brandName | String | Nombre de la marca |
calibrationPeriodId | String | Identificador del tipo de periodo de calibración: M = Meses. |
calibrationPeriodNum | Integer | Periodo de calibración en meses |
channelQuantity | Integer | Número de canales del equipo |
customerId | Integer | Identificador numérico del cliente |
customerName | String | Nombre del cliente |
customerTag | String | Nombre del equipo en el cliente |
customerUserId | Integer | Identificador del usuario del cliente asociado a este equipo |
defaultImageId | Integer | Identificador numérico de la imagen |
description | String | Descripción |
externalId | String | Identificador externo del equipo |
familyId | Integer | Identificador de la familia |
familyName | String | Nombre de la familia |
itemType | String | Tipo de equipo. Los posibles valores son: DEVICE = Dispositivo STANDARD = Patrón EXTERNAL_SENSOR = Sensor Externo INTERNAL_SENSOR = Sensor Interno PERIPHERAL = Ítem auxiliar |
lastCalibrationDate | Date | Fecha de la última calibración |
locationId | Integer | Identificador numérico de la localización del equipo en el cliente. |
modelId | Integer | Identificador numérico del modelo |
modelName | String | Nombre del modelo |
nextCalibrationDate | Date | Fecha de la próxima calibración. Este dato se calcula si existe la última fecha de calibración (lastCalibrationDate) y periodo de calibración (calibrationPeriodNum) |
observations | String | Observaciones |
organizationId | Integer | Identificador interno de la organización |
ownerId | Integer | Identificador interno del propietario del equipo |
ownerName | String | Nombre del propietario del equipo |
rec_status | String | Estado del registro. Los posibles valores son: A = activo D = desactivado |
serialNumber | String | Número de serie |
statusId | Integer | Identificador numérico del estado del equipo. |
tag | String | Nombre del equipo en Calibry |
updateDate | Long | Fecha última actualización del equipo |
Códigos Error
Código | Descripción |
|---|---|
1000 | Error genérico |
7000 | Error creando el equipo |
7001 | Faltan parámetros obligatorios |
7002 | Marca del equipo desconocida |
7003 | Modelo del equipo desconocido |
7004 | Cliente del equipo desconocido |
7005 | Propietario desconocido |
7006 | Nombre del equipo en uso |
7007 | Periodo de calibración desconocido |
7008 | Localización del cliente desconocida |
7010 | Estado desconocido |
7011 | Usuario del cliente asociado al equipo desconocido |
Ejemplos
Llamada (Método POST)
https://servidor:8443/calibry-rest-api/rest/cif/item
Headers:
Authorization
Content-Type = application/json
Body:
{
"tag":"tag-cif-190313",
"serialNumber":"sn-cif-190313",
"customerTag":"cust-tag-cif-190313",
"externalId":"ext-id-001",
"brandId":5,
"modelId":5,
"itemType":"DEVICE",
"channelQuantity":4,
"description":"Desc prueba",
"observations":"Obs prueba",
"customerId":5,
"calibrationPeriodNum":12,
"lastCalibrationDate":"2019-01-01",
"statusId":7,
"customerUserId":85
}
Respuestas
Correcta:
{
"id": 15350,
"tag": "tag-cif-074",
"serialNumber": "sn-tag-cif-074",
"customerTag": "tag-cif-074",
"externalId":"ext-id-001",
"brandId": 5,
"modelId": 5,
"itemType": "DEVICE",
"channelQuantity": 4,
"description": "Desc prueba",
"observations": "Obs prueba",
"calibrationPeriodNum": 12,
"lastCalibrationDate": 1519516800000,
"nextCalibrationDate": 1551052800000,
"customerId": 5,
"customerName": "MiCliente S.L.",
"locationId": 4,
"ownerId": null,
"ownerName": null,
"statusId": 1,
"organizationId": 1,
"brandName": "Chauvin Arnoux",
"modelName": "CA1244 Higrometro",
"addedDate": 1530181621382,
"calibrationPeriodId": "M",
"defaultImageId": null,
"familyId":1,
"familyName":"TEMPERATURA",
"recStatus": "A",
"customerUserId":85,
"updateDate":1666783500000
}
Error:
{"code":"7001"}