Setup

ERP, Rechnungsstellung und Bankabgleich

Senden Sie Zahlungen und akzeptierte Angebote an Ihr ERP und gleichen Sie Ihre Banktransaktionen automatisch mit ausstehenden Zahlungen ab, alles im BYO-Modell (das ERP und die Bank gehören Ihnen).

Diese Integration ist ein generischer, neutraler, globaler Connector für Ihre Finanzabläufe mit zwei unabhängigen Funktionen: (1) Daten an Ihr ERP-/Buchhaltungssystem senden, wenn eine Zahlung bestätigt oder ein Angebot akzeptiert wird; und (2) Transaktionen von Ihrer Bank empfangen (über Open Banking, einen Finanzaggregator wie Plaid, Tink oder TrueLayer, oder die Bank selbst) und automatisch mit ausstehenden Zahlungen abgleichen. Es funktioniert in jedem Land und jeder Währung, mit jedem ERP (QuickBooks, Xero, NetSuite, SAP, unter anderen) und jeder Bank. BYO-Modell: Konten und Zugangsdaten gehören Ihnen; es entstehen keine Kosten auf unserer Seite.

Beide starten inaktiv: Es passiert nichts, bis Sie konfigurieren und aktivieren. Die Geheimnisse (ERP-API-Schlüssel und Bank-Webhook-Secret) werden verschlüsselt gespeichert und niemals wieder angezeigt.

Voraussetzungen

ERP/Rechnungsstellung: ein HTTP-Endpunkt in Ihrem ERP (QuickBooks, Xero, NetSuite, SAP oder einem anderen), der einen POST JSON empfangen kann, sowie die Zugangsdaten zur Authentifizierung (API-Schlüssel oder Token).
Bankabgleich: ein Konto bei einer Bank oder einem Open-Banking-Aggregator (Plaid, Tink, TrueLayer oder die Bank selbst), der Transaktions-Webhooks senden und mit HMAC-SHA256 signieren kann.
In Sellio Administratorzugriff, um die Connectors unter Einstellungen → Integrationen zu speichern und zu aktivieren.

ERP / Rechnungsstellung (Senden)

Wenn eine Zahlung bestätigt wird (durch den Webhook des Zahlungsanbieters oder durch Bankabgleich) oder wenn das verknüpfte Angebot akzeptiert wird, sendet das CRM einen POST an Ihren ERP-Endpunkt mit einem JSON-Umschlag im Format { event, data, source, sentAt }. Das event gibt den Vorfall an (zum Beispiel payment.paid), und data enthält die Felder (Betrag, Währung, Referenz, Angebots-/Vertriebschancen-IDs).

Öffnen Sie Einstellungen → Integrationen und gehen Sie zur Karte „ERP / Rechnungsstellung“.
Endpunkt (URL): Fügen Sie die Adresse Ihres ERP ein, die den POST empfängt (z. B. https://erp.yourcompany.com/api/webhooks/crm).
Authentifizierungsheader und Präfix: Geben Sie an, wie authentifiziert werden soll (z. B. Authorization mit Präfix „Bearer “, oder ein benutzerdefinierter Header wie X-Api-Key ohne Präfix).
API-Schlüssel: Fügen Sie Ihren ERP-Schlüssel ein. Er wird verschlüsselt gespeichert.
Speichern Sie den Connector, validieren Sie ihn mit „Test senden“ und klicken Sie dann auf Aktivieren. Das automatische Senden erfolgt nur, wenn der Connector AKTIVIERT ist.

💡 Das Senden erfolgt nach bestem Bemühen (best effort): Ist Ihr ERP nicht erreichbar oder lehnt den Aufruf ab, wird das CRM nicht beeinträchtigt, und die Zahlung bleibt normal erfasst.

Bankabgleich (Empfangen)

Sie richten den Webhook Ihrer Bank/Ihres Open-Banking-Dienstes auf die vom CRM erzeugte URL. Für jede empfangene Transaktion (ein JSON mit Betrag, Währung, Referenz/Beschreibung und einer externen ID) sucht das CRM nach einer PASSENDEN AUSSTEHENDEN Zahlung und markiert sie als bezahlt.

Geben Sie auf der Karte „Bankabgleich“ das Webhook-Secret ein (den Schlüssel zum Signieren der Aufrufe) und speichern Sie.
Erzeugen Sie die Webhook-URL und fügen Sie sie in Ihre Bank/Ihren Open-Banking-Dienst/Aggregator ein.
Konfigurieren Sie den Anbieter so, dass er den Body jedes Aufrufs mit HMAC-SHA256 signiert und die Signatur im Header X-Signature sendet (hex oder base64, mit oder ohne Präfix sha256=).
Aktivieren Sie die Integration.

Wie der Abgleich funktioniert

Das CRM gleicht konservativ ab (es geht um Geld, daher wird nie geraten) und länderunabhängig: (1) Es filtert ausstehende Zahlungen nach exaktem Betrag und, wenn die Transaktion die Währung angibt, nach derselben Währung; (2) trägt die Transaktion eine Referenz/Beschreibung, bevorzugt es die Zahlung, deren Kennung (ID, externe ID, Angebot oder Vertriebschance) in dieser Referenz erscheint; (3) fehlt eine Referenz zur Unterscheidung, gleicht es nur ab, wenn es genau eine ausstehende Zahlung mit diesem Betrag gibt. Haben mehrere Zahlungen denselben Betrag und nichts unterscheidet sie, bleibt die Transaktion unabgeglichen (zur manuellen Bearbeitung durch Sie).

Example: Transaktion: { amount: 199.90, currency: "USD", reference: "Payment quote q_8f2a", external_id: "tx_123" } → wird der ausstehenden Zahlung über 199,90 zugeordnet, deren Angebot q_8f2a ist, und als bezahlt markiert.

💡 Der Abgleich ist idempotent: Da nur ausstehende Zahlungen in den Abgleich einfließen, wird die bereits bezahlte Zahlung nicht erneut berührt, wenn die Bank dieselbe Transaktion erneut sendet. Transaktionen ohne Übereinstimmung werden protokolliert, ohne den Empfang zu unterbrechen.

So testen Sie es

ERP: Klicken Sie bei aktiviertem Connector auf der Karte „ERP / Rechnungsstellung“ auf „Test senden“ und bestätigen Sie in Ihrem ERP, dass der POST angekommen ist (suchen Sie nach dem empfangenen Webhook-Datensatz/-Log).
Bankabgleich: Erstellen Sie eine ausstehende Zahlung mit einem eindeutigen Betrag und lösen Sie (oder simulieren Sie) eine Transaktion in Ihrer Bank/Ihrem Aggregator mit demselben Betrag und einer Referenz, die das Angebot/die Vertriebschance nennt. Prüfen Sie, ob die Zahlung auf „Bezahlt“ wechselt.
Prüfen Sie die Integrationshistorie/das Log, um die empfangenen Aufrufe und das Abgleichergebnis zu sehen.

Fehlerbehebung

„Test senden“ schlägt mit 401/403 fehl: Der ERP-API-Schlüssel ist falsch, oder Authentifizierungsheader/-präfix stimmen nicht überein. Fügen Sie den Schlüssel erneut ein und prüfen Sie den Headernamen (z. B. Authorization „Bearer “ oder X-Api-Key).
404 beim Senden: Der ERP-Endpunkt ist falsch, oder die Route existiert nicht. Bestätigen Sie die vollständige URL, die den POST empfängt.
Ungültige Signatur beim Abgleich (Webhook abgelehnt): Das Webhook-Secret im CRM unterscheidet sich von dem, mit dem die Bank signiert, oder die Signatur kommt nicht im Header X-Signature (HMAC-SHA256, hex oder base64) an. Gleichen Sie dasselbe Secret auf beiden Seiten ab.
Die Transaktion gleicht sich nicht ab: Möglicherweise gibt es mehr als eine ausstehende Zahlung mit demselben Betrag und keine Referenz zur Unterscheidung; nehmen Sie also die ID/das Angebot in die Transaktionsbeschreibung auf oder gleichen Sie manuell ab. Bestätigen Sie auch, dass die Währung übereinstimmt.
Beim Senden passiert nichts: Das automatische Senden erfolgt nur bei AKTIVIERTEM Connector. Aktivieren Sie ihn nach dem Speichern.

Open this article inside the system →