Overview

Bexio Shopware Integration

This Shopware 6 app connects your Shopware 6 shop with Bexio. As of now, we support creating Bexio invoices based on new orders in your shop as well as syncing customer data from your shop to Bexio with each order.

Installation

To install the app, please visit the Shopware Store and add the app to your shop. You can find the plugin here. Once installed, make sure to activate the App in your Shopware backend.

Configuration

Please check out our guide to configure the app correctly.

Order to invoice sync

With every new order, we check if the payment method is configured to create a new invoice in Bexio. If yes, we create a new invoice in Bexio with the order data. (See configuration for details).

Invoice status

The invoice status in Bexio is updated based on the order status in Shopware.

Pending

The invoice status is set to "pending" by default when a new order is created.

Paid

Once the payment status of an order in Shopware is set to "paid", we change the invoice status in Bexio to "paid" as well.

Cancelled

If an order is cancelled in Shopware, the corresponding invoice in Bexio is also cancelled.

Manual invoice creation

The app provides a functionality that allows users to manually transmit invoices to Bexio for individual orders. This option is available both on the order detail page and within the order list view (after selecting orders for bulk editing). Please note: This mode overrides the invoice transmission settings defined in both the payment methods and the main application configuration. In this mode, an invoice will always be generated, regardless of the configured settings.

Invoice payment status sync

The app provides an option in its settings to enable a daily synchronization of invoice payment statuses with Bexio. When this option is enabled, the app performs a daily check of orders with a pending payment status. If an invoice is marked as paid in Bexio, the corresponding order in Shopware will also be marked as paid. Similarly, if an invoice is marked as cancelled in Bexio, the app will update the Shopware order to reflect a cancelled payment status.

Contact sync and duplicate check

With every order, we sync the customer data to Bexio. If the customer is a company, we create a new company contact in bexio as well as a new contact person and connect them.

Duplicate check

We do a simple duplicate check. For companies, we check if the company name with the same city already exists in Bexio. For private customers, we check if the first name, last name and email address already exists in Bexio. If they already exist, we update them. If they don't exist, we create them during the invoice creation.

Taxation logic (available on from app version 1.0.13)

The app respects the taxation settings defined in Shopware 6 customer groups, as well as the billing address country configuration. Depending on the "Tax display" setting assigned to the customer group in Shopware, pricing is transmitted to Bexio differently. Three scenarios can be distinguished:

1. Order from a customer with "Gross" tax display in the Shopware customer group
   The invoice in Bexio is generated with the gross order value, and applied taxes are displayed on the invoice. Each line item is shown with a gross price.

2. Order from a customer with "Net" tax display in the Shopware customer group and the "Tax free" option disabled for the billing country
   The invoice in Bexio is generated with the gross order value, and applied taxes are displayed on the invoice. Each line item is shown with a net price.

3. Order from a customer with "Net" tax display in the Shopware customer group and the "Tax free" option enabled for the billing country
   The invoice in Bexio is generated with the net order value, and no taxes are displayed. However, if the total order value is lower than the threshold defined in the "Tax free from" setting, the invoice is generated as described in case 2.

Logging

We log the most important events in the Shopware logs. You can find them in the Shopware backend under "Settings" -> "System" -> "Event logs". Please check them if you encounter any issues.

FAQ

Why is the invoice for order X missing in Bexio?

A few things to check:

• Plugin is installed and activated.
• The API keys are correct.
• In the configuration, the module "Orders" is enabled.
• The default tax ID in app setting is configured wrongly.
• The taxes used in the line items of an order have a correct Bexio tax id.
• The payment method used in the order has the checkbox "Bexio: create invoice" enabled and valid Bexio payment type is selected.

Request a feature or report a bug

Please open a support ticket with your account at account.shopware.com and provide as much details as possible. We will get back to you as soon as possible.