Comprobar la lista de verificación por etapa
El robot «Comprobar la lista de verificación de la etapa» lee un campo personalizado Lista de verificación por etapa de una entidad CRM de Bitrix24 (Alaio) — una negociación, un prospecto, una empresa o un proceso inteligente — e informa si todos los elementos obligatorios de la etapa actual están marcados. Las entradas son el tipo de entidad, su ID y el código del campo. Devuelve all_done con el valor Y si todos los elementos obligatorios están marcados, de lo contrario N, además de los contadores done/total y la lista de los elementos que faltan.
El robot abre la entidad CRM por tipo e ID, determina su etapa actual (STAGE_ID en una negociación, STATUS_ID en un prospecto, stageId en un proceso inteligente) y lee el valor del campo Lista de verificación por etapa indicado. Toma los elementos configurados para esa etapa, los compara con los marcados y cuenta el progreso solo con los elementos obligatorios — los opcionales no afectan el resultado. Las salidas son: all_done — Y si todos los elementos obligatorios de la etapa están marcados, de lo contrario N; done y total — cuántos elementos obligatorios están marcados y cuántos hay en total; pending_list — los nombres de los elementos obligatorios aún sin marcar, uno por línea. Si los parámetros no son válidos, la entidad no se encuentra o el campo indicado no es una lista de verificación por etapa, el robot devuelve all_done N, contadores en cero y una lista vacía — las mismas claves que en el éxito, para que la condición del siguiente paso nunca encuentre una clave ausente. Notificar al responsable, devolver la etapa o crear una tarea para los elementos pendientes lo decide el propio escenario del proceso de negocio — el robot solo informa el hecho.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| Tipo de entidad: deal / contact / company / lead | string | sí | |
| ID de la entidad | int | sí | |
| Código del campo | string | sí |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Todos los elementos obligatorios de la etapa están hechos (Y/N) | string |
| Número de elementos obligatorios marcados | int |
| Número total de elementos obligatorios de la etapa | int |
| Lista de elementos obligatorios aún no marcados (uno por línea) | string |
Escenario: no dejar avanzar una negociación sin sus elementos obligatorios
- Una negociación cambia de etapa del embudo
- El robot comprueba la lista de verificación de la etapa actual mediante el campo Lista de verificación por etapa
- Con all_done = N el proceso crea una tarea para el responsable con la pending_list y devuelve la negociación a la etapa anterior