Integracije i API

Koje integracije nudi OptiRoutes?

Učitavanje narudžbi iz datoteke, s FTP-a ili SFTP-a

Najjednostavnija integracija je datoteka koju vaš sustav već izvozi. Na zaslonu narudžbi Učitaj dostave čita datoteku Excel ili CSV; svako polje sustava — adresu, naziv kupca, broj narudžbe, količinu i tako dalje — jednom povežete s nazivom svojeg stupca, a svaka se kasnija datoteka učitava na isti način. Za datoteku TXT s fiksnom širinom polja umjesto naziva stupaca navodite položaje znakova. Retci se mogu preskočiti prema oznaci u napomenama, druga oznaka može zamijeniti adresu, a vi odlučujete ažurira li se postojeći broj narudžbe ili dodaje kao nova narudžba.

Da biste ljude potpuno isključili iz postupka, u postavkama odaberite način automatskog učitavanja:

• Poslužitelj datoteka OptiRoutes — vaš sustav dnevnu datoteku, nazvanu datumom, odlaže u mapu vaše tvrtke na FTP poslužitelju ili na šifriranom SFTP poslužitelju.
• Vaš vlastiti FTP poslužitelj — OptiRoutes se povezuje s korisnikom kojeg mu zadate i učitava datoteku nazvanu današnjim datumom ili posljednju ažuriranu datoteku.
• Automatski uvoz i izvoz — narudžbe se učitavaju same i rute se također planiraju, bez ijednog klika.
• API za datoteke — vaš softver prenosi datoteku narudžbi putem HTTPS-a, kako je opisano u nastavku.

Na zaslonu kupaca datoteka Excel ili CSV s brojem kupca, nazivom, adresom, vremenom zadržavanja te vremenom otvaranja i zatvaranja izrađuje ili ažurira kupce i njihove vremenske prozore.

API za datoteke: narudžbe ulaze, POD-ovi i izvješća izlaze

Svaka tvrtka u OptiRoutesu ima vlastitu privatnu mapu datoteka: narudžbe koje učitava, potpisane otpremnice s fotografijama i potpisima, izvoze ruta i izvješća na kraju dana. API za datoteke omogućuje vašim sustavima da tu mapu izravno čitaju i u nju pišu putem HTTPS-a, bez FTP poslužitelja između. Voditelj tvrtke prebacuje između FTP-a i API-ja u izborniku Postavke → API i datoteke i ondje izrađuje ključeve — nije potreban zahtjev podršci, a nove tvrtke počinju s API-jem.

Pozivi obuhvaćaju provjeru ključa, popis sadržaja mape, preuzimanje, prijenos (do 50 MB po datoteci) i brisanje datoteka koje ste prenijeli, popis datoteka POD za dan prema narudžbi i vrsti te preuzimanje svih datoteka POD za dan kao jednog ZIP-a. Vodič sadrži primjere koda u Pythonu, C#-u i Node.js-u te skriptu za PowerShell koja mapu na vašem poslužitelju drži sinkroniziranom s mapom tvrtke — pa tim naviknut na FTP može nastaviti raditi na isti način. Pročitajte ga u vodiču za API za datoteke.

Kako su zaštićeni API ključevi?

• Najmanje potrebne ovlasti — svaki ključ dobiva samo dopuštenja koja su mu potrebna: samo potpisani POD-ovi, čitanje svih datoteka ili prijenos narudžbi i datoteka u mapu inbox.
• Dopuštene adrese — ključ se može ograničiti na fiksne IP adrese vašeg poslužitelja.
• Istek i rotacija — ključ može isteći nakon određenog broja dana; izradite novi ključ, prebacite se na njega, a zatim opozovite stari, bez prekida rada.
• Trenutačni opoziv — opozvani ključ prestaje raditi u roku od 30 sekundi.
• Revizija — svaki se poziv bilježi s vremenom, adresom, datotekom i odgovorom i prikazuje voditelju.
• Sigurna pohrana — OptiRoutes čuva samo SHA-256 otisak svakog ključa; veze su HTTPS s TLS-om 1.2 ili novijim, a ključ doseže samo mapu vlastite tvrtke.

Ograničenja: 300 zahtjeva u minuti po ključu, 50 MB po datoteci, 20 aktivnih ključeva po tvrtki i do 5000 stavki u jednom popisu sadržaja mape.

API za izvješća i slanje podataka

Za alate za izvještavanje i ERP konektore zaseban API na adresi api-users.optiroutes.com poslužuje podatke vaše tvrtke kao izvješća i prima podatke koji mu se šalju. Jedna adresa i jedan token, koje OptiRoutes izdaje za vašu tvrtku, pokrivaju svaki poziv. Na stranici dokumentacije možete zalijepiti svoj token i vidjeti koja su vam izvješća dostupna te mapiranje stupaca svojeg računa: pročitajte dokumentaciju API-ja.

Dva poziva za slanje rade u suprotnom smjeru: slanje narudžbi zapisuje datoteku narudžbi za dan i pokreće automatsko učitavanje, a slanje vozača, linija i vozila zamjenjuje cijeli vozni park, poput datoteke voznog parka. Budući da se poslani popis vozača smatra cijelim voznim parkom, uvijek šaljite sve vozače, a ne samo promjene.

Izvoz ruta i webhookovi

Izvoz ruta zapisuje označene rute u formatu CSV, XLSX, XML, JSON ili TXT s fiksnom širinom polja. Tablica stupaca određuje koja polja izlaze i pod kojim naslovom, mogu se dodati izvorni stupci vaše datoteke narudžbi, a uz upravljanje artiklima druga datoteka navodi svaki artikl. Izvozi mogu ići na vaše računalo, na vaš FTP poslužitelj ili u mapu tvrtke, a u formatu JSON izvoz se može poslati i na web-adresu; ako slanje ne uspije, sustav pokušava još jednom.

Za svaku dostavu u trenutku kad se dogodi upišite adresu za izvješća o dostavi u postavkama aplikacije za vozače: svako izvješće o dostavi koje vozači izrade šalje se i onamo, pa se drugi vaš sustav sam ažurira.

E-pošta, plaćanja, karte i poruke

• E-pošta — potpisane otpremnice šalju se s vašeg vlastitog Gmail računa pomoću Googleove lozinke za aplikaciju; izvješća poput izvješća o paletama na kraju dana idu na vašu e-adresu za izvješća; kupci koji plaćaju dobivaju potvrde o primitku, a vozači potvrde o predaji s blagajne.
• Plaćanja — nadoplate se plaćaju na sigurnoj stranici za plaćanje Stripe, uz neobavezno spremanje kartice za automatsku nadoplatu.
• Adrese i karte — adrese se odabiru među Googleovim prijedlozima i prije planiranja provjeravaju na karti.
• Navigacija — aplikacija za vozače svaku stanicu prosljeđuje Wazeu ili Apple Kartama na iPhoneu, prema adresi ili točnim koordinatama.
• SMS i WhatsApp — poruke o dolasku i poveznice za praćenje kupcima, upozorenja voditeljima, linije podizvođačima i slike ruta vozačima na WhatsAppu.

Česta pitanja