Triggers

Met triggers laat oneCORE je eigen automatiseringsflows, zoals Microsoft Power Automate, weten dat er iets belangrijks gebeurt in je shop. Bijvoorbeeld een order die van status verandert, een nieuwe zendingsregel, een winkelgebruiker die zijn gegevens aanpast of een wijziging in een offerte. Gebeurt dat, dan seint oneCORE de flow die je hebt gekoppeld in en geeft het de belangrijkste verwijzing mee, zoals het order-ID. Je flow haalt daarna via de Public API de verdere gegevens op die hij nodig heeft, en verstuurt een e-mail, werkt je ERP of CRM bij of start elk ander proces dat je nodig hebt.

Triggers heetten eerder "Notification template V2". Ze vervangen stap voor stap de oudere mail types van notification templates die automatiseringen startten, zoals het mail type Power automates. Het onderwerp en de tekst van e-mails en sms'jes beheer je nog steeds in Notification templates.

Machtigingen

Voor Triggers heb je de rol "Triggers" nodig. Daarna staat de functie onder het menu Management.

Trigger testen

Voordat je een trigger live gebruikt, kun je een test trigger draaien. Zo check je of je flow de gegevens goed ontvangt en zie je de trigger body vooraf. Een test trigger stuurt voorbeeldgegevens van een bestaand record in je shop, meestal het meest recente.

Soorten triggers

Triggers zijn in drie typen ingedeeld, naar de gegevens waar ze over gaan. Maak je een trigger, dan kies je eerst het type en daarna de trigger binnen dat type.

1. Order: voor gebeurtenissen in het orderproces

2. Shop user: voor gebeurtenissen rond een winkelgebruiker en zijn account

3. System: voor gebeurtenissen die het systeem maakt, zoals offertes, vouchers en nieuwsbrieven

Elke trigger gaat af bij een bepaalde gebeurtenis. Per trigger hieronder zie je wanneer hij afgaat, welke gegevens hij naar je flow stuurt en waar in oneCORE de gebeurtenis kan plaatsvinden.

Trigger bij Order status changed

Instelling

• Order status (meerdere keuzes): Any (standaard), Pre-created, Created, Fraud check, Processing, Finished, Declined, Cancelled.

Wanneer hij afgaat

• Als de status van een order verandert in een van de gekozen statussen.

Gegevens naar je flow

• Order ID
• Company URL

Waar hij kan afgaan

• Checkout flow (orderflow)
• Automatisch annuleren van orders
• Public API, als een order wordt bijgewerkt via

• PATCH /api/v2/orders/{id}
• PUT /api/v2/orders/{id}

• Orderdetailpagina in de Admin, als de status met de hand wordt gewijzigd

Test trigger: stuurt de gegevens van een bestaande order.

Let op: deze trigger gaat niet af als een order wordt aangemaakt.

Trigger bij Shipment line created

Wanneer hij afgaat

• Als er een zendingsregel wordt aangemaakt.

Gegevens naar je flow

• Order ID
• Shipment ID
• Shipment line ID

Waar hij kan afgaan

• Checkout flow (orderflow), als de betaling is afgerond
• Public API, als een zendingsregel wordt aangemaakt via POST /api/v2/orders/{id}/shipments/{shipmentId}/shipmentlines
• Orderdetailpagina in de Admin, als een zending met de hand wordt aangemaakt

Test trigger: stuurt de gegevens van de nieuwste zendingsregel.

Trigger bij Shop user created

Wanneer hij afgaat

• Als er een nieuwe winkelgebruiker wordt aangemaakt, door registratie of via de API.

Gegevens naar je flow

• Shop user ID
• First name
• Last name
• Email
• Phone number

Waar hij kan afgaan

• Checkout flow (orderflow), als klanten hun contactgegevens invullen
• In de front-end van een shop, als klanten een account aanmaken

Trigger bij Shop user updated

Wanneer hij afgaat

• Als een van deze gegevens van een winkelgebruiker wordt aangepast:

• Voornaam, achternaam, aanhef, verjaardag, e-mailadres, telefoonnummer
• Adresgegevens: voornaam, achternaam, bedrijfsnaam, telefoonnummer, straat, huisnummer, toevoeging, adres, postcode, plaats, land, KvK-nummer, btw-nummer
• Gegevens van het shop user type

Gegevens naar je flow

• Shop user ID
• First name
• Last name
• Email
• Phone number

Waar hij kan afgaan

• Account Connect (bijvoorbeeld My address)
• Checkout flow (orderflow)
• Admin, als een beheerder de gegevens van een klant met de hand aanpast
• First time login

Trigger bij Voucher claimed

Wanneer hij afgaat

• Als een winkelgebruiker een voucher claimt.

Gegevens naar je flow

• Voucher ID, code, comment
• Campaign ID
• Shop user ID
• Claimed date, redeemed date

Waar hij kan afgaan

• De component MyVouchers in Account Connect, als een winkelgebruiker op claimen klikt

Test trigger: stuurt de gegevens van de laatst geclaimde voucher.

Trigger bij Voucher redeemed

Wanneer hij afgaat

• Als een voucher aan een winkelgebruiker is gekoppeld en wordt verzilverd.

Gegevens naar je flow

• Voucher ID, code, comment
• Campaign ID
• Shop user ID
• Claimed date, redeemed date

Waar hij kan afgaan

• Als een voucher op een order wordt toegepast
• Een pagina om vouchers te verzilveren (per shop op maat)
• Public API, als de verzilverdatum van een voucher wordt bijgewerkt: /api/v2/campaigns/{id}/vouchers/{voucherId}

Test trigger: stuurt de gegevens van de laatst verzilverde voucher uit de nieuwste campagne, als die voucher aan een winkelgebruiker is gekoppeld.

Let op: nadat een voucher aan een winkelgebruiker is gekoppeld, kan het zo'n 10 minuten duren voordat de trigger de wijziging oppikt.

Trigger bij Quotation status changed

Wanneer hij afgaat

• Als de status van een offerte verandert.

Gegevens naar je flow

• Quotation ID

Waar hij kan afgaan

• Public API, als een offerte wordt bijgewerkt
• Offertedetailpagina in de Admin, als de status met de hand wordt gewijzigd

Test trigger: stuurt de gegevens van de nieuwste offerte.

Trigger bij Quotation contact changed

Wanneer hij afgaat

• Als een van deze contactgegevens van een offerte verandert:

• Naam, e-mailadres, telefoonnummer en land van de klant
• Gegevens van de winkelgebruiker: aanhef, voornaam, achternaam, e-mailadres, telefoonnummer, verjaardag, shop user type
• Verzend- of factuuradres
• De gekoppelde winkelgebruiker (shop user ID)

Gegevens naar je flow

• Quotation ID

Waar hij kan afgaan

• Detailpagina van de winkelgebruiker in de Admin, als een beheerder de gegevens met de hand aanpast
• Public API, als een offerte (/api/v2/quotations), winkelgebruiker (/api/v2/shopusers) of shop user type (/api/v2/shopuser/{}/shopusertypes) wordt bijgewerkt
• Account Connect (AccountOverview en AccountCompletion)

Test trigger: stuurt de gegevens van de nieuwste offerte.

Let op: een bestaand adres van een winkelgebruiker dat al in gebruik is aanpassen, laat deze trigger niet afgaan: oneCORE slaat het aangepaste adres op als een nieuw adres.

Trigger bij Quotation follow-up changed

Wanneer hij afgaat

• Als de opvolgdatum, de notitie of de slagingskans van een offerte verandert.

Gegevens naar je flow

• Quotation ID

Waar hij kan afgaan

• Public API, als een offerte (/api/v2/quotations) of een product in een offerte (/api/v2/quotations/{}/products) wordt bijgewerkt
• Offerteoverzicht in de Admin, als een beheerder de gegevens met de hand aanpast

Test trigger: stuurt de gegevens van de nieuwste offerte.

Trigger bij Quotation product changed

Wanneer hij afgaat

• Als een product aan een offerte wordt toegevoegd of eruit wordt verwijderd.
• Als een van deze productgegevens verandert:

• Aantal, productnotitie, kortingsregel
• Configuratie: edities en aantal per editie, afmetingen (lengte, breedte, hoogte), aantal, notitie
• Externe orderregel
• Servicekosten

Gegevens naar je flow

• Quotation ID

Waar hij kan afgaan

• Public API, als een product in een offerte wordt toegevoegd, bijgewerkt of verwijderd

Test trigger: stuurt de gegevens van de nieuwste offerte.

Trigger bij Quotation discount changed

Wanneer hij afgaat

• Als een wijziging het kortingsbedrag van een offerte verandert, bijvoorbeeld:

• Een voucher wordt gewijzigd, of het bedrag ervan verandert
• Een wijziging in een product verandert de prijs van de offerte

Gegevens naar je flow

• Quotation ID

Waar hij kan afgaan

• Public API, als een offerte wordt bijgewerkt

Test trigger: stuurt de gegevens van de nieuwste offerte.

Trigger bij Quotation shipment changed

De koppeling voor offertezendingen is alleen in sommige shops beschikbaar.

Wanneer hij afgaat

• Als bezorgproducten worden ingesteld (de antwoorden worden aangepast).
• Als de verwachte leverdatum wordt toegevoegd, aangepast of verwijderd.
• Als de verzendkosten veranderen.
• Als producten aan een bezorggroep worden toegevoegd of eruit worden verwijderd.

Gegevens naar je flow

• Quotation ID

Waar hij kan afgaan

• Public API, als de verzendgroep van een product in een offerte verandert
• Offertedetailpagina in het Sales portal

Test trigger: stuurt de gegevens van de nieuwste offerte.

Trigger bij Voucher created

Wanneer hij afgaat

• Als er een voucher wordt aangemaakt, in de Admin of via de API.

Gegevens naar je flow

• Voucher ID
• Campaign ID
• Voucher code

Waar hij kan afgaan

• Zodra een voucher wordt aangemaakt in de Campaign-omgeving van de Admin of via de Public API.

Test trigger: stuurt de gegevens van de laatst aangemaakte voucher.