Editar un producto

API de Wizerp › Editar un producto

Productos

# Editar un producto

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

Cambia los datos de un producto de tu empresa. La clave va en la URL y es la que devuelve GET /productos.

Es una edición parcial: sólo se tocan los campos que mandes. Si no mandas costo, se conserva el actual. Los datos fiscales se validan igual que en el alta. No cambia precios de venta ni inventario, y no sincroniza con marketplaces.

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
- `sku` (texto): Código del producto (SKU). Máximo 100. En el alta no puede repetir otro activo.
- `descripcion` (texto): Descripción. Máximo 500.
- `codigo_barras` (texto): Código de barras. Máximo 18.
- `categoria` (entero): Clave de categoría de tu empresa (ver GET /categorias).
- `costo` (decimal): Costo de reposición en pesos. En el alta, si lo omites queda en 0.
- `clave_sat` (texto): Clave de producto/servicio del SAT (8 caracteres, p. ej. 01010101).
- `unidad` (entero): Clave de la unidad de medida. Debe estar activa y tener clave del SAT.
- `objeto_impuesto` (texto): Objeto de impuesto del SAT (2 caracteres, p. ej. 02).
- `iva_venta` (texto): Clave de IVA de venta (p. ej. IVA16).
- `iva_compra` (texto): Clave de IVA de compra (p. ej. IVA16).
- `tipo` (texto): A = normal, B = virtual con precio, C = virtual sin precio.

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

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

Cambia los datos de un producto de tu empresa. La clave va en la URL y es la que devuelve GET /productos.

Es una edición parcial: sólo se tocan los campos que mandes. Si no mandas costo, se conserva el actual. Los datos fiscales se validan igual que en el alta. No cambia precios de venta ni inventario, y no sincroniza con marketplaces.

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.

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

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.

sku texto

Código del producto (SKU). Máximo 100. En el alta no puede repetir otro activo.

descripcion texto

Descripción. Máximo 500.

codigo_barras texto

Código de barras. Máximo 18.

categoria entero

Clave de categoría de tu empresa (ver GET /categorias).

costo decimal

Costo de reposición en pesos. En el alta, si lo omites queda en 0.

clave_sat texto

Clave de producto/servicio del SAT (8 caracteres, p. ej. 01010101).

unidad entero

Clave de la unidad de medida. Debe estar activa y tener clave del SAT.

objeto_impuesto texto

Objeto de impuesto del SAT (2 caracteres, p. ej. 02).

iva_venta texto

Clave de IVA de venta (p. ej. IVA16).

iva_compra texto

Clave de IVA de compra (p. ej. IVA16).

tipo texto

A = normal, B = virtual con precio, C = virtual sin precio.

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

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 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

Petición · cURL

curl -X PUT https://api.wizerp.com/api/v1/productos/{clave} \
  -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 '{"descripcion":"Camisa de vestir roja, talla M (nueva etiqueta)","costo":205}'

$ch = curl_init('https://api.wizerp.com/api/v1/productos/{clave}');
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,
    '{"descripcion":"Camisa de vestir roja, talla M (nueva etiqueta)","costo":205}');
$r = json_decode(curl_exec($ch), true);

const r = await fetch(
  "https://api.wizerp.com/api/v1/productos/{clave}",
  {
    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({"descripcion":"Camisa de vestir roja, talla M (nueva etiqueta)","costo":205}),
  }
);
const datos = await r.json();

import requests

r = requests.put(
    "https://api.wizerp.com/api/v1/productos/{clave}",
    headers={
        "Authorization": "Bearer wzk_live_…",
        "X-Wizerp-Key-Id": "208_a3f91c7d",
        "Idempotency-Key": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    },
    json={"descripcion":"Camisa de vestir roja, talla M (nueva etiqueta)","costo":205},
)
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
}

{
    "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, 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