Crear un producto

API de Wizerp › Crear un producto

Productos

# Crear un producto

POST https://api.wizerp.com/api/v1/productos

Da de alta un producto en tu catálogo. La empresa sale de tu llave.

Necesita sku, descripcion y unidad. El SKU no puede repetir el de otro producto activo de tu empresa: si ya existe, responde 409.

Los datos fiscales (clave_sat, objeto_impuesto, iva_venta, iva_compra, tipo) son opcionales, pero si los mandas se validan contra el catálogo del SAT y de tu empresa; si los omites, se usan los valores por omisión del ERP.

No crea inventario ni listas de precios, y no sincroniza con marketplaces: eso queda para una versión posterior. No se pueden escribir la empresa, el código interno, el estatus ni el producto padre.

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). Obligatorio. Máximo 100. En el alta no puede repetir otro activo.
- `descripcion` (texto): Descripción. Obligatorio. 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. Obligatorio. 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.

POST https://api.wizerp.com/api/v1/productos

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

Da de alta un producto en tu catálogo. La empresa sale de tu llave.

Necesita sku, descripcion y unidad. El SKU no puede repetir el de otro producto activo de tu empresa: si ya existe, responde 409.

Los datos fiscales (clave_sat, objeto_impuesto, iva_venta, iva_compra, tipo) son opcionales, pero si los mandas se validan contra el catálogo del SAT y de tu empresa; si los omites, se usan los valores por omisión del ERP.

No crea inventario ni listas de precios, y no sincroniza con marketplaces: eso queda para una versión posterior. No se pueden escribir la empresa, el código interno, el estatus ni el producto padre.

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

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 obligatorio

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

descripcion texto obligatorio

Descripción. Obligatorio. 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 obligatorio

Clave de la unidad de medida. Obligatorio. 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 POST https://api.wizerp.com/api/v1/productos \
  -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 '{"sku":"CAM-ROJA-M","descripcion":"Camisa de vestir roja, talla M","unidad":1,"clave_sat":"53101800","iva_venta":"IVA16","costo":189.5}'

$ch = curl_init('https://api.wizerp.com/api/v1/productos');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
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,
    '{"sku":"CAM-ROJA-M","descripcion":"Camisa de vestir roja, talla M","unidad":1,"clave_sat":"53101800","iva_venta":"IVA16","costo":189.5}');
$r = json_decode(curl_exec($ch), true);

const r = await fetch(
  "https://api.wizerp.com/api/v1/productos",
  {
    method: "POST",
    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({"sku":"CAM-ROJA-M","descripcion":"Camisa de vestir roja, talla M","unidad":1,"clave_sat":"53101800","iva_venta":"IVA16","costo":189.5}),
  }
);
const datos = await r.json();

import requests

r = requests.post(
    "https://api.wizerp.com/api/v1/productos",
    headers={
        "Authorization": "Bearer wzk_live_…",
        "X-Wizerp-Key-Id": "208_a3f91c7d",
        "Idempotency-Key": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    },
    json={"sku":"CAM-ROJA-M","descripcion":"Camisa de vestir roja, talla M","unidad":1,"clave_sat":"53101800","iva_venta":"IVA16","costo":189.5},
)
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"
}

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