---
title: "Integrácie a API: súbory, objednávky a POD | OptiRoutes"
description: "Prepojte OptiRoutes s ERP: nahrávanie z Excelu a CSV, FTP alebo SFTP, API pre súbory na objednávky a podpísané POD, API pre zostavy, export trás a webhooky."
url: https://optiroutes.com/sk/integrations/
lang: sk-SK
updated: 2026-10-24
---

# Integrácie a API

OptiRoutes sa prepája so systémami, ktoré už používate. Objednávky prichádzajú zo súboru Excel alebo CSV, z FTP či SFTP alebo cez zabezpečené API pre súbory; podpísané dodacie listy, exporty trás a zostavy sa vracajú rovnakou cestou. API pre zostavy poskytuje vaše dáta nástrojom BI a webové adresy priebežne prijímajú hlásenia o doručení a exporty trás.

## Aké integrácie OptiRoutes ponúka?

| Potreba | Ako to OptiRoutes rieši |
| --- | --- |
| Načítanie objednávok na daný deň | Nahrávanie z Excelu alebo CSV, automatické načítanie z FTP, SFTP alebo cez API pre súbory, vo formáte CSV, JSON alebo TXT s pevnou šírkou. |
| Zber podpísaných POD | Volania API pre súbory za deň alebo za objednávku, prípadne jeden ZIP za deň; kópie e-mailom. |
| Odoslanie trás do vášho systému | Export trás vo formáte CSV, XLSX, XML, JSON alebo TXT do súboru, na váš FTP, do priečinka spoločnosti alebo na webovú adresu. |
| Zostavy do BI alebo vášho ERP | API pre zostavy: objednávky, trasy, vodiči, zákazníci, POD a denný súhrn doručení. |
| Reakcia na každé doručenie | Adresa pre hlásenia o doručení, ktorá prijme každé hlásenie hneď, ako vznikne. |
| Platba za službu | Stripe Checkout pre predplatené dobitia a automatické dobitie. |

## Načítanie objednávok zo súboru, FTP alebo SFTP

Najjednoduchšou integráciou je súbor, ktorý váš systém už exportuje. Na obrazovke objednávok **Načítať dodávky** prečíta súbor Excel alebo CSV; každé pole systému – adresu, meno zákazníka, číslo objednávky, množstvo a podobne – raz priradíte k názvu vášho stĺpca a každý ďalší súbor sa načíta rovnako. Pri súbore TXT s pevnou šírkou zadáte namiesto názvov stĺpcov pozície znakov. Riadky sa dajú preskočiť podľa značkového slova v poznámkach, druhá značka môže nahradiť adresu a rozhodnete, či sa existujúce číslo objednávky aktualizuje, alebo pridá ako nové.

Ak chcete ľudí z procesu úplne vynechať, zvoľte v nastaveniach spôsob automatického načítania:

- **Súborový server OptiRoutes** – váš systém uloží denný súbor pomenovaný podľa dátumu do priečinka vašej spoločnosti na FTP serveri alebo na šifrovanom SFTP serveri.
- **Váš vlastný FTP server** – OptiRoutes sa pripojí s používateľom, ktorého mu zadáte, a načíta súbor pomenovaný dnešným dátumom alebo naposledy aktualizovaný súbor.
- **Automatický import a export** – objednávky sa načítajú samy a naplánujú sa aj trasy, bez jediného kliknutia.
- **API pre súbory** – váš softvér nahrá súbor objednávok cez HTTPS, ako je opísané nižšie.

Na obrazovke zákazníkov súbor Excel alebo CSV s číslom zákazníka, názvom, adresou, časom zastávky a časmi otvorenia a zatvorenia vytvorí alebo aktualizuje zákazníkov a ich časové okná.

## API pre súbory: objednávky dnu, POD a zostavy von

Každá spoločnosť v OptiRoutes má vlastný súkromný priečinok so súbormi: objednávky, ktoré načítava, podpísané dodacie listy s fotografiami a podpismi, exporty trás a zostavy na konci dňa. **API pre súbory** umožňuje vašim systémom čítať a zapisovať do tohto priečinka priamo cez HTTPS, bez FTP servera medzi tým. Manažér spoločnosti prepína medzi FTP a API v **Nastavenia → API a súbory** a tam aj vytvára kľúče – netreba žiadať podporu a nové spoločnosti začínajú na API.

| Priečinok | Čo obsahuje | Kto zapisuje |
| --- | --- | --- |
| orders_files/ | Denný súbor objednávok a exporty trás. | Vy (objednávky), OptiRoutes (exporty) |
| pod/YYYY/MM/DD/ | Podpísané POD daného dňa: podpísané PDF, podpis a fotografie. | OptiRoutes |
| pod/ | Zdrojové dodacie listy na podpis v aplikácii pre vodičov, jedno PDF na číslo objednávky. | Vy |
| reports/YYYY/MM/ | Zostavy na konci dňa a zostavy vrátení. | OptiRoutes |
| podBaseFile/ | Základný formulár POD. | Vy |
| inbox/ | Voľný priečinok pre súbory, ktoré chcete odovzdať. | Vy |

Priečinok spoločnosti v API pre súbory.

Volania pokrývajú overenie kľúča, výpis priečinka, sťahovanie, nahrávanie (do 50 MB na súbor) a mazanie vami nahraných súborov, výpis súborov POD za deň podľa objednávky a druhu a stiahnutie všetkých súborov POD za deň ako jeden ZIP. Príručka obsahuje ukážky kódu v jazykoch Python, C# a Node.js a skript PowerShell, ktorý udržiava priečinok na vašom serveri synchronizovaný s priečinkom spoločnosti – takže tím zvyknutý na FTP môže pracovať rovnako ako doteraz. Prečítajte si ju v [príručke k API pre súbory](https://srv2.optiroutes.com/api/v1/docs?lang=sk).

## Ako sú zabezpečené kľúče API?

- **Minimálne oprávnenia** – každý kľúč dostane len oprávnenia, ktoré potrebuje: len podpísané POD, čítanie všetkých súborov alebo nahrávanie objednávok a súborov do inboxu.
- **Povolené adresy** – kľúč sa dá obmedziť na pevné IP adresy vášho servera.
- **Platnosť a rotácia** – kľúč môže po určitom počte dní vypršať; vytvorte nový kľúč, prepnite naň a potom starý zrušte bez výpadku.
- **Okamžité zrušenie** – zrušený kľúč prestane fungovať do 30 sekúnd.
- **Audit** – každé volanie sa zaznamenáva s časom, adresou, súborom a odpoveďou a zobrazuje sa manažérovi.
- **Bezpečné uloženie** – OptiRoutes uchováva z každého kľúča len odtlačok SHA-256; spojenia sú cez HTTPS s TLS 1.2 alebo novším a kľúč má prístup len k priečinku vlastnej spoločnosti.

Limity: 300 požiadaviek za minútu na kľúč, 50 MB na súbor, 20 aktívnych kľúčov na spoločnosť a až 5 000 položiek v jednom výpise priečinka.

## API pre zostavy a push

Pre nástroje na zostavy a konektory ERP poskytuje samostatné API na adrese api-users.optiroutes.com dáta vašej spoločnosti vo forme zostáv a prijíma odosielané (push) dáta. Jedna adresa a jeden token, ktorý vydá OptiRoutes pre vašu spoločnosť, pokrývajú všetky volania. Na stránke dokumentácie môžete vložiť svoj token a pozrieť si, ktoré zostavy máte k dispozícii a aké je priradenie stĺpcov vo vašom účte: [prečítajte si dokumentáciu API](https://api-users.optiroutes.com/api-docs/en).

| Zostava | Čo vracia |
| --- | --- |
| orders | Objednávky a dodávky s trasou a vodičom. |
| routes | Trasy s vodičom a počtom zastávok. |
| drivers | Údaje o vodičoch. |
| customers | Údaje o zákazníkoch a adresy. |
| pod | Dokumentácia doručenia. |
| delivery-summary | Denný súhrn podľa stavu. |

Dve volania typu push fungujú opačným smerom: odoslanie objednávok zapíše súbor objednávok na daný deň a spustí automatické načítanie a odoslanie vodičov, liniek a vozidiel nahradí celý vozový park, podobne ako súbor vozového parku. Keďže odoslaný zoznam vodičov sa považuje za celý vozový park, vždy posielajte všetkých vodičov, nielen zmeny.

## Export trás a webhooky

Export trás zapíše označené trasy vo formáte CSV, XLSX, XML, JSON alebo TXT s pevnou šírkou. Tabuľka stĺpcov určuje, ktoré polia sa exportujú a pod akým záhlavím, dajú sa pridať pôvodné stĺpce vášho súboru objednávok a so správou položiek druhý súbor uvedie každú položku. Exporty môžu ísť do vášho počítača, na váš FTP server alebo do priečinka spoločnosti a pri formáte JSON sa export môže odoslať aj na webovú adresu; ak odoslanie zlyhá, systém to skúsi ešte raz.

Pre každé doručenie v momente, keď sa uskutoční, vyplňte v nastaveniach aplikácie pre vodičov **adresu pre hlásenia o doručení**: každé hlásenie o doručení, ktoré vodiči urobia, sa pošle aj tam, takže sa váš iný systém aktualizuje sám.

## E-mail, platby, mapy a správy

- **E-mail** – podpísané dodacie listy odchádzajú z vášho vlastného účtu Gmail s heslom aplikácie Google; zostavy, ako je zostava paliet na konci dňa, idú na váš e-mail pre zostavy; platiaci zákazníci dostávajú z pokladne potvrdenia a vodiči potvrdenia o vklade.
- **Platby** – dobitia sa platia na zabezpečenej platobnej stránke Stripe, s voliteľne uloženou kartou na automatické dobitie.
- **Adresy a mapy** – adresy sa vyberajú z návrhov Google a pred plánovaním sa overujú na mape.
- **Navigácia** – aplikácia pre vodičov odovzdá každú zastávku do Waze alebo na iPhone do Apple Maps, podľa adresy alebo presných súradníc.
- **SMS a WhatsApp** – správy o príchode a odkazy na sledovanie zákazníkom, upozornenia manažérom, linky subdodávateľom a obrázky trás vodičom cez WhatsApp.

Plánujete integráciu s vaším ERP alebo skladovým systémom? Povedzte nám, čo potrebujete prepojiť.

[Vyskúšať zadarmo](https://glob-a.optiroutes.com/auth/register?utm_source=site&utm_medium=cta&utm_campaign=integrations)

## Často kladené otázky

### Dokáže OptiRoutes načítavať objednávky automaticky z nášho ERP?

Áno. Váš ERP môže denný súbor uložiť na FTP alebo SFTP server OptiRoutes, na váš vlastný FTP server alebo ho nahrať cez API pre súbory a OptiRoutes ho načíta sám.

### Ako dostaneme podpísané POD do nášho systému?

Cez API pre súbory: vypíšte a stiahnite súbory POD za daný deň alebo ich stiahnite všetky ako jeden ZIP. Kópia sa posiela aj e-mailom podľa vašich pravidiel smerovania.

### Kto vytvára kľúče pre API pre súbory?

Manažér spoločnosti v Nastavenia, API a súbory. Kľúče majú oprávnenia, voliteľne povolené adresy a platnosť a dajú sa kedykoľvek zrušiť.

### Existuje API pre zostavy?

Áno. API pre zostavy vracia objednávky, trasy, vodičov, zákazníkov, POD a denný súhrn doručení, s tokenom, ktorý vydá OptiRoutes.

### V akých formátoch súborov môžeme exportovať trasy?

CSV, XLSX, XML, JSON a TXT s pevnou šírkou, so stĺpcami a záhlaviami, ktoré si zvolíte.

---

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