merchant_relationship

Beispiel-Datei in gitlab.

Beschreibung

Damit eine Zuordnung von customer_invitation und merchant_relationship erfolgen kann, muss sichergestellt sein, dass der gleiche customer_key in beiden Objekten definiert ist. Es ist daher vorteilhaft, wenn die Datentypen customer_invitation und merchant_relationship in einer Datei zusammengefasst werden, siehe auch in der Beispiel-Datei.

In Fällen, wo Gebühren anfallen und diese pro Kunde unterschiedlich sind oder es für gewisse Kunden Abweichungen zu den Standardgebühren gibt, sind diese mit den Kundendaten mittels transaction_fees im Datentyp merchant_relationship pro customer_key mitzugeben.

Bei den Gebühren stehen folgende Möglichkeiten zur Verfügung:

Auswahl von verschiedenen Gebührentypen.
Gebühr kann absolut oder prozentual definiert werden.
Gebühren können gestaffelt werden (Betragsobergrenzen).
Es muss pro Gebührentyp im Minimum eine Grundgebühr definiert werden.
Die Gebühr kann pro Bestellung oder pro Lieferung definiert werden (Hinweis: In Mercanto kann es pro Bestellung mehrere Liefertermine geben).

Verfügbare Felder

Feld (* = Pflicht)	Beschreibung
`customer_key` * String (100)	Eindeutige Kennung des Kunden aus Sicht des Lieferanten.
`label` String (100)	Kunden-lesbare Kennung des Kunden aus Sicht des Lieferanten (im Normalfall gleich wie der `customer_key`).
`active` boolean (true, false)	Definiert ob die Kundenbeziehung aktiv ist oder nicht. Nicht-aktive Kunden können keine Bestellungen absetzen. default = `true`.
`customer_type` String (enum)	Wird zu statistischen Zwecken verwendet, um Bestellungen und Umsätze von Stammkunden von denen zu trennen, die von Testnutzern oder von eigenen Mitarbeitern des Lieferanten verursacht werden. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#kundentyp
`delivery_address/street` * String (100)	Strasse des Kunden/der Geschäftseinheit des Kunden.
`delivery_address/` `street_additional` String (100)	Strasse (Zusatz) des Kunden/der Geschäftseinheit des Kunden.
`delivery_address/` `postal_code` * String (10)	PLZ des Kunden/der Geschäftseinheit des Kunden.
`delivery_address/city` * String (100)	Ort des Kunden/der Geschäftseinheit des Kunden.
`delivery_address/` `country_code` * String (enum)	Land des Kunden/der Geschäftseinheit des Kunden. Zulässige Werte: `CH`, `LI`
`delivery_methods/` `delivery_method` String (100)	Lieferoption die für den Kunden/die Geschäftseinheit verfügbar sein soll. Muss einer gültigen `delivery_method` entsprechen die durch Mercanto aufgesetzt wurde.
`delivery_methods/` `delivery_group` String (100)	Liefergruppe zu der der Kunde/die Geschäftseinheit zugehörig ist.
`price_group_key` String (100)	Preisgruppe zu der der Kunde/die Geschäftseinheit zugehörig ist.
`product_list_group` String (100)	Produktlistengruppe zu der der Kunde/die Geschäftseinheit zugehörig ist.
`transaction_fees/` `fee_type` String (enum)	Definiert den Gebührentypen der für diesen Kunden/diese Geschäftseinheit gültig ist. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#gebuhrenart
`transaction_fees/` `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.
`transaction_fees/` `fee_model/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`
`transaction_fees/` `fee_model/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`
`transaction_fees/` `fee_model/` `value_reference` String (enum)	Definiert, welche Summe als Schwellenwert herangezogen werden soll. Zulässige Werte: `order_total`, `delivery_total`
`transaction_fees/` `fee_model/fee_tiers/` `upper_bound` Integer (0, 10000000000)	Obere Grenze für die entsprechende Gebührenstufe. ACHTUNG: CHF Preise in JSON-Files müssen mit Faktor 100'000 multipliziert werden.
`transaction_fees/` `fee_model/fee_tiers/` `percentage` Integer (0, 10000000000)	%-Angabe für die entsprechende Gebührenstufe. ACHTUNG: CHF Preise in JSON-Files müssen mit Faktor 100'000 multipliziert werden.
`transaction_fees/` `fee_model/fee_tiers/` `fee` Integer (0, 10000000000)	CHF-Angabe für die entsprechende Gebührenstufe. ACHTUNG: CHF Preise in JSON-Files müssen mit Faktor 100'000 multipliziert werden.
`transaction_fees/` `fee_model/default_fee` Integer (0, 10000000000)	CHF-Abgabe für die Grundgebühr des entsprechenden Typs. ACHTUNG: CHF Preise in JSON-Files müssen mit Faktor 100'000 multipliziert werden.