Authentication

Kunden suchen

Einen Kunden anlegen

Um einen Kunden anzulegen, brauchst Du folgende Werte, die Du Dir vorab über die API abholen kannst.

• Die salesChannelId des Verkaufskanals, an den der Kunde gebunden werden soll.
• Die customerGroupId der Kundengruppe, an den der Kunde gebunden werden soll.
• Die customerNumber, also die Kundennummer, die für den neuen Kunden vergeben werden soll
• Die countryId des Landes, welche mit der Rechnungsadresse des Kunden verknüpft wird.
• Die salutationId für die Anrede des Kunden
• Die defaultPaymentMethodId, die Du über den Verkaufskanal herausfinden kannst (jedem Verkaufskanal ist eine Standard-Zahlart zugeordnet)

Darüber hinaus benötigst Du die interne mpnId des Kunden, welchen den Kunden mit dem MPN System verknüpft

Einen Kunden updaten

Um einen Kunden zu updaten, musst Du die Kunden ID in der URL mit angeben und die PATCH Methode verwenden.

Blockierte Annstalten updaten

Um die blockierte Anstalten eines Kunden zu updaten, nutzen wir die `sync` API.

Einzelne Anstalten blockieren

Einzelne Anstalten von der Blockliste entfernen

Den kompletten Satz an blockierten Anstalten neu einspielen

Wir Du oben vielleicht schon gesehen hast, kann die Sync API mehrere Aktionen im Body übergeben bekommen. Eine Kombination aus einer DELETE Aktion und einer UPSERT Aktion erlaubt es uns, mit einer Anfrage den kompletten Satz der blockierten Anstalten eines Kunden neu einzuspielen.

Kundengruppen auflisten

Customer Context

Der Kunden Kontext kann schon vor der Kunden Authentifizierung erzeugt werden:

Kunden Login (via Store API)

Der Kunde kann über die Store API authentifiziert werden

Kunden Login über die MPN ID (via Admin API)

Der Kunde kann über die Admin API authentifiziert werden

Die nächste Nummer eines Nummernkreises abrufen

Unterstützte Entitäten für Nummernkreise sind

• product
• customer

Entferne den Suffix ?preview=true, um diese Nummer tatsächlich zu reservieren.

Verkaufskanäle auflisten

Anreden auflisten

Länder auflisten

Einen Warenkorb erzeugen

Einen Vollbemusterung Warenkorb erstellen

Einen existierenden Warenkorb abrufen

Eine Bestellung erzeugen

Bezahlprozess initiieren

Initialisiere den Bezahlprozess über diesen Endpunkt

Bezahlprozess abschließen

Nachdem der Bezahl-Anbieter den Kunden zurück sendet, rufe diesen Endpunkt auf, um den Bezahlprozess abzuschlißen

Die Inhalte einer Bestellung anzeigen

Über diesen Endpunkt werden die IDs aller Anstalten und Gruppen zurück gegeben, die Teil einer Bestellung waren. Die Inhalte werden angezeigt, unabhängig davon ob die Bestellung vollständig bezahlt wurde oder nicht.

Die Inhalte einer Kampagne anzeigen

Über diesen Endpunkt werden die Inhalte einer Kampagne zurück gegeben. Die Inhalte enthalten allerdings NUR Anstalten und Bestellungen die einen abgeschlossenen Bestellstatus haben.

Die Bestellhistorie eines Kunden anzeigen

Über diesen Endpunkt wird die Bestell-Historie eines Kunden angezeigt.

Ein Dokument downloaden

Über diesen Endpunkt kannst Du ein Dokument des Kunden downloaden.

Verfügbare Sprachen

Verfügbare Zahlmethoden anzeigen

Zahlarten über die Admin-API suchen

Bitte beachte, dass bei der Admin API alle Zahlarten, die im System hinterlegt sind, zurück gegeben werden. Wenn Du nur Zahlarten auflisten möchtest, die für den Verkaufskanal freigeschaltet sind, nutze die Store-API

Das Eltern-Produkt aller Anstalten finden

Ein Produkt anhand einer MPN ID finden

Ein Produkt anlegen

Um ein Produkt anzulegen brauchst Du:

• Die parentId des Produktes. Dies ist die ID des Eltern-Produktes aller Anstalten (siehe oben)
• Die Produkt-Nummer des Produktes, die über den Nummernkreis generiert werden kann

Darüber hinaus kannst Du die mpnId angeben, welche das Produkt mit dem MPN System verknüpft

Ein Produkt updaten

Um ein Produkt upzudaten brauchst Du:

• Die MPN ID der Anstalt / des Verbundes
• Die ID der mpn_product_data Entität, die mit dem Produkt verknüpft ist. Du erhältst die ID, wenn das Produkt über die API aufrufst (siehe "Ein Produkt anhand einer MPN ID finden"). Die MPN ID findest Du in der Response unter "data.extensions.mpnData.id".

Das Eltern-Produkt aller Verbünde finden

Einen Verbund anhand einer MPN ID finden

Einen Verbund anlegen

Um ein Verbund anzulegen brauchst Du:

• Die parentId des Verbundes. Dies ist die ID des Eltern-Produktes aller Verbünde (siehe oben)
• Die Produkt-Nummer des Verbundes, die über den Nummernkreis generiert werden kann

Als ID gilt die MPN-ID

Einen Verbund updaten

Um die assoziierten Anstalten eines Verbundes zu updaten, nutzen wir die `sync` API.

Einzelne Anstalten hinzufügen

Einzelne Anstalten entfernen

Den kompletten Satz an assoziierten Anstalten neu einspielen

Wir Du oben vielleicht schon gesehen hast, kann die Sync API mehrere Aktionen im Body übergeben bekommen. Eine Kombination aus einer DELETE Aktion und einer UPSERT Aktion erlaubt es uns, mit einer Anfrage den kompletten Satz der Anstalten eines Verbundes neu einzuspielen.