Lista de ventas

API de Wizerp › Lista de ventas

Ventas

# Lista de ventas

GET https://api.wizerp.com/api/v1/ventas

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.

Aquí viven TODOS los documentos de venta: remisiones, facturas, cotizaciones, pedidos y anticipos. Sin el filtro tipo se devuelven las ventas (tipo=venta; remision es sinónimo). Para los demás pide ese tipo: cada tipo se pagina por separado, no hay un listado de todos a la vez.

En pedidos, surtido_estatus y monto_surtido traen el avance del surtido; en los demás tipos vienen null. No hay filtro por surtido.

Los documentos cancelados no salen salvo que pidas cancelada=true.

El filtro folio busca en el folio del tipo consultado: el mismo número puede existir como venta y como factura.

Si filtras por fechas, el rango máximo es de 92 días: para un periodo mayor, pide por ventanas y recorre cada una con cursor.

Los renglones de un documento se consultan en GET /ventas-renglones con la clave que devuelve esta lista.

Permiso: ventas: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): Número entero.
- `tipo` (texto): Uno de los valores de la lista. Valores: remision, venta, factura, cotizacion, pedido, anticipo.
- `folio` (entero): El número de folio del documento. El folio se busca según el «tipo» consultado: el mismo número puede existir como venta y como factura.
- `cliente` (entero): Número entero.
- `cancelada` (booleano): true devuelve solo documentos cancelados; false, solo vigentes. Sin este filtro, los cancelados no salen.
- `fecha_desde` (texto): Fecha ISO 8601 en UTC, por ejemplo 2026-10-01T00:00:00Z. Devuelve lo que sea igual o posterior.
- `fecha_hasta` (texto): Fecha ISO 8601 en UTC. Devuelve lo que sea igual o anterior.
- `sucursal` (entero): Número entero.
- `sku` (texto): El código del producto. Devuelve los documentos que incluyen ese SKU en sus renglones. Si el SKU corresponde a varios productos, cuentan todos.

GET https://api.wizerp.com/api/v1/ventas

https://api.wizerp.com/api/v1/ventas

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.

Aquí viven TODOS los documentos de venta: remisiones, facturas, cotizaciones, pedidos y anticipos. Sin el filtro tipo se devuelven las ventas (tipo=venta; remision es sinónimo). Para los demás pide ese tipo: cada tipo se pagina por separado, no hay un listado de todos a la vez.

En pedidos, surtido_estatus y monto_surtido traen el avance del surtido; en los demás tipos vienen null. No hay filtro por surtido.

Los documentos cancelados no salen salvo que pidas cancelada=true.

El filtro folio busca en el folio del tipo consultado: el mismo número puede existir como venta y como factura.

Si filtras por fechas, el rango máximo es de 92 días: para un periodo mayor, pide por ventanas y recorre cada una con cursor.

Los renglones de un documento se consultan en GET /ventas-renglones con la clave que devuelve esta lista.

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

Peticiones recientes · de esta consola, solo en esta pestaña

Hora	Estado	Duración	Acciones
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

Número entero.

tipo texto

Uno de los valores de la lista.

Valores: remision venta factura cotizacion pedido anticipo

folio entero

El número de folio del documento. El folio se busca según el «tipo» consultado: el mismo número puede existir como venta y como factura.

cliente entero

Número entero.

cancelada booleano

true devuelve solo documentos cancelados; false, solo vigentes. Sin este filtro, los cancelados no salen.

fecha_desde texto

Fecha ISO 8601 en UTC, por ejemplo 2026-10-01T00:00:00Z. Devuelve lo que sea igual o posterior.

fecha_hasta texto

Fecha ISO 8601 en UTC. Devuelve lo que sea igual o anterior.

sucursal entero

Número entero.

sku texto

El código del producto. Devuelve los documentos que incluyen ese SKU en sus renglones. Si el SKU corresponde a varios productos, cuentan todos.

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

Lenguaje

Credenciales

Llave secreta

Identificador de la llave

La llave vive solo en esta página: no se guarda ni se registra. Probar llama desde el servidor y cuenta contra tus topes.

Petición · cURL

curl -G https://api.wizerp.com/api/v1/ventas \
  -H "Authorization: Bearer wzk_live_…" \
  -H "X-Wizerp-Key-Id: 208_a3f91c7d" \
  -d limite=5

$ch = curl_init('https://api.wizerp.com/api/v1/ventas?limite=5');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer wzk_live_…',
    'X-Wizerp-Key-Id: 208_a3f91c7d',
]);
$r = json_decode(curl_exec($ch), true);

const r = await fetch(
  "https://api.wizerp.com/api/v1/ventas?limite=5",
  {
    headers: {
      Authorization: "Bearer wzk_live_…",
      "X-Wizerp-Key-Id": "208_a3f91c7d",
    },
  }
);
const datos = await r.json();

import requests

r = requests.get(
    "https://api.wizerp.com/api/v1/ventas",
    params={"limite": 5},
    headers={
        "Authorization": "Bearer wzk_live_…",
        "X-Wizerp-Key-Id": "208_a3f91c7d",
    },
)
datos = r.json()

Respuesta elige un ejemplo

{
    "ok": true,
    "datos": [
        {
            "clave": 184027,
            "tipo": "activo",
            "folio": 184027,
            "cancelada": true,
            "fecha": "2026-10-07T18:22:04Z",
            "cliente": 184027,
            "cliente_nombre": "texto",
            "rfc": "texto",
            "subtotal": 12.5,
            "descuento": 12.5,
            "iva": 12.5,
            "total": 12.5,
            "saldo": 12.5,
            "moneda": "texto",
            "tipo_cambio": 12.5,
            "sucursal": 184027,
            "almacen": 184027,
            "vendedor": 184027,
            "uuid": "texto",
            "creado": "2026-10-07T18:22:04Z",
            "surtido_estatus": "activo",
            "monto_surtido": 12.5
        }
    ],
    "siguiente": "184027",
    "hay_mas": true
}

{
    "ok": false,
    "error": {
        "codigo": "filtro_invalido",
        "mensaje": "Petición mal formada: filtro no permitido, filtro vacío, cursor o límite inválidos, o una cabecera de navegador",
        "campo": "limite",
        "peticion": "req_dca2d22e3324f9a8"
    }
}

{
    "ok": false,
    "error": {
        "codigo": "llave_invalida",
        "mensaje": "La llave no es válida, está revocada, venció, o la empresa dejó de ser PRO",
        "peticion": "req_dca2d22e3324f9a8"
    }
}

{
    "ok": false,
    "error": {
        "codigo": "limite_excedido",
        "mensaje": "Pasaste un tope. La respuesta trae Retry-After",
        "peticion": "req_dca2d22e3324f9a8"
    }
}

Ver la referencia completa