Paquetes de servicio
Un paquete comercial de un servicio, definido como múltiplo de la unidad base del servicio.
- Nombre API:
servicepackages - Dominio: Catálogo
- Módulos: Ventas, Servicios, 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í | |
| Servicio | serviceId | Referencia | Sí | Servicio padre que define la unidad base. Se establece al crear el registro y no puede cambiar después. |
| Nombre | label | Texto I18n | Nombre comercial de este paquete de servicio. Se muestra en documentos y se combina con el nombre del servicio en el artículo materializado. | |
| SKU | sku | Texto | Código interno para identificar este paquete de servicio en la operación. Único dentro de la organización. | |
| Código de barras GTIN | gtin | Código de barras GTIN | GTIN opcional (8, 12, 13 o 14 dígitos) para identificar el artículo mediante escaneo. | |
| Cantidad | quantity | Decimal | Sí | Cuántas unidades base del servicio padre contiene este paquete (por ejemplo 8 horas o 6 piezas). |
| Cantidad discreta | isDiscrete | Binario | Sí | Cuando está activo, la cantidad contenida debe ser un número entero de unidades base del servicio y las transacciones posteriores usan paquetes enteros. Cuando está desactivado, se permiten cantidades fraccionarias del paquete. |
| Enlaces | links | Enlace | Enlaces | ||
| Imagen | image | Imagen | Imagen del paquete. Cuando se define, reemplaza la imagen del servicio en el artículo materializado. | |
| Tags | tagIds | Tags | Tags opcionales para clasificar y filtrar este paquete. | |
| Descripción | description | Campo de Texto I18n | Descripción comercial localizada de este paquete. Se muestra en documentos cuando aplica. | |
| 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.
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook servicepackages.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea un paquete. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios del paquete. | App · API · MCP · CLI |
| Deshabilitar | disable | Desactiva el paquete para usos nuevos. Las referencias existentes se mantienen. Actívalo de nuevo para usarlo. | App · API · MCP · CLI |
| Habilitar | undisable | Vuelve a activar el paquete 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 paquete. 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 paquete. | App · API · CLI |
| Archivar | archive | Retira el paquete 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 paquete a las listas y las acciones activas. | App · API · MCP · CLI |
| Eliminar | delete | Elimina el paquete 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.