> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spott.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Xero

> Verbinden Sie Xero, um Platzierungen aus Spott abzurechnen, mit synchronisierten Pay Codes, Rechnungskontakten und Rechnungsstatus.

Mit der Xero-Integration können Ihre Berater **Rechnungen für Platzierungen direkt in Spott
erstellen** und als Entwürfe an Xero senden. Ihr Finanzteam gibt sie dann wie gewohnt in
Xero frei, versendet sie und erfasst die Zahlung, und Spott verfolgt den Status jeder
Rechnung an der Platzierung.

Mit der Integration können Sie:

* **Ihre Xero-Artikel als Pay Codes nach Spott synchronisieren**, sodass Rechnungspositionen
  dieselben Codes, Preise und Beschreibungen verwenden wie in Xero.
* **Ein Spott-Unternehmen einmalig mit seinem Xero-Kontakt verknüpfen**, sodass jede künftige
  Rechnung an die richtige Rechnungsstelle geht.
* **Rechnungsentwürfe erstellen** aus Contingent-, Vertrags- und Retained-Platzierungen,
  auch Rechnungen auf Basis freigegebener Timesheets.
* **Auf einen Blick sehen**, welche Platzierungen abgerechnet sind, welche Rechnungen noch
  Entwürfe sind und welche bezahlt wurden.

Diese Seite behandelt die Einrichtung der Integration. Wie Sie Rechnungen erstellen und ihren
Status verfolgen, sobald sie in Xero sind, beschreibt
[Rechnungsstellung mit Xero](/de/docs/integrations/xero-invoicing). Freigabe, Versand und
Abgleich der Rechnungen erfolgen in Xero, nicht in Spott.

## Bevor Sie beginnen

Prüfen Sie, dass drei Dinge vorhanden sind, bevor Ihr Team seine erste Rechnung erstellt:

* **Ein Spott-Admin hat Xero verbunden.** Die Verbindung wird einmal für den gesamten
  Workspace hergestellt.
* **Ihre Xero-Artikel sind eingerichtet.** Spott importiert sie als Pay Codes, mit ihren
  Codes, Beschreibungen und Standardpreisen.
* **Ihre Rechnungskontakte existieren in Xero.** Jedes Spott-Unternehmen wird mit einem
  bestehenden Xero-Kontakt verknüpft. Xero-Kontakte lassen sich noch nicht aus Spott heraus
  anlegen, legen Sie fehlende also zuerst in Xero an.

## Ihre Xero-Organisation verbinden

1. Gehen Sie zu **Settings → Integrations** und wählen Sie **Xero**.
2. Verbinden Sie Ihr Xero-Konto und wählen Sie die Xero-Organisation, die verknüpft werden
   soll.
3. Prüfen Sie die Zeile der Organisation. Sie zeigt den Namen der verknüpften Organisation
   und **Connected**.

<Frame>
  <img src="https://mintcdn.com/spott-docs/YFFORp-1ZGFt73B8/images/integrations/xero-connected.webp?fit=max&auto=format&n=YFFORp-1ZGFt73B8&q=85&s=c7256f707f3fca708485d7cf8873412a" alt="Die Seite der Xero-Integration mit einer verbundenen Organisation und Manage pay codes" width="970" height="410" data-path="images/integrations/xero-connected.webp" />
</Frame>

<Note>
  Nur Workspace-Admins können diese Integration verbinden. Ein Xero-Konto ist erforderlich.
</Note>

## Pay Codes aus Xero synchronisieren

Pay Codes sind die Leistungen, die Sie abrechnen, etwa ein Honorar für eine Festanstellung
oder ein Stundensatz für Entwicklung. Sie stammen aus Ihren Xero-Artikeln.

1. Öffnen Sie auf der Seite der Xero-Integration **Manage pay codes**. Alternativ gehen Sie
   zu **Settings → Templates → Rate Card Templates → Pay Codes**.
2. Klicken Sie auf **Sync pay codes**, um die aktuellen Artikelcodes aus Xero zu importieren.
3. Importierte Codes erscheinen in der Liste mit dem Label **Xero** und ihrer Beschreibung.

Synchronisieren Sie erneut, sobald Ihr Finanzteam Artikel in Xero hinzufügt oder ändert.
Die Synchronisierung ist **einseitig**: Änderungen in Xero kommen in Spott an, aber Pay Codes,
die Sie in Spott anlegen, werden nicht an Xero gesendet.

<Tip>
  Sie können Pay Codes auch direkt in Spott mit **Create pay code** anlegen. Diese dienen nur
  der Erfassung, zum Beispiel wenn Sie Xero nicht nutzen. Verwenden Sie für alles, was Sie
  über Xero abrechnen, Xero-Pay-Codes.
</Tip>

### Einen Spott-Pay-Code nach Xero übernehmen

Wenn Sie einen Pay Code in Spott angelegt haben und ihn jetzt über Xero abrechnen möchten:

1. Legen Sie in Xero einen Artikel an, dessen Code **exakt** dem Spott-Pay-Code entspricht,
   einschließlich Groß- und Kleinschreibung und Leerzeichen. `OT` und `ot` gelten als
   unterschiedliche Codes.
2. Klicken Sie danach in Spott erneut auf **Sync pay codes**.

Spott verknüpft die beiden, und der Pay Code erhält das Label **Xero**. Alle Rate Cards und
Timesheets, die ihn bereits verwenden, funktionieren weiter.

### Beschreibungsvorlagen

Die Beschreibung eines Pay Codes wird zur Positionsbeschreibung auf der Rechnung. Statt
festem Text können Sie sie als Vorlage schreiben, die Angaben aus der Platzierung einsetzt.
Das funktioniert für jeden Pay Code, auch für die aus Xero synchronisierten: Öffnen Sie einen
Xero-Pay-Code in Spott und ergänzen Sie seine Beschreibung um Variablen.

1. Öffnen Sie einen Pay Code und klicken Sie in das Feld **Description**.
2. Tippen Sie `{` und wählen Sie eine Platzierungsvariable, etwa Vorname, Nachname,
   Unternehmen oder Startdatum.

So wird zum Beispiel `Placement of { First name } { Last name } at { Company }, starting { Start date }`
auf der Rechnung zu *Platzierung von John Doe bei Acme, Beginn am 2024-02-01*.

* Nur **Platzierungsvariablen** können verwendet werden.
* Eine Beschreibung ohne Variablen wird so übernommen, wie sie geschrieben ist.
* Deckt eine Rechnung mehrere Platzierungen ab, lassen sich die Variablen nicht ausfüllen,
  und die Position lautet **N/A**. Bearbeiten Sie diese Position vor dem Versand von Hand.

<Note>
  Ihre Vorlage wird nur in Spott gespeichert; der Artikel in Xero behält seine eigene
  Beschreibung. Sobald Sie die Beschreibung eines Pay Codes in Spott bearbeiten, überschreibt
  die Synchronisierung aus Xero sie nicht mehr. Um zur Xero-Beschreibung zurückzukehren,
  leeren Sie das Feld und synchronisieren Sie erneut.
</Note>

## Unternehmen mit Xero-Kontakten verknüpfen

Jedes Spott-Unternehmen wird über einen Xero-Kontakt abgerechnet. Sie können die Verknüpfung
vorab im Unternehmensdatensatz herstellen oder bei der ersten Rechnung an dieses Unternehmen.

1. Öffnen Sie das Unternehmen in Spott und klicken Sie auf **External Links**.
2. Klicken Sie auf das **+** neben **Xero**.
3. Wählen Sie den **Xero contact** aus dem Dropdown.

<video className="w-full rounded-xl" autoPlay muted loop playsInline controls preload="metadata" src="https://spott-media.b-cdn.net/docs/onboarding/v4/xero-link-contact.mp4" />

Nach der Verknüpfung geht jede Rechnung an dieses Unternehmen an denselben Xero-Kontakt, und
Sie werden nicht erneut gefragt. Prüfen Sie den Kontakt genau, bevor Sie bestätigen, denn die
Verknüpfung lässt sich in Spott nicht rückgängig machen.

<Card title="Ihre erste Rechnung erstellen" icon="file-invoice-dollar" href="/de/docs/integrations/xero-invoicing">
  **Rechnungsstellung mit Xero** führt durch die Abrechnung von Contingent-, Retained- und
  Vertragsplatzierungen, einschließlich Rate Cards und Timesheets, und zeigt, wie Sie den Status
  jeder Rechnung verfolgen, sobald sie in Xero ist.
</Card>
