Skip to navigation

Libro de inventario de un producto

El libro de inventario del producto, el más reciente primero. El conteo que devuelve el resto de la API es un caché de la última de estas líneas, así que aquí se explica cualquier número: por qué la camisa dice 3 cuando la bodega dice 5.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Path parameters

product_idstringRequired
ID del producto

Query parameters

pageintegerOptionalDefaults to 1
limitintegerOptional<=100

Response

Una página del libro

idstringOptional
product_idstringOptional
variant_idstring or nullOptional
deltaintegerOptional

Las unidades que se movieron, con signo: una venta es negativa, una entrega positiva.

resulting_quantityintegerOptional

El conteo que quedó justo después de este movimiento.

reasonenumOptional

sale y refund los escribe un pago; el resto los escribe el comercio o una integración. manual es un conteo escrito en el formulario del producto y api su equivalente enviado por la API.

notestring or nullOptional<=200 characters
created_atdatetimeOptional