Solicitudes de aprobación
Solicitud para ejecutar un procedimiento cuando el usuario no tiene el rol requerido.
- Nombre API:
procedurerequests - Dominio: Accesos y aprobaciones
- Módulos: Ventas, Compras
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í | |
| Folio | uid | Texto | Sí | El folio es un identificador único y legible para el registro. |
| Usuario | userId | Usuario | Sí | |
| Política | procedurepolicyId | Referencia | ||
| Rol | roleId | Referencia | Sí | |
| Requisito | requirement | Texto | Sí | Nivel de aprobación solicitado para esta operación. |
| Importe | amount | Moneda | Importe monetario en la moneda que corresponde a este registro. | |
| Moneda de cotización | currency | Constante | Valor del catálogo de la tabla para este campo. | |
| Registro | tableUid | Constante | Sí | Tabla de negocio a la que apunta esta fila. |
| Procedimiento | procedure | Constante | Sí | El procedimiento de tabla al que aplica esta regla. |
| ID del registro | recordId | Texto | Sí | |
| Datos | payload | JSON | Sí | La entrada del procedimiento capturada para aprobación. |
| Comentario | comment | Campo de Texto | Nota opcional para quien revisa. | |
| Estatus | status | Constante | Sí | Estado del ciclo o del proceso según los valores permitidos para este registro. |
| Registro actualizado el | recordUpdatedAt | Fecha y Hora | Sí | Versión del registro al crear la solicitud. |
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Ejecutado por | processedBy | Usuario | ||
| Ejecutado el | processedAt | Fecha y Hora | ||
| Aprobado por | approvedBy | Usuario | ||
| Aprobado el | approvedAt | Fecha y Hora | ||
| Rechazado por | rejectedBy | Usuario | ||
| Rechazado el | rejectedAt | Fecha y Hora | ||
| Cancelado por | canceledBy | Usuario | ||
| Cancelado el | canceledAt | Fecha y Hora | ||
| Sustituido el | supersededAt | 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 |
|---|---|---|
Usuario userId | Usuarios | referencia |
Política procedurepolicyId | Políticas de aprobación | referencia |
Rol roleId | Roles | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook procedurerequests.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Cancelar | cancel | Revierte el efecto registrado de la acción. | App · WebMCP · API · CLI |
Estados
Cómo pasa un registro de un estado a otro. Archivar y bloquear pueden ocurrir en cualquier estado.
Eventos
Momentos a los que el registro llega por sí solo. Suscríbete a ellos con un webhook.
| Nombre | Evento de webhook | Descripción |
|---|---|---|
| Aprobación solicitada | procedurerequests.pending | Una operación necesita acción del aprobador. |