Tienda

Productos

Gestiona tu catálogo de productos y categorías. Los productos pueden tener control de inventario, precios de comparación, impuestos y metadatos personalizados.

Listar categorías

GET /v1/product-categories

Parámetros opcionales: is_active, parent_id (UUID o "root"), limit, page

Crear categoría

POST /v1/product-categories

Cuerpo

{
  "name": "Electrónicos",
  "description": "Productos electrónicos y gadgets",
  "parent_id": null,
  "sort_order": 1,
  "is_active": true
}

Campo	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre de la categoría
`parent_id`	uuid	No	Categoría padre (para subcategorías)
`description`	string	No	Descripción
`sort_order`	integer	No	Orden de visualización
`is_active`	boolean	No	Si está activa (default: true)

Obtener / Actualizar / Eliminar categoría

GET /v1/product-categories/{'{id}'}

PATCH /v1/product-categories/{'{id}'}

DELETE /v1/product-categories/{'{id}'}

Al eliminar una categoría, sus subcategorías se mueven al padre y los productos se desvinculan.

Listar productos

GET /v1/products

Parámetros opcionales: status (active, draft, archived), category (UUID), search, featured, in_stock, limit, page

Crear producto

POST /v1/products

Cuerpo

{
  "name": "Laptop Pro 15",
  "price": 25999.00,
  "currency": "MXN",
  "sku": "LAP-PRO-15",
  "description": "Laptop profesional de 15 pulgadas",
  "product_category_id": "uuid-de-la-categoria",
  "track_stock": true,
  "stock_quantity": 50,
  "tax_rate": 16,
  "is_featured": true,
  "metadata": {
    "brand": "TechCorp",
    "warranty_months": 24
  }
}

Campo	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre del producto
`price`	number	Sí	Precio en decimales (100.00 = $100)
`currency`	string	No	Moneda ISO 4217 (por defecto, la de la cuenta)
`status`	string	No	active, draft, archived (default: active)
`product_category_id`	uuid	No	UUID de la categoría
`sku`	string	No	Código SKU
`description`	string	No	Descripción larga
`compare_at_price`	number	No	Precio de comparación (antes)
`cost_price`	number	No	Costo del producto
`track_stock`	boolean	No	Activar control de inventario
`stock_quantity`	integer	No	Cantidad en stock
`tax_rate`	number	No	Tasa de impuesto (%)
`is_featured`	boolean	No	Producto destacado
`image_url`	url	No	URL de la imagen
`metadata`	object	No	Metadatos personalizados

Obtener / Actualizar / Eliminar producto

GET /v1/products/{'{id}'}

PATCH /v1/products/{'{id}'}

DELETE /v1/products/{'{id}'}

No se puede eliminar un producto con pedidos pendientes.

¿Te sirvió esta página? Gracias por avisarnos.