Saltar al contenido principal
POST
cURL

Autorizaciones

Authorization
string
header
requerido

Para tus propios scripts e integraciones de servidor a servidor. Crea una clave en la app en Configuración > Acceso > Claves de API y cópiala entonces, porque se muestra una sola vez. Envíala como Authorization: Bearer <key>. La clave actúa como el miembro que la creó, en la organización en la que se creó. Una llamada necesita el permiso del miembro y uno de los alcances de la clave, como inventory:read o sales:write. Una clave con * tiene todos los alcances.

Cuerpo

application/json

Un cambio de estado: un artículo por ID o SKU, una ubicación, una cantidad decimal exacta positiva, el estado que dejan las existencias y el que toman.

item
string
requerido

El artículo, por su ID o su SKU. Un SKU coincide sin distinguir mayúsculas.

Maximum string length: 64
location_id
string<uuid>
requerido

El ID de la ubicación donde están las existencias. Las existencias se quedan allí.

from
enum<string>
requerido

El estado que dejan las existencias: available, quarantined o rejected. Las existencias en él no pueden bajar de cero.

Opciones disponibles:
available,
quarantined,
rejected
to
enum<string>
requerido

El estado que toman las existencias: available, quarantined o rejected. Debe ser distinto de from. Pasar existencias retenidas a available cierra las solicitudes abiertas para liberarlas.

Opciones disponibles:
available,
quarantined,
rejected
quantity
string
requerido

Un decimal exacto positivo, enviado como cadena, con hasta 20 dígitos a cada lado del punto. Está en unit, o en la unidad base del artículo cuando se omite unit.

Pattern: ^(?!0+(\.0+)?$)\d{1,20}(\.\d{1,20})?$
unit
string | null

La unidad en la que está la cantidad, como case. Debe ser una unidad desde la que el artículo se convierte. Si no se envía, se usa la unidad base del artículo.

Maximum string length: 16
note
string | null

Una nota que se guarda con los movimientos, de hasta 1000 caracteres.

Maximum string length: 1000
lot
string | null

El número de lote, para un artículo con seguimiento por lote. Debe ser un lote que el artículo ya tenga; los números de lote coinciden sin distinguir mayúsculas.

Maximum string length: 64
serials
string[] | null

Los números de serie, para un artículo con seguimiento por número de serie. Envía uno por unidad, de modo que la cantidad coincida con la cantidad en la unidad base. Máximo 25 en una solicitud.

Maximum array length: 25

Un número de serie, sin espacios al inicio ni al final.

Maximum string length: 64
bulk_id
string<uuid> | null

El ID de la lista masiva de la que este comando es una línea, un UUID que el cliente elige para toda la lista. Omítelo para un comando fuera de una lista masiva; entonces no se ejecutan las comprobaciones masivas.

bulk_line
integer | null

La posición de la línea en la lista masiva, de 0 a 99.

Rango requerido: 0 <= x <= 99
decisions
object | null

La decisión para cada marca que el miembro resolvió en la vista previa masiva, como {"reserved": "leave"}. Solo se pueden decidir reserved, mixed_lots y short_dated.

bulk_undo_of
string<uuid> | null

En una línea de un "Deshacer todo", el bulk_id de la lista masiva que deshace.

Respuesta

Arreglo de StockMovementResource

data
StockMovementResource · object[]
requerido