--- title: "Integrációk és API: fájlok, rendelések és POD | OptiRoutes" description: "Kösse össze az OptiRoutes-t az ERP-jével: Excel/CSV, FTP vagy SFTP, fájl-API rendelésekhez és aláírt POD-okhoz, jelentés-API, útvonalexport, webhookok." url: https://optiroutes.com/hu/integrations/ lang: hu-HU updated: 2026-10-24 --- # Integrációk és API Az OptiRoutes a már használt rendszereihez kapcsolódik. A rendelések Excel- vagy CSV-fájlból, FTP-ről vagy SFTP-ről, illetve egy biztonságos fájl-API-n keresztül érkeznek; az aláírt szállítólevelek, az útvonalexportok és a jelentések ugyanígy jutnak vissza. Egy jelentés-API kiszolgálja az adatait a BI-eszközöknek, a webcímek pedig valós időben fogadják a kiszállítási jelentéseket és az útvonalexportokat. ## Milyen integrációkat kínál az OptiRoutes? | Igény | Hogyan oldja meg az OptiRoutes | | --- | --- | | A nap rendeléseinek betöltése | Excel- vagy CSV-feltöltés, automatikus betöltés FTP-ről, SFTP-ről vagy a fájl-API-n keresztül, CSV, JSON vagy rögzített szélességű TXT formátumban. | | Aláírt POD-ok begyűjtése | Fájl-API-hívások naponként vagy rendelésenként, vagy napi egy ZIP; másolatok e-mailben. | | Útvonalak küldése a rendszerébe | Útvonalexport CSV, XLSX, XML, JSON vagy TXT formátumban, fájlba, a saját FTP-jére, a cég mappájába vagy egy webcímre. | | Jelentések a BI-ba vagy az ERP-be | A jelentés-API: rendelések, útvonalak, sofőrök, ügyfelek, POD és napi kiszállítási összesítő. | | Reagálás minden kiszállításra | Egy kiszállításijelentés-cím, amely minden jelentést megkap, amint elkészül. | | A szolgáltatás kifizetése | Stripe Checkout az előre fizetett feltöltésekhez és az automatikus feltöltéshez. | ## Rendelések betöltése fájlból, FTP-ről vagy SFTP-ről A legegyszerűbb integráció az a fájl, amelyet a rendszere már most is exportál. A rendelések képernyőn a **Kiszállítások betöltése** beolvas egy Excel- vagy CSV-fájlt; minden rendszermezőt – cím, ügyfélnév, rendelésszám, mennyiség és így tovább – egyszer kell hozzárendelnie a saját oszlopnevéhez, és minden későbbi fájl ugyanígy töltődik be. Rögzített szélességű TXT-fájlnál oszlopnevek helyett karakterpozíciókat ad meg. A sorok egy megjegyzésben szereplő jelölőszóval kihagyhatók, egy második jelölő lecserélheti a címet, és Ön dönti el, hogy egy meglévő rendelésszám frissüljön-e, vagy újként kerüljön felvételre. Hogy kiiktassa a kézi lépéseket, válasszon automatikus betöltési módot a beállításokban: - **Az OptiRoutes fájlszervere** – a rendszere a dátummal elnevezett napi fájlt a cége mappájába teszi az FTP-szerveren vagy a titkosított SFTP-szerveren. - **Saját FTP-szerver** – az OptiRoutes az Ön által megadott felhasználóval kapcsolódik, és betölti a mai dátummal elnevezett vagy a legutóbb frissített fájlt. - **Automatikus import és export** – a rendelések maguktól töltődnek be, és az útvonalak is megtervezésre kerülnek, egyetlen kattintás nélkül. - **A fájl-API** – a szoftvere HTTPS-en tölti fel a rendelésfájlt, ahogy alább leírjuk. Az ügyfelek képernyőn egy ügyfélszámot, nevet, címet, megállási időt, valamint nyitási és zárási időt tartalmazó Excel- vagy CSV-fájl létrehozza vagy frissíti az ügyfeleket és az időablakaikat. ## A fájl-API: rendelések be, POD-ok és jelentések ki Az OptiRoutes-ban minden cégnek saját, privát fájlmappája van: az általa betöltött rendelések, az aláírt szállítólevelek fényképeikkel és aláírásaikkal, az útvonalexportok és a napvégi jelentések. A **fájl-API** lehetővé teszi, hogy a rendszerei közvetlenül, HTTPS-en olvassák és írják ezt a mappát, közbeiktatott FTP-szerver nélkül. A cég vezetője a **Beállítások → API és fájlok** menüpontban vált az FTP és az API között, és ott hozza létre a kulcsokat is – nem kell az ügyfélszolgálathoz fordulni, az új cégek pedig eleve az API-val indulnak. | Mappa | Mit tartalmaz | Ki írja | | --- | --- | --- | | orders_files/ | A napi rendelésfájl és az útvonalexportok. | Ön (rendelések), OptiRoutes (exportok) | | pod/YYYY/MM/DD/ | Az adott nap aláírt POD-jai: az aláírt PDF, az aláírás és a fényképek. | OptiRoutes | | pod/ | A sofőralkalmazásban aláírandó forrás-szállítólevelek, rendelésszámonként egy PDF. | Ön | | reports/YYYY/MM/ | Napvégi és visszárujelentések. | OptiRoutes | | podBaseFile/ | A POD alapűrlapja. | Ön | | inbox/ | Szabad mappa az átadni kívánt fájlokhoz. | Ön | A cég mappája a fájl-API-ban. A hívások lefedik a kulcs ellenőrzését, egy mappa listázását, a letöltést, a feltöltést (fájlonként legfeljebb 50 MB) és a saját feltöltésű fájlok törlését, egy nap POD-fájljainak listázását rendelés és típus szerint, valamint egy nap összes POD-fájljának letöltését egyetlen ZIP-ként. Az útmutató Python, C# és Node.js kódmintákat, valamint egy PowerShell-szkriptet tartalmaz, amely a szerverén lévő mappát szinkronban tartja a cég mappájával – így az FTP-hez szokott csapat ugyanúgy dolgozhat tovább. Olvassa el [a fájl-API útmutatóját](https://srv2.optiroutes.com/api/v1/docs?lang=hu). ## Hogyan védettek az API-kulcsok? - **Legkisebb jogosultság** – minden kulcs csak a szükséges jogosultságokat kapja meg: csak aláírt POD-ok, minden fájl olvasása, vagy rendelések és inbox-fájlok feltöltése. - **Engedélyezett címek** – egy kulcs a szervere fix IP-címeire korlátozható. - **Lejárat és csere** – egy kulcs adott számú nap után lejárhat; hozzon létre új kulcsot, váltson át, majd vonja vissza a régit, kiesés nélkül. - **Azonnali visszavonás** – a visszavont kulcs 30 másodpercen belül leáll. - **Naplózás** – minden hívás naplózásra kerül időponttal, címmel, fájllal és válasszal, és megjelenik a vezetőnek. - **Biztonságos tárolás** – az OptiRoutes minden kulcsból csak egy SHA-256 ujjlenyomatot őriz; a kapcsolatok TLS 1.2 vagy újabb protokollal védett HTTPS-en futnak, és egy kulcs csak a saját cégének mappáját éri el. Korlátok: kulcsonként percenként 300 kérés, fájlonként 50 MB, cégenként 20 aktív kulcs, és egy mappalistázásban legfeljebb 5000 bejegyzés. ## A jelentés- és push API A jelentéskészítő eszközök és az ERP-csatlakozók számára egy külön API az api-users.optiroutes.com címen jelentésként szolgálja ki cége adatait, és fogadja a beküldött adatokat. Egy cím és egy token, amelyet az OptiRoutes ad ki a cégének, minden hívást lefed. A dokumentációs oldalon beillesztheti a tokenjét, és megnézheti, mely jelentések érhetők el Önnek, valamint fiókja oszlop-hozzárendelését: [olvassa el az API-dokumentációt](https://api-users.optiroutes.com/api-docs/en). | Jelentés | Mit ad vissza | | --- | --- | | orders | Rendelések és kiszállítások, útvonallal és sofőrrel. | | routes | Útvonalak, sofőrrel és a megállók számával. | | drivers | Sofőradatok. | | customers | Ügyféladatok és címek. | | pod | Kiszállítási dokumentáció. | | delivery-summary | Napi összesítő állapot szerint. | Két push hívás a másik irányba működik: a rendelések beküldése megírja a nap rendelésfájlját, és elindítja az automatikus betöltést, a sofőrök, járatok és járművek beküldése pedig a teljes flottát lecseréli, mint egy flottafájl. Mivel a beküldött sofőrlista a teljes flottának számít, mindig minden sofőrt küldjön el, ne csak a változásokat. ## Útvonalak exportálása és webhookok Az útvonalexport a megjelölt útvonalakat CSV, XLSX, XML, JSON vagy rögzített szélességű TXT formátumban írja ki. Egy oszloptáblázat határozza meg, mely mezők kerülnek ki és milyen fejléccel, a rendelésfájl eredeti oszlopai hozzáadhatók, tételkezeléssel pedig egy második fájl minden tételt felsorol. Az export a számítógépére, az FTP-szerverére vagy a cég mappájába mehet, JSON esetén pedig egy webcímre is elküldhető; ha a küldés sikertelen, a rendszer még egyszer megpróbálja. Az egyes kiszállítások valós idejű követéséhez töltse ki a **kiszállítási jelentések címét** a sofőralkalmazás beállításaiban: a sofőrök minden kiszállítási jelentése oda is elküldődik, így egy másik rendszere magától frissül. ## E-mail, fizetés, térképek és üzenetküldés - **E-mail** – az aláírt szállítólevelek a saját Gmail-fiókjából, Google-alkalmazásjelszóval mennek ki; az olyan jelentések, mint a napvégi raklapjelentés, a jelentések e-mail-címére érkeznek; a pénztárból a fizető ügyfelek nyugtát, a sofőrök befizetési igazolást kapnak. - **Fizetés** – a feltöltéseket egy biztonságos Stripe fizetési oldalon fizeti, az automatikus feltöltéshez opcionálisan mentett kártyával. - **Címek és térképek** – a címeket a Google javaslatai közül választja ki, és tervezés előtt a térképen ellenőrizzük őket. - **Navigáció** – a sofőralkalmazás minden megállót a Waze-nek, iPhone-on az Apple Térképnek ad át, cím vagy pontos koordináták alapján. - **SMS és WhatsApp** – érkezési üzenetek és követési linkek az ügyfeleknek, figyelmeztetések a vezetőknek, járatok az alvállalkozóknak, és útvonalképek a sofőröknek WhatsAppon. Integrációt tervez az ERP- vagy raktárkezelő rendszerével? Mondja el, mit kell összekapcsolnia. [Ingyenes próba indítása](https://glob-a.optiroutes.com/auth/register?utm_source=site&utm_medium=cta&utm_campaign=integrations) ## Gyakran ismételt kérdések ### Betöltheti az OptiRoutes automatikusan a rendeléseket az ERP-rendszerünkből? Igen. Az ERP-je napi fájlt helyezhet el az OptiRoutes FTP- vagy SFTP-szerverén, a saját FTP-szerverén, vagy feltöltheti a fájl-API-n keresztül, az OptiRoutes pedig magától betölti. ### Hogyan kerülnek az aláírt POD-ok a rendszerünkbe? A fájl-API-n keresztül: listázza és töltse le egy nap POD-fájljait, vagy töltse le mindet egyetlen ZIP-ként. Egy másolatot a továbbítási szabályai szerint e-mailben is küldünk. ### Ki hozza létre a fájl-API kulcsait? A cég vezetője, a Beállítások, API és fájlok menüpontban. A kulcsoknak jogosultságaik, opcionálisan engedélyezett címeik és lejáratuk vannak, és bármikor visszavonhatók. ### Van API a jelentésekhez? Igen. A jelentés-API rendeléseket, útvonalakat, sofőröket, ügyfeleket, POD-ot és napi kiszállítási összesítőt ad vissza, az OptiRoutes által kiadott tokennel. ### Milyen fájlformátumokba exportálhatjuk az útvonalakat? CSV, XLSX, XML, JSON és rögzített szélességű TXT formátumba, az Ön által választott oszlopokkal és fejlécekkel. --- OptiRoutes · 1235 Jefferson Ave, Redwood City, CA 94062, USA · yoni@optiroutes.com · https://optiroutes.com/hu/