Crear una unidad de pieza

POSThttps://carchost.fieldcontrol.com.br/part-units

Registra una unidad física de una pieza, opcionalmente ya en un inventario.

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

Solicitud

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.

partIdstringobligatorio

Identificador de la pieza.

codestringobligatorio

Código de la unidad (p. ej. número de serie).

descriptionstring

Descripción de la unidad.

usageConditionstring

Condición de uso.

Valores aceptados: new, semi_new, used, refurbished, defective.Predeterminado: new.

valuenumber

Valor de la unidad.

storageIdstring

Inventario de entrada. Con inventario, la API registra un movimiento de entrada y la unidad queda available (o under_review en inventario de clasificación); sin inventario, queda available.

externalIdstring

Identificador de la unidad en su sistema.

archivedboolean

Archiva la unidad.

Predeterminado: false.

Respuestas

• 201

  Unidad de pieza creada.

• 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

  Cuerpo inválido (resourceValidationErr): partId o code ausentes (reason: missing required field), pieza o inventario inexistentes, usageCondition inválida, o campo de situación enviado (reason: transition field not allowed in create/update).

• 429

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

• 500

  Error inesperado en el servidor.