Estados Personalizados
Configuración de los estados configurables del sistema: estados de OC Portal (Convenios), estados de pago de facturas, y estados de pago y de ruta de OC a proveedores.
Descripción
Marko incluye varios catálogos de estados que la empresa puede ampliar con estados propios. Cada catálogo trae un conjunto de estados predeterminados del sistema (no editables ni eliminables) y permite agregar estados personalizados con su propio nombre y color.
Todos los catálogos comparten el mismo patrón de funcionamiento:
- Los estados predeterminados están protegidos: no se pueden editar ni eliminar (se muestra un candado 🔒).
- Los estados personalizados se pueden crear, editar y eliminar.
- La eliminación es soft delete: el estado se marca como eliminado (
isDeleted) y deja de mostrarse, pero no se borra físicamente para preservar el histórico de documentos que ya lo usaban. - El nombre de cada estado debe ser único dentro del catálogo.
- Cada estado nuevo recibe un código/ID autoasignado que no se puede modificar después.
1. Estados OC Portal (OC Convenios)
Componente: FinancialStatementsComponent — pestaña Estados OC Portal
Define el flujo de estados de gestión de las órdenes de compra del Portal Mercado Público (OC Convenios).
Estados predeterminados (no editables)
| Código | Nombre | Color |
|---|---|---|
| 0 | Pendiente | Amarillo |
| 300 | Cerrada | Verde |
Crear estado personalizado
Formulario con los campos:
- Nombre (obligatorio, único)
- Color de Fondo — selector de color (hex)
- Color de Texto — selector de color (hex)
A diferencia de los demás catálogos, este permite definir el color de fondo y de texto de forma independiente (vista previa tipo badge). El código se autoasigna tomando el primer número libre en el rango 1–299 (los códigos 0 y 300 están reservados por los estados del sistema). Como consecuencia, se pueden crear hasta 298 estados personalizados.
Edición y eliminación
- Se pueden editar el nombre y los colores de fondo/texto. El código es inmutable.
- La eliminación es soft delete (
isDeleted).
2. Estados de Pago de Facturas
Componente: InvoicePaymentStatusesComponent — pestaña Estados Pago Facturas
Estados que describen la situación de cobro de las facturas de venta.
Estados predeterminados (no editables)
| ID | Nombre | Color |
|---|---|---|
| 0 | Todos | Light |
| 1 | Pendiente | Light |
| 5 | Pago Parcial | Warning |
| 8 | Compromiso de Pago | Warning |
| 10 | Pagada | Success |
| 11 | Descontada | Success |
| 20 | Retenida | Dark |
| 30 | No pagada | Danger |
| 40 | Nota de Crédito | Info |
| 50 | Factorizada | Primary |
Crear estado personalizado
Formulario con los campos:
- Nombre (obligatorio, único — sin distinguir mayúsculas/minúsculas)
- Color — selector con los colores Bootstrap: Primary (azul), Secondary (gris), Success (verde), Danger (rojo), Warning (amarillo), Info (celeste), Light (claro), Dark (oscuro)
El ID se autoasigna a partir de 61 (el siguiente número disponible si ya existen personalizados).
Edición y eliminación
- Se pueden editar el nombre y el color. El ID es inmutable.
- La eliminación es soft delete (
isDeleted); los estados eliminados no se muestran en la lista.
3. Estados de Pago OC Proveedores
Componente: OcProviderPaymentStatusesComponent — pestaña Estados Pago OC Proveedores
Estados que describen la situación de pago de las órdenes de compra a proveedores.
Estados predeterminados (no editables)
| ID | Nombre | Color |
|---|---|---|
| 0 | Pendiente | Light |
| 1 | Pendiente | Light |
| 2 | Pre-pagada | Light |
| 5 | Pago Parcial | Info |
| 10 | Pagada | Success |
| 20 | Retenida | Warning |
| 30 | No pagada | Danger |
| 40 | Rebaja Inventario | Warning |
| 50 | Modificar OC | Info |
| 60 | OC Anulada | Dark |
Crear estado personalizado
Mismos campos y reglas que en Estados de Pago de Facturas:
- Nombre (obligatorio, único)
- Color — colores Bootstrap (Primary, Secondary, Success, Danger, Warning, Info, Light, Dark)
- ID autoasignado a partir de 61
Edición y eliminación
- Editar nombre y color (ID inmutable).
- Soft delete (
isDeleted).
4. Estados de Ruta OC Proveedores
Componente: OcProviderRouteStatusesComponent — pestaña Estados Ruta OC Proveedores
Estados que describen el avance logístico (ruta de despacho) de las órdenes de compra a proveedores.
Estados predeterminados
| ID | Nombre | Color |
|---|---|---|
| 0 | Sin asignar | Light |
| 10 | En preparación | Info |
| 20 | Despachada | Primary |
| 30 | En tránsito | Warning |
| 40 | Entregada | Success |
| 50 | Con problemas | Danger |
| 60 | Devuelta | Dark |
Activar/desactivar estados predeterminados (exclusivo de este catálogo)
A diferencia de los otros catálogos, aquí los estados predeterminados se pueden desactivar mediante una casilla en la columna Activo, para ocultarlos del flujo sin eliminarlos. La única excepción es Sin asignar (ID 0), que está siempre activo y no se puede desactivar.
Crear estado personalizado
- Nombre (obligatorio, único)
- Color — colores Bootstrap (Primary, Secondary, Success, Danger, Warning, Info, Light, Dark)
- ID autoasignado a partir de 61
Edición y eliminación
- Editar nombre y color (ID inmutable).
- Soft delete (
isDeleted).
Distinción visual
En todos los catálogos cada estado se muestra con:
- Una vista previa tipo badge con su color.
- Una etiqueta de tipo: Por defecto (estado del sistema) o Personalizado.
- Acciones (Editar / Eliminar) habilitadas solo para los estados personalizados; los del sistema muestran un candado 🔒.
Validaciones y límites
- Nombre obligatorio y único en cada catálogo.
- Los estados del sistema no se pueden editar ni eliminar.
- La eliminación de personalizados es soft delete (preserva el histórico).
- En Estados OC Portal el código se asigna en el rango 1–299; en los demás catálogos el ID parte en 61.