Koppla ihop dina system åt båda hållen

Order flödar in från din webbutik eller ditt affärssystem, och allt som händer med dem flödar tillbaka: på en rutt, ute för leverans, levererad med signatur, en ny ETA. Ett REST-API och signerade webhooks, tillgängliga för alla företag under Inställningar → API-nycklar.

Starta gratis provperiod Läs guiden Guide för API-integration

API-nycklar under Inställningar i Afi Planner: en API-nyckel, en webhook-endpoint och dess senaste leveranser

Slut på CSV-filer fram och tillbaka

Skapa eller uppdatera order från ditt eget system, en i taget eller upp till 1 000 per anrop, inom paketets antal stopp per plan (500 i den kostnadsfria provperioden). Skickar du samma order-ID igen uppdateras ordern i stället för att dubbleras, tills en förare har arbetat med den; därefter ändrar PATCH dess fält.

Vet direkt när den är levererad

Webhooks meddelar dina system när en order planeras, går ut, levereras eller misslyckas, med orsaken, fotot och signaturen, och när kunden väljer en annan dag, ändrar instruktionerna eller betygsätter leveransen.

Samma regler som i appen

Order som skickas via API:et kontrolleras, planeras och begränsas precis som order som en trafikledare lägger in.

Ett REST-API för hela leveransdagen

Allt en trafikledare gör under en dag kan automatiseras: lägg till order, välj vilka förare som arbetar, planera rutterna, skicka dem till förarna och läs sedan var varje order befinner sig.

Order: skapa, uppdatera med ditt eget order-ID, massimport, pausa, släpp, avboka med en orsak (ordern finns kvar, med vem som avbokade den och när), ta bort en order som lagts in av misstag, och leverera en misslyckad order igen (nästa försök, med samma spårningslänk)
Kundens instruktioner från din kassa (customerNote, leaveAtDoor), och notifyCustomer: false för en kund som inte vill ha meddelanden
Planering: starta en optimering och följ jobbet tills rutterna är klara
Utskick: skicka rutterna, eller ändringarna sedan senast, till förarnas telefoner
Läsning: varje orders rutt så som den skickades till föraren, med stoppordning och ETA (och draftRoute när trafikledarens tavla skiljer sig från det som skickades), live-ETA, statushistorik, länkar till leveransbevis och varje försök på ordern
En plan per dag: nya order och dagens endpoints (förare, optimering, utskick, plan) använder dagens första plan
Idempotensnycklar för säkra omförsök, och en OpenAPI 3.1-beskrivning för kodgeneratorer

Webhooks som dina utvecklare kan lita på

Varje händelse signeras med HMAC-SHA256 och en tidsstämpel, så att din server kan kontrollera att den verkligen kommer från Afi Planner. Misslyckade leveranser försöks igen i ungefär ett dygn, och varje försök syns i en leveranslogg med payload, headers, din servers svar, filter och Skicka igen.

order.created, order.updated, order.status_changed, order.loaded (förarens lastkontroll lade den i bilen), order.eta_changed, order.cancelled (med orsaken), order.deleted
order.rescheduled_by_customer (en annan dag vald på spårningssidan), order.instructions_changed, order.rated, order.not_attempted (förarens dag tog slut med ordern fortfarande öppen), order.moved_back (en order som flyttats till en annan dag är tillbaka där den var)
plan.optimized, plan.job_failed, route.dispatched
”Skicka test” och ”Försök igen nu” under Inställningar
Händelser som uppstår medan en endpoint är avstängd sparas inte: läs ordrarna igen när du slår på den
Endpoints måste vara publika HTTPS-adresser

En webhook-endpoint med en lyckad testleverans och listan över senaste händelser

Byggt för verklig drift

API-nycklar skapas och återkallas av ägaren eller en teammedlem med behörigheten Utvecklare, och visas bara en gång. En nyckel kan vara skrivskyddad, kan löpa ut och kan bytas med den gamla kvar i 1 eller 24 timmar. Den har skaparens behörigheter, så en nyckel gör aldrig mer än personen som skapade den. Varje nyckel kan göra 600 anrop per minut. Länkar till leveransbevis slutar gälla efter en timme. Gränser för kollin och pausade eller avslutade konton gäller precis som i appen.

Utvecklarverktyg under Inställningar → Utvecklare

Din utvecklare kan testa hela kopplingen innan en enda kodrad skrivs, och se varje anrop efteråt.

Testa nyckeln: färdiga anrop (kontrollera nyckeln, dagens order, skapa och läsa en testorder) eller dina egna, med svaret, statusen, tiden och ett curl-kommando att kopiera
API-anropslogg: varje anrop till API:et i 3 dagar, med status, nyckel, order-ID och anropets och svarets innehåll, utan hemligheter
En Postman-samling gjord för ditt företag: din tidszon, din depå och exempelorder i ditt eget format för order-ID, från nyckelkontroll till webhooks
Testorder: en order vars ID börjar med API-TEST- planeras aldrig, läggs aldrig på en rutt och får inga meddelanden, räknas inte i användning och analys, och raderas efter 3 dagar; dess webhooks har test: true

Steg-för-steg-guider

7 steg · 7 min läsning

Koppla ihop dina system med API:et och webhooks

Vanliga frågor om det här

Har Afi Planner ett API med webhooks?

Vanliga frågor

Behöver jag en utvecklare?

Ja, att ansluta via API:et eller webhooks kräver en utvecklare eller en integrationspartner. Ditt team kan samtidigt fortsätta importera kalkylblad i appen.

Finns det en app för Shopify eller Zapier?

Inte än. I dag ansluter du dem via API:et och webhooks. Hör av dig om du behöver en färdig koppling.

Kostar API:et extra?

Nej. API:et och webhooks ingår i alla abonnemang, även i den kostnadsfria provperioden.

Fler funktioner

Planera morgondagens rutter på 3 minuter

Starta din kostnadsfria provperiod på 3 månader. Inget kreditkort, inget uppstartssamtal, ingen installation.

Starta gratis provperiod Prata med säljteamet