Artículos

Endpoints

GET    /api/items                    # Listar articulos
POST   /api/items                    # Crear articulo
PATCH  /api/items/:id                # Actualizar articulo
DELETE /api/items/:id                # Eliminar articulo
GET    /api/items/:id/batches        # Lotes del articulo
GET    /api/items/:id/stock          # Stock por almacen/zona
GET    /api/items/:id/uoms           # UOMs alternativas
POST   /api/items/:id/uoms           # Añadir UOM alternativa
DELETE /api/items/:itemId/uoms/:id   # Eliminar UOM alternativa

Campos del artículo

Campo	Tipo	Descripción
id	UUID	Identificador
code	string	Código único
name	string	Nombre
description	string	Descripción
uomId	UUID	Unidad de medida base
categoryId	UUID	Categoría
taxGroupId	UUID	Grupo de impuestos
manageBy	N/B/S	Sin trazabilidad / Por lotes / Por serie
basePrice	decimal	Precio base
stock	decimal	Stock total
minStock	decimal	Stock mínimo (alertas)

Crear artículo

curl -X POST http://localhost:3000/api/items \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenantId>" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "PROD-001",
    "name": "Producto ejemplo",
    "uomId": "uuid-uom",
    "categoryId": "uuid-cat",
    "taxGroupId": "uuid-tax",
    "manageBy": "N",
    "basePrice": 25.50
  }'

Trazabilidad

• manageBy: 'B' — Gestión por lotes (batchNum + expiryDate)
• manageBy: 'S' — Gestión por número de serie (serialNum único)
• manageBy: 'N' — Sin trazabilidad

Unidades de medida alternativas

Cada artículo puede tener UOMs alternativas con factor de conversión:

POST /api/items/:id/uoms
{
  "uomId": "uuid-uom-caja",
  "factor": 12
}

Esto significa que 1 caja = 12 unidades base.