Custom Shop Integration

Verknüpfe dein individuelles Shop-System mit JUNE, um relevante Daten zu synchronisieren

Niclas Mai avatar
Verfasst von Niclas Mai
Vor über einer Woche aktualisiert

Folge den untenstehenden Schritten, um dein individuelles Shop-System in JUNE zu integrieren. So kannst du Daten austauschen und alle Funktionen von JUNE nutzen.

Die eingehenden Daten werden in der JUNE Automation verarbeitet und in die JUNE Customer Data Plattform übertragen.

Für folgende Shop-Systeme bieten wir Plug-and-play Lösungen an:

Neuen Customer erstellen

Bevor die E-Commerce Daten an JUNE übertragen werden, sollte in der jeweiligen E-Commerce-Liste zuerst ein neuer Datensatz erstellt werden (➡️ So erstellst du Datensätze via REST API), damit die E-Commerce Daten diesem Customer zugewiesen und dadurch in Liste angezeigt werden.
Die Zuweisung der Daten erfolgt über das Feld email.

E-Commerce Data

Um E-Commerce Data zu übertragen, müssen die Daten aus deinem Shop-System an unsere JUNE RestAPI übermittelt werden:

Customer Data Update

Nutze den folgenden Payload, um Kundendaten einzupflegen oder zu aktualisieren.

Methode: POST

{
"id": <string>,
"email": <string>,
"customer": {
"firstname": <string>,
"lastname": <string>,
"store_id": <string>,
"locale": <string>,
"geo_location": {
"city": <string>,
"country": <string>
},
"guest": <boolean>
}
}

Beispiel:

{
"id": "989b2165281d7ff9302887fd2d9f9580",
"email": "info@juneapp.com",
"customer": {
"firstname": "William",
"lastname": "Taylor",
"store_id": "4c87afc269af469cae2478e3f4c95fab",
"locale": "en-GB",
"geo_location": {
"city": "London",
"country": "United Kingdom"
},
"guest": false
}
}

Erforderliche oder optionale Angaben?

  • Customer ID: erforderlich

  • Customer Email: erforderlich, wenn die ID noch nicht festgelegt wurde

  • Customer Info

    • First Name: optional

    • Last Name: optional

    • Store ID: optional

    • Locale: optional

    • Geo Location

      • City: optional

      • Country: optional

  • Guest: wird auf "false" gesetzt, wenn keine Daten angegeben werden


Order Created

Nutze den folgenden Payload, um eingehende Bestellungen einzupflegen oder zu aktualisieren.

Methode: POST

{  
"id": <string>,
"email": <string>,
"order": {
"id": <String>,
"created_at": <String (yyyy-MM-dd'T'HH:mm:ss.SSSZ)>,
"total": <Number>,
"shipping": <Number>,
"voucher": <String>,
"products": [ <Array>
{
"id": <String>,
"name": <String>,
"image": <String (URL)>,
"qty": <Number>,
"price": <Number>,
"category": [ <Array>
<String 1>,
<String 2>,
<String 3>
],
"link": <String (URL)>
}
]
}
}

Beispiel:

{
"id": "989b2165281d7ff9302887fd2d9f9580",
"email": "info@juneapp.com",
"order": {
"id": "96b0ac4b3ef2486ddsf6c0d34",
"created_at": "2023-10-05T16:47:21+00:00",
"total": 99.99,
"shipping": 0,
"voucher": 0,
"products": [
{
"id": "26b0ac4b3ef2486d976c0d57",
"name": "Summer Shirt Men",
"image": "http://yoururl.com/shirt_600x600.jpg",
"qty": 1,
"price": 19.99,
"category": [
"Catalogue #1",
"Clothing",
"Men"
],
"link": "https://yoururl.com/26b0ac4b3ef2486d976c0d57"
}
]
}
}

Erforderliche oder optionale Angaben?

  • Customer ID: erforderlich

  • Customer Email: erforderlich, wenn die ID noch nicht festgelegt wurde

  • Order ID: erforderlich

  • Created At: erforderlich

  • Total: erforderlich

  • Shipping: optional

  • Voucher: optional

  • Products

    • Product ID: erforderlich

    • Name: erforderlich

    • Image: optional

    • Quantity (Qty): erforderlich

    • Price: erforderlich

    • Category: optional

    • Link: erforderlich


Fulfillment Update

Nutze den folgenden Payload, um Lieferungen einzupflegen oder zu aktualisieren.

Methode: POST

{
"id": <string>,
"email": <string>,
"fulfillment": {
"id": <String>,
"created_at": <String (yyyy-MM-dd'T'HH:mm:ss.SSSZ)>,
"total": <Number>,
"shipping": <Number>,
"voucher": <String>,
"tracking_code": <String>,
"products": [ <Array>
{
"id": <String>,
"name": <String>,
"image": <String (URL)>,
"qty": <Number>,
"price": <Number>,
"category": [ <Array>
<String 1>,
<String 2>,
<String 3>
],
"link": <String (URL)>
}
]
}
}

Beispiel:

{
"id": "989b2165281d7ff9302887fd2d9f9580",
"email": "info@juneapp.com",
"fulfillment": {
"id": "96b0ac4b3ef2486ddsf6c0d34",
"created_at": "2023-10-05T16:47:21+00:00",
"total": 19.99,
"shipping": 0,
"voucher": 0,
"tracking_code": "",
"products": [
{
"id": "26b0ac4b3ef2486d976c0d57",
"name": "Summer Shirt Men",
"image": "http://yoururl.com/shirt_600x600.jpg",
"qty": 1,
"price": 19.99,
"category": [
"Catalogue #1",
"Clothing",
"Men"
],
"link": "https://yoururl.com/26b0ac4b3ef2486d976c0d57"
}
]
}
}

Die Bestellung muss bereits im System verfügbar sein, bevor ein Fulfillment gepflegt werden kann.

Erforderliche oder optionale Angaben?

  • Customer ID: erforderlich

  • Customer Email: erforderlich, wenn die ID noch nicht festgelegt wurde

  • Order ID: erforderlich

  • Created At: erforderlich

  • Total: erforderlich

  • Shipping: optional

  • Voucher: optional

  • Tracking Code: optional

  • Products

    • Product ID: erforderlich

    • Name: erforderlich

    • Image: optional

    • Quantity (Qty): erforderlich

    • Price: erforderlich

    • Category: optional

    • Link: erforderlich


Cart Update

Nutze den folgenden Payload, um aktuelle Warenkorb-Status einzupflegen oder zu aktualisieren. Mit diesen Daten können dann unter anderem automatisierte Prozesse eingerichtet werden, um Kunden eine E-Mail zu senden (z. B. abgebrochene Warenkörbe).

Methode: POST

{
"id": <string>,
"email": <string>,
"cart": {
"action": "update",
"products": [ <Array>
{
"id": <String>,
"name": <String>,
"image": <String (URL)>,
"link": <String (URL)>,
"qty": <Number>,
"price": <Number>,
"category": [ <Array>
<String 1>,
<String 2>
]
}
]
}
}

Beispiel:

{
"id": "989b2165281d7ff9302887fd2d9f9580",
"email": "info@juneapp.com",
"cart": {
"action": "update",
"products": [
{
"id": "26b0ac4b3ef2486d976c0d575075734b",
"name": "Summer Shirt Men",
"image": "http://yoururl.com/shirt_600x600.jpg",
"link": "https://yoururl.com/26b0ac4b3ef2486d976c0d57",
"qty": 1,
"price": 19.99,
"category": [
"Catalogue #1",
"Clothing",
"Men"
]
}
]
}
}

Dieser Payload überträgt den aktuellen Warenkorb in JUNE. Mit diesen Daten können dann automatisierte Prozesse eingerichtet werden, um beispielsweise Kunden eine E-Mail zu senden (z. B. abgebrochene Warenkörbe).

Erforderliche oder optionale Angaben?

  • Customer ID: erforderlich

  • Customer Email: erforderlich, wenn die ID noch nicht festgelegt wurde

  • Action: erforderlich

  • Products

    • Product ID: erforderlich

    • Name: erforderlich

    • Image: optional

    • Quantity (Qty): erforderlich

    • Price: erforderlich

    • Category: optional

    • Link: erforderlich


Token erstellen

Um einen Token in JUNE zu erstellen, folge bitte diesen Schritten:

  1. Gehe in deine E-Commerce-Liste, indem du über die linke Menüleiste zu Automation navigierst.

  2. Wähle nun die gewünschte Liste aus.

  3. Wähle in der oberen Menüleiste E-Commerce Einstellungen.

  4. Klicke auf den Button Provider hinzufügen, wähle Custom aus und bestätige deine Auswahl.

  5. Im nächsten Schritt wird dir der Token angezeigt, welchen du jetzt kopieren kannst.

🧑‍💻 Kontakt & Unterstützung

Du benötigst Hilfe beim Einrichten einer Integration? Unsere Developer sind gerne für dich da. Buche dir hier einen passenden Termin.

Hat dies Ihre Frage beantwortet?