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 traslado de una ubicación a otra en un solo paso: un artículo por ID o SKU, la ubicación de la que sale y a la que llega. También toma una cantidad positiva en cualquier unidad desde la que el artículo se convierta y los números de lote o de serie de las existencias con seguimiento.

item
string
requerido

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

Maximum string length: 64
from_location_id
string<uuid>
requerido

El ID de la ubicación de la que salen las existencias. No puede estar archivada.

to_location_id
string<uuid>
requerido

El ID de la ubicación a la que van las existencias. No puede estar archivada ni ser la misma que from_location_id.

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
status
enum<string> | null

El estado en el que están las existencias y en el que se quedan: available, quarantined o rejected. Si no se envía, las existencias quedan available.

Opciones disponibles:
available,
quarantined,
rejected
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. El lote sigue igual en el destino.

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

StockMoveResource

data
StockMoveResource · object
requerido

Un movimiento entre dos ubicaciones, o la reversión de uno, con los movimientos que contabilizó bajo el ID del traslado.