Integrări și API

Ce integrări oferă OptiRoutes?

Încărcarea comenzilor dintr-un fișier, de pe FTP sau SFTP

Cea mai simplă integrare este fișierul pe care sistemul dumneavoastră îl exportă deja. În ecranul de comenzi, Încarcă livrările citește un fișier Excel sau CSV; mapați o singură dată fiecare câmp din sistem — adresă, nume client, număr comandă, cantitate și așa mai departe — la numele coloanei dumneavoastră, iar fiecare fișier ulterior se încarcă la fel. Pentru un fișier TXT cu lățime fixă indicați pozițiile caracterelor în locul numelor de coloane. Rândurile pot fi omise printr-un cuvânt-marcaj în observații, un al doilea marcaj poate înlocui adresa, iar dumneavoastră decideți dacă un număr de comandă existent este actualizat sau adăugat ca nou.

Pentru a scoate oamenii din proces, alegeți în setări o metodă de încărcare automată:

• Serverul de fișiere OptiRoutes — sistemul dumneavoastră lasă fișierul zilnic, denumit după dată, în dosarul companiei de pe serverul FTP sau de pe serverul SFTP criptat.
• Propriul server FTP — OptiRoutes se conectează cu utilizatorul pe care i-l dați și încarcă fișierul denumit cu data de azi sau fișierul actualizat cel mai recent.
• Import și export automat — comenzile se încarcă singure, iar rutele sunt și planificate, fără niciun clic.
• API-ul pentru fișiere — software-ul dumneavoastră încarcă fișierul de comenzi prin HTTPS, așa cum este descris mai jos.

În ecranul clienților, un fișier Excel sau CSV cu numărul clientului, numele, adresa, timpul de oprire și orele de deschidere și de închidere creează sau actualizează clienții și ferestrele lor de timp.

API-ul pentru fișiere: comenzile intră, POD-urile și rapoartele ies

Fiecare companie din OptiRoutes are propriul dosar privat de fișiere: comenzile pe care le încarcă, avizele de livrare semnate cu fotografiile și semnăturile lor, exporturile de rute și rapoartele de sfârșit de zi. API-ul pentru fișiere le permite sistemelor dumneavoastră să citească și să scrie direct în acest dosar prin HTTPS, fără niciun server FTP la mijloc. Managerul companiei comută între FTP și API în Setări → API și fișiere și tot acolo creează cheile — nu este nevoie de nicio solicitare către suport, iar companiile noi pornesc direct pe API.

Apelurile acoperă verificarea cheii, listarea unui dosar, descărcarea, încărcarea (până la 50 MB pe fișier) și ștergerea fișierelor încărcate de dumneavoastră, listarea fișierelor POD ale unei zile pe comandă și pe tip și descărcarea tuturor fișierelor POD ale unei zile ca un singur ZIP. Ghidul include exemple de cod în Python, C# și Node.js, precum și un script PowerShell care ține un dosar de pe serverul dumneavoastră sincronizat cu dosarul companiei — astfel încât o echipă obișnuită cu FTP poate lucra în continuare la fel. Citiți ghidul API-ului pentru fișiere.

Cum sunt securizate cheile API?

• Privilegiu minim — fiecare cheie primește doar permisiunile de care are nevoie: doar POD-uri semnate, citirea tuturor fișierelor sau încărcarea de comenzi și de fișiere în inbox.
• Adrese permise — o cheie poate fi limitată la adresele IP fixe ale serverului dumneavoastră.
• Expirare și rotire — o cheie poate expira după un număr de zile; creați o cheie nouă, comutați pe ea, apoi revocați-o pe cea veche, fără întreruperi.
• Revocare imediată — o cheie revocată nu mai funcționează în cel mult 30 de secunde.
• Audit — fiecare apel este înregistrat cu ora, adresa, fișierul și răspunsul și este afișat managerului.
• Stocare sigură — OptiRoutes păstrează doar o amprentă SHA-256 a fiecărei chei; conexiunile sunt HTTPS cu TLS 1.2 sau mai nou, iar o cheie are acces doar la dosarul propriei companii.

Limite: 300 de cereri pe minut per cheie, 50 MB pe fișier, 20 de chei active per companie și până la 5.000 de intrări într-o singură listare de dosar.

API-ul de rapoarte și de push

Pentru instrumentele de raportare și conectorii ERP, un API separat, la api-users.optiroutes.com, pune la dispoziție datele companiei sub formă de rapoarte și acceptă date trimise prin push. O singură adresă și un singur token, emis de OptiRoutes pentru compania dumneavoastră, acoperă toate apelurile. Pagina de documentație vă permite să lipiți tokenul și să vedeți ce rapoarte vă sunt disponibile și maparea coloanelor din contul dumneavoastră: citiți documentația API.

Două apeluri de push funcționează în sens invers: trimiterea comenzilor scrie fișierul de comenzi al zilei și pornește încărcarea automată, iar trimiterea șoferilor, liniilor și vehiculelor înlocuiește întreaga flotă, ca un fișier de flotă. Deoarece lista de șoferi trimisă este considerată flota completă, trimiteți întotdeauna toți șoferii, nu doar modificările.

Exportul rutelor și webhook-uri

Exportul rutelor scrie rutele marcate în CSV, XLSX, XML, JSON sau TXT cu lățime fixă. Un tabel de coloane decide ce câmpuri ies și sub ce antet, se pot adăuga coloane originale din fișierul de comenzi, iar cu gestionarea articolelor un al doilea fișier listează fiecare articol. Exporturile pot merge pe calculatorul dumneavoastră, pe serverul FTP sau în dosarul companiei, iar în format JSON exportul poate fi trimis și la o adresă web; dacă trimiterea eșuează, sistemul mai încearcă o dată.

Pentru fiecare livrare, pe loc, completați adresa pentru rapoartele de livrare în setările aplicației șoferului: fiecare raport de livrare făcut de șoferi este trimis și acolo, astfel încât un alt sistem al dumneavoastră se actualizează singur.

E-mail, plăți, hărți și mesagerie

• E-mail — avizele de livrare semnate pleacă din propriul cont Gmail, cu o parolă de aplicație Google; rapoartele, precum raportul de paleți de sfârșit de zi, ajung la adresa de e-mail pentru rapoarte; clienții care plătesc primesc chitanțe, iar șoferii confirmări de depunere de la casierie.
• Plăți — reîncărcările se plătesc pe o pagină de plată Stripe securizată, cu un card salvat opțional pentru reîncărcarea automată.
• Adrese și hărți — adresele sunt alese din sugestiile Google și verificate pe hartă înainte de planificare.
• Navigație — aplicația șoferului trimite fiecare oprire către Waze sau, pe iPhone, către Apple Maps, după adresă sau după coordonate exacte.
• SMS și WhatsApp — mesaje de sosire și linkuri de urmărire pentru clienți, alerte pentru manageri, linii pentru subcontractanți și imagini ale rutelor pentru șoferi pe WhatsApp.

Întrebări frecvente