---
title: "Integracije in API: datoteke, naročila in POD | OptiRoutes"
description: "OptiRoutes povežite s svojim ERP: nalaganje Excel in CSV, FTP ali SFTP, Files API za naročila in podpisane POD, API za poročila, izvoz poti in webhooki."
url: https://optiroutes.com/sl/integrations/
lang: sl-SI
updated: 2026-10-24
---

# Integracije in API

OptiRoutes se poveže s sistemi, ki jih že uporabljate. Naročila pridejo iz datoteke Excel ali CSV, prek FTP ali SFTP ali prek varnega Files API; podpisane dobavnice, izvozi poti in poročila se vrnejo po isti poti. API za poročila podatke posreduje orodjem BI, spletni naslovi pa sproti prejemajo poročila o dostavah in izvoze poti.

## Katere integracije ponuja OptiRoutes?

| Potreba | Kako to reši OptiRoutes |
| --- | --- |
| Nalaganje naročil dneva | Nalaganje datotek Excel ali CSV, samodejno nalaganje prek FTP, SFTP ali Files API, v obliki CSV, JSON ali TXT s fiksno širino. |
| Prevzem podpisanih POD | Klici Files API po dnevih ali po naročilih ali en ZIP na dan; kopije po e-pošti. |
| Pošiljanje poti v vaš sistem | Izvoz poti v CSV, XLSX, XML, JSON ali TXT, v datoteko, na vaš FTP, v mapo podjetja ali na spletni naslov. |
| Poročila v BI ali vaš ERP | API za poročila: naročila, poti, vozniki, stranke, POD in dnevni povzetek dostav. |
| Odziv na vsako dostavo | Naslov za poročila o dostavah, ki prejme vsako poročilo takoj, ko je oddano. |
| Plačilo storitve | Stripe Checkout za predplačniške polnitve in samodejno polnitev. |

## Nalaganje naročil iz datoteke, prek FTP ali SFTP

Najpreprostejša integracija je datoteka, ki jo vaš sistem že izvaža. Na zaslonu naročil **Naloži dostave** prebere datoteko Excel ali CSV; vsako polje sistema – naslov, ime stranke, številko naročila, količino in tako naprej – enkrat preslikate na ime svojega stolpca, vsaka poznejša datoteka pa se naloži na enak način. Pri datoteki TXT s fiksno širino namesto imen stolpcev navedete položaje znakov. Vrstice je mogoče preskočiti z oznako v opombah, druga oznaka lahko zamenja naslov, odločite pa se tudi, ali se obstoječa številka naročila posodobi ali doda kot novo.

Če želite ljudi izločiti iz postopka, v nastavitvah izberite način samodejnega nalaganja:

- **Datotečni strežnik OptiRoutes** – vaš sistem dnevno datoteko, poimenovano z datumom, odloži v mapo vašega podjetja na strežniku FTP ali na šifriranem strežniku SFTP.
- **Vaš lastni strežnik FTP** – OptiRoutes se poveže z uporabnikom, ki mu ga podate, in naloži datoteko, poimenovano z današnjim datumom, ali nazadnje posodobljeno datoteko.
- **Samodejni uvoz in izvoz** – naročila se naložijo sama, poti pa se tudi načrtujejo, brez enega samega klika.
- **Files API** – vaša programska oprema datoteko z naročili naloži prek HTTPS, kot je opisano spodaj.

Na zaslonu strank datoteka Excel ali CSV s številko stranke, imenom, naslovom, časom postanka ter časom odprtja in zaprtja ustvari ali posodobi stranke in njihova časovna okna.

## Files API: naročila noter, POD in poročila ven

Vsako podjetje v OptiRoutes ima svojo zasebno mapo datotek: naročila, ki jih naloži, podpisane dobavnice s fotografijami in podpisi, izvoze poti in poročila ob koncu dneva. **Files API** vašim sistemom omogoča, da to mapo berejo in vanjo pišejo neposredno prek HTTPS, brez vmesnega strežnika FTP. Vodja podjetja v **Nastavitve → API in datoteke** preklaplja med FTP in API ter tam ustvari ključe – zahteva podpori ni potrebna, nova podjetja pa začnejo z API.

| Mapa | Kaj vsebuje | Kdo piše |
| --- | --- | --- |
| orders_files/ | Dnevna datoteka z naročili in izvozi poti. | Vi (naročila), OptiRoutes (izvozi) |
| pod/YYYY/MM/DD/ | Podpisani POD tistega dne: podpisani PDF, podpis in fotografije. | OptiRoutes |
| pod/ | Izvorne dobavnice za podpis v aplikaciji za voznike, en PDF na številko naročila. | Vi |
| reports/YYYY/MM/ | Poročila ob koncu dneva in poročila o vračilih. | OptiRoutes |
| podBaseFile/ | Osnovni obrazec POD. | Vi |
| inbox/ | Prosta mapa za datoteke, ki jih želite predati. | Vi |

Mapa podjetja v Files API.

Klici pokrivajo preverjanje ključa, izpis mape, prenos, nalaganje (do 50 MB na datoteko) in brisanje datotek, ki ste jih naložili, izpis datotek POD dneva po naročilu in vrsti ter prenos vseh datotek POD dneva kot en ZIP. Vodnik vsebuje primere kode v Pythonu, C# in Node.js ter skripto PowerShell, ki mapo na vašem strežniku sproti usklajuje z mapo podjetja – tako lahko ekipa, vajena FTP, dela naprej na enak način. Preberite ga v [vodniku za Files API](https://srv2.optiroutes.com/api/v1/docs?lang=sl).

## Kako so zaščiteni ključi API?

- **Najmanjše potrebne pravice** – vsak ključ dobi le dovoljenja, ki jih potrebuje: le podpisani POD, branje vseh datotek ali nalaganje naročil in datotek v mapo inbox.
- **Dovoljeni naslovi** – ključ je mogoče omejiti na fiksne naslove IP vašega strežnika.
- **Potek in menjava** – ključ lahko poteče po določenem številu dni; ustvarite nov ključ, preklopite, nato prekličite starega, brez izpada.
- **Takojšen preklic** – preklican ključ preneha delovati v 30 sekundah.
- **Revizija** – vsak klic se zabeleži s časom, naslovom, datoteko in odgovorom ter prikaže vodji.
- **Varno shranjevanje** – OptiRoutes hrani le prstni odtis SHA-256 vsakega ključa; povezave so HTTPS s TLS 1.2 ali novejšim, ključ pa ima dostop le do mape svojega podjetja.

Omejitve: 300 zahtev na minuto na ključ, 50 MB na datoteko, 20 aktivnih ključev na podjetje in do 5.000 vnosov v enem izpisu mape.

## API za poročila in potiskanje podatkov

Za orodja za poročanje in povezovalnike ERP ločen API na api-users.optiroutes.com podatke vašega podjetja posreduje kot poročila in sprejema potisnjene podatke. En naslov in en žeton, ki ga OptiRoutes izda za vaše podjetje, pokrivata vse klice. Na strani z dokumentacijo lahko prilepite svoj žeton in vidite, katera poročila so vam na voljo in kakšna je preslikava stolpcev vašega računa: [preberite dokumentacijo API](https://api-users.optiroutes.com/api-docs/en).

| Poročilo | Kaj vrne |
| --- | --- |
| orders | Naročila in dostave, s potjo in voznikom. |
| routes | Poti, z voznikom in številom postankov. |
| drivers | Podatki o voznikih. |
| customers | Podatki o strankah in naslovi. |
| pod | Dokumentacija dostav. |
| delivery-summary | Dnevni povzetek po stanjih. |

Dva klica za potiskanje delujeta v nasprotni smeri: potiskanje naročil zapiše dnevno datoteko z naročili in zažene samodejno nalaganje, potiskanje voznikov, linij in vozil pa zamenja celoten vozni park, tako kot datoteka voznega parka. Ker potisnjeni seznam voznikov šteje kot celoten vozni park, vedno pošljite vse voznike, ne le sprememb.

## Izvoz poti in webhooki

Izvoz poti označene poti zapiše v CSV, XLSX, XML, JSON ali TXT s fiksno širino. Preglednica stolpcev določa, katera polja gredo ven in pod katerim naslovom, dodati je mogoče izvirne stolpce vaše datoteke z naročili, z upravljanjem artiklov pa druga datoteka navede vse artikle. Izvozi lahko gredo na vaš računalnik, vaš strežnik FTP ali v mapo podjetja, z JSON pa je izvoz mogoče poslati tudi na spletni naslov; če pošiljanje ne uspe, sistem poskusi še enkrat.

Za vsako dostavo sproti izpolnite **naslov za poročila o dostavah** v nastavitvah aplikacije za voznike: vsako poročilo o dostavi, ki ga oddajo vozniki, se pošlje tudi tja, tako da se drug vaš sistem posodobi sam.

## E-pošta, plačila, zemljevidi in sporočila

- **E-pošta** – podpisane dobavnice se pošiljajo z vašega lastnega računa Gmail z Googlovim geslom za aplikacije; poročila, kot je poročilo o paletah ob koncu dneva, gredo na vaš e-naslov za poročila; stranke, ki plačajo, z blagajne prejmejo potrdila, vozniki pa potrdila o pologu.
- **Plačila** – polnitve se plačajo na varni plačilni strani Stripe, z neobvezno shranjeno kartico za samodejno polnitev.
- **Naslovi in zemljevidi** – naslovi se izberejo med Googlovimi predlogi in se pred načrtovanjem preverijo na zemljevidu.
- **Navigacija** – aplikacija za voznike vsak postanek preda Waze ali Apple Maps na iPhonu, po naslovu ali natančnih koordinatah.
- **SMS in WhatsApp** – sporočila o prihodu in povezave za sledenje strankam, opozorila vodjem, linije podizvajalcem in slike poti voznikom prek WhatsApp.

Načrtujete integracijo s svojim sistemom ERP ali skladiščnim sistemom? Povejte nam, kaj morate povezati.

[Začnite brezplačni preizkus](https://glob-a.optiroutes.com/auth/register?utm_source=site&utm_medium=cta&utm_campaign=integrations)

## Pogosta vprašanja

### Ali lahko OptiRoutes naročila samodejno nalaga iz našega sistema ERP?

Da. Vaš ERP lahko dnevno datoteko odloži na strežnik FTP ali SFTP OptiRoutes, na vaš lastni strežnik FTP ali jo naloži prek Files API, OptiRoutes pa jo naloži sam.

### Kako podpisane POD prenesemo v naš sistem?

Prek Files API: izpišite in prenesite datoteke POD dneva ali jih vse prenesite kot en ZIP. Kopija se pošlje tudi po e-pošti po vaših pravilih pošiljanja.

### Kdo ustvarja ključe za Files API?

Vodja podjetja, v Nastavitve, API in datoteke. Ključi imajo dovoljenja, neobvezne dovoljene naslove in potek, preklicati pa jih je mogoče kadar koli.

### Ali obstaja API za poročila?

Da. API za poročila vrača naročila, poti, voznike, stranke, POD in dnevni povzetek dostav, z žetonom, ki ga izda OptiRoutes.

### V katere oblike datotek lahko izvažamo poti?

CSV, XLSX, XML, JSON in TXT s fiksno širino, s stolpci in naslovi, ki jih izberete.

---

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