Invoicing

lexoffice

Introduction

lexoffice is a powerful billing integration. Easy creation of invoices, contacts and offers makes running a business piece of cake. hostware can directly sync all contacts + invoices into lexoffice, directly connecting it with your billing software.

Installation

  • Please install the module and activate it for the sales channels you want to use. Attention: The current active synchronizer will be deactivated for the given sales channel. (Past invoices can still be viewed from remote)

  • Go to the module configuration. Get your lexoffice API key from lexoffice settings. To use the lexoffice API, you need the biggest plan (XL) After creation of the API key, copy it into the module settings.

  • Finished! hostware now syncs future invoices directly into your lexoffice.

Was wird synchronisiert?

Die lexoffice-Integration synchronisiert folgende Daten:

  • Kontakte: Kunden und Kontaktdaten werden automatisch synchronisiert

  • Rechnungen: Neue Rechnungen werden direkt in lexoffice erstellt

Zahlungsstatus

Rechnungen, die in lexoffice als bezahlt oder storniert gebucht werden, erkennt hostware nach wenigen Minuten automatisch und aktualisiert den lokalen Rechnungsstatus sowie die hinterlegte Zahlung.

Anpassungen an dem Inhalt der Rechnung in lexoffice werden nicht zu hostware übernommen. Die Rückwärtssynchronisation betrachtet hierbei nur den Status und die Zahlungen.

Wenn eine Rechnung in hostware als bezahlt markiert wird, ändert sich der Status in lexoffice nicht automatisch.

Externe Rechnungen, die direkt in lexoffice erstellt werden, werden ebenfalls automatisch nach hostware importiert, sofern der Kundenkontakt bereits existiert. Weitere Informationen finden Sie unter Import von externen Rechnungen.

Troubleshooting

Invoice was not created automatically in lexoffice

Hostware evaluates unsynced invoices for automatic sync every five minutes. You normally do not need to start this yourself.

An invoice is only eligible for automatic sync when all of the following are true:

  • The invoice status is not DRAFT, WAIT_FOR_INPUT, or CANCELLED.

  • If the invoice is prepaid, it has already been paid.

If an invoice is eligible but still has not synced, or it shows a sync error, you can trigger it manually from the invoice detail view. See Invoices for details.

Lexoffice payment status is not reflected in hostware

Wait a few minutes. Hostware checks lexoffice continuously and reflects status changes such as paid or voided after a short delay.

There are performance limits: in each five-minute window, hostware checks only the last 20 invoices by change date. If you change more than 20 invoices at once, some updates may be delayed.

Also remember that content edits made in lexoffice never sync back to hostware. Only status and payment changes are considered.

No invoice email after a credit reload

Credit top-up invoices are created in an open state. Hostware defers the invoice email until the top-up is actually paid.

After payment is received, Hostware sends the invoice email automatically, updates the paid status locally, and then syncs the invoice to lexoffice if it meets the regular sync criteria.

If the customer expects an email immediately after requesting a top-up, this is expected — the email is sent after payment, not at creation.

Rounding differences on B2B invoices

When the lexoffice setting "E-Rechnungen für Kunden mit Unternehmen erzeugen?" is enabled, the lexoffice API requires net prices with a maximum of two decimal places. Because of this limitation, rounding differences can occur when converting gross amounts to net prices.

For example, a gross amount of 9,99 € may result in a net price that rounds to 9,98 € on the invoice. This is a known limitation of the lexoffice API and not a bug in hostware.

Street or address changes do not appear in Lexoffice

Hostware syncs customer contacts, including addresses, to Lexoffice automatically. If a recent street or address change in Hostware has not appeared in Lexoffice, verify that the change was saved in the Hostware customer profile.

Changes made directly in Lexoffice do not sync back to Hostware. If you edit an address in Lexoffice, Hostware will overwrite it on the next contact sync if the Hostware customer profile still holds the old value.

Was this helpful?