⌘K

API de Wizerp › Renglones de una compra

Renglones de compra

Renglones de una compra

GET https://api.wizerp.com/api/v1/compras-renglones

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 compra (o clave, para releer un renglón): esta consulta devuelve los renglones de UNA compra, no un listado general. La clave de la compra la da GET /compras.

Wizerp liga los renglones a la compra por su folio, y el folio puede repetirse en otra compra de tu empresa. Si eso pasa, la respuesta trae los renglones de todas las compras con ese folio —lo mismo que muestra el ERP— y en esos renglones el campo compra viene null, porque no hay forma de saber a cuál pertenecen. folio viene siempre.

El campo sku viene null en renglones capturados como texto libre o si el producto fue eliminado por completo del catálogo; la descripción viene siempre.

costo_total es cantidad × costo_unitario, y costo_unitario es el costo por unidad ya con descuento; precio es el de lista antes del descuento. iva e ieps son los impuestos del renglón.

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

Peticiones recientes · de esta consola, solo en esta pestaña
HoraEstadoDuraciónAcciones
Prueba esta consulta para ver aquí tu historial.

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: compra o clave. Número entero.

compra entero

Manda al menos uno de: compra o clave. La clave de la compra (campo clave de GET /compras), no su folio.

Respuestas

400 Petición mal formada: filtro no permitido, filtro vacío, cursor o límite inválidos, o una cabecera de navegador
401 La llave no es válida, está revocada, venció, o la empresa dejó de ser PRO
403 La llave no tiene el permiso que pide esta operación
404 La ruta no existe, o tu empresa no tiene la API habilitada
429 Pasaste un tope. La respuesta trae Retry-After
500 Falló de nuestro lado. Reintenta y reporta el valor de peticion
503 Tu empresa tiene demasiadas peticiones en curso, o la búsqueda no está disponible. Trae Retry-After

Ver la referencia completa