easybill-Integration

Mit der easybill-Integration synchronisieren Sie Ihre Rechnungen, Angebote und Kunden von dVersum nach easybill. Zahlungseingänge werden automatisch per Webhook zurückgemeldet und aktualisieren den Rechnungsstatus in dVersum.

Voraussetzungen

Einrichtung

Schritt 1: API-Key eingeben

1. Gehen Sie zu Einstellungen > Integrationen
2. Scrollen Sie zum Abschnitt easybill
3. Geben Sie Ihren easybill API-Key ein
4. Klicken Sie auf Verbinden

Die Verbindung wird sofort getestet. Bei Erfolg wird der Status auf Verbunden gesetzt.

Schritt 2: Webhook einrichten (optional)

Um automatische Zahlungsbenachrichtigungen zu erhalten:

1. Kopieren Sie die angezeigte Webhook-URL aus den Einstellungen
2. Öffnen Sie Ihre easybill-API-Einstellungen
3. Erstellen Sie einen neuen Webhook mit dieser URL
4. Aktivieren Sie das Event document.payment_add

Was wird synchronisiert?

Rechnungen (dVersum → easybill)

Folgende Rechnungstypen werden synchronisiert:

Synchronisierte Daten pro Rechnung:

• Rechnungsnummer, Ausstellungsdatum, Fälligkeitsdatum
• Alle Positionen mit Beschreibung, Menge, Einzelpreis, Steuersatz
• Leistungszeitraum
• Notizen und Beschreibung
• Reverse-Charge-Kennzeichnung (§13b UStG)
• Kundenreferenz (wird automatisch verknüpft)

Angebote (dVersum → easybill)

Angebote werden als OFFER-Dokumente in easybill erstellt, inkl. aller Positionen und Gültigkeitsdauer.

Kunden (dVersum → easybill)

Beim Synchronisieren einer Rechnung wird der zugehörige Kunde automatisch in easybill angelegt oder zugeordnet:

• Firmennname, Anschrift, E-Mail
• USt-IdNr., Website, Telefon, Notizen
• Bereits vorhandene easybill-Kunden werden per Name erkannt (kein Duplikat)

Rechnungen synchronisieren

Einzelne Rechnung synchronisieren

1. Öffnen Sie eine Rechnung in dVersum
2. Klicken Sie auf Mit easybill synchronisieren
3. Die Rechnung wird sofort in easybill erstellt

Alle Rechnungen synchronisieren

1. Gehen Sie zu Einstellungen > Integrationen > easybill
2. Klicken Sie auf Rechnungen synchronisieren
3. Alle noch nicht synchronisierten Rechnungen (außer Entwürfe) werden übertragen

Kunden synchronisieren

Klicken Sie auf Kunden synchronisieren, um alle dVersum-Kunden ohne easybill-Zuordnung zu übertragen.

Zahlungsverfolgung (Webhook)

Wenn Sie den Webhook eingerichtet haben, werden Zahlungseingänge in easybill automatisch an dVersum gemeldet:

1. Ein Kunde bezahlt eine Rechnung in easybill
2. easybill sendet ein Webhook-Event an dVersum
3. dVersum aktualisiert den Rechnungsstatus:
   • Bezahlt -- wenn der volle Betrag beglichen ist
   • Teilweise bezahlt -- bei Teilzahlungen
4. Alle Administratoren erhalten eine In-App-Benachrichtigung über den Zahlungseingang

Verbindung trennen

1. Gehen Sie zu Einstellungen > Integrationen > easybill
2. Klicken Sie auf Trennen
3. Bestätigen Sie die Trennung

Nach dem Trennen:

• Bereits synchronisierte Daten bleiben in easybill erhalten
• Neue Rechnungen werden nicht mehr synchronisiert
• Webhook-Events werden ignoriert

Einschränkungen

• Einweg-Synchronisation: Daten fließen von dVersum nach easybill (Rechnungen, Kunden, Angebote). Nur Zahlungen werden von easybill zurückgemeldet.
• Keine Änderungs-Sync: Wenn Sie eine bereits synchronisierte Rechnung in dVersum ändern, wird die Änderung nicht automatisch nach easybill übertragen.
• Ein Konto pro Organisation: Jede Organisation kann genau eine easybill-Verbindung haben.

Tipps

1. Webhook einrichten -- Richten Sie den Webhook ein, um Zahlungsstatus automatisch aktualisiert zu bekommen
2. Regelmäßig synchronisieren -- Nutzen Sie die Bulk-Synchronisation, um alle neuen Rechnungen auf einmal zu übertragen
3. Kunden zuerst prüfen -- Synchronisieren Sie zuerst die Kunden, damit die Zuordnung bei Rechnungen reibungslos funktioniert