Servicios
Un servicio operativo del catálogo, con su unidad base.
- Nombre API:
services - Dominio: Catálogo
- Módulos: Ventas, Servicios, Finanzas, 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 | Nombre comercial del servicio. Se muestra en documentos, selectores y el artículo materializado. | |
| SKU | sku | Texto | Código interno para identificar este 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. | |
| Familia | servicegroupId | Referencia | Familia opcional que agrupa este servicio con servicios de catálogo relacionados. | |
| Unidad base | baseunit | Constante | Sí | Unidad base para facturación e identidad de catálogo — normalmente horas o días para servicios. |
| Cumplimiento | fulfillment | Constante | Sí | Cómo se devenga la venta: al comprometer, cuando se aprueba la orden, o al finalizar una orden de servicio. |
| Cantidad discreta | isDiscrete | Binario | Sí | Cuando está activo, las cantidades deben ser números enteros en la unidad base (por ejemplo 1 o 2 horas). Cuando está desactivado, se permiten cantidades fraccionarias (por ejemplo 0.5 horas o 1.25 días). |
| Enlaces | links | Enlace | Enlaces | ||
| Imagen | image | Imagen | Imagen principal del servicio en el catálogo. Se copia a los artículos materializados salvo que un empaque la reemplace. | |
| Tags | tagIds | Tags | Tags opcionales para clasificar y filtrar este servicio. | |
| Descripción | description | Campo de Texto I18n | Descripción comercial localizada. Se muestra en documentos y se copia a los artículos materializados. | |
| 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 servicegroupId | Familias de servicio | referencia |
Tags tagIds | Tags | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook services.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea un servicio. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios del servicio. | App · API · MCP · CLI |
| Deshabilitar | disable | Desactiva el servicio para usos nuevos. Las referencias existentes se mantienen. Actívalo de nuevo para usarlo. | App · API · MCP · CLI |
| Habilitar | undisable | Vuelve a activar el servicio 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 servicio. 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 servicio. | App · API · CLI |
| Archivar | archive | Retira el servicio 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 servicio a las listas y las acciones activas. | App · API · MCP · CLI |
| Eliminar | delete | Elimina el servicio 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.