Obter produtos do negócio
O robô «Obter produtos do negócio» passa para um processo de negócios do Bitrix24 (Alaio) as linhas de produtos de um negócio: IDs e nomes dos produtos, quantidades, preços, uma lista de texto pronta e o total com moeda.
O robô lê os produtos de um negócio e os entrega aos próximos passos do processo. Os robôs padrão não enxergam os produtos do negócio: não dá para colocar a lista de produtos em um comentário ou tarefa, verificar se um produto está no negócio nem somar as linhas. O robô retorna IDs dos produtos, nomes, quantidades e preços unitários de cada linha como listas separadas, um texto pronto no formato «Nome × quantidade = soma» linha a linha, o total e a moeda do negócio. Os preços já incluem desconto e imposto, e o total é a soma de «preço × quantidade» de todas as linhas, ou seja, o que o cliente paga. Por padrão é usado o negócio em que o processo roda; qualquer outro pode ser informado por ID. Também funciona com elementos de processos inteligentes com produtos. Se não houver produtos, o robô retorna «Tem produtos = Não».
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Negócio | select | — | current |
| ID do negócio (para o modo «Negócio por ID») | string | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Tem produtos | bool |
| Número de linhas | int |
| IDs dos produtos | int |
| Nomes dos produtos | string |
| Quantidades por linha | double |
| Preços unitários (com desconto e imposto) | double |
| Lista de produtos em texto | text |
| Total | double |
| Moeda | string |
| Sucesso | bool |
| Erro | string |
Quais erros o robô pode retornar?
O robô grava essas mensagens no histórico do processo de negócios quando não consegue concluir uma etapa. O texto mostra o que corrigir nas configurações ou nos dados.
- Não foi possível determinar o negócio. No modo «Negócio por ID» informe um ID válido; o item atual deve ser um negócio ou um elemento de processo inteligente.
- Erro de API ao ler os produtos do negócio.
Cenário: enviar ao cliente a composição do pedido
- O robô é colocado na etapa «Fatura emitida»
- Ele retorna a lista de produtos em texto e o total do negócio
- O próximo robô envia ao cliente um e-mail com essa lista e o valor a pagar