Roboteka
Roboteka · Roboter · Auftrag per ID aktualisieren

Auftrag per ID aktualisieren

Der Roboter „Auftrag per ID aktualisieren“ ändert jeden Auftrag anhand seiner Kennung aus jedem Geschäftsprozess-Kontext in Bitrix24 (Alaio). 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

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.

  • Fehler: {id} ist nicht angegeben
  • Fehler: fields_json ist leer
  • Fehler: fields_json enthält ungültiges JSON
  • API-Fehler

Szenario: Aktualisierung eines Auftrags aus einem Kontaktprozess

  1. Der Kontakt wechselt in eine neue Pipeline-Phase
  2. Der Roboter aktualisiert den verknüpften Auftrag: stageId und opportunity werden als JSON übergeben
  3. Ein Y-Ergebnis bestätigt die Aktualisierung für den nächsten Schritt

Ähnliche Roboter

Passende Artikel

Installieren Aufgabe beschreiben — wir bauen den Roboter kostenlos