Integrációk és API

Milyen integrációkat kínál az OptiRoutes?

Rendelések betöltése fájlból, FTP-ről vagy SFTP-ről

A legegyszerűbb integráció az a fájl, amelyet a rendszere már most is exportál. A rendelések képernyőn a Kiszállítások betöltése beolvas egy Excel- vagy CSV-fájlt; minden rendszermezőt – cím, ügyfélnév, rendelésszám, mennyiség és így tovább – egyszer kell hozzárendelnie a saját oszlopnevéhez, és minden későbbi fájl ugyanígy töltődik be. Rögzített szélességű TXT-fájlnál oszlopnevek helyett karakterpozíciókat ad meg. A sorok egy megjegyzésben szereplő jelölőszóval kihagyhatók, egy második jelölő lecserélheti a címet, és Ön dönti el, hogy egy meglévő rendelésszám frissüljön-e, vagy újként kerüljön felvételre.

Hogy kiiktassa a kézi lépéseket, válasszon automatikus betöltési módot a beállításokban:

• Az OptiRoutes fájlszervere – a rendszere a dátummal elnevezett napi fájlt a cége mappájába teszi az FTP-szerveren vagy a titkosított SFTP-szerveren.
• Saját FTP-szerver – az OptiRoutes az Ön által megadott felhasználóval kapcsolódik, és betölti a mai dátummal elnevezett vagy a legutóbb frissített fájlt.
• Automatikus import és export – a rendelések maguktól töltődnek be, és az útvonalak is megtervezésre kerülnek, egyetlen kattintás nélkül.
• A fájl-API – a szoftvere HTTPS-en tölti fel a rendelésfájlt, ahogy alább leírjuk.

Az ügyfelek képernyőn egy ügyfélszámot, nevet, címet, megállási időt, valamint nyitási és zárási időt tartalmazó Excel- vagy CSV-fájl létrehozza vagy frissíti az ügyfeleket és az időablakaikat.

A fájl-API: rendelések be, POD-ok és jelentések ki

Az OptiRoutes-ban minden cégnek saját, privát fájlmappája van: az általa betöltött rendelések, az aláírt szállítólevelek fényképeikkel és aláírásaikkal, az útvonalexportok és a napvégi jelentések. A fájl-API lehetővé teszi, hogy a rendszerei közvetlenül, HTTPS-en olvassák és írják ezt a mappát, közbeiktatott FTP-szerver nélkül. A cég vezetője a Beállítások → API és fájlok menüpontban vált az FTP és az API között, és ott hozza létre a kulcsokat is – nem kell az ügyfélszolgálathoz fordulni, az új cégek pedig eleve az API-val indulnak.

A hívások lefedik a kulcs ellenőrzését, egy mappa listázását, a letöltést, a feltöltést (fájlonként legfeljebb 50 MB) és a saját feltöltésű fájlok törlését, egy nap POD-fájljainak listázását rendelés és típus szerint, valamint egy nap összes POD-fájljának letöltését egyetlen ZIP-ként. Az útmutató Python, C# és Node.js kódmintákat, valamint egy PowerShell-szkriptet tartalmaz, amely a szerverén lévő mappát szinkronban tartja a cég mappájával – így az FTP-hez szokott csapat ugyanúgy dolgozhat tovább. Olvassa el a fájl-API útmutatóját.

Hogyan védettek az API-kulcsok?

• Legkisebb jogosultság – minden kulcs csak a szükséges jogosultságokat kapja meg: csak aláírt POD-ok, minden fájl olvasása, vagy rendelések és inbox-fájlok feltöltése.
• Engedélyezett címek – egy kulcs a szervere fix IP-címeire korlátozható.
• Lejárat és csere – egy kulcs adott számú nap után lejárhat; hozzon létre új kulcsot, váltson át, majd vonja vissza a régit, kiesés nélkül.
• Azonnali visszavonás – a visszavont kulcs 30 másodpercen belül leáll.
• Naplózás – minden hívás naplózásra kerül időponttal, címmel, fájllal és válasszal, és megjelenik a vezetőnek.
• Biztonságos tárolás – az OptiRoutes minden kulcsból csak egy SHA-256 ujjlenyomatot őriz; a kapcsolatok TLS 1.2 vagy újabb protokollal védett HTTPS-en futnak, és egy kulcs csak a saját cégének mappáját éri el.

Korlátok: kulcsonként percenként 300 kérés, fájlonként 50 MB, cégenként 20 aktív kulcs, és egy mappalistázásban legfeljebb 5000 bejegyzés.

A jelentés- és push API

A jelentéskészítő eszközök és az ERP-csatlakozók számára egy külön API az api-users.optiroutes.com címen jelentésként szolgálja ki cége adatait, és fogadja a beküldött adatokat. Egy cím és egy token, amelyet az OptiRoutes ad ki a cégének, minden hívást lefed. A dokumentációs oldalon beillesztheti a tokenjét, és megnézheti, mely jelentések érhetők el Önnek, valamint fiókja oszlop-hozzárendelését: olvassa el az API-dokumentációt.

Két push hívás a másik irányba működik: a rendelések beküldése megírja a nap rendelésfájlját, és elindítja az automatikus betöltést, a sofőrök, járatok és járművek beküldése pedig a teljes flottát lecseréli, mint egy flottafájl. Mivel a beküldött sofőrlista a teljes flottának számít, mindig minden sofőrt küldjön el, ne csak a változásokat.

Útvonalak exportálása és webhookok

Az útvonalexport a megjelölt útvonalakat CSV, XLSX, XML, JSON vagy rögzített szélességű TXT formátumban írja ki. Egy oszloptáblázat határozza meg, mely mezők kerülnek ki és milyen fejléccel, a rendelésfájl eredeti oszlopai hozzáadhatók, tételkezeléssel pedig egy második fájl minden tételt felsorol. Az export a számítógépére, az FTP-szerverére vagy a cég mappájába mehet, JSON esetén pedig egy webcímre is elküldhető; ha a küldés sikertelen, a rendszer még egyszer megpróbálja.

Az egyes kiszállítások valós idejű követéséhez töltse ki a kiszállítási jelentések címét a sofőralkalmazás beállításaiban: a sofőrök minden kiszállítási jelentése oda is elküldődik, így egy másik rendszere magától frissül.

E-mail, fizetés, térképek és üzenetküldés

• E-mail – az aláírt szállítólevelek a saját Gmail-fiókjából, Google-alkalmazásjelszóval mennek ki; az olyan jelentések, mint a napvégi raklapjelentés, a jelentések e-mail-címére érkeznek; a pénztárból a fizető ügyfelek nyugtát, a sofőrök befizetési igazolást kapnak.
• Fizetés – a feltöltéseket egy biztonságos Stripe fizetési oldalon fizeti, az automatikus feltöltéshez opcionálisan mentett kártyával.
• Címek és térképek – a címeket a Google javaslatai közül választja ki, és tervezés előtt a térképen ellenőrizzük őket.
• Navigáció – a sofőralkalmazás minden megállót a Waze-nek, iPhone-on az Apple Térképnek ad át, cím vagy pontos koordináták alapján.
• SMS és WhatsApp – érkezési üzenetek és követési linkek az ügyfeleknek, figyelmeztetések a vezetőknek, járatok az alvállalkozóknak, és útvonalképek a sofőröknek WhatsAppon.

Gyakran ismételt kérdések