Fijar precios de un producto

Referencia › Fijar precios de un producto

Productos

Fijar precios de un producto

# Fijar precios de un producto

PUT https://api.wizerp.com/api/v1/productos/{clave}/precios

Pone el precio de una o varias listas de precios de un producto de tu empresa, en una moneda. La clave del producto va en la URL y es la que devuelve GET /productos.

Es parcial: sólo cambian las listas que mandes en «precios» (precio01 a precio10). Las demás quedan como estaban. Manda null para dejar una lista sin precio. Sólo se aceptan las listas que tu empresa tiene habilitadas en Wizerp: una lista eliminada (por encima de las habilitadas) responde 422 y en la respuesta sale null.

Los precios se guardan SIN IVA, igual que en Wizerp. Si los tuyos ya traen IVA, manda incluye_iva: true y se les quita con la tasa de IVA de venta del producto.

En tu moneda predeterminada, el margen de cada lista se recalcula contra el costo del producto, como lo hace la pantalla; así un cambio de costo posterior respeta el precio que mandaste.

No aplica a kits ni a productos que agrupan variantes (pon el precio en cada variante). No sincroniza con marketplaces ni franquicias: si vendes en Mercado Libre o Shopify, el precio nuevo se publica la próxima vez que se sincronice desde Wizerp. Para leer los precios usa GET /precios. La clave que devuelve puede cambiar si Wizerp recalcula el precio por un cambio de costo; identifica el precio por producto y moneda, no por clave.

Toda escritura necesita la cabecera Idempotency-Key: un valor único por operación (por ejemplo un UUID) que repites tal cual al reintentar. Con la misma clave y los mismos datos se devuelve la respuesta guardada, sin duplicar; con la misma clave y datos distintos responde 409.

Permiso: productos:write

## Cuerpo JSON
- `moneda` (texto): Código ISO de la moneda (MXN, USD…). Si lo omites, la predeterminada de tu empresa. Debe estar activa en Wizerp.
- `incluye_iva` (booleano): true si los precios que mandas ya incluyen IVA. Por omisión false.
- `precios` (objeto): Obligatorio. Llaves precio01…precio10 con el precio (número ≥ 0, hasta 5 decimales) o null para quitarlo. Ejemplo: {"precio01": 120.50, "precio02": 110}.

PUT https://api.wizerp.com/api/v1/productos/{clave}/precios

https://api.wizerp.com/api/v1/productos/{clave}/precios

Pone el precio de una o varias listas de precios de un producto de tu empresa, en una moneda. La clave del producto va en la URL y es la que devuelve GET /productos.

Los precios se guardan SIN IVA, igual que en Wizerp. Si los tuyos ya traen IVA, manda incluye_iva: true y se les quita con la tasa de IVA de venta del producto.

En tu moneda predeterminada, el margen de cada lista se recalcula contra el costo del producto, como lo hace la pantalla; así un cambio de costo posterior respeta el precio que mandaste.

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

Parámetros de ruta

clave entero en la URL

La clave del producto (la de GET /productos). Va en la URL.

Cuerpo JSON

Además, toda escritura necesita la cabecera Idempotency-Key: un valor único por operación (por ejemplo un UUID) que repites tal cual al reintentar.

moneda texto

Código ISO de la moneda (MXN, USD…). Si lo omites, la predeterminada de tu empresa. Debe estar activa en Wizerp.

incluye_iva booleano

true si los precios que mandas ya incluyen IVA. Por omisión false.

precios objeto obligatorio

Obligatorio. Llaves precio01…precio10 con el precio (número ≥ 0, hasta 5 decimales) o null para quitarlo. Ejemplo: {"precio01": 120.50, "precio02": 110}.

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

409 Conflicto: misma Idempotency-Key con datos distintos, o ya existe un registro con ese identificador (RFC, SKU)

413 El cuerpo pasa del máximo

415 El cuerpo no va como JSON (falta Content-Type: application/json)

422 Un dato no es válido para tu empresa

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

Petición · cURL

curl -X PUT https://api.wizerp.com/api/v1/productos/{clave}/precios \
  -H "Authorization: Bearer wzk_live_…" \
  -H "X-Wizerp-Key-Id: 208_a3f91c7d" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -d '{"precios":{"precio01":349.9,"precio02":319}}'

$ch = curl_init('https://api.wizerp.com/api/v1/productos/{clave}/precios');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer wzk_live_…',
    'X-Wizerp-Key-Id: 208_a3f91c7d',
    'Content-Type: application/json',
    'Idempotency-Key: 3fa85f64-5717-4562-b3fc-2c963f66afa6',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS,
    '{"precios":{"precio01":349.9,"precio02":319}}');
$r = json_decode(curl_exec($ch), true);

const r = await fetch(
  "https://api.wizerp.com/api/v1/productos/{clave}/precios",
  {
    method: "PUT",
    headers: {
      Authorization: "Bearer wzk_live_…",
      "X-Wizerp-Key-Id": "208_a3f91c7d",
      "Content-Type": "application/json",
      "Idempotency-Key": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    },
    body: JSON.stringify({"precios":{"precio01":349.9,"precio02":319}}),
  }
);
const datos = await r.json();

import requests

r = requests.put(
    "https://api.wizerp.com/api/v1/productos/{clave}/precios",
    headers={
        "Authorization": "Bearer wzk_live_…",
        "X-Wizerp-Key-Id": "208_a3f91c7d",
        "Idempotency-Key": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    },
    json={"precios":{"precio01":349.9,"precio02":319}},
)
datos = r.json()

Las escrituras se prueban desde tu propio sistema con tu llave; la consola pública es solo para consultas. Copia el ejemplo de arriba: ya lleva el cuerpo y la cabecera Idempotency-Key.

Respuesta elige un ejemplo

{
    "ok": true,
    "producto": 184027,
    "sku": "texto",
    "moneda": "texto",
    "clave": 184027,
    "precios": {
        "clave": 184027
    },
    "actualizado": "texto"
}

{
    "ok": false,
    "error": {
        "codigo": "json_invalido",
        "mensaje": "Petición mal formada: filtro no permitido, filtro vacío, cursor o límite inválidos, o una cabecera de navegador",
        "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