Ajustar el inventario de un producto
Mueve el conteo de un producto y deja la línea correspondiente en el libro de inventario. Es la misma puerta por la que pasa la pantalla de Inventarios, así que la sincronización de una bodega y el conteo a mano del comercio dejan el mismo tipo de línea y se leen igual en el historial.
Para una combinación, usa el endpoint equivalente bajo /product_variants/{id}.
Authentication
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
Request
Mover el inventario de un producto o de una de sus combinaciones.
La razón lleva el signo, así que quantity siempre es cuántas unidades se movieron y nunca un número negativo cuyo significado podría contradecir la razón que va al lado: received suma, damaged y lost restan. recount es la excepción — dice cuánto hay en la bodega y el libro calcula la diferencia.
Response
La línea que quedó en el libro
Las unidades que se movieron, con signo: una venta es negativa, una entrega positiva.
El conteo que quedó justo después de este movimiento.
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.