Saltar al contenido principal

Instalar una unidad de pieza

POSThttps://carchost.fieldcontrol.com.br/part-units/{id}/install

Instala la unidad en un equipo o ubicación. Si estaba en inventario, la API registra un movimiento de salida. Se acepta cualquier situación, excepto discarded.

Requiere los headers X-Api-Key, User-Agent y Content-Type: application/json. Límite: 1 solicitud por segundo (más información).

Solicitud​

Parámetros de ruta

idstringobligatorio

Identificador de la unidad de pieza.

Ejemplo: YzNkNGU1ZjYtYTdiOC05MDEyLWNkZWYtMTIzNDU2Nzg5MDEyOjIyOTE1.

Headers

User-Agentstringobligatorio

Identificación de su aplicación.

Ejemplo: MinhaIntegracao/1.0.

Cuerpo de la solicitud

JSON, enviado con el header Content-Type: application/json.

equipmentIdstring

Equipo en el que se instala la unidad.

locationIdstring

Ubicación en la que se instala la unidad.

locationSectorIdstring

Sector de la ubicación.

locationEnvironmentIdstring

Ambiente de la ubicación.

installedAtstring (fecha y hora)

Fecha de instalación. El valor predeterminado es el momento de la solicitud.

replacementDueAtstring (fecha y hora)

Fecha prevista para el reemplazo.

Respuestas

  • 200

    Unidad instalada (status: installed).

  • 401

    Clave de API ausente (Missing API Key) o inválida (Invalid API Key). Consulte Autenticación.

  • 403

    Cuenta bloqueada (Account blocked), vencida (Account expired) o con un plan que no permite integración (Account plan not allowed). Consulte Autenticación.

  • 422

    Unidad descartada (reason: invalid status) o equipo, ubicación, sector o ambiente inexistentes (resourceValidationErr). Unidad inexistente: 422 resourceNotFound (no hay 404). Identificador de la URL inválido o de otra cuenta: uriValidationErr.

  • 429

    Se superó el límite de 1 solicitud por segundo. Consulte Límite de solicitudes.

  • 500

    Error inesperado en el servidor. También ocurre cuando un identificador del cuerpo no está en el formato esperado.