Unternehmen per ID aktualisieren
Der Roboter „Unternehmen per ID aktualisieren“ ändert jedes Unternehmen anhand seiner Kennung aus jedem Geschäftsprozess-Kontext in Bitrix24 (Alaio). Die zu ändernden Felder werden als JSON im camelCase-Format übergeben (title, assignedById, industry, revenue 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 ein beliebiges Unternehmen anhand seiner ID, auch wenn der Geschäftsprozess auf einer anderen CRM-Entität läuft — einem Deal, einem Kontakt oder einer Aufgabe. Die Unternehmens-ID und die Feldmenge werden explizit angegeben: Felder werden als JSON-Zeichenkette im camelCase-Format übergeben (zum Beispiel {"title":"Neues Unternehmen","assignedById":5,"industry":"IT","revenue":1000000}). Die Aktualisierung verwendet die universelle Methode crm.item.update, sodass alle Unternehmensfelder verfügbar sind, einschließlich benutzerdefinierter. Typische Fälle: bei einer Phasenänderung des Deals das verknüpfte Unternehmen aktualisieren; den Verantwortlichen und die Branche aus einem externen System setzen; Unternehmensfelder 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 |
|---|---|---|---|
| Unternehmens-ID | int | ja | |
| Zu aktualisierende Felder (camelCase-JSON): {"title":"New company","assignedById":5,"industry":"IT","revenue":1000000} | 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 Unternehmens aus einem Deal-Prozess
- Der Deal wechselt in eine neue Pipeline-Phase
- Der Roboter aktualisiert das verknüpfte Unternehmen: assignedById und industry werden als JSON übergeben
- Ein Y-Ergebnis bestätigt die Aktualisierung für den nächsten Schritt