Zum Hauptinhalt springen

Xero Integration für Spesen

Integriere Yokoy mit Xero, um Spesen automatisch in das Buchhaltungssystem zu exportieren.

Verfasst von Yokoy Team

Mit der Yokoy-Spesenintegration für Xero kannst Du Deine Workflows optimieren, indem Du die Datenflüsse im Spesenmanagement automatisierst, manuellen Aufwand reduzierst und eine korrekte Kontenzuordnung sicherstellst.

Mit dieser Integration kannst Du Xero-Tracking-Kategorien als Kostenstellen und Konten als Spesenkategorien in Yokoy importieren. Xero-Kontakte werden mit den Benutzern in Yokoy synchronisiert, sodass Änderungen an Namen oder Status automatisch in Yokoy aktualisiert werden.

Wenn Du geprüfte Spesen aus Yokoy exportierst, werden diese automatisch entsprechend in Xero verbucht:

Yokoy Spesentyp

Xero-Konzept

  • Privat bezahlte Spesen (erstattungsfähig Spesen)

  • Rechnungen

  • Gutschriften für privat bezahlte Spesen

  • Gutschrift-Rechnungen / Lieferantengutschriften

  • Firmenkarten-Transaktionen

  • Geld ausgeben-Banktransaktionen

  • Rückerstattungen von Firmenkarten-Transaktionen

  • Geld erhalten-Banktransaktionen

  • Reisespesen (von Geschäftsreise-Anbietern wie TravelPerk)

  • Geld ausgeben-Banktransaktionen

  • Gutschriften für Reisespesen

  • Geld erhalten-Banktransaktionen

Die Yokoy-Integration sendet den entsprechenden Steuersatz aus Yokoy, sodass die Steuerbeträge in Xero berechnet werden können.

Der Genehmigungsprozess für Spesen wird vollständig von Yokoy gesteuert – entweder über einen Standard-Workflow wie Kostenstellen- oder Vorgesetztenfreigabe oder über einen individuellen Workflow.

So funktioniert es

Die Yokoy-Integration für Xero ist eine API-basierte Integration, die Daten bidirektional austauscht. Tracking-Kategorien und Konten werden in Yokoy importiert und täglich synchronisiert. Benutzer, Firmenkarten und Steuersätze werden ebenfalls täglich synchronisiert, müssen jedoch zuerst manuell in Yokoy erstellt werden.

Sobald Spesen in Yokoy verarbeitet und für den Export freigegeben sind, werden sie nach Xero exportiert.

Wenn Du die Yokoy-Integration konfigurierst, musst Du Yokoy die folgenden Zugriffsrechte auf Xero gewähren:

Lesezugriff

Schreibzugriff

  • Unternehmensinformationen

  • Konten

  • Kontakte

  • Steuersätze

  • Tracking-Kategorien

  • Rechnungen

  • Anhänge

  • Spesen

  • Lieferantengutschriften

Mitarbeiter- & Buchhaltungs-Stammdaten

Die Yokoy-Integration für Xero ermöglicht es Dir, Mitarbeiter- und Buchhaltungs-Stammdaten aus Xero zur Verwendung in Yokoy zu synchronisieren. Die Daten werden auf Unternehmensebene und nicht für die gesamte Organisation synchronisiert.

Bei der erstmaligen Einrichtung der Integration muss das Yokoy-Team einen Synchronisationsjob konfigurieren, um Objekte in Yokoy zu erstellen oder zu aktualisieren. Sobald dieser eingerichtet ist, läuft der Job täglich und prüft auf Änderungen.

Du kannst die folgenden Datenobjekte aus Xero synchronisieren:

Ein eindeutiger Identifikator wird verwendet, um festzustellen, ob das entsprechende Objekt (z. B. Spesenkategorie, Kostenobjekt, Benutzer oder Steuersatz) bereits in Yokoy vorhanden ist. Wird es gefunden, versucht die Integration, das bestehende Objekt mit den Änderungen in den Daten zu aktualisieren.

Bei Konten und Tracking-Kategorien erstellt die Integration eine neue Kategorie oder ein neues Kostenobjekt in Yokoy, falls das entsprechende Objekt dort nicht gefunden wird. Bei anderen Stammdaten wie Steuersätzen, Firmenkarten und Benutzern müssen diese jedoch zuerst manuell in Yokoy angelegt werden.

In Yokoy werden nur bestimmte Werte aktualisiert, wenn Änderungen an diesen Objekten in Xero vorgenommen werden. Beispiel: Bei Steuersätzen wird nur der Status aktualisiert.

Spesenkategorien

Ein Spesenkonto wird eins-zu-eins einer Yokoy-Spesenkategorie zugeordnet.

Mit anderen Worten: Für jedes Spesenkonto kann nur eine Spesenkategorie erstellt werden.

Das Xero-Konto muss den Kontotyp Expense oder Bank haben und die Option

Show in Expense Claims muss aktiviert sein – ansonsten wird es von der Integration ignoriert.

Die Integration synchronisiert alle Änderungen an Konten und aktualisiert das entsprechende Objekt in Yokoy. Beispiel: Wenn Du ein Konto in Xero archivieren,

wird die entsprechende Spesenkategorie in Yokoy als inaktiv markiert und die Synchronisierung aktualisiert den Status der Kategorie entsprechend.

Wenn sich der Xero-Kontotyp in einen anderen Typ als Expense oder Bank ändert, werden weitere Änderungen am Xero-Konto nicht mehr mit der bestehenden Yokoy-Spesenkategorie synchronisiert.

Für weitere Details zu den mit Xero abgeglichenen Steuersatzdaten, siehe:

🚧 Vorsicht

Spesenkategorien können in Yokoy nicht manuell erstellt werden.

Wenn Du Spesenkategorien manuell anlegst und in Spesen verwendest,

können diese Spesen nicht exportiert werden. Die Integration verwendet

beim Synchronisieren der Kategorien mit Xero eine interne ID.

💡 Tipp

In Xero importierte Bankkonten, die als Spesenkategorien erscheinen, können nicht automatisch aus der Spesenübersicht ausgeblendet werden. Du kannst sie jedoch manuell ausblenden, indem Du Nicht sichtbar für Mitarbeiter auswählst.

Kostenobjekte

Yokoy-Kostenobjekte für das Kostencontrolling werden aus den Xero-Tracking-Kategorien erstellt. Die Integration synchronisiert alle Änderungen an Tracking-Kategorien und aktualisiert das entsprechende Objekt in Yokoy. Archivierte Tracking-Kategorien werden ebenfalls in die Synchronisierung einbezogen.

✏️ Hinweis
Du musst Kostenobjekt-Genehmiger manuell in Yokoy einrichten, da diese Information nicht aus Xero importiert wird.

Weitere Details zu den mit Xero abgeglichenen Kostenobjektdaten, siehe

🚧 Achtung

Kostenobjekte können in Yokoy nicht manuell erstellt werden.

Wenn Du Kostenobjekte manuell anlegst und in Spesen verwendest, können diese Spesen nicht exportiert werden. Die Integration verwendet beim Synchronisieren der Kostenobjekte mit Xero eine interne ID.

Benutzer

Benutzer müssen zuerst in Yokoy erstellt werden, bevor sie mit Xero-Kontakten abgeglichen werden können. Diese Benutzer werden über die E-Mail-Adresse mit Xero-Kontakten verknüpft. Deshalb ist es wichtig, dass die E-Mail-Adresse in Xero und Yokoy identisch ist, damit die Synchronisierung korrekt funktioniert.

Nach der Erstsynchronisierung musst Du die E-Mail-Adresse in Yokoy manuell aktualisieren, falls sich die E-Mail-Adresse eines Xero-Kontakts ändert,

damit der Benutzer weiterhin mit dem Xero-Kontakt „synchron“ bleibt.

Der Synchronisierungsjob kann Änderungen am Vorname, Nachname, Status und Contact ID des Benutzers aktualisieren. Wenn ein Kontakt in Xero nicht aktiv ist,

wird der Benutzer in Yokoy ebenfalls als inaktiv betrachtet, und die Synchronisierung aktualisiert den Benutzerstatus entsprechend.

Für weitere Details zu den mit Xero abgeglichenen Benutzerdaten, siehe

Steuersätze

Steuersätze müssen in Yokoy erstellt werden, bevor sie mit Xero abgeglichen werden können. Dabei muss der Xero-Steuersatzcode verwendet werden, damit der Synchronisierungsjob die entsprechenden Yokoy-Sätze korrekt identifizieren kann. Die Xero-Steuersatzcodes können über das Service-Request-Template angefordert werden.

Nach der Erstsynchronisierung musst Du den entsprechenden Steuersatz in Yokoy manuell aktualisieren, falls sich der Steuersatz in Xero ändert.

Der Synchronisierungsjob aktualisiert nur Änderungen am Status des Steuersatzes.

Mit anderen Worten: Wenn ein Steuersatz in Xero nicht aktiv ist, wird er in Yokoy ebenfalls als inaktiv betrachtet und der Synchronisierungsjob aktualisiert den Status des Steuersatzes entsprechend.

Für weitere Details zu den mit Xero abgeglichenen Steuersatzdaten, siehe

Firmenkarten

Wenn Dein Unternehmen Yokoy Platinum Visa-Karten oder eine andere Drittanbieter-Kartenintegration verwendet, müssen die Firmenkarten zuerst in Yokoy erstellt werden, bevor sie mit Xero verknüpft werden können. Diese Firmenkarten werden über den Code (Xero) / ERP-Code (Yokoy) mit den Xero-Kreditkartenkonten abgeglichen.

Nach der Erstsynchronisierung musst Du die entsprechenden Firmendaten in Yokoy manuell aktualisieren, wenn ein Kreditkartenkonto in Xero geändert wird.

Sobald die Einrichtung abgeschlossen ist, aktualisiert der Synchronisierungsjob nur Änderungen am Status des Xero-Kreditkartenkontos. Mit anderen Worten:
Wenn ein Kreditkartenkonto in Xero nicht aktiv ist, wird die Firmenkarte in Yokoy ebenfalls als inaktiv betrachtet und der Synchronisierungsjob aktualisiert den Status der Firmenkarte entsprechend.

Für weitere Details zu den mit Xero abgeglichenen Steuersatzdaten, siehe

Buchung von Finanztransaktionen (Spesen)

Die Yokoy-Integration exportiert Daten wie Mitarbeiterinformationen, Tracking-Kategorien, Konten, Steuerreferenz (für die Berechnung in Xero), Betrag und Währung.

Standardmäßig werden Spesendaten nur exportiert, wenn ein Finanzbenutzer in Finance > Export auf Exportieren klickt. Du kannst die Integration jedoch so konfigurieren, dass Spesen in regelmäßigen Abständen automatisch exportiert werden. Siehe Automatischen Export für Spesen einrichten.

Exportarten

Die folgenden Yokoy-Spesentypen werden unterstützt:

Privat bezahlte Spesen

Erstattungsfähige Spesen werden in Xero als approved Bills (genehmigte Rechnungen) exportiert. Yokoy-Gutschriften werden als Lieferantengutschriften im Status Entwurf nach Xero exportiert.

Die folgenden Spesendaten werden nach Xero exportiert:

Xero-Feld

Yokoy Spesendaten

Beschreibung

Typ

N/A

Wird an Xero gesendet als ACCPAY (Spese) oder ACCPAYCREDIT (Gutschrift).

Total

Spesen-Gesamttotal

Berechnung erfolgt vor dem Export zu Xero basierend auf Spesenwährung und Exportwährungskonfiguration.

Status

N/A

Wird an Xero gesendet als AUTHORISED (Spesen) oder kein Status (für Gutschriften).

Von (Kontakt)

Submitter

Interner Identifikator, der zur Zuordnung zum Xero-Benutzer verwendet wird.

Betrag
(pro Einzelposten)

Betrag pro Einzelposten

Berechnet über die Buchungslogik (Journal Entry) innerhalb von Yokoy.

Konto
(pro Einzelposten)

Kategorie pro Einzelposten

Kategorie (Header)

N/A

Xero zieht diese Daten basierend auf dem internen Identifikator, der im Kostenobjekt in Yokoy gespeichert ist.

Wert in der Kategorie-Spalte
(pro Einzelposten)

Kostenobjektname

Steuersatz
(pro Einzelposten)

Steuersatz

Gesamtsteuer (Berechnung in Xero)

N/A

Berechnung erfolgt in Xero basierend auf Betrag und übermitteltem TaxType (TaxType wird gemäß Steuersatz in Yokoy gesendet).

Referenz

N/A

Wird an Xero gesendet als leere Zeichenkette.

Datum

Veröffentlichungs

datum

Währungsbetrag

N/A

Logik erfolgt über die Buchungslogik innerhalb von Yokoy, basierend auf Spesenwährung und Exportwährungskonfiguration.

Fälligkeitsdatum

Spesendatum

Der anzuwendende Steuersatz für privat bezahlte Spesen hängt davon ab, ob es sich um eine Gutschrift handelt oder nicht.

  • Bei privat bezahlten Spesen wird der auf dem Konto hinterlegte Standardsteuersatz in der Rechnung durch den von Yokoy übermittelten Steuersatz überschrieben.

  • Bei Gutschriften wird der von Yokoy übermittelte Steuersatz ignoriert. Stattdessen wird der auf dem Xero-Konto hinterlegte Standardsteuersatz verwendet.

Kartenspesen und Reisespesen

Mit Firmenkarte bezahlte Spesen sowie Reisespesen werden als Spend Money Bank Transactions exportiert, da in Xero für diese Transaktionen keine Zahlung generiert wird. Rückerstattungen von Firmenkarten- und Reisespesen werden als Receive Money Bank Transactions exportiert.

Firmendatenkarten

Die Daten für mit Firmenkarte bezahlte Spesen werden wie folgt nach Xero exportiert:

Xero-Daten

Spesen gezahlt durch Firmenkarte

Beschreibung

Konto (Typ: BANK, Kontotyp: KREDITKARTE)

Firmenkarte

Interner Identifikator zur Zuordnung zum Xero-Kreditkartenkonto.

Datum

Spesendatum

Spend vs. Receive Money

N/A

Die Geschäftslogik hängt davon ab,

ob es sich bei der Spese um eine Gutschrift handelt oder nicht. Handelt es sich um eine reguläre Spese, wird SPEND an Xero übermittelt, bei einer Gutschrift hingegen RECEIVE.

Zu

Submitter

Interner Identifikator, der zur Zuordnung zum Xero-Benutzer verwendet wird.

Betrag (pro Einzelposten)

Betrag pro Einzelposten

Berechnung über die Buchungslogik (Journal Entry) innerhalb von Yokoy.

Konto (pro Einzelposten)

Kategorie pro Einzelposten

Kategorie (Header)

N/A

Xero zieht diese Daten basierend auf dem im Kostenobjekt gespeicherten internen Identifikator.

Wert in der Kategorie-Spalte (pro Einzelposten)

Kostenobjekt-Name

Steuersatz (pro Einzelposten)

Steuersatz

Stückpreis (pro Einzelposten)

Nettobetrag (pro Einzelposten)

Berechnet über die Buchungslogik (Journal Entry) innerhalb von Yokoy.

Gesamtsteuer (Berechnung in Xero)

N/A

Berechnung in Xero basierend auf Betrag und übermitteltem TaxType (gemäß TaxType in Yokoy).

Referenz

N/A

Wird an Xero gesendet als empty string (leere Zeichenkette).

Betragswährung

N/A

Business-Logik über die Buchungslogik innerhalb von Yokoy, basierend auf Spesenwährung und Exportwährungskonfiguration.

Reisespesen-Daten

Die Daten für Spesen, die mit einer Geschäftsreiseanbieter-Integration verbunden sind, werden wie folgt nach Xero exportiert:

Xero-Daten

Spesen-Daten des Reiseanbieters

Beschreibung

Konto (Typ: BANK, Kontotyp: BANK)

Transferkonto (konfiguriert in der Geschäftsreise-Anbieter-Konfiguration)

Der im Transferkonto aus der Geschäftsreiseanbieter-Konfiguration gespeicherte Wert wird genutzt, um einer Spesenkategorie im ERP-Code in Yokoy zugeordnet zu werden.

Datum

Spesendatum

Spend vs Receive Money

N/A

Die Geschäftslogik hängt davon ab,

ob es sich bei der Reisespese um eine Gutschrift handelt oder nicht. Handelt es sich um eine reguläre Spese, wird SPEND an Xero übermittelt, bei einer Gutschrift hingegen RECEIVE.

Zu

Submitter

Interner Identifikator, der zur Zuordnung zum Xero-Benutzer verwendet wird.

Betrag (pro Einzelposten)

Betrag pro Einzelposten

Berechnet über die Buchungslogik (Journal Entry) innerhalb von Yokoy.

Konto (pro Einzelposten)

Kategorie pro Einzelposten

Kategorie (Header)

N/A

Xero zieht diese Daten basierend auf dem im Kostenobjekt gespeicherten internen Identifikator.

Wert in der Kategorie-Spalte (pro Einzelposten)

Kostenobjekt-Name

Steuersatz (pro Einzelposten)

Steuersatz

Stückpreis (pro Einzelposten)

Nettobetrag (pro Einzelposten)

Berechnet über die Buchungslogik (Journal Entry) innerhalb von Yokoy.

Gesamtsteuer (Berechnung in Xero)

N/A

Berechnung in Xero basierend auf Betrag und übermitteltem TaxType (gemäß TaxType in Yokoy).

Referenz

N/A

Wird an Xero gesendet als empty string (leere Zeichenkette).

Betragswährung

N/A

Geschäftslogik über die Buchungslogik innerhalb von Yokoy, basierend auf Spesenwährung und Exportwährungskonfiguration.

Währungsbehandlung

Abhängig von der in den Unternehmenseinstellungen festgelegten Buchungsstrategie exportiert die Yokoy-Integration Spesen entweder in:

  • Unternehmenswährung

  • Ursprünglicher Belegwährung

  • Benutzerwährung

Steuerbeträge

Yokoy übermittelt die ausgewählten Steuersätze im Spesen-Datenexport an Xero – Xero berechnet anschließend die Steuer basierend auf diesen Angaben.

Handhabung von Gutschriften

  • Gutschriften für erstattungsfähige Spesen (d. h. privat bezahlte Spesen) werden beim Export wie reguläre Spesen behandelt; sie erscheinen in Xero jedoch als Lieferantengutschrift im Status Entwurf.

  • Gutschriften für nicht erstattungsfähige Spesen (d. h. mit Firmenkarte bezahlte Spesen) werden ebenfalls wie reguläre Spesen exportiert; sie erscheinen in Xero jedoch als Banktransaktion Geldeingang.

Spesenbelege und unterstützende Dokumente

Spesenbelege und alle an die Spesen angehängten Dateien als unterstützende Dokumente können bei Bedarf an Xero übermittelt werden. In der Yokoy-Integration kannst Du konfigurieren, ob nur Belege, alle Dokumente (Belege und Anhänge) oder keine Dokumente übertragen werden sollen.

Belege und unterstützende Dokumente werden in Xero in der Spalte Datei angezeigt. Du kannst diese Dateien in der Vorschau ansehen, indem Du auf die Datei klickst. Des Weiteren sind sie auch in der Ansicht View Bill (Rechnung anzeigen) sichtbar, wenn Du auf das Dateisymbol klickst.

View Bill in Xero where you can find the expense receipt as an attachment

Der Rechnungsverlauf enthält die Aktion Attached the file through the Xero API using Yokoy Business App. (Datei über die Xero-API mit der Yokoy Business App angehängt).

✏️ Hinweis

In Yokoy behalten als Dateien hochgeladene Belege den ursprünglichen Dateinamen. Dateien, die als unterstützende Dokumente hochgeladen werden, werden mit dem Zeitstempel des Uploads umbenannt.

Xero lehnt alle Dateien ab, deren Dateinamen die Zeichen <, >, :, ", /, \, |, ?, *, \0 enthalten. Daher entfernt die Integration diese Zeichen, falls sie im Dateinamen vorkommen. Beispiel: 2025-08-22T10:00:09.953Z-1.png wird zu 2025-08-22T100009.953Z-1.png.


Hat dies deine Frage beantwortet?