Buscar negociaciones con un producto
El robot «Buscar negociaciones con un producto» encuentra en Bitrix24 (Alaio) las negociaciones cuyos productos incluyen un producto dado, con filtro por contacto, empresa y negociaciones abiertas, y devuelve sus ID, el número y el ID de la más reciente.
El robot busca negociaciones por un producto del catálogo. Un proceso de negocio no tiene una forma estándar de saber en qué negociaciones se vende un producto concreto: el filtro de la lista de negociaciones por productos no está disponible para los robots. El robot recibe un ID de producto y, opcionalmente, un ID de contacto, un ID de empresa y la marca «solo negociaciones abiertas» (no en una etapa final), revisa las negociaciones que cumplen el filtro de la más nueva a la más antigua y devuelve los ID de las que tienen el producto entre sus productos, su número y el ID de la más reciente. El número de negociaciones devueltas se limita con un ajuste (50 por defecto) y la revisión a las 500 más recientes según el filtro, así el robot no sobrecarga la cuenta. Si no hay negociaciones, el número es cero y el proceso puede tomar otra rama.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| ID del producto | int | sí | |
| ID del contacto (opcional) | string | — | |
| ID de la empresa (opcional) | string | — | |
| Solo negociaciones abiertas | bool | — | N |
| Cuántas negociaciones devolver (50 por defecto; se revisan las 500 más recientes según el filtro) | int | — | 50 |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| ID de las negociaciones encontradas | int |
| Número de negociaciones encontradas | int |
| ID de la primera (más reciente) negociación | int |
| Éxito | bool |
| Error | string |
¿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.
- Indique el ID del producto.
- Error de API al buscar negociaciones.
Escenario: avisar a los gerentes de la retirada de un producto
- El proceso se inicia manualmente con el ID del producto
- El robot devuelve los ID de las negociaciones abiertas que contienen ese producto
- Un ciclo sobre la lista asigna una tarea al responsable de cada negociación