Integrationer och API

Vilka integrationer erbjuder OptiRoutes?

Läsa in beställningar från en fil, FTP eller SFTP

Den enklaste integrationen är filen som ditt system redan exporterar. På beställningsskärmen läser Läs in leveranser en Excel- eller CSV-fil; du mappar varje systemfält – adress, kundnamn, ordernummer, antal och så vidare – till ditt kolumnnamn en gång, och varje senare fil läses in på samma sätt. För en TXT-fil med fast bredd anger du teckenpositioner i stället för kolumnnamn. Rader kan hoppas över med ett markeringsord i anmärkningarna, ett andra markeringsord kan ersätta adressen och du bestämmer om ett befintligt ordernummer ska uppdateras eller läggas till som nytt.

För att ta bort det manuella momentet väljer du ett automatiskt inläsningssätt i inställningarna:

• OptiRoutes filserver – ditt system lägger dagens fil, namngiven efter datumet, i företagets mapp på FTP-servern eller på den krypterade SFTP-servern.
• Din egen FTP-server – OptiRoutes ansluter med den användare du anger och läser in filen som är namngiven efter dagens datum, eller den senast uppdaterade filen.
• Automatisk import och export – beställningarna läses in av sig själva och rutterna planeras också, utan att någon behöver klicka.
• Fil-API:t – din programvara laddar upp beställningsfilen via HTTPS, som beskrivs nedan.

På kundskärmen skapar eller uppdaterar en Excel- eller CSV-fil med kundnummer, namn, adress, stopptid samt öppnings- och stängningstider kunder och deras tidsfönster.

Fil-API:t: beställningar in, leveransbevis och rapporter ut

Varje företag i OptiRoutes har en egen privat mapp med filer: beställningarna som läses in, de signerade följesedlarna med foton och signaturer, ruttexporterna och rapporterna vid dagens slut. Fil-API:t låter dina system läsa och skriva i den mappen direkt via HTTPS, utan någon FTP-server emellan. Företagets chef växlar mellan FTP och API:t under Inställningar → API och filer och skapar nycklarna där – ingen förfrågan till supporten behövs, och nya företag börjar med API:t.

Anropen omfattar kontroll av nyckeln, listning av en mapp, nedladdning, uppladdning (upp till 50 MB per fil) och radering av filer du har laddat upp, listning av en dags POD-filer efter beställning och typ samt nedladdning av alla en dags POD-filer som en ZIP-fil. Guiden innehåller kodexempel i Python, C# och Node.js och ett PowerShell-skript som håller en mapp på din server synkroniserad med företagets mapp – så att ett team som är vant vid FTP kan fortsätta arbeta på samma sätt. Läs den i guiden för fil-API:t.

Hur skyddas API-nycklarna?

• Minsta möjliga behörighet – varje nyckel får bara de behörigheter den behöver: bara signerade leveransbevis, läsa alla filer eller ladda upp beställningar och filer till inkorgen.
• Tillåtna adresser – en nyckel kan begränsas till din servers fasta IP-adresser.
• Utgångstid och rotation – en nyckel kan upphöra att gälla efter ett antal dagar; skapa en ny nyckel, byt och återkalla sedan den gamla utan avbrott.
• Återkalla direkt – en återkallad nyckel slutar fungera inom 30 sekunder.
• Granskning – varje anrop loggas med tid, adress, fil och svar och visas för chefen.
• Säker lagring – OptiRoutes sparar bara ett SHA-256-fingeravtryck av varje nyckel; anslutningarna sker via HTTPS med TLS 1.2 eller senare, och en nyckel når bara sitt eget företags mapp.

Gränser: 300 anrop per minut och nyckel, 50 MB per fil, 20 aktiva nycklar per företag och upp till 5 000 poster i en mapplistning.

API:t för rapporter och push

För rapportverktyg och kopplingar till affärssystem finns ett separat API på api-users.optiroutes.com som levererar ditt företags data som rapporter och tar emot data som skickas in. En adress och en token, utfärdad av OptiRoutes för ditt företag, täcker alla anrop. På dokumentationssidan kan du klistra in din token och se vilka rapporter som är öppna för dig och kolumnmappningen för ditt konto: läs API-dokumentationen.

Två push-anrop fungerar åt andra hållet: push av beställningar skriver dagens beställningsfil och startar den automatiska inläsningen, och push av förare, linjer och fordon ersätter hela flottan, som en flottfil. Eftersom den inskickade förarlistan räknas som hela flottan ska du alltid skicka alla förare, inte bara ändringarna.

Ruttexport och webhooks

Ruttexporten skriver de markerade rutterna i CSV, XLSX, XML, JSON eller TXT med fast bredd. En kolumntabell avgör vilka fält som går ut och under vilken rubrik, ursprungliga kolumner från din beställningsfil kan läggas till och med artikelhantering listar en andra fil varje artikel. Exporter kan gå till din dator, din FTP-server eller företagsmappen, och med JSON kan exporten också skickas till en webbadress; om sändningen misslyckas försöker systemet en gång till.

För varje leverans i samma stund som den sker fyller du i adressen för leveransrapporter i förarappens inställningar: varje leveransrapport som förarna gör skickas även dit, så att ett annat av dina system uppdateras automatiskt.

E-post, betalningar, kartor och meddelanden

• E-post – signerade följesedlar skickas från ditt eget Gmail-konto med ett applösenord från Google; rapporter som pallrapporten vid dagens slut går till din e-postadress för rapporter; betalande kunder får kvitton och förarna inlämningsbekräftelser från kassan.
• Betalningar – påfyllningar betalas på en säker betalsida från Stripe, med ett valfritt sparat kort för automatisk påfyllning.
• Adresser och kartor – adresserna väljs bland Googles förslag och verifieras på kartan före planeringen.
• Navigering – förarappen lämnar över varje stopp till Waze, eller Apple Maps på en iPhone, via adress eller exakta koordinater.
• SMS och WhatsApp – ankomstmeddelanden och spårningslänkar till kunder, aviseringar till chefer, linjer till underleverantörer och ruttbilder till förare på WhatsApp.

Vanliga frågor