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 |
|
|
|
|
|
|
|
|
|
|
|
|
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 |
|
|
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:
Xero Daten | Yokoy Daten |
Benutzer (existierende)* | |
Steuersätze (existierende)* | |
Firmenkarten (existierende)* |
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:
Erstattungsfähige Spesen (d. h. privat bezahlte Spesen)
Kartenspesen (d. h. nicht erstattungsfähige Spesen außer Reisekosten)
Reisespesen (d. h. Spesen von Geschäftsreise-Anbietern wie z. B. TravelPerk)
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 |
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 |
Von (Kontakt) | Submitter | Interner Identifikator, der zur Zuordnung zum Xero-Benutzer verwendet wird. |
Betrag | Betrag pro Einzelposten | Berechnet über die Buchungslogik (Journal Entry) innerhalb von Yokoy. |
Konto | 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 | Kostenobjektname |
|
Steuersatz | Steuersatz |
|
Gesamtsteuer (Berechnung in Xero) | N/A | Berechnung erfolgt in Xero basierend auf Betrag und übermitteltem |
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: | 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 |
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 |
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: | 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 |
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 |
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.
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.

