--- title: "Integraatiot ja API: tiedostot, tilaukset ja POD | OptiRoutes" description: "Liitä OptiRoutes ERP-järjestelmääsi: Excel- ja CSV-lataus, FTP tai SFTP, tiedosto-API tilauksille ja POD:ille, raportti-API, reittien viennit ja webhookit." url: https://optiroutes.com/fi/integrations/ lang: fi-FI updated: 2026-10-24 --- # Integraatiot ja API OptiRoutes liittyy jo käyttämiisi järjestelmiin. Tilaukset tulevat Excel- tai CSV-tiedostosta, FTP:ltä tai SFTP:ltä tai suojatun tiedosto-API:n kautta; allekirjoitetut lähetteet, reittien viennit ja raportit palaavat samaa tietä. Raportti-API tarjoaa tietosi BI-työkaluille, ja verkko-osoitteet vastaanottavat toimitusraportit ja reittien viennit sitä mukaa kuin ne syntyvät. ## Mitä integraatioita OptiRoutes tarjoaa? | Tarve | Miten OptiRoutes sen hoitaa | | --- | --- | | Päivän tilausten lataus | Excel- tai CSV-lataus, automaattinen tuonti FTP:ltä, SFTP:ltä tai tiedosto-API:n kautta CSV-, JSON- tai kiinteän leveyden TXT-muodossa. | | Allekirjoitettujen POD:ien keruu | Tiedosto-API-kutsut päivittäin tai tilauksittain tai yksi ZIP päivää kohden; kopiot sähköpostitse. | | Reittien lähettäminen järjestelmääsi | Reittien vienti CSV-, XLSX-, XML-, JSON- tai TXT-muodossa tiedostoon, FTP-palvelimellesi, yrityksen kansioon tai verkko-osoitteeseen. | | Raportointi BI-työkaluun tai ERP-järjestelmään | Raportti-API: tilaukset, reitit, kuljettajat, asiakkaat, POD ja päivittäinen toimitusyhteenveto. | | Reagointi jokaiseen toimitukseen | Toimitusraporttien osoite, joka vastaanottaa jokaisen raportin sen syntyessä. | | Palvelun maksaminen | Stripe Checkout ennakkoon maksettaville saldon lisäyksille ja automaattiselle täydennykselle. | ## Tilausten lataus tiedostosta, FTP:ltä tai SFTP:ltä Yksinkertaisin integraatio on tiedosto, jonka järjestelmäsi jo vie. Tilausnäkymässä **Lataa toimitukset** lukee Excel- tai CSV-tiedoston; kohdistat kunkin järjestelmän kentän — osoite, asiakkaan nimi, tilausnumero, määrä ja niin edelleen — sarakenimeesi kerran, ja jokainen myöhempi tiedosto latautuu samalla tavalla. Kiinteän leveyden TXT-tiedostolle annat sarakenimien sijaan merkkipaikat. Rivejä voi ohittaa huomautuksissa olevan merkkisanan perusteella, toinen merkkisana voi korvata osoitteen, ja päätät, päivitetäänkö olemassa oleva tilausnumero vai lisätäänkö se uutena. Jotta ihmisiä ei tarvita välissä, valitse asetuksissa automaattinen lataustapa: - **OptiRoutesin tiedostopalvelin** — järjestelmäsi pudottaa päivämäärällä nimetyn päivittäisen tiedoston yrityksesi kansioon FTP-palvelimella tai salatulla SFTP-palvelimella. - **Oma FTP-palvelimesi** — OptiRoutes yhdistää antamallasi käyttäjällä ja lataa tämän päivän päivämäärällä nimetyn tiedoston tai viimeksi päivitetyn tiedoston. - **Automaattinen tuonti ja vienti** — tilaukset latautuvat itsestään ja myös reitit suunnitellaan ilman ainuttakaan napsautusta. - **Tiedosto-API** — ohjelmistosi lataa tilaustiedoston HTTPS:n kautta, kuten alla kuvataan. Asiakasnäkymässä Excel- tai CSV-tiedosto, jossa on asiakasnumero, nimi, osoite, pysähdysaika sekä avaamis- ja sulkemisajat, luo tai päivittää asiakkaat ja heidän aikaikkunansa. ## Tiedosto-API: tilaukset sisään, POD:t ja raportit ulos Jokaisella OptiRoutesin yrityksellä on oma yksityinen tiedostokansionsa: sen lataamat tilaukset, allekirjoitetut lähetteet valokuvineen ja allekirjoituksineen, reittien viennit ja päivän päätteen raportit. **Tiedosto-API** antaa järjestelmiesi lukea ja kirjoittaa tähän kansioon suoraan HTTPS:n kautta ilman välissä olevaa FTP-palvelinta. Yrityksen esihenkilö vaihtaa FTP:n ja API:n välillä kohdassa **Asetukset → API ja tiedostot** ja luo avaimet siellä — tukipyyntöä ei tarvita, ja uudet yritykset aloittavat API:lla. | Kansio | Mitä siinä on | Kuka kirjoittaa | | --- | --- | --- | | orders_files/ | Päivittäinen tilaustiedosto ja reittien viennit. | Sinä (tilaukset), OptiRoutes (viennit) | | pod/YYYY/MM/DD/ | Kyseisen päivän allekirjoitetut POD:t: allekirjoitettu PDF, allekirjoitus ja valokuvat. | OptiRoutes | | pod/ | Kuljettajasovelluksessa allekirjoitettavat alkuperäiset lähetteet, yksi PDF tilausnumeroa kohden. | Sinä | | reports/YYYY/MM/ | Päivän päätteen ja palautusten raportit. | OptiRoutes | | podBaseFile/ | POD-pohjalomake. | Sinä | | inbox/ | Vapaa kansio tiedostoille, jotka haluat luovuttaa. | Sinä | Yrityksen kansio tiedosto-API:ssa. Kutsut kattavat avaimen tarkistuksen, kansion listauksen, latauksen, lähetyksen (enintään 50 Mt tiedostoa kohden) ja itse lähettämiesi tiedostojen poistamisen, päivän POD-tiedostojen listauksen tilauksen ja lajin mukaan sekä päivän kaikkien POD-tiedostojen latauksen yhtenä ZIP-tiedostona. Opas sisältää koodiesimerkit Pythonilla, C#:lla ja Node.js:llä sekä PowerShell-skriptin, joka pitää palvelimesi kansion synkronoituna yrityksen kansion kanssa — joten FTP:hen tottunut tiimi voi jatkaa työskentelyä samalla tavalla. Lue se [tiedosto-API:n oppaasta](https://srv2.optiroutes.com/api/v1/docs?lang=fi). ## Miten API-avaimet on suojattu? - **Vähimmät oikeudet** — jokainen avain saa vain tarvitsemansa oikeudet: vain allekirjoitetut POD:t, kaikkien tiedostojen luku tai tilausten ja inbox-tiedostojen lähetys. - **Sallitut osoitteet** — avaimen voi rajata palvelimesi kiinteisiin IP-osoitteisiin. - **Vanhentuminen ja kierrätys** — avaimelle voi asettaa voimassaoloajan päivinä; luo uusi avain, vaihda ja mitätöi vanha ilman katkoja. - **Välitön mitätöinti** — mitätöity avain lakkaa toimimasta 30 sekunnin kuluessa. - **Lokitus** — jokainen kutsu kirjataan aikoineen, osoitteineen, tiedostoineen ja vastauksineen, ja se näytetään esihenkilölle. - **Turvallinen säilytys** — OptiRoutes säilyttää kustakin avaimesta vain SHA-256-sormenjäljen; yhteydet ovat HTTPS-yhteyksiä TLS 1.2:lla tai uudemmalla, ja avain pääsee vain oman yrityksensä kansioon. Rajat: 300 pyyntöä minuutissa avainta kohden, 50 Mt tiedostoa kohden, 20 aktiivista avainta yritystä kohden ja enintään 5 000 merkintää yhdessä kansiolistauksessa. ## Raportti- ja push-API Raportointityökaluja ja ERP-liittimiä varten erillinen API osoitteessa api-users.optiroutes.com tarjoaa yrityksesi tiedot raportteina ja vastaanottaa lähetettyä dataa. Yksi osoite ja yksi OptiRoutesin yrityksellesi myöntämä tunniste kattavat jokaisen kutsun. Dokumentaatiosivulle voit liittää tunnisteesi ja nähdä, mitkä raportit ovat käytettävissäsi ja tilisi sarakekohdistuksen: [lue API-dokumentaatio](https://api-users.optiroutes.com/api-docs/en). | Raportti | Mitä se palauttaa | | --- | --- | | orders | Tilaukset ja toimitukset reitteineen ja kuljettajineen. | | routes | Reitit kuljettajineen ja pysähdysten määrineen. | | drivers | Kuljettajatiedot. | | customers | Asiakastiedot ja osoitteet. | | pod | Toimitusten dokumentaatio. | | delivery-summary | Päivittäinen yhteenveto tiloittain. | Kaksi push-kutsua toimii toiseen suuntaan: tilausten lähettäminen kirjoittaa päivän tilaustiedoston ja käynnistää automaattisen latauksen, ja kuljettajien, linjojen ja ajoneuvojen lähettäminen korvaa koko kaluston kuten kalustotiedosto. Koska lähetetty kuljettajaluettelo katsotaan koko kalustoksi, lähetä aina jokainen kuljettaja, ei vain muutoksia. ## Reittien vienti ja webhookit Reittien vienti kirjoittaa merkityt reitit CSV-, XLSX-, XML-, JSON- tai kiinteän leveyden TXT-muodossa. Saraketaulukko ratkaisee, mitkä kentät viedään ja millä otsikolla, tilaustiedostosi alkuperäisiä sarakkeita voi lisätä, ja nimikehallinnassa toinen tiedosto listaa jokaisen nimikkeen. Viennit voivat mennä tietokoneellesi, FTP-palvelimellesi tai yrityksen kansioon, ja JSON-muodossa viennin voi lähettää myös verkko-osoitteeseen; jos lähetys epäonnistuu, järjestelmä yrittää vielä kerran. Jokaista toimitusta varten sen tapahtuessa täytä kuljettajasovelluksen asetuksiin **toimitusraporttien osoite**: jokainen kuljettajien tekemä toimitusraportti lähetetään myös sinne, jolloin toinen järjestelmäsi päivittyy itsestään. ## Sähköposti, maksut, kartat ja viestintä - **Sähköposti** — allekirjoitetut lähetteet lähtevät omalta Gmail-tililtäsi Googlen sovellussalasanalla; raportit, kuten päivän päätteen lavaraportti, menevät raporttien sähköpostiosoitteeseesi; maksaneet asiakkaat saavat kassalta kuitit ja kuljettajat talletusvahvistukset. - **Maksut** — saldon lisäykset maksetaan suojatulla Stripe-maksusivulla, ja automaattista täydennystä varten kortin voi halutessaan tallentaa. - **Osoitteet ja kartat** — osoitteet valitaan Googlen ehdotuksista ja vahvistetaan kartalla ennen suunnittelua. - **Navigointi** — kuljettajasovellus välittää jokaisen pysähdyksen Wazeen tai iPhonessa Apple Mapsiin osoitteen tai tarkkojen koordinaattien perusteella. - **SMS ja WhatsApp** — saapumisviestit ja seurantalinkit asiakkaille, hälytykset esihenkilöille, linjat alihankkijoille ja reittikuvat kuljettajille WhatsAppissa. Suunnitteletko integraatiota ERP- tai varastojärjestelmäsi kanssa? Kerro meille, mitä haluat liittää. [Aloita ilmainen kokeilu](https://glob-a.optiroutes.com/auth/register?utm_source=site&utm_medium=cta&utm_campaign=integrations) ## Usein kysytyt kysymykset ### Voiko OptiRoutes ladata tilaukset automaattisesti ERP-järjestelmästämme? Voi. ERP-järjestelmäsi voi pudottaa päivittäisen tiedoston OptiRoutesin FTP- tai SFTP-palvelimelle tai omalle FTP-palvelimellesi tai lähettää sen tiedosto-API:n kautta, ja OptiRoutes lataa sen itsestään. ### Miten saamme allekirjoitetut POD:t järjestelmäämme? Tiedosto-API:n kautta: listaa ja lataa päivän POD-tiedostot tai lataa ne kaikki yhtenä ZIP-tiedostona. Kopio lähetetään myös sähköpostitse ohjaussääntöjesi mukaan. ### Kuka luo tiedosto-API:n API-avaimet? Yrityksen esihenkilö kohdassa Asetukset, API ja tiedostot. Avaimilla on oikeudet, valinnaiset sallitut osoitteet ja vanhentuminen, ja ne voi mitätöidä milloin tahansa. ### Onko raporteille API? On. Raportti-API palauttaa tilaukset, reitit, kuljettajat, asiakkaat, POD:n ja päivittäisen toimitusyhteenvedon OptiRoutesin myöntämällä tunnisteella. ### Missä tiedostomuodoissa reitit voi viedä? CSV-, XLSX-, XML-, JSON- ja kiinteän leveyden TXT-muodossa valitsemillasi sarakkeilla ja otsikoilla. --- OptiRoutes · 1235 Jefferson Ave, Redwood City, CA 94062, USA · yoni@optiroutes.com · https://optiroutes.com/fi/