merchant_relationships-.csv

Template-Datei zum Herunterladen, hier klicken.
Ausgefüllte Beispiel-Datei zum Herunterladen, hier klicken.

Beschreibung

Mit merchant_relationships.csv werden die Geschäftseinheiten (Business Units) eines Kunden verwaltet - z. B. der Hauptsitz, einzelne Filialen oder Geschäftsbereiche. Jede Geschäftseinheit erhält hier ihre eigene Adresse sowie kundenspezifische Einstellungen wie Lieferoptionen, Liefergruppe oder Preisgruppe.

Es gilt:

Wird ein Kunde erstmals eingeladen, müssen customer_invitations.csv und merchant_relationships.csv immer gemeinsam importiert werden. Die Kundennummer (customer_key) aus customer_invitations.csv muss dabei hier als company_customer_key wiederverwendet werden.
Die Firma selbst muss zusätzlich als eigene Geschäftseinheit erfasst werden – d. h. es braucht mindestens eine Zeile, in der customer_key demselben Wert wie company_customer_key entspricht.
Sollen nur bestehende Geschäftseinheiten angepasst werden (z. B. Adresse, Lieferoptionen oder Preisgruppe), genügt ein alleiniger Import von merchant_relationships.csv – eine neue Einladung ist dafür nicht nötig.
Pro Geschäftseinheit können bis zu drei Lieferoptionen bzw. Liefergruppen (delivery_method_1-3, delivery_group_1-3) hinterlegt werden. Werden mehr als drei benötigt, kontaktiert der Lieferant den Mercanto Support.

Abhängigkeiten zu anderen Datentypen:

company_customer_key muss einem customer_key aus customer_invitations.csv entsprechen.
price_group_key kann in products_prices.csv als price_group referenziert werden, um kundenspezifische Preise zu ermöglichen.

Verfügbare Spalten

Feld (* = Pflicht)	Beschreibung
`company_customer_key` * String (100)	Entspricht der Kundennummer aus der Datei `customer_invitations.csv`. Dies ist der eindeutige Schlüssel, um zu erkennen, welche Datensätze zu welcher Firma gehören
`customer_key` * String (100)	Eindeutige Kennung des Kunden/der Geschäftseinheit aus Sicht des Lieferanten.
`name` * String (100)	Name der Geschäftseinheit.
`active` boolean (0, 1)	Definiert ob die Kundenbeziehung aktiv ist oder nicht, wobei `1` = aktiv und `0` = inaktiv ist. Inaktive Kunden können keine Bestellungen absetzen. default = `1`
`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
`street` * String (100)	Strasse des Kunden/der Geschäftseinheit des Kunden.
`street_additional` String (100)	Strasse (Zusatz) des Kunden/der Geschäftseinheit des Kunden.
`postal_code` * String (10)	PLZ des Kunden/der Geschäftseinheit des Kunden.
`city` * String (100)	Ort des Kunden/der Geschäftseinheit des Kunden.
`country_code` * String (enum)	Land des Kunden/der Geschäftseinheit des Kunden. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#landercode
`delivery_method_1` String (100)	Wenn für den Kunden nur spezifische Lieferoptionen gelten sollen, können diese hier eingetragen werden. Bleibt das Feld leer, gelten für den Kunden alle bestehenden Lieferoptionen. Wenn eine Liefergruppe ausgefüllt ist, muss zwingend eine Lieferoption angegeben werden.
`delivery_group_1` String (100)	Liefergruppe zu der der Kunde/die Geschäftseinheit zugehörig ist.
`delivery_method_2` String (100)	Siehe `delivery_method_1`.
`delivery_group_2` String (100)	Siehe `delivery_group_1`.
`delivery_method_3` String (100)	Siehe `delivery_method_1`.
`delivery_group_3` String (100)	Siehe `delivery_group_1`.
`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.

Typischer Anwendungsfall: Ein Lieferant lädt „Bäckerei Muster AG“ neu ein (customer_invitations.csv) und legt gleichzeitig zwei Geschäftseinheiten an: eine für den Hauptsitz (customer_key = company_customer_key) und eine weitere für eine Filiale mit eigener Adresse und eigenen Lieferoptionen.