Integrasjoner og API

Hvilke integrasjoner tilbyr OptiRoutes?

Innlesing av ordrer fra fil, FTP eller SFTP

Den enkleste integrasjonen er filen systemet ditt allerede eksporterer. På ordreskjermen leser Last inn leveringer en Excel- eller CSV-fil; du kobler hvert systemfelt – adresse, kundenavn, ordrenummer, antall og så videre – til kolonnenavnet ditt én gang, og alle senere filer lastes inn på samme måte. For en TXT-fil med fast bredde oppgir du tegnposisjoner i stedet for kolonnenavn. Rader kan hoppes over med et merkeord i merknadene, et annet merkeord kan erstatte adressen, og du bestemmer om et eksisterende ordrenummer skal oppdateres eller legges til som nytt.

Vil du ta menneskene ut av prosessen, velger du en automatisk innlesingsmetode i innstillingene:

• Filserveren til OptiRoutes – systemet ditt legger den daglige filen, navngitt etter datoen, i bedriftens mappe på FTP-serveren eller på den krypterte SFTP-serveren.
• Din egen FTP-server – OptiRoutes kobler til med brukeren du oppgir, og laster inn filen med dagens dato i navnet, eller den sist oppdaterte filen.
• Automatisk import og eksport – ordrene lastes inn av seg selv, og rutene planlegges også, uten at noen trenger å klikke.
• Fil-API-et – programvaren din laster opp ordrefilen over HTTPS, som beskrevet nedenfor.

På kundeskjermen oppretter eller oppdaterer en Excel- eller CSV-fil med kundenummer, navn, adresse, stopptid og åpnings- og stengetider kunder og tidsvinduene deres.

Fil-API-et: ordrer inn, leveringsbevis og rapporter ut

Hver bedrift i OptiRoutes har sin egen private mappe med filer: ordrene den laster inn, de signerte følgesedlene med bilder og signaturer, ruteeksportene og rapportene ved dagens slutt. Med fil-API-et kan systemene dine lese og skrive i denne mappen direkte over HTTPS, uten noen FTP-server imellom. Bedriftens leder bytter mellom FTP og API-et under Innstillinger → API og filer og oppretter nøklene der – du trenger ikke kontakte brukerstøtte, og nye bedrifter starter på API-et.

Kallene dekker kontroll av nøkkelen, listing av en mappe, nedlasting, opplasting (opptil 50 MB per fil) og sletting av filer du har lastet opp, listing av en dags POD-filer etter ordre og type, og nedlasting av alle POD-filene for en dag som én ZIP. Veiledningen har kodeeksempler i Python, C# og Node.js, og et PowerShell-skript som holder en mappe på serveren din synkronisert med bedriftens mappe – så et team som er vant til FTP, kan fortsette å jobbe på samme måte. Les den i veiledningen for fil-API-et.

Hvordan er API-nøklene sikret?

• Minste privilegium – hver nøkkel får bare de tillatelsene den trenger: bare signerte leveringsbevis, lesing av alle filer, eller opplasting av ordrer og innboksfiler.
• Tillatte adresser – en nøkkel kan begrenses til de faste IP-adressene til serveren din.
• Utløp og rotasjon – en nøkkel kan utløpe etter et antall dager; opprett en ny nøkkel, bytt over og tilbakekall deretter den gamle uten nedetid.
• Tilbakekall umiddelbart – en tilbakekalt nøkkel slutter å virke innen 30 sekunder.
• Revisjon – hvert kall logges med tid, adresse, fil og svar, og vises for lederen.
• Sikker lagring – OptiRoutes lagrer bare et SHA-256-fingeravtrykk av hver nøkkel; tilkoblingene går over HTTPS med TLS 1.2 eller nyere, og en nøkkel gir bare tilgang til mappen til sin egen bedrift.

Grenser: 300 forespørsler i minuttet per nøkkel, 50 MB per fil, 20 aktive nøkler per bedrift og opptil 5 000 oppføringer i én mappeliste.

Rapport- og push-API-et

For rapporteringsverktøy og ERP-koblinger finnes et separat API på api-users.optiroutes.com som leverer bedriftens data som rapporter og tar imot data som sendes inn. Én adresse og ett token, utstedt av OptiRoutes for bedriften din, dekker alle kall. På dokumentasjonssiden kan du lime inn tokenet ditt og se hvilke rapporter som er åpne for deg, og kolonnekoblingen for kontoen din: les API-dokumentasjonen.

To push-kall går den andre veien: Push av ordrer skriver dagens ordrefil og starter den automatiske innlesingen, og push av sjåfører, linjer og kjøretøy erstatter hele flåten, som en flåtefil. Fordi sjåførlisten som sendes inn, regnes som hele flåten, må du alltid sende alle sjåfører, ikke bare endringene.

Eksport av ruter og webhooks

Ruteeksporten skriver de markerte rutene i CSV, XLSX, XML, JSON eller TXT med fast bredde. En kolonnetabell bestemmer hvilke felter som går ut, og under hvilken overskrift, originalkolonner fra ordrefilen kan legges til, og med varehåndtering lister en andre fil opp alle varelinjer. Eksportene kan gå til datamaskinen din, FTP-serveren din eller bedriftens mappe, og med JSON kan eksporten også sendes til en nettadresse; hvis sendingen mislykkes, prøver systemet én gang til.

For hver levering idet den skjer fyller du inn adressen for leveringsrapporter i innstillingene for sjåførappen: Hver leveringsrapport sjåførene lager, sendes også dit, slik at et annet av systemene dine oppdateres av seg selv.

E-post, betalinger, kart og meldinger

• E-post – signerte følgesedler sendes fra din egen Gmail-konto med et app-passord fra Google; rapporter som pallrapporten ved dagens slutt går til rapportadressen din; betalende kunder får kvitteringer og sjåførene innleveringsbekreftelser fra kassen.
• Betalinger – påfyllinger betales på en sikker betalingsside fra Stripe, med mulighet for lagret kort til automatisk påfylling.
• Adresser og kart – adressene velges fra forslag fra Google og kontrolleres på kartet før planleggingen.
• Navigasjon – sjåførappen sender hvert stopp videre til Waze, eller til Apple Maps på iPhone, etter adresse eller nøyaktige koordinater.
• SMS og WhatsApp – ankomstmeldinger og sporingslenker til kunder, varsler til ledere, linjer til underleverandører og rutebilder til sjåførene på WhatsApp.

Vanlige spørsmål