Cuentas por pagar a proveedores (compras y gastos)

Referencia › Cuentas por pagar a proveedores (compras y gastos)

Cuentas por pagar

Cuentas por pagar a proveedores (compras y gastos)

# Cuentas por pagar a proveedores (compras y gastos)

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

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.

Cada página trae hasta 30 registros (`limite`, de 1 a 30; 30 si no lo mandas).
Un `limite` mayor contesta 400 limite_invalido. Mientras los límites estén en
modo de aviso sigue la regla anterior (100 por omisión, hasta 500) y la
respuesta trae la cabecera `X-Wizerp-Aviso` con lo que cambiará.

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.

Por omisión solo salen las cuentas pendientes de pago; pide estatus=pagado o estatus=cancelado para ver las demás. Pendiente incluye cuentas con saldo cero o a tu favor; para cuadrar con el reporte de CxP pendientes del ERP agrega con_saldo=true. tipo distingue compras (con la orden de compra en compra, la clave de GET /compras) de gastos.

Una cuenta que agrupa varias operaciones sale una sola vez, con el total del grupo, como en la cartera del ERP.

saldo puede ser negativo: es un saldo a tu favor con el proveedor. proveedor es la clave de GET /proveedores; viene 0 cuando la cuenta se capturó sin proveedor.

factura es el folio del documento del proveedor tal como se capturó (puede traer varios separados por coma); uuid viene solo si la cuenta se creó desde un CFDI.

Permiso: cxp: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 30, máximo 30.
- `clave` (entero): Número entero.
- `estatus` (texto): Uno de los valores de la lista. Valores: cancelado, pendiente, pagado.
- `tipo` (texto): Uno de los valores de la lista. Valores: compra, gasto.
- `proveedor` (entero): Número entero.
- `uuid` (texto): El folio fiscal (UUID) completo, 36 caracteres. No distingue mayúsculas.
- `con_saldo` (booleano): true devuelve sólo las cuentas con saldo mayor a cero (lo que el ERP reporta como pendiente); false, las de saldo cero o a tu favor.
- `vencido` (booleano): true devuelve las cuentas con saldo mayor a cero y vencimiento anterior a hoy (UTC); false, todas las demás.

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

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

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.

Cada página trae hasta 30 registros (limite, de 1 a 30; 30 si no lo mandas). Un limite mayor contesta 400 limite_invalido. Mientras los límites estén en modo de aviso sigue la regla anterior (100 por omisión, hasta 500) y la respuesta trae la cabecera X-Wizerp-Aviso con lo que cambiará.

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.

Por omisión solo salen las cuentas pendientes de pago; pide estatus=pagado o estatus=cancelado para ver las demás. Pendiente incluye cuentas con saldo cero o a tu favor; para cuadrar con el reporte de CxP pendientes del ERP agrega con_saldo=true. tipo distingue compras (con la orden de compra en compra, la clave de GET /compras) de gastos.

Una cuenta que agrupa varias operaciones sale una sola vez, con el total del grupo, como en la cartera del ERP.

saldo puede ser negativo: es un saldo a tu favor con el proveedor. proveedor es la clave de GET /proveedores; viene 0 cuando la cuenta se capturó sin proveedor.

factura es el folio del documento del proveedor tal como se capturó (puede traer varios separados por coma); uuid viene solo si la cuenta se creó desde un CFDI.

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

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 30, máximo 30.

clave entero

Número entero.

estatus texto

Uno de los valores de la lista.

Valores: cancelado pendiente pagado

tipo texto

Uno de los valores de la lista.

Valores: compra gasto

proveedor entero

Número entero.

uuid texto

El folio fiscal (UUID) completo, 36 caracteres. No distingue mayúsculas.

con_saldo booleano

true devuelve sólo las cuentas con saldo mayor a cero (lo que el ERP reporta como pendiente); false, las de saldo cero o a tu favor.

vencido booleano

true devuelve las cuentas con saldo mayor a cero y vencimiento anterior a hoy (UTC); false, todas las demás.

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 o venció (llave_invalida), o el usuario dueño de la llave ya no tiene acceso a la empresa (llave_sin_titular)

402 Tu empresa no tiene un plan Pro vigente (plan_requerido). Mientras los límites estén en modo de aviso, esta situación sigue contestando 401 llave_invalida

403 La llave no tiene el permiso que pide esta operación (sin_permiso), o no tiene aceptados los términos de uso de la API vigentes (terminos_pendientes: acéptalos en Wizerp, Configuración › Llaves de API)

404 La ruta no existe, o tu empresa no tiene la API habilitada

429 Pasaste el ritmo de 150 peticiones por minuto de tu llave (limite_excedido) o el cupo mensual de tu empresa (cupo_agotado). 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/cxp \
  -H "Authorization: Bearer wzk_live_…" \
  -H "X-Wizerp-Key-Id: 208_a3f91c7d" \
  -d limite=5

$ch = curl_init('https://api.wizerp.com/api/v1/cxp?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/cxp?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/cxp",
    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,
            "folio": 184027,
            "tipo": "compra",
            "proveedor": 184027,
            "sucursal": 184027,
            "compra": 184027,
            "factura": "texto",
            "uuid": "texto",
            "moneda": "texto",
            "tipo_cambio": 12.5,
            "importe": 12.5,
            "subtotal": 12.5,
            "iva": 12.5,
            "retencion_iva": 12.5,
            "retencion_isr": 12.5,
            "saldo": 12.5,
            "fecha": "2026-10-07T18:22:04Z",
            "vencimiento": "2026-10-07T18:22:04Z",
            "estatus": "cancelado"
        }
    ],
    "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 o venció (llave_invalida), o el usuario dueño de la llave ya no tiene acceso a la empresa (llave_sin_titular)",
        "peticion": "req_dca2d22e3324f9a8"
    }
}

{
    "ok": false,
    "error": {
        "codigo": "limite_excedido",
        "mensaje": "Pasaste el ritmo de 150 peticiones por minuto de tu llave (limite_excedido) o el cupo mensual de tu empresa (cupo_agotado). La respuesta trae Retry-After",
        "peticion": "req_dca2d22e3324f9a8"
    }
}

Ver la referencia completa