Komma igång

eklo är en matmarknad som kopplar ihop lokala producenter med kunder i deras närhet. Istället för hemleverans möts köpare och säljare vid ett utlämningsställe — ett fysiskt torg, en saluhall eller liknande — vid ett bokat hämttillfälle. Det är den idén som formar nästan allt annat i appen: kundvagnen är alltid knuten till en vald plats och tid, en producent säljer bara från de platser den faktiskt är kopplad till, och en order kan spänna över flera producenter som alla levererar till samma plats och tid.

Den här dokumentationen är skriven för alla som jobbar med eklo — oavsett om du bygger nya funktioner, supportar en producent, eller bara vill förstå hur en viss del hänger ihop.

De två sidorna av appen

Kunder handlar om att hitta ett utlämningsställe, bläddra bland det producenterna där har att erbjuda, och handla. Se För kunder för hela köpflödet — från att välja hämtplats till orderbekräftelse.

Producenter driver sin egen butik: de ansluter sitt Stripe-konto för att kunna ta betalt, lägger upp produkter, väljer vilka utlämningsställen de säljer från, och hanterar ordrar och utbetalningar från sin egen kontrollpanel. Se För producenter för hela den resan, från anslutning av Stripe till att se pengarna landa på banken.

Kärnkoncept värda att känna till överallt

Betalningar går via Stripe Connect. eklo tar emot hela betalningen från kunden i en enda Checkout-session, även när ordern innehåller varor från flera producenter — pengarna delas sedan upp internt och överförs till varje producents eget anslutna Stripe-konto. Se Betalningar & utbetalningar för hur det här faktiskt går till, inklusive varför en nyss gjord utbetalning inte är tillgänglig på banken direkt.

En övergiven checkout är inte en riktig order. Att klicka “Fortfart till betalning” skapar en order direkt, innan betalningen är klar — annars skulle inte avgiftsfördelningen vara redo i samma ögonblick betalningen faktiskt går igenom. Om kunden aldrig fullföljer betalningen markeras ordern som expired istället för att bli ett spöke som ligger kvar för evigt. Det här är varför en producents kontrollpanel skiljer mellan “riktiga” ordrar och checkouter som aldrig blev av.

Sandbox och produktion är helt separata miljöer — egna databaser, egna Stripe-nycklar, och olika temafärger i både appen och i transaktionsmejl (gul/orange i sandbox, grön i produktion), så att det aldrig råder tvivel om vilken miljö du faktiskt tittar på. Se Sandbox vs. produktion för detaljerna.

Var du hittar vad

• För kunder — bläddra, kundvagn, checkout, ordrar, recensioner.
• För producenter — komma igång, butiksinställningar, produkter, utlämningsställen, ordrar, kunder, utbetalningar, moms.
• Notiser & e-post — hur och när eklo hör av sig, via e-post och i appen.
• Sandbox vs. produktion — vad som skiljer de två miljöerna åt och varför.