Get deal products
The Get deal products robot passes the product rows of a deal into a Bitrix24 (Alaio) workflow: product IDs and names, quantities, prices, a ready text list and the total with currency.
The robot reads the products of a deal and hands them to the next workflow steps. Stock robots cannot see deal products: you cannot put the product list into a comment or a task, check whether a given product is in the deal, or add up the rows. The robot returns product IDs, names, quantities and unit prices per row as separate lists, a ready text in the form "Name × quantity = sum" line by line, the total and the deal currency. Prices already include discount and tax, and the total is the sum of "price × quantity" over all rows, which is what the client pays. By default the deal the process runs on is used; any other deal can be given by ID. It also works on smart process elements with products. When there are no products the robot returns "Has products = No".
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Deal | select | — | current |
| Deal ID (for the "Deal by ID" mode) | string | — |
What does the robot return?
| Parameter | Type |
|---|---|
| Has products | bool |
| Number of rows | int |
| Product IDs | int |
| Product names | string |
| Quantities per row | double |
| Unit prices (after discount and tax) | double |
| Product list as text | text |
| Total | double |
| Currency | string |
| Success | bool |
| Error | string |
What errors can the robot return?
The robot writes these messages to the business process log when it cannot complete a step. The text tells you what to fix in the settings or the data.
- Could not resolve the deal. In the "Deal by ID" mode enter a valid ID; the current item must be a deal or a smart process element.
- API error while reading the deal products.
Scenario: send the client the order contents
- The robot is placed on the "Invoice sent" stage
- It returns the product list as text and the deal total
- The next robot e-mails the client this list and the amount due