customer_invitation
Beispiel-Datei in gitlab.
Beschreibung
Dieser Datentyp dient dazu, einen Kunden auf Mercanto einzuladen.
Es gilt:
- Es braucht die Angabe zur Firma, mindestens bestehend aus einer Kundennummer (
customer_key) und einem Firmennamen (company_name), welche mit der UID (uid) und der Rechtsform (legal_form) ergänzt werden können. Insbesondere die UID ist für das Kundenmatching wichtig, da so einfacher identifiziert werden kann, ob die Firma bereits auf Mercanto besteht. - Es muss pro Firma angegeben werden, wer die Kontaktperson ist, bestehend aus Vorname (
first_name), Name (last_name) und E-Mail Adresse (email). - Es muss pro Firma angegeben werden, welche Geschäftseinheiten (
business_units) zu dieser Firma gehören. Einer Firma kann dabei eine beliebige Anzahl an Geschäftseinheiten zugeordnet werden. - Geschäftseinheiten können Filialen, Subunternehmen oder auch Geschäftsbereiche sein.
- Diejenige Kundennummer (
customer_key), welche der Firma zugewiesen wurde, muss gleichzeitig immer auch als Business Unit erfasst werden.
Verfügbare Felder
| 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 |
business_units/customer_key * String (100) | Eindeutige Kennung der Geschäftseinheit aus Sicht des Lieferanten. |
business_units/parent_customer_keyString (100) | Kennung der Geschäftseinheit die dieser Geschäftseinheit vorsteht (bspw. im Falle eines Hauptsitzes und Zweigniederlassungen/Filialen). |
business_units/name * String (100) | Name der Geschäftseinheit. |
contact_person/email * String (email) | E-Mail-Adresse der Kontaktperson. Wird benötigt, um die Zugangsdaten zu versenden. |
contact_person/first_name * String (100) | Vorname der Kontaktperson. |
contact_person/last_name * String (100) | Nachname der Kontaktperson. |
contact_person/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 |