API de Productos

Crea, lee, actualiza y elimina productos en tu catálogo.

Endpoints

GET

/products

products:read

Obtén una lista paginada de productos. Soporta filtrado por estado, categoría y búsqueda.

GET

/products/:id

products:read

Obtén un producto individual por su ID.

POST

/products

products:write

Crea un nuevo producto en tu catálogo.

PUT

/products/:id

products:write

Actualiza un producto existente. Se soportan actualizaciones parciales.

DELETE

/products/:id

products:write

Eliminación suave de un producto. Puede restaurarse en 30 días.

Referencia de Campos

Campo	Tipo	Obligatorio	Descripción
id	string	No	Identificador único del producto (solo lectura)
sku	string	Sí	Unidad de mantenimiento de stock
name	string	Sí	Nombre del producto
description	string	No	Descripción del producto (HTML permitido)
barcode	string	No	Código de barras principal del producto (UPC/EAN)
brand	string	No	Nombre de marca del producto
categoryId	string	No	Identificador de categoría
unitPrice	integer	Sí	Precio en centavos (ej. 1999 = $19.99)
normalPrice	integer	No	Precio normal / de lista en centavos (para mostrar descuentos)
purchasePrice	integer	No	Precio de compra / costo en centavos
weight	string	No	Peso en gramos
isActive	boolean	No	Si el producto está activo / publicado (predeterminado: true)
stockTotal	integer	No	Stock total disponible en todos los almacenes (solo lectura)
images	string[]	No	URLs de imágenes del producto
createdAt	datetime	No	Marca de tiempo ISO 8601 (solo lectura)
updatedAt	datetime	No	Marca de tiempo ISO 8601 (solo lectura)

Parámetros de Consulta (Lista)

Campo	Tipo	Obligatorio	Descripción
page	integer	No	Número de página (predeterminado: 1)
limit	integer	No	Elementos por página (predeterminado: 20, máx: 100)

Ejemplo

Listar productos con paginación

bash

curl "https://api.mercozy.com/api/v1/external/products?page=1&limit=10" \
  -H "X-API-Key: mk_live_your_key_here"

Crear un producto

bash

curl -X POST "https://api.mercozy.com/api/v1/external/products" \
  -H "X-API-Key: mk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "WDG-001",
    "name": "Premium Widget",
    "unitPrice": 2999,
    "normalPrice": 3999,
    "brand": "Acme Corp",
    "isActive": true
  }'