Obtener los productos de la negociación
El robot «Obtener los productos de la negociación» lleva a un proceso de negocio de Bitrix24 (Alaio) las filas de productos de una negociación: ID y nombres de productos, cantidades, precios, una lista de texto lista y el total con moneda.
El robot lee los productos de una negociación y los entrega a los siguientes pasos del proceso. Los robots estándar no ven los productos de la negociación: no se puede poner la lista de productos en un comentario o una tarea, comprobar si un producto concreto está en la negociación ni sumar las filas. El robot devuelve los ID de productos, nombres, cantidades y precios unitarios de cada fila como listas separadas, un texto listo con la forma «Nombre × cantidad = suma» línea a línea, el total y la moneda de la negociación. Los precios ya incluyen descuento e impuesto, y el total es la suma de «precio × cantidad» de todas las filas, es decir, lo que paga el cliente. Por defecto se usa la negociación en la que se ejecuta el proceso; cualquier otra puede indicarse por ID. También funciona con elementos de procesos inteligentes con productos. Si no hay productos, el robot devuelve «Tiene productos = No».
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| Negociación | select | — | current |
| ID de la negociación (para el modo «Negociación por ID») | string | — |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Tiene productos | bool |
| Número de filas | int |
| ID de productos | int |
| Nombres de productos | string |
| Cantidades por fila | double |
| Precios unitarios (con descuento e impuesto) | double |
| Lista de productos en texto | text |
| Total | double |
| Moneda | string |
| É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.
- No se pudo determinar la negociación. En el modo «Negociación por ID» indique un ID válido; el elemento actual debe ser una negociación o un elemento de proceso inteligente.
- Error de API al leer los productos de la negociación.
Escenario: enviar al cliente el contenido del pedido
- El robot se coloca en la etapa «Factura emitida»
- Devuelve la lista de productos en texto y el total de la negociación
- El siguiente robot envía al cliente un correo con esa lista y el importe a pagar