Auftrag per ID aktualisieren
Der Roboter „Auftrag per ID aktualisieren“ ändert jeden Auftrag anhand seiner Kennung aus jedem Geschäftsprozess-Kontext in Bitrix24. Die zu ändernden Felder werden als JSON im camelCase-Format übergeben (title, stageId, opportunity, assignedById und weitere). Er gibt ein Erfolgskennzeichen Y/N für die bedingte Verzweigung im Prozess zurück und arbeitet über die universelle CRM-Methode crm.item.update.
Der Roboter aktualisiert einen beliebigen Auftrag anhand seiner ID, auch wenn der Geschäftsprozess auf einer anderen CRM-Entität läuft — einem Kontakt, einem Lead oder einer Aufgabe. Die Auftrags-ID und die Feldmenge werden explizit angegeben: Felder werden als JSON-Zeichenkette im camelCase-Format übergeben (zum Beispiel {"title":"Neuer Auftrag","stageId":"C1:WON","opportunity":50000,"assignedById":5}). Die Aktualisierung verwendet die universelle Methode crm.item.update, sodass alle Auftragsfelder verfügbar sind, einschließlich benutzerdefinierter. Typische Fälle: bei einer Phasenänderung des Kontakts den verknüpften Auftrag aktualisieren; den Verantwortlichen und den Betrag aus einem externen System setzen; Auftragsphasen aus einem übergeordneten Prozess massenhaft ändern. Er gibt ein Kennzeichen Erfolgreich (Y/N) zurück: Y bei erfolgreicher Aktualisierung, N bei leerer ID, leerem oder ungültigem JSON oder einem API-Fehler — vergleichen Sie es in der Bedingung des nächsten Schritts.
Welche Eingabeparameter akzeptiert der Roboter?
| Parameter | Typ | Pflichtfeld? | Standard |
|---|---|---|---|
| Auftrags-ID | int | ja | |
| Zu aktualisierende Felder (camelCase-JSON): {"title":"New deal","stageId":"C1:WON","assignedById":5,"opportunity":50000} | string | ja |
Was gibt der Roboter zurück?
| Parameter | Typ |
|---|---|
| Erfolg (Y/N) | string |
Szenario: Aktualisierung eines Auftrags aus einem Kontaktprozess
- Der Kontakt wechselt in eine neue Pipeline-Phase
- Der Roboter aktualisiert den verknüpften Auftrag: stageId und opportunity werden als JSON übergeben
- Ein Y-Ergebnis bestätigt die Aktualisierung für den nächsten Schritt