Saltar al contenido principal

Realizar un movimiento

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

Registra una entrada, una salida o una transferencia entre depósitos y actualiza el saldo del producto. El valor del movimiento se calcula con el valor unitario del producto. 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.

typestringobligatorio

entry (entrada), removal (salida) o transfer (transferencia del depósito storageRemoval al depósito storage).

Valores aceptados: entry, removal, transfer.

quantitynumberobligatorio

Cantidad, mayor que cero. Entera para productos medidos en unidad; hasta 3 decimales para las demás medidas.

productobjectobligatorio
Campos de product
idstringobligatorio

Identificador del producto.

storageobjectobligatorio

Depósito del movimiento. En la transferencia, es el depósito de destino.

Campos de storage
idstringobligatorio

Identificador del depósito.

storageRemovalobject

Depósito de origen. Obligatorio cuando type es transfer, y distinto de storage.

Campos de storageRemoval
idstringobligatorio

Identificador del depósito de origen.

orderobject

Orden de servicio vinculada al movimiento.

Campos de order
idstring

Identificador de la orden de servicio.

identifierstring

Identificador libre del movimiento en su proceso.

Hasta 255 caracteres.Acepta: null.

descriptionstring

Descripción del movimiento.

Hasta 1000 caracteres.Acepta: null.

externalobject
Campos de external
idstring

Identificador del movimiento en su sistema.

Acepta: null.

minimalQuantitynumber

Cantidad mínima del producto en el depósito. Solo se considera en la primera entrada del producto en el depósito.

minimalQuantityAtRisknumber

Cantidad a partir de la cual el inventario se considera en riesgo; debe ser mayor que minimalQuantity. Solo se considera en la primera entrada del producto en el depósito.

Respuestas

  • 201

    Movimiento creado. En type: transfer, la respuesta es la transferencia (StorageMovementTransfer), con los identificadores de la salida y de la entrada.

  • 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): producto, depósito u orden inexistentes (reason: not found), salida mayor que el saldo o de producto sin saldo (reason: Invalid removal), cantidad con demasiados decimales, o transferencia sin storageRemoval o con depósitos iguales. 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.