Skip to navigation

Libro de inventario de una variante

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_variant_idstringRequired
ID de la variante

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