Webáruház-integráció

Szerveroldali követés Shopware 6-hoz

Adj hozzá egy Shopware-integrációt a rendelések olvasási jogosultságával, és a ROASaurus az Admin API-ból szinkronizálja a kifizetett rendeléseket. Egy Flow Builder-webhookkal a rendelések a kifizetésük pillanatában megérkeznek.

A Shopware dióhéjban
A rendelések így érkeznekAdmin API-lekérdezés 5 percenként; azonnali, Flow Builder-webhookkal
Hozzáférési adatokAz integráció access key ID-ja és secret access key-je
Kifizetett rendelésekEgy paid állapotú tranzakció
RendelésazonosítóA Shopware rendelésszáma
Köszönőoldali kódrészletcheckout/finish sablon, a page.order.orderNumber használatával

Hogyan csatlakozik a Shopware

  1. Add hozzá a ROASaurus scriptet a témádhoz (base.html.twig, base_script_tracking blokk), vagy egy tag manager pluginnal.
  2. Settings › System › Integrations › Add integration, a rendelések olvasási jogosultságával. Add meg az access key ID-t és a secret access key-t a ROASaurusban.
  3. A pontos egyeztetéshez add hozzá a köszönőoldali kódrészletet a storefront/page/checkout/finish/index.html.twig fájlhoz.

A ROASaurus az integrációs kulcsokat egy rövid életű Admin API-tokenre cseréli, és 5 percenként megkeresi a legutóbbi futása óta frissült rendeléseket. Egy rendelés akkor számít kifizetettnek, ha valamelyik tranzakciója paid állapotban van. Azonosítóként a rendelésszámot használja, amelyet a köszönőoldali kódrészlet is küld.

Azonnali rendelések a Flow Builderrel

Shopware Evolve és afölött hozz létre egy flow-t a State Enter / Order Transaction / State / Paid eseményindítóval és a Call URL (Webhook) művelettel, POST a ROASaurus webhook-URL-jére. A hívás csak jelzés: a ROASaurus nem bízik a tartalmában, hanem a hitelesített API-n keresztül lekéri az utolsó két óra rendeléseit. A már meglévő rendeléseket figyelmen kívül hagyja.

Mit olvas ki a ROASaurus az egyes rendelésekből

A végösszeg, a pénznem, a rendelés dátuma, a vevő e-mail-címe és neve, a számlázási telefonszám, város, irányítószám és ország, az ügyfélazonosító, valamint a termék-tételsorok mennyiséggel, egységárral és cikkszámmal.

A rendelések összekötése a hirdetési kattintásokkal

A köszönőoldali kódrészlet a rendelésszámmal és a végösszeggel küldi el a ROASaurus vásárlást, ami összeköti a rendelést a látogatóval. Nélküle a ROASaurus egy olyan e-mail-címet használ, amelyet a látogató korábban megadott az oldaladon, például egy felugró ablakban.

Korlátok

  • A Shopware alapértelmezetten anonimizálja a vevő IP-címét, ezért az IP-alapú tartalék ritkán segít. Add hozzá a köszönőoldali kódrészletet.
  • A Flow Builder-webhookokhoz Shopware Evolve vagy magasabb kell. Nélkülük a rendelések legfeljebb 5 perccel később érkeznek meg.
  • A csatlakozó a platform hivatalos API-dokumentációja alapján készült. A hitelesítő adatok mentése után nyomd meg a Test connection gombot, majd adj le egy tesztrendelést, és nézd meg az Event logot.

Kapcsolódó

GYIK

Kérdések, válaszok

Kell a Flow Builder?

Nem. Nélküle a ROASaurus 5 percenként lekéri a kifizetett rendeléseket. A Flow Builder-webhook, amely Shopware Evolve és afölött érhető el, csak azt éri el, hogy azonnal megérkezzenek.

Biztonságos a Flow Builder-webhook?

A ROASaurus csak jelzésnek tekinti. Soha nem vesz át rendelési adatot a hívásból; a friss rendeléseket az Admin API-n keresztül kéri le az integrációs kulcsaiddal.

Milyen hozzáférés kell az integrációnak?

Olvasási hozzáférés a rendelésekhez. A ROASaurus az integráció access key ID-jával és secretjével kér egy rövid életű Admin API-tokent.

Minden eladás visszavezetve arra a hirdetésre, amelyik hozta

Szerveroldali követés, profit és ügyfél-élettartamérték egyetlen appban. 14 napos ingyenes próbaidőszak, bankkártya nélkül.

Indítsd el az ingyenes próbaidőszakot →