Precios por producto

API de Wizerp › Precios por producto

Listas de precios

# Precios por producto

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

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.

Una fila activa por producto y moneda, con los diez precios de tu empresa: precio01 a precio10 corresponden a las listas de precios L1 a L10, cuyos nombres tu empresa define en el ERP (Configuración › Almacenes › Lista de precios › Nombrar listas de precios); la API entrega las diez posiciones y tu integración decide cuál usar. Un precio puede venir null si esa lista no está capturada para el producto.

Por omisión solo salen filas activas; pide estatus para ver inactivas o eliminadas.

Identifica cada precio por sku y moneda, no por clave: cuando el ERP recalcula precios puede guardarlos en una fila nueva (clave nueva) y marcar la anterior como eliminada.

Para sincronizar, recorre el listado completo con cursor, o consulta por sku los productos que te interesan. No hay filtro por fecha de modificación ni por moneda: ninguno de los dos tiene un índice que responda rápido en empresas grandes. La moneda sí viene en cada fila.

El campo actualizado es la fecha de última modificación y es solo informativo: viene null en las filas que nunca cambiaron desde que existe ese registro, que en muchas empresas son casi todas.

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 las filas de todos.

Permiso: productos: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.
- `sku` (texto): El código del producto. Si el SKU corresponde a varios productos, se devuelven las filas de todos.
- `estatus` (texto): Uno de los valores de la lista. Valores: activo, inactivo, eliminado.

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

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

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.

Por omisión solo salen filas activas; pide estatus para ver inactivas o eliminadas.

Identifica cada precio por sku y moneda, no por clave: cuando el ERP recalcula precios puede guardarlos en una fila nueva (clave nueva) y marcar la anterior como eliminada.

El campo actualizado es la fecha de última modificación y es solo informativo: viene null en las filas que nunca cambiaron desde que existe ese registro, que en muchas empresas son casi todas.

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 las filas de todos.

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

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.

sku texto

El código del producto. Si el SKU corresponde a varios productos, se devuelven las filas de todos.

estatus texto

Uno de los valores de la lista.

Valores: activo inactivo eliminado

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/precios \
  -H "Authorization: Bearer wzk_live_…" \
  -H "X-Wizerp-Key-Id: 208_a3f91c7d" \
  -d limite=5

$ch = curl_init('https://api.wizerp.com/api/v1/precios?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/precios?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/precios",
    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,
            "sku": "texto",
            "moneda": "texto",
            "estatus": "activo",
            "precio01": 12.5,
            "precio02": 12.5,
            "precio03": 12.5,
            "precio04": 12.5,
            "precio05": 12.5,
            "precio06": 12.5,
            "precio07": 12.5,
            "precio08": 12.5,
            "precio09": 12.5,
            "precio10": 12.5,
            "actualizado": "2026-10-07T18:22:04Z"
        }
    ],
    "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