Saltar al contenido principal

Realizar una transferencia por identificador externo

POSThttps://carchost.fieldcontrol.com.br/storages-movements-v2/transfers

Transfiere uno o más productos entre dos depósitos, identificando depósitos y productos por el external.id registrado. Cada ítem genera una salida en el origen y una entrada en el destino. Requiere el módulo de control de 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.

originStorageExternalIdstringobligatorio

Identificador externo (external.id) del depósito de origen.

destinationStorageExternalIdstringobligatorio

Identificador externo (external.id) del depósito de destino.

notesstring

Observación guardada como descripción de los movimientos.

itemslista de objetosobligatorio

Productos transferidos. La transferencia es atómica; si un ítem falla, no se guarda nada.

Campos de items
productExternalIdstringobligatorio

Identificador externo (external.id) del producto.

quantitynumberobligatorio

Cantidad transferida. Entera para productos medidos en unidad; hasta 3 decimales para los demás.

unitCostnumber

Costo unitario informado a su sistema de origen. No cambia el valor del producto en Field Control.

Respuestas

  • 201

    Transferencia realizada.

  • 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): depósitos o ítems ausentes (reason: missing field), depósito o producto no encontrado por el identificador externo (reason: not found), producto sin saldo o con saldo menor que la cantidad en el origen (reason: Invalid removal), o cantidad con demasiados decimales. Cuenta sin el módulo de control de inventario: resourceNotAllowed.

  • 429

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

  • 500

    Error inesperado en el servidor.