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.
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
IsReconciledfestlegen. 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.
| 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.