Ciclo de vida
Acciones
Una acción es algo que puedes hacer con un registro: crear, editar, enviar, aprobar, cancelar. Cada acción tiene un nombre, un nombre API y una descripción, y es la misma en la app, por MCP, en la API y en la CLI.
| Propiedad | Significa |
|---|---|
| Confirmación | Las acciones que cambian mucho piden confirmación antes de correr. |
| Destructiva | La acción elimina o no se puede deshacer, y lo indica. |
| Simulación | La acción puede correr sin guardar y devolver lo que cambiaría. Toda escritura de tabla la permite. |
La lectura (buscar, abrir, contar) funciona en toda tabla y no es una acción.
Estados
Un registro pasa por estados cuando se ejecutan acciones sobre él. Una cotización empieza creada, se envía y luego se acepta o se declina:
El estado decide qué acciones son posibles: no puedes editar una cotización enviada, pero puedes revisarla. Cada acción guarda quién la hizo y cuándo (sentAt, sentBy), así el estado de un registro siempre dice cómo llegó ahí.
Algunas tablas tienen además una columna de estatus con sus propias transiciones, como el estatus de un CFDI ante el SAT. La base de datos rechaza un cambio de estatus que no esté permitido. Cada tabla en Dominios muestra su diagrama de estados.
Archivar, bloquear, cancelar, revisar
| Acción | Qué hace | Se deshace con |
|---|---|---|
| Archivar | Retira un registro del uso diario. Ya no aparece en las listas ni se puede elegir. | Desarchivar |
| Bloquear | Detiene las ediciones de un registro, por ejemplo un cliente con crédito suspendido. | Desbloquear |
| Cancelar | Anula un documento emitido. Netzo registra los movimientos contrarios; el original queda. | — |
| Revisar | Crea un registro nuevo que reemplaza al anterior, como la versión 2 de una cotización. El anterior queda como historia. | — |
Registros que dependen de otros
Un registro que pertenece a otro sigue a su dueño de una de tres formas:
| Perfil | Ejemplo | Al archivar el dueño | Al bloquear el dueño |
|---|---|---|---|
| Parte | Las partidas de una cotización | Se archivan con él | Se bloquean con él |
| Miembro | Las sucursales de un cliente | Se archivan con él, y no se desarchivan mientras el dueño esté archivado | Siguen activas |
| Vínculo | La certificación de un producto | Se archiva si se archiva cualquiera de sus dos lados | Sigue activo |
Eliminar un registro elimina sus partes. Si una parte no se puede eliminar, por ejemplo porque está bloqueada, el registro tampoco.
Momentos con el tiempo
Algunos estados llegan solos con el tiempo: una cotización vence, una factura queda vencida, una entrega va tarde. Netzo los detecta y los registra como eventos, que pueden enviar una notificación o un webhook.
Lo que sigue
Después de algunas acciones, la app propone el siguiente documento: aceptar una cotización ofrece crear el pedido con sus datos. La propuesta solo llena el formulario; una persona lo envía. Netzo nunca crea el documento siguiente por su cuenta.