transaction_fees-.csv

Template-Datei zum Herunterladen, hier klicken.

Beschreibung

Allgemeingültige Gebühren werden durch den Mercanto Support gepflegt. Mit transaction_fees.csv kann ein Lieferant davon abweichende, kundenspezifische Gebühren definieren.

Es gilt:

Kundenspezifische Gebühren überschreiben immer die allgemeingültigen Gebühren, sofern für den entsprechenden Gebührentyp (fee_type) vorhanden.
Pro Gebührentyp muss mindestens eine Grundgebühr (default_value) definiert werden.
Gebühren können absolut (in CHF) oder prozentual berechnet werden (logic).
Gebühren können gestaffelt werden: Bis zu vier Stufen (upper_bound_tier_1-4 / fee_tier_1-4) erlauben unterschiedliche Gebühren abhängig vom Bestell- oder Lieferwert.
Die Gebühr kann wahlweise pro Bestellung oder pro Lieferung berechnet werden (applies_to).
Optional kann die Gebühr auf eine bestimmte Lieferoption (delivery_method) eingeschränkt werden.

Abhängigkeiten zu anderen Datentypen:

customer_key muss einem Kunden bzw. einer Geschäftseinheit aus merchant_relationships.csv entsprechen.
delivery_method, falls angegeben, muss einer bei Mercanto hinterlegten Lieferoption entsprechen.

Verfügbare Spalten

Feld (* = Pflicht)	Beschreibung
`import_type` * String (enum)	Definiert, ob dieser Datensatz erstellt/aktualisiert oder gelöscht werden soll. Zulässige Werte: `create_update` oder `delete`
`customer_key` * String (100)	Eindeutige Kennung des Kunden aus Sicht des Lieferanten.
`fee_type` * String (enum)	Definiert den Gebührentypen der für diesen Kunden/diese Geschäftseinheit gültig ist. https://my.mercanto.ch/de/definierte-werte#gebuhrenart
`delivery_method` String (100)	Lieferoption für die der angegebene Gebührentyp gültig ist. Muss einer gültigen `delivery_method` entsprechen die durch Mercanto aufgesetzt wurde.
`logic` * String (enum)	Definiert, ob die Gebühr als Wert oder in Prozent gerechnet werden soll. Zulässige Werte: `single_value_threshold`, `single_value_threshold_percentage`
`applies_to` * String (enum)	Definiert, ob die Gebühr nur auf die Bestellung oder auf alle Lieferungen innerhalb einer Bestellung angewendet werden soll (bspw. mehrfache Berechnung von Liefergebühren in einer einzelnen Bestellung). Zulässige Werte: `order`, `delivery`
`upper_bound_tier_1` Integer (0, 10000000000)	Erste Obergrenze (Schwellenwert) bis zu welcher die Gebühr gültig ist. Preis in CHF.
`fee_tier_1` Integer (0, 10000000000)	Gebühr (in % oder CHF) die anfällt, wenn der dazugehörige `upper_bound_tier_1` nicht erreicht wird.
`upper_bound_tier_2` Integer (0, 10000000000)	Zweite Obergrenze (Schwellenwert) bis zu welcher die Gebühr gültig ist. Preis in CHF.
`fee_tier_2` Integer (0, 10000000000)	Gebühr (in % oder CHF) die anfällt, wenn der dazugehörige `upper_bound_tier_2` nicht erreicht wird.
`upper_bound_tier_3` Integer (0, 10000000000)	Dritte Obergrenze (Schwellenwert) bis zu welcher die Gebühr gültig ist. Preis in CHF.
`fee_tier_3` Integer (0, 10000000000)	Gebühr (in % oder CHF) die anfällt, wenn der dazugehörige `upper_bound_tier_3` nicht erreicht wird.
`upper_bound_tier_4` Integer (0, 10000000000)	Vierte Obergrenze (Schwellenwert) bis zu welcher die Gebühr gültig ist. Preis in CHF.
`fee_tier_4` Integer (0, 10000000000)	Gebühr (in % oder CHF) die anfällt, wenn der dazugehörige `upper_bound_tier_4` nicht erreicht wird.
`default_value` * Integer (0, 10000000000)	CHF-Angabe für die Grundgebühr des entsprechenden Typs.

Typischer Anwendungsfall: Ein Lieferant möchte für einen bestimmten Kunden eine reduzierte Liefergebühr definieren. Dazu wird eine Zeile mit customer_key, dem passenden fee_type, logic = Wertangabe, applies_to = delivery sowie der gewünschten Grundgebühr (default_value) angelegt.