Slik kobles butikkdesignet til ReAI.
ReAI er både datakilde og handelsplattform. Nettsiden kan være helt selvstendig, med sitt eget repo og sin egen deploy.
Følg flyten
- Git eier design, navigasjon og forklaringer. Et rent statisk nettsted trenger ingen commerce-integrasjon.
- Management-API-et lar en autorisert operatør vedlikeholde Site, produkter, publisering og handelsregler.
- Site API leverer bare denne Sitens publiserte data til Worker. Site-nøkkelen er separat fra brukerens management-nøkkel.
- ReAI checkout håndterer kontakt, levering og betalingsstatus. Ordre, faktura og regnskapsoppfølging blir i plattformen.
Uavhengig nettsted, felles forretningsdata
En designendring deployer bare dette nettstedet. Produkt- og prisendringer gjøres i ReAI. En feil i katalogkallet vises som en feil; produksjon bruker aldri en lokal reservekatalog som later som den er live.
Kassasystem i samme plattform
ReAI samler nettbutikk, kassasystem og regnskap. Salg i fysisk butikk håndteres i kassasystemet, med kvitteringer, betalinger og regnskapsoppfølging i ReAI. Du trenger ikke en dyr integrasjon mellom et separat kassasystem og regnskapssystem. Site API-et på dette nettstedet er for nettbutikken; kassasystemet brukes i ReAI.
HTML først, JavaScript for interaksjon
Denne butikken sender ferdig HTML fra en Cloudflare Worker. Det trengs ikke en stor JavaScript-app for å vise produkter. Bilder lastes i passende størrelser, og bilder lenger ned på siden lastes ved behov. Kurv, fargevalg og påmelding bruker små skript. Du kan også bruke et annet rammeverk; Site API-et binder deg ikke til dette designet.
Mellomlagre katalog, hent lagerstatus fersk
storefront gir én sammenhengende katalog med produkter og samlinger, slik at du slipper ett kall per samling. Leverings-API-et støtter ETag for katalogdata. Tilgjengelighet hentes separat og uten mellomlagring, gjerne i ett batch-kall for variantene på siden. Checkout validerer pris og lager på nytt. Denne testbutikkens HTML og JSON-svar mellomlagres ikke.
Hent dataene designet trenger
Bruk produktdetaljer til produktsiden, samlinger til navigasjonen og tilgjengelighet til variantvalg. Beskrivelser leveres både som tekst og som renset HTML. Site API gir nettstedets publiserte data. Andre backend-funksjoner hører til management-API-et og krever autorisert serverkode; en offentlig nettside skal ikke få tilgang til privat regnskap.
Hva Site API ikke skal gi nettleseren
Intern tenant-ID, kostpris, margin, lagerbeholdning, bank- og regnskapsdata hører ikke hjemme i offentlige leveringsdata. Management-API-et har bredere funksjoner og krever bruker-/tenant-tilgang. API-lekeplassen her viser bare Site-leveringsdata.
Fra betaling til oppfølging
En opprettet checkout er ikke en betalt ordre. ReAI håndterer betalingsutfall og videre ordre-/fakturaflyt; bruk plattformens status før levering. Faktura, innbetaling og oppgjør er ulike steg. Adyen-gebyrer og avstemming skal ikke behandles som om en retur-URL automatisk bokførte alt.
Ett privat repo per kunde
Hver kundes nettsted har egne rettigheter, instruksjoner og deploy. Du kan dele repo-tilgang med kunden og deploye designendringer uten å deploye andre kunders nettsteder.
Browser → demo Worker → /site/v1/** (Site credential)
Operator → /api/** + X-Tenant-Id (management credential)
Browser → ReAI hosted checkout → Adyen
ReAI → payment status / order / invoice follow-up