---
title: "Integracije i API: datoteke, narudžbe i POD | OptiRoutes"
description: "Povežite OptiRoutes s ERP-om: prijenos Excel i CSV, FTP ili SFTP, API za datoteke za narudžbe i potpisane POD-ove, API za izvješća, izvoz ruta i webhookovi."
url: https://optiroutes.com/hr/integrations/
lang: hr-HR
updated: 2026-10-24
---

# Integracije i API

OptiRoutes se povezuje sa sustavima koje već koristite. Narudžbe stižu iz datoteke Excel ili CSV, s FTP-a ili SFTP-a ili putem sigurnog API-ja za datoteke; potpisane otpremnice, izvozi ruta i izvješća vraćaju se istim putem. API za izvješća poslužuje vaše podatke BI alatima, a web-adrese primaju izvješća o dostavi i izvoze ruta u trenutku kad nastanu.

## Koje integracije nudi OptiRoutes?

| Potreba | Kako to OptiRoutes rješava |
| --- | --- |
| Učitavanje narudžbi za dan | Prijenos datoteka Excel ili CSV, automatsko učitavanje s FTP-a, SFTP-a ili putem API-ja za datoteke, u formatu CSV, JSON ili TXT s fiksnom širinom polja. |
| Preuzimanje potpisanih POD-ova | Pozivi API-ja za datoteke po danu ili po narudžbi ili jedan ZIP po danu; kopije e-poštom. |
| Slanje ruta u vaš sustav | Izvoz ruta u formatu CSV, XLSX, XML, JSON ili TXT, u datoteku, na vaš FTP, u mapu tvrtke ili na web-adresu. |
| Izvještavanje u BI ili vaš ERP | API za izvješća: narudžbe, rute, vozači, kupci, POD i dnevni sažetak dostava. |
| Reakcija na svaku dostavu | Adresa za izvješća o dostavi koja prima svako izvješće u trenutku kad nastane. |
| Plaćanje usluge | Stripe Checkout za unaprijed plaćene nadoplate i automatsku nadoplatu. |

## 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.

| Mapa | Što sadrži | Tko piše |
| --- | --- | --- |
| orders_files/ | Dnevnu datoteku narudžbi i izvoze ruta. | Vi (narudžbe), OptiRoutes (izvozi) |
| pod/YYYY/MM/DD/ | Potpisane POD-ove tog dana: potpisani PDF, potpis i fotografije. | OptiRoutes |
| pod/ | Izvorne otpremnice za potpis u aplikaciji za vozače, jedan PDF po broju narudžbe. | Vi |
| reports/YYYY/MM/ | Izvješća na kraju dana i izvješća o povratima. | OptiRoutes |
| podBaseFile/ | Osnovni obrazac za POD. | Vi |
| inbox/ | Slobodnu mapu za datoteke koje želite predati. | Vi |

Mapa tvrtke u API-ju za datoteke.

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](https://srv2.optiroutes.com/api/v1/docs?lang=hr).

## 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](https://api-users.optiroutes.com/api-docs/en).

| Izvješće | Što vraća |
| --- | --- |
| orders | Narudžbe i dostave, s rutom i vozačem. |
| routes | Rute, s vozačem i brojem stanica. |
| drivers | Podatke o vozačima. |
| customers | Podatke o kupcima i adrese. |
| pod | Dokumentaciju o dostavi. |
| delivery-summary | Dnevni sažetak po statusu. |

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.

Planirate integraciju sa svojim ERP-om ili skladišnim sustavom? Recite nam što trebate povezati.

[Započnite besplatno probno razdoblje](https://glob-a.optiroutes.com/auth/register?utm_source=site&utm_medium=cta&utm_campaign=integrations)

## Česta pitanja

### Može li OptiRoutes automatski učitavati narudžbe iz našeg ERP-a?

Može. Vaš ERP može dnevnu datoteku odložiti na FTP ili SFTP poslužitelj OptiRoutesa, na vaš vlastiti FTP poslužitelj ili je prenijeti putem API-ja za datoteke, a OptiRoutes je sam učitava.

### Kako potpisane POD-ove prenijeti u naš sustav?

Putem API-ja za datoteke: izlistajte i preuzmite datoteke POD za dan ili ih preuzmite sve kao jedan ZIP. Kopija se šalje i e-poštom prema vašim pravilima slanja.

### Tko izrađuje API ključeve za API za datoteke?

Voditelj tvrtke, u izborniku Postavke, API i datoteke. Ključevi imaju dopuštenja, neobavezne dopuštene adrese i rok isteka, a mogu se opozvati u bilo kojem trenutku.

### Postoji li API za izvješća?

Postoji. API za izvješća vraća narudžbe, rute, vozače, kupce, POD i dnevni sažetak dostava, uz token koji izdaje OptiRoutes.

### U kojim formatima datoteka možemo izvoziti rute?

CSV, XLSX, XML, JSON i TXT s fiksnom širinom polja, sa stupcima i naslovima koje odaberete.

---

OptiRoutes · 1235 Jefferson Ave, Redwood City, CA 94062, USA · yoni@optiroutes.com · https://optiroutes.com/hr/