Konfiguration

Öffnen Sie die Seite "Meine Erweiterungen": und öffnen Sie die Konfigurationsseite des Plugins:

Allgemeine und API-Anmeldeinformationen

Das Plugin ermöglicht es Ihnen, zwei API-Schlüssel hinzuzufügen. Einen für die Produktionsumgebung von Bexio und einen für die Testumgebung. Wenn Sie nicht über zwei verschiedene Bexio-Umgebungen verfügen, können Sie einfach denselben API-Schlüssel in beide Felder eintragen. Mit der Auswahl "Betriebsmodus" können Sie wählen, welche Umgebung verwendet werden soll. Dies ist praktisch, wenn Sie eine Staging Shopware-Umgebung haben, die die Rechnungen an die Testumgebung von Bexio senden soll.

Das API-Token heisst jetzt "Personal Access Token" und kann in Ihrem Bexio-Entwicklerkonto generiert werden: developer.bexio.com -> Personal Access Tokens -> Create new token ->Token generieren.

wICHTIG: Der "Personal Access Token" muss alle 6 Monate manuell erneuert werden, sonst funktioniert die Verbindung nicht mehr.

Module

In diesem Abschnitt können Sie die verschiedenen Module der App aktivieren. Im Moment ist es nur Bestellungen auf Rechnung synchronisieren. Wenn dies aktiviert ist, generiert unsere App eine neue Rechnung für jede neue Bestellung in Ihrem Shop, abhängig von der Konfiguration der Zahlungsmethode.

Bestellungen

In diesem Abschnitt können Sie die folgenden Dinge konfigurieren:

1. Bexio-Benutzer-ID: Dies ist die ID des Benutzers, dem wir alle Rechnungen zuordnen.

Zahlungsmöglichkeiten

Die App fügt drei neue benutzerdefinierte Felder zu den Shopware-Zahlungsmethoden hinzu. Sie können sie auf der Detailseite der Zahlungsmethode in Ihrer Shopware-Verwaltung sehen:

Es gibt drei Felder:

1. Kontrollkästchen, wenn Bestellungen mit dieser Zahlungsmethode eine Bexio-Rechnung erzeugen sollen.
2. Wählen Sie die passende Bexio-Zahlungsart.
3. Wählen Sie das passende Bexio-Bankkonto.

Das ist praktisch, wenn Sie z.B. nur Rechnungen für Bestellungen mit der Zahlungsart "Rechnung" erstellen wollen und nicht für Bestellungen mit der Zahlungsart "Paypal". Mit diesen benutzerdefinierten Feldern können Sie sie nach Ihren Bedürfnissen konfigurieren.

Der Bexiozahlungsart wird hier im Prozess der Rechnungserstellung verwendet:

Der Bexiobankkonto wird hier im Prozess der Rechnungserstellung verwendet:

sowie für das Bankkonto bei der Kennzeichnung von Aufträgen als bezahlt.

Die Bexio-Bankkontonummer ist die Nummer des Bankkontos in Bexio. Sie finden die Bankkontonummer in Ihrem Bexio-Konto in der URL-Leiste, wenn Sie auf ein Bankkonto in der Bankkontoliste klicken: In diesem Beispiel ist die ID 1.

Automatischer Versand von Rechnungen über Bexio

Die App fügt ein benutzerdefiniertes Feld zu den Zahlungsmethoden hinzu, um den automatischen Versand von Rechnungen über Bexio zu ermöglichen. Wenn dies aktiviert ist, werden die Rechnungen in Bexio nicht nur erstellt, sondern auch direkt an den Kunden gesendet.

In Bexio gibt es ein schönes Protokoll der versendeten Rechnungen:

Leider verlangt die API von Bexio, dass wir einen E-Mail-Betreff und -Text senden, und wir können Ihre Standard-E-Mail-Vorlage nicht verwenden. Daher ist es erforderlich, den E-Mail-Betreff und -Text in den Einstellungen der Zahlungsmethode in Shopware auszufüllen.

Anzeige von Produktvarianten in Bexio-Rechnungen

Bei der Synchronisierung von Bestellungen aus Shopware mit Bexio ist es wichtig, dass die Produktvarianten in den Rechnungen korrekt angezeigt werden. Mit dieser Einstellung können Sie steuern, wie die Produktbeschreibungen, einschließlich der Variantendetails, übertragen werden. Führen Sie die folgenden Schritte aus, um diese Option richtig zu konfigurieren.

Gehen Sie wie folgt vor, um sicherzustellen, dass Produktvarianten in Bexio-Rechnungen korrekt angezeigt werden:

1. Navigieren Sie im Shopware-Backend zu Meine Erweiterungen und öffnen Sie das Plugin Webwirkung Bexio Integration.
2. Geben Sie unter dem Modal "Bestellungen" die korrekte Bexio-Benutzer-ID ein.
3. Suchen Sie die Option Quelle für die Produktbeschreibung und wählen Sie, ob die Produktbeschreibungen aus Shopware oder Bexio stammen sollen.
4. Aktivieren Sie schließlich die Option "Produktbeschreibung: Variante hinzufügen", um sicherzustellen, dass Produktvarianten in Bexio-Rechnungen enthalten sind.

Wenn Sie diese Schritte befolgen, wird das System die Informationen zu den Produktvarianten korrekt übertragen und in den Bexio-Rechnungen anzeigen.

Manuelle Übermittlung von Bestellungen aus Shopware an Bexio auf Bestelllistenebene

Mit der manuellen Übertragungsfunktion können Sie mehrere Aufträge mit einem einzigen Klick effizient an Bexio übertragen. Dies ermöglicht eine schnellere Verarbeitung und eine bessere Kontrolle über die Auftragssynchronisation. Um eine erfolgreiche Übertragung zu gewährleisten, stellen Sie sicher, dass die richtigen Bexio-IDs für Produkte, Versand und Steuern korrekt konfiguriert sind. Falsche oder fehlende IDs können zu Übertragungsfehlern oder unvollständiger Datensynchronisation führen.

Wichtig: Die manuelle Übertragung funktioniert auch, wenn die allgemeine Auftragsübertragung in der bexio-Einstellung deaktiviert ist.

Überprüfen Sie die Rundungseinstellung in den Shopware-Währungseinstellungen

Bexio wendet einen Rundungsfaktor von 0,5 auf die Gesamtsumme der Rechnung an. Bitte stellen Sie sicher, dass Ihre Shopware-Währungseinstellungen entsprechend angepasst sind.

Navigieren Sie dazu zu Einstellungen > Währungen, wählen Sie Ihre aktiven Währungen aus und setzen Sie das Intervall für die Gesamtsummenrundung auf 0,50.

Synchronisierung des Zahlungsstatus von Bexio zu Shopware

Die Integration ermöglicht es Ihnen, den Zahlungsstatus automatisch von Bexio zurück in Shopware zu synchronisieren. Dadurch wird sichergestellt, dass die in Bexio registrierten Zahlungen auch im Shopware-Bestellstatus reflektiert werden.

1. Es werden nur Bestellungen der letzten 6 Monate geprüft.
2. Eine Konfigurationsoption ist in den Plugin-Einstellungen verfügbar.

3. Die Synchronisierung erfolgt automatisch alle 24 Stunden um 01:00 Uhr.
4. Diese Funktion ist nützlich, wenn Sie den Status Ihrer Shopware-Bestellungen ohne manuelle Anpassungen auf dem neuesten Stand halten möchten.

Steuerliche Kartierung

Die App fügt ein benutzerdefiniertes Feld hinzu, um Ihre Steuersätze den Steuersätzen von Bexio zuzuordnen.

Bitte stellen Sie sicher, dass diese IDs korrekt sind. Andernfalls wird die Rechnungserstellung fehlschlagen.

Sie können die IDs in Ihrem Bexio-Konto findenhier. Die ID ist in der URL des Steuersatzes in der Detailansicht in bexio sichtbar. In diesem Beispiel ist die ID 13:

Versandart

Standardmäßig schreiben wir in Bexio eine eigene Position für die Versandkosten in die Rechnung und verwenden die Standardsteuer-ID 28. Dies kann jedoch in den Versandarteneinstellungen in Shopware geändert werden. Bitte sehen Sie sich die benutzerdefinierten Felder auf der Detailseite der Versandart an:

Hier können Sie die Bexio-Produkt-ID hinzufügen, um die Versandmethode einem Bexio-Produkt zuzuordnen, und auch die Steuernummer.

Bitte beachten Sie, dass die bexio-Produkt-ID die ID des Produkts in Bexio ist. Sie können die Produkt-ID in Ihrem bexio-Konto in der URL-Leiste finden, wenn Sie auf ein Produkt in der Produktliste klicken:

So können Sie den verschiedenen Bexio-Produkten unterschiedliche Versandmethoden zuordnen.

Begrüßung

Die App fügt den Anreden ein benutzerdefiniertes Feld hinzu, um Ihre Anreden den Bexio-Anreden zuzuordnen. Wenn die Bexio Anrede-ID ausgefüllt ist, verwendet die App diese Anrede-ID für die Rechnungserstellung.

In Shopware ist es ein neues benutzerdefiniertes Feld auf der Detailseite der Anrede:

In Bexio finden Sie die Anrede-IDs in der Einstellung Sie finden die Anrede-ID in Ihrem bexio-Konto in der URL-Leiste, wenn Sie auf eine Anrede in der Anredenliste klicken:

(fakultativ) Produkt-ID

Die App fügt den Produkten ein benutzerdefiniertes Feld hinzu, um Ihre Produkte den Bexio-Produkten zuzuordnen. Wenn die Bexio-Produkt-ID ausgefüllt ist, wird die App diese Produkt-ID für die Rechnungserstellung verwenden. Andernfalls erstellen wir einfach eine neue benutzerdefinierte Position. Der Unterschied ist unten dargestellt. In Bexio ist sie mit einem anderen Symbol gekennzeichnet.

Produkt-ID in Shopware

Es gibt ein neues benutzerdefiniertes Feld auf der Produktdetail-Seite:

Produkt-ID ist ausgefüllt

Produkt-ID ist nicht ausgefüllt

Wenn die Produkt-ID gesetzt ist, werden der Produktname und die Beschreibung von Bexio für die Rechnung verwendet und der produktname und -beschreibung aus Shopware werden ignoriert.

Bitte stellen Sie sicher, dass die Produkt-ID korrekt ist wenn Sie diese Funktion nutzen möchten. Andernfalls wird die Rechnungserstellung fehlschlagen.

Sie finden die Produkt-ID in Ihrem bexio-Konto in der URL-Leiste, wenn Sie auf ein Produkt in der Produktliste klicken:

In Zukunft werden wir möglicherweise die Verwendung der Produktnummer anstelle der Produkt-ID unterstützen.

FAQ

Was sollte ich überprüfen, wenn meine Bestellungen nicht übermittelt werden?

• Das Plugin ist installiert und aktiviert.
• Die API-Schlüssel sind korrekt (HINWEIS: Sie müssen alle 6 Monate neu generiert werden).
• Prüfen Sie in der Plugin-Konfiguration, ob der Toggle "Module Orders" aktiviert ist.
• Die in den Positionen einer Bestellung verwendeten Steuern haben eine korrekte Bexio-Steuer-ID.
• Für die in der Bestellung verwendete Zahlungsmethode wird die Checkbox "Bexio: Rechnung erstellen" aktiviert und eine gültige Bexio-Zahlungsmethode ausgewählt.