Import Kontakt

JSON-REST Endpunkt für die Übernahme von Webshop-Kontakten.

Zweck

Der Endpunkt übernimmt Kontaktdaten aus dem Webshop in den Kontakt-Importcontainer von Business Central.

Endpunkt

  • Methode: POST
  • URL-Muster: http://<server>:<odata-port>/<service-tier>/api/BEterna/Import/v2.0/companies(<company-system-id>)/webshopContacts

Pflichtparameter

  • webshopChannel im Payload
  • JSON-Body mit Kontaktkopf

Kernbereiche der Payload

  • Kontaktkopf: Kanal, Kontaktnummer, Name, Adresse, Sprache, Land, Kommunikationsdaten
  • Optionale Zusatzfelder wie Anrede, Vor-/Nachname, Firmenname
  • Kontaktzeilen (webshopcontactLines) für Ship-to-bezogene Informationen

Antwortverhalten

  • Die API liefert den übernommenen Datensatz als JSON zurück.
  • Mit $expand=webshopcontactLines können die Kontaktzeilen in der Response mitgeliefert werden.

Ergebnis

  • Der Webshop-Kontakt ist für die weitere Verarbeitung in BC bereitgestellt.