Kilometersätze importieren | Yokoy Help Center

🌐 Web | 👤 Admin mit Kilometersatz-Berechtigungen

Du kannst Kilometersätze mithilfe einer CSV-Datei importieren.

Die Importdatei für Kilometersätze ist eine Komma-getrennte CSV-Datei. Sie enthält verpflichtende sowie optionale Spalten, die beim Import vorhanden sein müssen – andernfalls schlägt der Import fehl. Alle Pflichtfelder müssen mit Werten befüllt sein. Zusätzliche Spalten, die nicht Teil des Standardformats sind, werden ignoriert.

So importierst Du einen Kilometersatz:

Gehe zu Admin > Fahrtpauschalen.
Klicke auf Datei importieren.
Lade bei Bedarf im Dialogfenster die Vorlage herunter.
Wähle das Unternehmen aus, lade Deine Datei hoch und klicke auf Import starten.
Nach Abschluss kannst Du den Status einsehen und einen Bericht mit Details zu erstellten, aktualisierten oder duplizierten Sätzen sowie etwaigen Fehlern herunterladen.

✏️ Hinweis
Yokoy unterstützt CSV-Dateien mit den folgenden Zeichencodierungen: UTF-8, UTF-16 und ISO/IEC 8859-1:1998 (Latin1).

Kilometersatz-Importdateien

Attribut	erforderlich	Beschreibung	Akzeptierte Werte
`id`		Der eindeutige Bezeichner des Kilometersatzes, der automatisch generiert wird, wenn dieses Feld leer bleibt. Wenn Du einen bestehenden Kilometersatz aktualisieren möchtest, musst Du diesen Wert angeben.	String / Null
`name`	Ja	Der Name des Kilometersatzes.	String
`categoryId`	Ja	Die Kategorie, mit der der Kilometersatz verknüpft werden soll. Dadurch wird sichergestellt, dass die Kilometer auf das richtige Steueraufwandskonto gebucht werden.	String
`mileageRateType`	Ja	Art des Kilometersatzes.	Normal / Gestuft
`rate`	Normal: Ja Gestuft: Nein	Wenn der Kilometersatz normal ist, dann gib den/die Satz/Sätze pro Kilometer oder Meile an.	Nummer
`description`	Ja	Füge bei Bedarf eine Beschreibung für den Kilometersatz hinzu.	String
`currency`	Ja	Gib die Währung ein, in der der Kilometersatz angezeigt wird.	String
`validityStartDate`	Nein	Lege ein Startdatum fest, ab dem der Kilometersatz aktiv ist (falls zutreffend).
`validityEndDate`	Nein	Lege ein Enddatum fest, bis zu dem der Kilometersatz aktiv ist (falls zutreffend).
`applicableCountries`	Nein	Lege fest, in welchen Ländern der Kilometersatz gültig ist.	ISO 3166-1 alpha-2 code
`applicableMinUserDistance`	Nein	Definiere die minimale Anzahl an Kilometern oder Meilen, die erforderlich ist, um den Kilometersatz zu aktivieren. Der Kilometerzähler auf Mitarbeiterebene wählt den korrekten Satz basierend auf dem kumulierten Gesamtwert des Mitarbeiters.	Number
`applicableMaxUserDistance`	Nein	Definiere die maximale Anzahl an Kilometern oder Meilen, die erforderlich ist, um den Kilometersatz zu aktivieren. Der Kilometerzähler auf Mitarbeiterebene wählt den korrekten Satz basierend auf dem kumulierten Gesamtwert des Mitarbeiters.	Number
`rates`	Normal: Nein Gestufte: Ja	Wenn der Kilometersatz gestuft ist, müssen alle Sätze mit ihren Schwellenwerten angegeben werden.	Objekt, Liste von Objekten
`rate`	Ja	Der/die Satz/Sätze pro Kilometer oder Meile. Der jeweils gültige Satz gilt bis zur nächsten Schwelle.	Nummer
`threshold`	Ja	Maximaler Schwellenwert der jeweiligen Satzstufe.	Nummer
`priority`	Nein	Priorisiere den Kilometersatz, indem Du eine Zahl zwischen 1 und 99 eingibst. Eine höhere Zahl bedeutet eine höhere Priorität. Dadurch kann Yokoy den passenden Kilometersatz automatisch einer Spesenabrechnung zuweisen.	Nummer
`distanceCutOff`	Nein	Wenn ein Schwellenwert für die Mindestentfernung angegeben ist, wird die Kilometerpauschale nur berechnet, wenn die pro Fahrt zurückgelegte Strecke größer als dieser Schwellenwert ist. Das bedeutet: Wenn die Strecke kürzer ist, erfolgt keine Auszahlung.	Nummer