customer_invitations-.csv

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

Beschreibung

Mit customer_invitations.csv lädt ein Lieferant einen neuen Kunden zu Mercanto ein. Diese Datei liefert die Firmen- und Kontaktdaten; die Kundennummern mit den dazugehörigen Geschäftseinheiten (Business Units) werden separat in merchant_relationships.csv definiert.

Für jede Einladung müssen zwingend mitgegeben werden:

Firma: Übergeordnete Kundennummer (customer_key) - aus merchant_relationships.csv gleicher Wert wie company_customer_key, Firmenname (company_name) und Rechtsform (legal_form)
Kontaktperson: Vorname (first_name), Nachname (last_name) und E-Mail-Adresse (email)

Ergänzend gilt:

Die UID (uid) kann optional mitgegeben werden. Sie ist für das Kundenmatching hilfreich, da sich damit einfacher feststellen lässt, ob die Firma bereits auf Mercanto besteht.

Abhängigkeit zu merchant_relationships.csv (zwingend):

Eine neue Kundeneinladung besteht immer aus beiden Dateien gemeinsam: customer_invitations.csv und merchant_relationships.csv. Die Kundennummer (customer_key) aus dieser Datei muss in merchant_relationships.csv als company_customer_key verwendet werden.
Die Firma selbst muss dabei zwingend auch als eigene Geschäftseinheit in merchant_relationships.csv erfasst werden (dort: customer_key = company_customer_key).
Sollen lediglich bestehende Geschäftseinheiten angepasst werden (z. B. Adresse oder Lieferoptionen), genügt ein alleiniger Import von merchant_relationships.csv – eine erneute Einladung ist dafür nicht nötig.

Verfügbare Spalten

Feld (* = Pflicht)	Beschreibung
`customer_key` * String (100)	Eindeutige Kennung des Kunden aus Sicht des Lieferanten.
`company_name` * String (100)	Name des Kunden.
`uid` String (100)	UID des Kunden.
`legal_form` * String (enum)	Rechtsform des Kunden. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#rechtsform
`email` * String (email)	E-Mail-Adresse der Kontaktperson. Wird benötigt, um die Zugangsdaten zu versenden.
`first_name` * String (100)	Vorname der Kontaktperson.
`last_name` * String (100)	Nachname der Kontaktperson.
`language_code` String (enum)	Sprache der Kontaktperson (Emails aus Mercanto werden in der hier übergebenen Sprache verschickt). Zulässige Werte: `de_CH`, `fr_CH`, `it_CH`, `en_GB`

Typischer Anwendungsfall: Ein Lieferant gewinnt einen neuen Kunden, „Bäckerei Muster AG“, und lädt diesen über eine Zeile mit Firmenname, Kundennummer, Rechtsform sowie den Kontaktdaten der zuständigen Ansprechperson zu Mercanto ein (gemeinsam mit einer passenden Zeile in merchant_relationships.csv).