Fecha de entrada en la etapa
El robot «Fecha de entrada en la etapa» devuelve, dentro de un proceso de negocio de Bitrix24 (Alaio), la fecha en que una negociación, un prospecto o un elemento de proceso inteligente entró en una etapa determinada, junto con el número de entradas. La etapa se indica por código o por nombre, y se elige la primera o la última entrada.
El robot devuelve la fecha de entrada en la etapa indicada dentro del propio proceso de negocio de Bitrix24 (Alaio), leyendo el historial en tiempo de ejecución. La etapa se puede indicar por código o por nombre, con prioridad para el código, de modo que renombrar una etapa del embudo no rompe nada, a diferencia de las soluciones que dependen solo del nombre. Si el elemento volvió a la etapa varias veces, se elige la primera o la última entrada, y el número de entradas se devuelve por separado, lo que muestra con qué frecuencia el elemento retrocedió en el embudo. Se admiten negociaciones, prospectos y elementos de procesos inteligentes; por defecto se usa el elemento sobre el que se ejecuta el proceso. Una etapa que no existe en el portal se trata como un error de configuración y se informa de forma explícita, mientras que una etapa en la que el elemento simplemente no estuvo es una respuesta normal de «no encontrado». Se tienen en cuenta los embudos entre los que se movió el elemento.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| Elemento | select | — | auto |
| ID del elemento (para los modos «por ID») | string | — | |
| ID del tipo de proceso inteligente (solo para el modo de proceso inteligente) | string | — | |
| Etapa — código o nombre | string | sí | |
| Qué entrada | select | — | last |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Fecha de entrada en la etapa | string |
| Código de la etapa | string |
| Nombre de la etapa | string |
| Número de entradas en la etapa | int |
| Entrada en la etapa encontrada (Y/N) | bool |
| Correcto | bool |
¿Qué errores puede devolver el robot?
El robot escribe estos mensajes en el registro del proceso de negocio cuando no puede completar un paso. El texto indica qué corregir en la configuración o en los datos.
- La etapa «{stage}» no se encontró en el portal. Indique el código de la etapa o su nombre exacto.
- Este tipo de elemento no tiene etapas. El robot funciona con negociaciones, prospectos y procesos inteligentes; para los modos «por ID» indique un ID válido.
- Error de API al leer el historial de etapas.
Escenario: control de negociaciones estancadas
- Un proceso periódico ejecuta el robot sobre una negociación
- Toma la fecha de la última entrada en la etapa «Factura enviada»
- Si han pasado más de siete días, se crea una tarea para el responsable, y el número de entradas muestra cuántas veces ha retrocedido ya