Produkte des Deals abrufen
Der Roboter „Produkte des Deals abrufen“ übergibt die Produktpositionen eines Deals an einen Bitrix24 (Alaio)-Workflow: Produkt-IDs und -Namen, Mengen, Preise, eine fertige Textliste und die Gesamtsumme mit Währung.
Der Roboter liest die Produkte eines Deals und gibt sie an die nächsten Workflow-Schritte weiter. Standardroboter sehen die Produkte eines Deals nicht: Man kann die Produktliste nicht in einen Kommentar oder eine Aufgabe einfügen, nicht prüfen, ob ein bestimmtes Produkt im Deal ist, und die Positionen nicht summieren. Der Roboter liefert Produkt-IDs, Namen, Mengen und Stückpreise je Position als getrennte Listen, einen fertigen Text der Form „Name × Menge = Summe“ Zeile für Zeile, die Gesamtsumme und die Währung des Deals. Die Preise enthalten bereits Rabatt und Steuer, die Gesamtsumme ist die Summe von „Preis × Menge“ über alle Positionen, also das, was der Kunde bezahlt. Standardmäßig wird der Deal verwendet, auf dem der Prozess läuft; jeder andere Deal kann per ID angegeben werden. Funktioniert auch mit Smart-Prozess-Elementen mit Produkten. Gibt es keine Produkte, liefert der Roboter „Produkte vorhanden = Nein“.
Welche Eingabeparameter akzeptiert der Roboter?
| Parameter | Typ | Pflichtfeld? | Standard |
|---|---|---|---|
| Deal | select | — | current |
| Deal-ID (für den Modus „Deal per ID“) | string | — |
Was gibt der Roboter zurück?
| Parameter | Typ |
|---|---|
| Produkte vorhanden | bool |
| Anzahl der Positionen | int |
| Produkt-IDs | int |
| Produktnamen | string |
| Mengen pro Position | double |
| Stückpreise (nach Rabatt und Steuer) | double |
| Produktliste als Text | text |
| Gesamtsumme | double |
| Währung | string |
| Erfolg | bool |
| Fehler | string |
Welche Fehler kann der Roboter zurückgeben?
Diese Meldungen schreibt der Roboter ins Protokoll des Geschäftsprozesses, wenn er einen Schritt nicht ausführen kann. Der Text zeigt, was in den Einstellungen oder Daten zu korrigieren ist.
- Deal konnte nicht bestimmt werden. Im Modus „Deal per ID“ eine gültige ID angeben; das aktuelle Element muss ein Deal oder ein Smart-Prozess-Element sein.
- API-Fehler beim Lesen der Produkte des Deals.
Szenario: dem Kunden den Bestellinhalt senden
- Der Roboter wird auf die Phase „Rechnung gestellt“ gesetzt
- Er liefert die Produktliste als Text und die Gesamtsumme des Deals
- Der nächste Roboter schickt dem Kunden eine E-Mail mit dieser Liste und dem fälligen Betrag