Integrieren Sie Xero mit Perk für Ausgaben

Die Xero-Integration für Perk automatisiert den Datenfluss im Ausgabenmanagement zwischen Perk und Xero. Sie importiert Stammdaten (Konten, Erfassungskategorien, Steuersätze, Kontakte) von Xero nach Perk und exportiert genehmigte Ausgaben und Gutschriften von Perk nach Xero. Der Genehmigungsprozess für Ausgaben verbleibt vollständig in Perk.

Rolle: Kontoadministratoren können Einrichtungsaufgaben durchführen.

Informationen zur Konfiguration der Integration finden Sie unter Einrichten der Xero-Integration für Perk-Ausgaben. Informationen zu fehlgeschlagenen Exporten und Importen finden Sie unter Beheben von Problemen mit der Xero-Integration für Perk-Ausgaben.

Was die Integration bewirkt

Die Xero-Integration für Perk sorgt dafür, dass Ihre Ausgabendaten zwischen den beiden Systemen synchronisiert bleiben, sodass Ihr Finanzteam mit einer einzigen, verlässlichen Datenquelle arbeitet. Perk ruft Referenzdaten aus Xero ab und überträgt abgeschlossene Ausgaben zurück, während der Genehmigungsprozess vollständig in Perk abläuft.

  • Import (Xero zu Perk): Kontenplan, Tracking-Kategorien, Steuersätze und Kontakte.
  • Export (Perk zu Xero): Genehmigte Ausgaben und Gutschriften. Der Xero-Datensatz hängt von der Zahlungsart der Ausgabe ab:
    • Privat bezahlte (erstattungsfähige) Ausgaben: genehmigte Rechnungen.
    • Privat bezahlte Gutschriften: Genehmigte Lieferantengutschriften.
    • Firmenkarten- und Reisekosten: Ausgaben Banktransaktionen.
    • Firmenkarten und Reisegutschriften: Geldtransaktionen empfangen.

Pro Perk-Unternehmen (juristische Person) kann nur ein Xero-Mandant verknüpft werden. Die Verbindungen werden unternehmensspezifisch hergestellt, sodass für jedes Unternehmen mit mehreren Firmen eine separate Konfiguration erforderlich ist.

Hinweis: „Perk-Konto“ bezeichnet Ihre oberste Kundeneinheit in Perk. „Xero-Konto“ oder „Hauptbuchkonto“ bezeichnet ein Konto in Ihrem Xero-Kontenplan.

Wie Perk- und Xero-Daten abgebildet werden

Xero-Daten Karten zu Perk Anmerkungen
Xero-Konto (Kontenplan) Ausgabenkategorie Es können alle Xero-Kontotypen importiert werden (Ausgaben, Bank, Einnahmen, Vermögen, Verbindlichkeiten, Sonstige).
Xero-Tracking-Kategorie Kostenobjekt oder benutzerdefiniertes Feld Die Auswahl erfolgt pro Kategorie während der Einrichtung. Xero unterstützt bis zu zwei Tracking-Kategorien.
Xero-Steuersatz Steuersatz für Perk Importiert mit Namen, Prozentangabe und Umsatzsteuer-Identifikationsnummer.
Xero-Kontakt Perk-nutzer Die Zuordnung erfolgt per E-Mail. Der Benutzer muss bereits bei Perk vorhanden sein.
Xero-Kreditkartenkonto Firmenkreditkarte Die Firmenkarte muss zuerst in Perk erstellt werden.

Eine Ausgabenkategorie ist die Kategorie, in der eine Ausgabe in Perk kodiert wird. Ein Kostenobjekt ist ein Wert, den Mitarbeiter bei der Kodierung einer Ausgabe auswählen; er steuert die Kostenverteilung und den Genehmigungsprozess. Ein Benutzerdefiniertes Feld speichert eine sekundäre Klassifizierung der Ausgabe.

Für die Integration werden folgende Berechtigungen in Xero benötigt:

  • Lesen Sie: Konten, Firmeninformationen, Kontakte, Artikel, Anhänge, Tracking-Kategorien, Steuersätze.
  • Schreiben Sie: Rechnungen, Konten, Anhänge, Ausgaben, Lieferantengutschriften.

Wenn Sie detaillierte technische Informationen darüber erhalten möchten, wie die einzelnen Felder in Perk zugeordnet sind, lesen Sie bitte den Abschnitt „Datenaustausch (technische Feldzuordnung)“ am Ende dieses Artikels.

So funktioniert die Synchronisierung

Nach dem ersten Import bleiben Xero und Perk nahezu in Echtzeit synchronisiert. Änderungen in Xero werden Perk in der Regel innerhalb von Sekunden über Webhooks erreicht. Ein nächtlicher Abgleich um 00:00 Uhr UTC erfasst alle Änderungen, die die Webhooks nicht erfasst haben. Jede Synchronisierung ist eine Delta-Synchronisierung: Es werden nur die in Xero geänderten Datensätze berücksichtigt. Ausgaben werden manuell oder automatisch in Echtzeit nach Xero exportiert.

Da die Synchronisierung auf Delta-Werten basiert, werden Änderungen, die in Xero nicht erfasst werden, nicht übernommen. Beispiel: Das Hinzufügen eines Perk-Nutzers, dessen Xero-Kontakt bereits existiert, führt nicht zu einer Zuordnung, da sich am Kontakt nichts geändert hat. Weitere Informationen finden Sie im Artikel „Hinzufügen neuer Mitarbeiter nach der Einrichtung“.

Datentyp Abgeholt Nicht abgeholt Aktualisierte Attribute Nicht aktualisiert
Rechnungen Neues Konto (wird automatisch importiert, wenn Sie den gesamten Kontotyp ausgewählt haben); Umbenennen; Konto in den Importeinstellungen abgewählt (wird in Perk inaktiv). Konto in Xero gelöscht oder archiviert (bleibt in Perk aktiv, bis Sie es deaktivieren). Ein neues Konto in einem Typ, bei dem Sie einzelne Konten ausgewählt haben (manuell hinzufügen). Name; aktiver/inaktiver Status. ERP-Code in Perk bearbeitet (Export verwendet eine interne ID).
Tracking-Kategorien Neuer Optionswert unter einer zugeordneten Kategorie; Kategorie oder Option umbenannt. Kategorie oder Option in Xero gelöscht oder archiviert. Nach der Einrichtung wurde eine neue Tracking-Kategorie hinzugefügt (gehen Sie zu Importeinstellungen > Bearbeiten, um sie zuzuordnen). Name; Optionswerte. Der Zuordnungstyp (Kostenobjekt vs. benutzerdefiniertes Feld) wird bei der Einrichtung festgelegt. Die Genehmiger für Kostenobjekte werden in Perk manuell festgelegt.
Steuersätze Neuer aktiver Tarif (wird immer automatisch importiert); Tarif abgewählt, gelöscht, deaktiviert oder archiviert; Namens- oder Prozentänderung. Keine. Es wurde eine Streichung des Steuersatzes festgestellt. Name; Bewertung; Status. Keiner.
Nutzer (Kontakte) Neuer Xero-Kontakt, der mit der E-Mail-Adresse eines Perk-Nutzers übereinstimmt; jede Änderung an einem bestehenden Kontakt (Übereinstimmung wird neu bewertet); Kontakt deaktiviert (Nutzer wird inaktiv). Neuer Perk-Nutzer, dessen Xero-Kontakt bereits existiert und sich nicht geändert hat (beliebiges Feld des Kontakts bearbeiten, um die Zuordnung auszulösen). Nutzer werden nicht aus Xero erstellt. Vorname; Nachname; Status; Kontakt-ID. E-Mail (Abgleichsschlüssel; beide Seiten manuell aktualisieren). Genehmigungslimits, Linienvorgesetzte, Standardkostenobjekte (in Perk festgelegt).

Gut zu wissen

  • Gelöschte oder archivierte Xero-Daten werden nicht erkannt. Das Löschen oder Archivieren eines Kontos oder einer Tracking-Kategorie in Xero deaktiviert nicht die zugehörige Ausgabenkategorie, das Kostenobjekt oder das benutzerdefinierte Feld in Perk. Deaktivieren Sie diese manuell. Ausgaben, die einem in Xero gelöschten Konto zugeordnet sind, können nicht exportiert werden. Löschungen von Steuersätzen werden erkannt.
  • Manuell erstellte Datensätze haben keine Xero-Verknüpfung. Ausgabenkategorien, Kostenobjekte und benutzerdefinierte Felder, die manuell in Perk erstellt wurden, werden nicht rückwärts zugeordnet. Exporte mit einer manuellen Kategorie oder einem manuellen Kostenobjekt schlagen fehl; der Wert eines manuell erstellten benutzerdefinierten Felds wird beim Export nicht berücksichtigt.
  • Karten- und Reisekosten werden als nicht abgeglichen verbucht. Xero erstellt Ausgaben für Bankgeschäfte immer als nicht abgeglichen, und nur Apps der API-Kategorie „Konvertierung“ (einmalige Migration) können IsReconciled festlegen. Xero stellt nicht abgeglichene Kontoauszugsdaten auch nicht über seine öffentliche API bereit. Gleichen Sie diese Transaktionen manuell in Xero ab. Dies ist das erwartete Verhalten von Xero und kein Integrationsfehler.
  • Lieferantenrechnungen. Der Export von Perk-Lieferantenrechnungen nach Xero wird nicht unterstützt.

Datenaustausch (technische Feldzuordnung)

Stammdaten (Xero zu Perk)

Nutzer

Perk-Nutzer werden mit Xero- Kontakten synchronisiert. Der Nutzer muss zunächst in Perk vorhanden sein. Die E-Mail-Adresse dient als eindeutiger Identifikator und muss in beiden Systemen identisch sein. Ändert sich die E-Mail-Adresse eines Xero-Kontakts, muss sie auch in Perk aktualisiert werden.

Xero-Kontaktdaten Perk-Nutzerdaten Beschreibung
E-Mail-Adresse E-Mail-Adresse Eindeutiger Identifikator während der Synchronisierung.
Name Vorname Xero Name am ersten Leerzeichen geteilt.
Name Nachname Xero Name am letzten Leerzeichen geteilt.
Kontaktstatus Status In Xero gelöschte oder archivierte Einträge werden in Perk inaktiv.

Steuersätze

Die Steuersätze für Zusatzleistungen werden mit den Steuersätzen von Xero synchronisiert. Bei ausgewählten (automatisch synchronisierten) Sätzen werden Name, Satz und Status beim nächsten Durchlauf aktualisiert.

Xero-Steuersatzdaten Daten zum Steuersatz für geldwerte Vorteile Beschreibung
Name Name Wird bei der nächsten Synchronisierung aktualisiert, falls sich etwas ändert.
Code Perk ERP-Code Eindeutiger Identifikator während der Synchronisierung.
Gesamtsteuersatz oder effektiver Steuersatz Steuersatz Prozentualer Zinssatz. Verwenden Sie den höheren Zinssatz, falls beide in Xero verwendet werden.
Status Status Aktiv bei der ersten Synchronisierung. In Xero gelöschte, deaktivierte oder archivierte Einträge werden in Perk inaktiv. Das Abwählen eines Tarifs in den Importeinstellungen deaktiviert diesen ebenfalls.

Firmenkarten

Perk-Firmenkarten werden mit Xero -Konten vom Typ „Bank“ und „Kreditkarte“ synchronisiert. Die Karte muss zuvor in Perk angelegt sein. Nach der Einrichtung werden in Perk nur Statusänderungen des Xero-Kreditkartenkontos aktualisiert.

Xero-Kreditkartendaten Daten der Firmenkreditkarte Beschreibung
Status Status In Xero gelöschte Einträge werden in Perk deaktiviert.
Bankkontonummer Gläubigernummer Eindeutiger Identifikator während der Synchronisierung.

Kostenobjekte (Erfassungskategorien)

Eine als Kostenobjekt zugeordnete Tracking-Kategorie wird mit einem Perk-Kostenobjekt synchronisiert. Aktive Kategorien werden als aktiv, archivierte als inaktiv importiert. Jede Option wird als Kostenobjektwert importiert; neue Optionen einer zugeordneten Kategorie werden beim nächsten Synchronisieren importiert.

Xero-Tracking-Kategoriedaten Daten zum Kostenobjekt für Zusatzleistungen Beschreibung
Name Name Name der Tracking-Kategorie.
Name der Option Kostenobjektwert Ein Wert pro Option.
Status Status Löschungen und Archivierungen in Xero werden nicht erkannt.

Benutzerdefinierte Felder (Tracking-Kategorien)

Eine als benutzerdefiniertes Feld zugeordnete Tracking-Kategorie erzeugt ein neues, entsprechend benanntes Perk-Feld. Jede Option wird als Wert importiert.

Xero-Tracking-Kategoriedaten Daten des benutzerdefinierten Perk-Felds Beschreibung
Name Name des benutzerdefinierten Felds Es wird ein neues benutzerdefiniertes Feld erstellt, das nach der Kategorie benannt ist.
Name der Option Wert des benutzerdefinierten Felds Ein Wert pro Option.
Status Status Inaktivität in Xero bedeutet Inaktivität in Perk. Löschungen und Archivierungen werden nicht erkannt.

Ausgabenkategorien (Konten)

Xero-Konten werden den Ausgabenkategorien von Perk zugeordnet. Sie wählen die zu importierenden Konten während der Einrichtung aus. Beim ersten Synchronisieren werden nur aktive Konten importiert. Ein umbenanntes Konto wird beim nächsten Synchronisieren aktualisiert. Der Export erfolgt über eine interne ID, nicht über den ERP-Code.

Xero-Kontodaten Daten zu Ausgabenkategorien für Vergünstigungen Beschreibung
Name Name Der Kontoname.
Code Perk ERP-Code Kundenspezifischer Code, zum Beispiel 200 oder SALES.
AccountID Intern verwendet Eindeutiger Identifikator während der Synchronisierung.
Status Status Wenn ein Konto in den Importeinstellungen abgewählt wird, wird es deaktiviert. Löschungen und Archivierungen in Xero werden nicht erkannt.

Export (Vorteil für Xero)

Privat bezahlte Ausgaben

Erstattungsfähige Ausgaben werden als genehmigte Rechnungen exportiert. Gutschriften werden als genehmigte Lieferantengutschriften exportiert.

Hinweis: Bei Ausgaben überschreibt der von Perk übermittelte Steuersatz den Standardsteuersatz des Xero-Kontos in der Rechnung. Bei Gutschriften wird der von Perk übermittelte Steuersatz ignoriert und der Standardsteuersatz des Xero-Kontos verwendet.
Xero-Feld Daten zu Vergünstigungsausgaben Beschreibung
Typ n / A ACCPAY (Ausgabe) oder ACCPAYCREDIT (Gutschrift).
Summe Gesamtkostenanspruch Berechnet vor dem Export aus der Ausgabenwährung und der Exportwährungskonfiguration.
Status n / A AUTHORISED.
Von (Kontakt) Submitter Interne Kennung, die dem Xero-Benutzer zugeordnet ist.
Betrag pro Position Betrag (pro Position) Berechnet über die Journalbuchungsfunktion in Perk.
Konto (pro Position) Kategorie pro Position
Kategorie (Überschrift) n / A Xero bezieht diese Information je nach Zuordnung aus der internen Kennung des Kostenobjekts oder des benutzerdefinierten Felds.
Wert in der Spalte „Kategorie“ (pro Position) Name des Kostenobjekts
Steuersatz (pro Position) Steuersatz
Gesamtsteuer n / A Berechnet in Xero aus Betrag und TaxType.
Referenz Spesen-ID Aufwands-ID für Vergünstigungen.
Beschreibung (pro Position) Händlername
Datum Veröffentlichungsdatum
Betrag Währung n / A Basierend auf der Konfiguration der Ausgabenwährung und der Exportwährung.
Fälligkeitsdatum Rechnungsdatum

Kartentransaktionen

Firmenkartentransaktionen werden als Geld ausgeben-Banktransaktionen exportiert. Kartengutschriften werden als Geld erhalten exportiert.

Xero-Daten Daten zu Vergünstigungsausgaben Beschreibung
Konto (Typ BANK, Kontotyp KREDITKARTE) Firmenkarte Interne Kennung, die dem Xero-Kreditkartenkonto zugeordnet ist.
Datum Rechnungsdatum
Geld ausgeben vs. Geld erhalten n / A SPEND für reguläre Ausgaben, RECEIVE für Gutschriften.
Bis Submitter Interne Kennung, die dem Xero-Benutzer zugeordnet ist.
Betrag pro Position Betrag (pro Position) Berechnet über die Journalbuchungsfunktion.
Konto (pro Position) Kategorie pro Position
Kategorie (Überschrift) n / A Aus dem Kostenobjekt oder dem benutzerdefinierten Feldbezeichner.
Wert in der Spalte „Kategorie“ (pro Position) Name des Kostenobjekts
Steuersatz (pro Position) Steuersatz
Einzelpreis (pro Position) Nettobetrag (pro Position) Berechnet über die Journalbuchungsfunktion.
Gesamtsteuer n / A Berechnet in Xero.
Referenz Spesen-ID
Beschreibung (pro Position) Händlername
Betrag Währung n / A Basierend auf der Konfiguration der Ausgabenwährung und der Exportwährung.

Reisekosten

Reisekosten werden als Geld ausgeben-Banktransaktionen exportiert. Reisegutschriften werden als Geld erhalten exportiert. Gleiche Felder wie bei Kartenzahlungen, außer dem Konto:

Xero-Daten Daten zu Vergünstigungsausgaben Beschreibung
Konto (Typ BANK, Kontotyp BANK) Transferkonto (Konfiguration des Reiseanbieters) Der Wert des Transferkontos ist in Perk einem ERP-Code für Ausgabenkategorien zugeordnet.

Währung und Steuern

Je nach Buchungsstrategie in den Unternehmenseinstellungen exportiert Perk jede Ausgabe in Unternehmenswährung, Originalwährung des Belegs oder Benutzerwährung. Perk übermittelt den ausgewählten Steuersatz, und Xero berechnet die Steuer.

War dieser Beitrag hilfreich?