Productos
Un producto del catálogo con su unidad base, modo de trazabilidad y códigos comerciales.
- Nombre API:
products - Dominio: Catálogo
- Módulos: Ventas, Tiendas, Servicios, Finanzas, Inventario, Manufactura, Compras, Logística, Datos maestros
Campos
El nombre API es el que usan la API, MCP y la CLI.
| Nombre | Nombre API | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| ID | id | ID de registro | Sí | |
| Nombre | label | Texto I18n | ||
| SKU | sku | Texto | El SKU (del inglés Stock Keeping Unit) es un código alfanumérico único definido por la empresa para identificar, clasificar y gestionar un producto dentro de sus operaciones. A diferencia del UPC o EAN, el SKU es un identificador interno y su formato puede adaptarse a las necesidades del negocio. | |
| Código de barras GTIN | gtin | Código de barras GTIN | ||
| Familia | productgroupId | Referencia | ||
| Material | materialId | Referencia | ||
| Densidad | density | Decimal | Densidad del material de la unidad base del producto. | |
| Unidad de densidad | densityunit | Constante | Unidad de la medición de densidad (p. ej. g/cm³). | |
| Unidad base | baseunit | Constante | Sí | Cantidad canónica de inventario del producto. Todas las existencias, movimientos, valorizaciones y auditorías se registran en esta unidad (por ejemplo: unidades, kg o m). Las UOM no cambian esta cantidad. Las dimensiones de instancia solo están permitidas cuando la unidad base es unidades. |
| Trazabilidad | tracking | Constante | Sí | Define cómo se rastrea el inventario: por cantidad (sin trazabilidad individual), por lote (para productos perecederos o con lotificación) o por número de serie (para activos o artículos con identificación única). |
| Modo de surtido | supplyMode | Constante | Sí | Valor predeterminado para partidas de venta: existencias de inventario, fabricación, pedido especial o envío directo del proveedor. |
| Abastecimiento | procurement | Constante | Sí | Política de abastecimiento del artículo (comprar, fabricar o ambos), distinta del modo de surtido en la partida de venta. |
| Cantidad discreta | isDiscrete | Binario | Sí | Cuando está activo, las cantidades deben ser números enteros en la unidad base. Cuando está desactivado, se permiten cantidades fraccionarias. |
| Control de vida útil | hasShelfLife | Binario | Sí | Habilita el control de vida útil del producto. Requiere registrar una fecha de vencimiento o consumo preferente durante la recepción y utilizar trazabilidad por lote o número de serie. |
| Vida útil (días) | shelfLifeDays | Número Entero | Número estándar de días de vida útil del producto. La fecha de vencimiento se calcula a partir de la fecha de recepción o de la fecha de fabricación, según el proceso correspondiente. | |
| Peso | weight | Decimal | Masa física de una unidad base de este producto (no es un factor de conversión de cantidad). | |
| Unidad de peso | weightunit | Constante | Unidad de la medición de peso (p. ej. kg, g, lb). | |
| Dimensiones | dimensions | Dimensiones | Geometría de cada instancia física contada. Opcional en productos con unidad base unidades. Prohibido en cualquier otra unidad base. | |
| Enlaces | links | Enlace | Enlaces | ||
| Imagen | image | Imagen | ||
| Tags | tagIds | Tags | ||
| Descripción | description | Campo de Texto I18n | ||
| Datos | data | Datos | ||
| Identificadores externos | identifiers | Identificador externo | Identificadores externos | Claves de sistemas remotos y tipos de id opcionales. Un valor por par de sistema y tipo en este registro. | |
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Publicado por | publishedBy | Usuario | ||
| Publicado el | publishedAt | Fecha y Hora | ||
| Deshabilitado por | disabledBy | Usuario | ||
| Deshabilitado el | disabledAt | Fecha y Hora | ||
| Bloqueado por | blockedBy | Usuario | ||
| Bloqueado el | blockedAt | Fecha y Hora | ||
| Archivado por | archivedBy | Usuario | ||
| Archivado el | archivedAt | Fecha y Hora |
Relaciones
Los registros poseídos (línea sólida) se eliminan con su dueño. Los registros agrupados (línea punteada) pueden existir solos.
| Campo | Apunta a | Tipo |
|---|---|---|
Familia productgroupId | Familias de producto | referencia |
Material materialId | Materiales | referencia |
Tags tagIds | Tags | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook products.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea un producto. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios del producto. | App · API · MCP · CLI |
| Deshabilitar | disable | Desactiva el producto para usos nuevos. Las referencias existentes se mantienen. Actívalo de nuevo para usarlo. | App · API · MCP · CLI |
| Habilitar | undisable | Vuelve a activar el producto para usos nuevos. | App · API · MCP · CLI |
| Publicar | publish | Publica la disponibilidad para que pueda usarse. | App · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar el producto. Sigue visible y puede seguir en documentos existentes. Desbloquéalo para volver a cambiarlo. | App · API · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar el producto. | App · API · CLI |
| Archivar | archive | Retira el producto del uso diario. Sale de las listas y los selectores activos, y la mayoría de las acciones se detienen. Desarchívalo para restaurarlo. | App · API · MCP · CLI |
| Restaurar | unarchive | Devuelve el producto a las listas y las acciones activas. | App · API · MCP · CLI |
| Eliminar | delete | Elimina el producto y los datos que le pertenecen. No se puede deshacer. | App · API · MCP · CLI |
Estados
Cómo pasa un registro de un estado a otro. Archivar y bloquear pueden ocurrir en cualquier estado.