# Movimientos de inventario (kardex)

GET https://api.wizerp.com/api/v1/movimientos-inventario

Devuelve los registros de tu empresa, paginados por cursor.

Las consultas devuelven páginas, no listas completas. Pide la siguiente pasando
en `cursor` el valor que vino en `siguiente`, hasta que `hay_mas` sea false.

No hay conteo total: contar millones de filas cuesta lo mismo que traerlas.

Sólo se aceptan los filtros documentados. Cualquier otro parámetro contesta
400 filtro_no_permitido; no se ignora en silencio, porque un filtro ignorado
hace creer que filtraste.

Necesita el filtro sku, venta o clave: esta consulta devuelve el kardex de UN producto o de UN documento, no un listado general. No hay filtro por fechas: el kardex se consulta por producto o por documento. El SKU lo da GET /productos y la clave de la venta, GET /ventas.

cantidad siempre es positiva; si el movimiento suma o resta lo dice sentido (entrada o salida). Traen sentido null el saldo inicial (fija la existencia), la salida por embarque (ver abajo) y los tipos que no reconocemos. existencia_anterior y existencia_actual son la existencia del almacén antes y después del movimiento, no costos.

En almacenes que surten por embarque, esas dos existencias son el disponible (existencia menos lo comprometido por embarcar): la venta lo descuenta al venderse, y la salida_embarque registra después la salida física sin cambiarlo. Por eso su sentido es null; contarla como salida descontaría dos veces la misma venta.

almacen y almacen_destino se entregan como texto tal como están guardados: casi siempre es la clave del almacén (campo clave de GET /almacenes), pero los movimientos antiguos y algunos procesos del ERP guardan su código (campo codigo). Un mismo texto puede ser la clave de un almacén y el código de otro.

fecha está en UTC. El campo sku puede venir null si el producto fue eliminado por completo del catálogo; si un SKU corresponde a varios productos, el filtro sku devuelve los movimientos de todos.

Permiso: kardex:read

## Query params
- `cursor` (texto): La clave que vino en «siguiente» de la página anterior. Sin él, empieza por el principio.
- `limite` (entero): Registros por página. Omisión 100, máximo 500.
- `clave` (entero): Manda al menos uno de: sku, venta o clave. Número entero.
- `sku` (texto): Manda al menos uno de: sku, venta o clave. El código del producto. Si el SKU corresponde a varios productos, se devuelven las filas de todos.
- `venta` (entero): Manda al menos uno de: sku, venta o clave. Número entero.
- `tipo` (texto): Uno de los valores de la lista. Valores: registro, traspaso_salida, traspaso_entrada, ajuste_entrada, ajuste_salida, compra, cancelacion_compra, venta, cancelacion_venta, devolucion_nota_credito, cancelacion_nota_credito, saldo_inicial, orden_servicio, salida_embarque, produccion, merma, devolucion.

https://api.wizerp.com/api/v1/movimientos-inventario

Devuelve los registros de tu empresa, paginados por cursor.

Las consultas devuelven páginas, no listas completas. Pide la siguiente pasando en cursor el valor que vino en siguiente, hasta que hay_mas sea false.

No hay conteo total: contar millones de filas cuesta lo mismo que traerlas.

Sólo se aceptan los filtros documentados. Cualquier otro parámetro contesta 400 filtro_no_permitido; no se ignora en silencio, porque un filtro ignorado hace creer que filtraste.

Necesita el filtro sku, venta o clave: esta consulta devuelve el kardex de UN producto o de UN documento, no un listado general. No hay filtro por fechas: el kardex se consulta por producto o por documento. El SKU lo da GET /productos y la clave de la venta, GET /ventas.

cantidad siempre es positiva; si el movimiento suma o resta lo dice sentido (entrada o salida). Traen sentido null el saldo inicial (fija la existencia), la salida por embarque (ver abajo) y los tipos que no reconocemos. existencia_anterior y existencia_actual son la existencia del almacén antes y después del movimiento, no costos.

En almacenes que surten por embarque, esas dos existencias son el disponible (existencia menos lo comprometido por embarcar): la venta lo descuenta al venderse, y la salida_embarque registra después la salida física sin cambiarlo. Por eso su sentido es null; contarla como salida descontaría dos veces la misma venta.

almacen y almacen_destino se entregan como texto tal como están guardados: casi siempre es la clave del almacén (campo clave de GET /almacenes), pero los movimientos antiguos y algunos procesos del ERP guardan su código (campo codigo). Un mismo texto puede ser la clave de un almacén y el código de otro.

fecha está en UTC. El campo sku puede venir null si el producto fue eliminado por completo del catálogo; si un SKU corresponde a varios productos, el filtro sku devuelve los movimientos de todos.

Requiere el permiso kardex:read en la llave · contrato del 2026-10-10

Query Params

Respuestas