Integrations

Bling ERP verbinden und Kunden, Produkte, Bestellungen und Rechnungen synchronisieren

Verbinden Sie Ihr Bling-Konto (ein brasilianisches ERP) per OAuth mit dem CRM und synchronisieren Sie Kunden, Produkte, Verkaufsaufträge und Rechnungen in beide Richtungen, ohne Duplikate zu erzeugen.

Sie können Ihr Bling-Konto mit dem CRM verbinden. Nach der Verbindung ruft das CRM Kunden (als Kontakt oder Firma), Produkte, Verkaufsaufträge und Rechnungen aus Bling ab und verknüpft alles über die Bling-ID. Ein erneuter Sync erzeugt niemals Duplikate: Er aktualisiert den bereits vorhandenen Datensatz.

Das Modell ist BYO („bring your own account“): Sie nutzen Ihr eigenes Bling-Konto und Ihre eigene OAuth-App. Wir sehen Ihre Zugangsdaten niemals, und es entstehen keine Kosten unsererseits. Die Integration startet inaktiv: Nichts passiert, bis Sie die Zugangsdaten konfigurieren und sie aktivieren.

Voraussetzungen

Ein Bling-Konto mit Zugriff auf API v3.
Eine in Bling (Entwicklerbereich) erstellte App, aus der Sie Client ID und Client Secret erhalten und die Sie autorisieren, um den OAuth-Refresh-Token zu erhalten.
In Sellio: Administratorrechte (Berechtigung Einstellungen verwalten), um die Zugangsdaten unter Einstellungen → Integrationen zu speichern.

Schritt 1: Die App in Bling erstellen

Öffnen Sie in Bling den Apps-/Entwicklerbereich und erstellen Sie eine neue App mit API v3.
Kopieren Sie die Client ID und das Client Secret der App.
Führen Sie die OAuth-Autorisierung der App für Ihr Konto durch und bewahren Sie den generierten Refresh-Token auf. Das CRM nutzt den Refresh-Token, um den Zugriff eigenständig zu erneuern.

Schritt 2: Die Zugangsdaten in das CRM einfügen

Öffnen Sie Einstellungen → Integrationen und suchen Sie die Karte „Bling ERP“.
Fügen Sie Client ID, Client Secret und Refresh-Token ein. Zugangsdaten werden verschlüsselt gespeichert und nie wieder angezeigt.
Wählen Sie unter „Entitäten und Richtung“ für Kunden, Produkte, Aufträge und Rechnungen, ob aus Bling abgerufen, an Bling gesendet, beide Richtungen genutzt oder nicht synchronisiert werden soll.
Klicken Sie auf „Verbindung speichern“ und dann auf „Aktivieren“.

Schritt 3: Synchronisieren und Updates empfangen

Klicken Sie auf „Jetzt synchronisieren“, um sofort Daten aus Bling abzurufen. Ein automatischer Sync läuft außerdem täglich.
Um Änderungen nahezu in Echtzeit zu erhalten, richten Sie die Bling-Benachrichtigungen (Webhook) auf die auf der Karte angezeigte URL. Sie enthält ein geheimes Token: Halten Sie es vertraulich.
Wir empfehlen dringend, das „Webhook-Geheimnis“ auf der Karte auszufüllen und denselben Wert in Bling zu verwenden. Da dieser Webhook Datensätze in Ihr CRM SCHREIBT (Kontakte, Aufträge, Rechnungen), garantiert das Geheimnis die Authentizität jedes Aufrufs durch eine Signatur (HMAC).

Einzelkunden werden zu Kontakten und Firmen werden zu Firmen. Jedes Produkt wird zu einem Produkt, jeder Verkaufsauftrag wird zu einem Verkaufsauftrag (mit dem Kunden verknüpft) und jede Rechnung wird zu einer Aktivität mit Nummer, Betrag und DANFE-Link.

Sicherheit und Datenschutz

Client Secret und Refresh-Token werden verschlüsselt gespeichert und nie angezeigt. Der Zugriffs-Token wird automatisch erneuert, wenn er abläuft, ohne erneute Autorisierung. Die Verbindung startet inaktiv und synchronisiert erst, nachdem sie konfiguriert und aktiviert wurde.

💡 Sicherheitsempfehlung: Legen Sie das „Webhook-Geheimnis“ fest. Der Bling-Webhook SCHREIBT Datensätze in Ihr CRM (Kontakte, Aufträge, Rechnungen), behandeln Sie ihn also als Dateneingangspunkt. Mit dem Geheimnis wird jeder Aufruf per Signatur (HMAC) validiert, und nur wer das Geheimnis kennt, kommt durch. Ohne es besteht der einzige Schutz im URL-Token: Sollte dieses Token durchsickern, könnte jemand Daten in Ihr Konto einschleusen. Es ist nicht zwingend erforderlich, wird aber dringend empfohlen.

Example: Webhook-URL zur Registrierung in Bling: https://app.yourcompany.com/api/inbound/bling/YOUR-TOKEN (kopieren Sie den exakten Wert, der auf der Karte angezeigt wird).

So testen Sie

Klicken Sie nach dem Speichern und Aktivieren auf „Jetzt synchronisieren“ und warten Sie die Bestätigung ab.
Öffnen Sie die Listen Kontakte, Produkte und Verkaufsaufträge und prüfen Sie, ob die Bling-Datensätze erschienen sind.
Beobachten Sie auf der Karte, wie die Anzahl „Verknüpfungen pro Entität“ mit der Synchronisierung wächst.

Fehlerbehebung

Nichts synchronisiert sich: Prüfen Sie, ob die Integration „Aktiviert“ ist und mindestens eine Entität auf „Aus Bling abrufen“ oder „Beide Richtungen“ gesetzt ist.
Anmeldefehler bei der Synchronisierung: Geben Sie Client ID, Client Secret und Refresh-Token erneut ein (Secret und Token werden vom Server nie zurückgesendet, fügen Sie sie also vollständig ein).
Datensätze erscheinen nicht: Prüfen Sie, ob die Objekte Kontakt, Firma, Produkt und Verkaufsauftrag in Ihrem Konto existieren (sie sind Standard).
Der Webhook kommt nicht an: Prüfen Sie, ob die in Bling registrierte URL mit der auf der Karte angezeigten übereinstimmt und, falls Sie ein Webhook-Geheimnis verwendet haben, ob es auf beiden Seiten identisch ist.

Open this article inside the system →