Shopware

Listrak

Inhaltsverzeichnis

Kostenlose 15-minütige Erstberatung direkt mit unseren Experten.

Kostenlose Beratung +49 421 438 1919-0

3. Configuratie opslaan

Dit document beschrijft de aangepaste Admin API-endpoints die de Listrak-plugin voor Shopware 6 biedt. Met deze endpoints kunnen geautoriseerde gebruikers volledige gegevenssynchronisatietaken tussen Shopware en het Listrak-systeem starten.

Endpoint: 

POST /api/_action/listrak/data-api/test

Beschrijving
Test de verbinding met de Listrak Data API met de opgegeven dataClientId en dataClientSecret. Geeft bij succes een geldig toegangstoken terug.
Request-headers

Authorization: Bearer 
Content-Type: application/json

Voorbeeld van een request-body
Succesvolle respons

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Voorbeeld van een foutrespons

{
  "errors": [
    {
      "status": "400",
      "detail": "Missing client ID and/or client Secret"
    }
  ]
}

Endpoint

POST /api/_action/listrak/email-api/test

Beschrijving
Test de verbinding met de Listrak Email API met de opgegeven emailClientId en emailClientSecret. Geeft bij succes een geldig toegangstoken terug.
Request-headers

Authorization: Bearer 
Content-Type: application/json

Voorbeeld van een request-body

{
  "Listrak.config.emailClientId": "your-email-client-id",
  "Listrak.config.emailClientSecret": "your-email-client-secret"
}

Succesvolle respons

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Voorbeeld van een foutrespons

{
  "errors": [
    {
      "status": "401",
      "detail": "The provided API credentials are invalid."
    }
  ]
}

Shopware-events

De plugin luistert naar belangrijke Shopware-events zoals winkelwagenupdates, klantregistraties en geplaatste bestellingen.

Gegevens die naar Listrak worden verzonden

Gegevens worden automatisch via beveiligde API-aanroepen naar Listrak verzonden, inclusief retries en foutlogging.

Transactionele e-mails

Voeg de Transactional List ID toe in de configuratie-instellingen van de plugin.
Ga naar de Flow Builder in het gedeelte Instellingen van de Shopware-admin.
Voeg een nieuwe flow toe.
Selecteer een event als trigger.
Selecteer na het kiezen van het event de actie ‘Send email with Listrak’.

vi. Definieer in de geopende modal de ontvanger, de Transactional Message ID en eventuele Listrak-profielvelden die voor de transactionele e-mail nodig zijn.

vii. Nadat u hebt gecontroleerd dat u de juiste gegevens en Shopware-templatevariabelen voor de transactionele e-mail hebt opgegeven, klikt u op Add Action. In het veld Field Value kunt u Twig-syntaxis gebruiken.
viii. Activeer de flow en sla deze vervolgens op.

listrak:sync-products

Synchroniseer producten naar Listrak voor het opgegeven Sales Channel.

Argumenten:

Naam Beschrijving 
sales-channel-id
Sales Channel-ID om producten te filteren. (

Optie Beschrijving 
--limit=
Maximaal aantal te exporteren producten. 
--local
Genereer het bestand lokaal in plaats van het via FTP over te dragen.

)

Opties:

listrak:sync-orders

Synchroniseer bestellingen naar Listrak voor het opgegeven Sales Channel.
Argumenten:

Naam Beschrijving 
sales-channel-id
Sales Channel-ID om bestellingen te filteren. (vereist)

Opties:

Optie Beschrijving 
--limit=
Maximaal aantal te exporteren bestellingen. 
--offset=
Startoffset voor de export (voor batchverwerking). 
listrak:sync-newsletter-recipients

Synchroniseer nieuwsbriefontvangers naar Listrak voor het opgegeven Sales Channel.
Argumenten:

Naam Beschrijving 
sales-channel-id
Sales Channel-ID om nieuwsbriefontvangers te filteren. (vereist)

Opties:

Optie Beschrijving 
--limit=
Maximaal aantal te exporteren nieuwsbriefontvangers. 
--offset=
Startoffset voor de export (voor batchverwerking). 
listrak:sync-customers

Synchroniseer klanten naar Listrak voor het opgegeven Sales Channel.

Naam Beschrijving 
sales-channel-id
Sales Channel-ID om klanten te filteren. (vereist)

Opties:

Optie Beschrijving 
--limit=
Maximaal aantal te exporteren klanten. 
--offset=
Startoffset voor de export (voor batchverwerking).

Is een Listrak-account vereist?
Ja. U hebt een actief Listrak-account, een Data Integration en een Email Integration nodig om gegevens te synchroniseren.

Welke variabelen kan ik gebruiken in de flow voor transactionele e-mails?

Afhankelijk van het type event hebt u toegang tot verschillende variabelen, maar enkele van de meest gebruikte variabelen zijn:

order

{{ order.orderNumber }}

{{ order.orderDate|date(‘Y-m-d H:i’) }} (datum moet worden geformatteerd)

{{ order.currency.isoCode }}

{{ order.lineItems }}

{{ order.deliveries }}

{{ order.transactions }}

{{ order.defaultBillingAddress.firstName }}

{{ order.defaultBillingAddress.lastName}}

{{ order.defaultBillingAddress.street}}

{{ order.defaultBillingAddress.zipcode}}

{{ order.defaultBillingAddress.city}}

{{ order.defaultBillingAddress.phoneNumber}}

etc.

salesChannel
{{ salesChannel.name }}

customer
{{ customer.firstName }}
{{ customer.lastName }}
{{ customer.email }}
etc.

Let op: gegevens zoals orderregels of ordertransacties moeten via Twig-syntaxis worden doorlopen.

Gerelateerde onderwerpen

Lees meer over de pluginconfiguratie in onze WIKI.