Kom igång
Aktivera integrationen
Öppna inställningssidan för Rule Email Marketing i adminmenyn i Starweb.
Klistra in din Rule API-nyckel och klicka på Testa anslutning. Du ska få ett meddelande om att anslutningen lyckades.
Aktivera “Aktivera synk till Rule” och spara.
Verifiera att det fungerar
Lägg en testorder i butiken.
Logga in i Rule och gå till Subscribers. Sök upp kunden via e-postadress.
Kontrollera att namn, adress, orderuppgifter och taggen OrderCompleted finns på prenumeranten.
Hantera integrationen
Nyhetsbrevsprenumeration
Om kunden valde att prenumerera på nyhetsbrev vid köpet läggs taggen Newsletter till i Rule, tillsammans med taggen OrderCompleted.
Inaktivera integrationen tillfälligt
Stäng av Aktivera synk till Rule i Starweb och spara. API-nyckeln sparas kvar och integrationen kan aktiveras igen när som helst.
Ta bort integrationen helt
Rensa API-nyckelfältet i Starweb och spara. Synkroniseringen inaktiveras automatiskt och alla statusfält återställs.
Statussektion – förstå vad som visas
Längst ned på inställningssidan i Starweb finns en Statussektion med två fält:
Senaste lyckade synk - Tidpunkt för den senast skickade ordern. Om detta är aktuellt fungerar integrationen som den ska.
Senaste fel - Det senaste problemet som uppstod vid ett synkförsök, med tidsstämpel. Det betyder inte nödvändigtvis att integrationen är trasig – enskilda ordrar kan hoppas över av giltiga skäl.
Vanliga felmeddelanden
Felmeddelande | Vad det betyder | Åtgärd |
Order has no email or parseable phone; skipping sync | Kunden på ordern saknade både e-postadress och telefonnummer. Rule kräver minst ett av dessa. | Ingen åtgärd behövs – förväntat beteende. |
Invalid API key | API-nyckeln är felaktig eller har spärrats i Rule. | Ange en giltig API-nyckel och testa anslutningen igen. |
Vad som skickas till Rule
Taggar (händelser)
Rules automationer triggas av taggar som sätts på medlemmen. Varje slutförd order skickar följande:
Tagg | När | Beskrivning |
OrderCompleted | Alltid | Skickas för varje slutförd order. Används för att starta automatiseringsflödet "order slutförd". |
Newsletter | Om kunden prenumererar på nyhetsbrev | Markerar prenumeranten som opt-in för nyhetsbrev. |
Identifierare
Fält | Beskrivning |
Primär identifierare. Hämtas från orderns kund (faller tillbaka på ursprungskunden vid gästköp). | |
phone_number | Skickas bara om ett giltigt telefonnummer kan tolkas – skickas aldrig tomt, så ett lagrat nummer kan aldrig skrivas över av ett tomt värde. |
language | Orderns språkkod (t.ex. sv, en) – styr språkspecifikt innehåll i Rule. |
Kunddata
Fält | Beskrivning |
FirstName | Förnamn |
LastName | Efternamn |
CustomerNumber | Internt kund-ID från Starweb |
Company | Företagsnamn (tomt för privatkunder) |
Street | Gatuadress (faktureringsadress) |
Postcode | Postnummer (faktureringsadress) |
City | Ort (faktureringsadress) |
State | Län/region (faktureringsadress) |
Country | Landsnamn, lokaliserat till orderns språk (t.ex. "Sverige") |
CountryCode | ISO-landskod (t.ex. SE) |
Source | Alltid Starweb |
MarketingConsent | Om kunden har samtyckt till nyhetsbrev/marknadsföring |
Orderdata
Fält | Beskrivning |
OrderNumber | Ordernummer i Starweb |
Date | Tidpunkt då ordern skapades |
Currency | ISO-valutakod (t.ex. SEK) |
BillingStreet / City / Postcode / Country | Fullständig faktureringsadress |
ShippingStreet / City / Postcode / Country | Fullständig leveransadress (faller tillbaka på faktureringsadress om ingen separat leveransadress finns) |
AmountsIncludeVat | Om alla belopp inkluderar moms (B2C inkl., B2B exkl.) |
SubtotalAmount | Delsumma för produkter |
DiscountAmount | Total rabatt (positivt värde) |
ShippingAmount | Fraktkostnad |
TotalVatAmount | Total moms |
TotalAmount | Totalt betalt belopp |
PaymentMethodName | Betalningsmetod som visas för kunden |
ShippingMethodName | Fraktmetod som visas för kunden |
PricelistUsed | Prislista som användes på ordern |
Products | Lista med orderrader (se nedan) |
Brands | Unik lista med varumärkesnamn från ordern |
Names | Unik lista med produktnamn |
SKUs | Unik lista med produkters SKU |
Categories | Unik lista med produkters huvudkategori |
Produktdata – per orderrad
Fält | Beskrivning |
type | bundle, variant eller basic |
sku | artikelnummer för orderraden |
name | Produktnamn |
variantName | Variantens eget namn (tomt för basic/bundle) |
variation | Valda attribut (t.ex. "Röd, S") för varianter; valda ingående produkter för bundles |
brand | Varumärke/tillverkare |
category | Produktens huvudkategori |
image | URL till produkt- eller variantbild |
url | URL till produktsidan |
unitPriceAmount | Enhetspris |
qty | Beställd kvantitet |
subtotalAmount | Summa per rad |