---
title: "Integracijos ir API: failai, užsakymai ir POD | OptiRoutes"
description: "Prijunkite OptiRoutes prie savo ERP: Excel ir CSV įkėlimas, FTP ar SFTP, failų API užsakymams ir POD, ataskaitų API, maršrutų eksportas ir webhook."
url: https://optiroutes.com/lt/integrations/
lang: lt-LT
updated: 2026-10-24
---

# Integracijos ir API

OptiRoutes jungiasi prie jūsų jau naudojamų sistemų. Užsakymai atkeliauja iš Excel ar CSV failo, per FTP ar SFTP arba per saugų failų API; pasirašyti važtaraščiai, maršrutų eksportai ir ataskaitos grąžinami tuo pačiu keliu. Ataskaitų API teikia jūsų duomenis BI įrankiams, o interneto adresai pristatymų ataskaitas ir maršrutų eksportus gauna iškart, kai jie atsiranda.

## Kokias integracijas siūlo OptiRoutes?

| Poreikis | Kaip tai daro OptiRoutes |
| --- | --- |
| Įkelti dienos užsakymus | Excel ar CSV įkėlimas, automatinis įkėlimas per FTP, SFTP ar failų API, CSV, JSON ar fiksuoto pločio TXT formatu. |
| Surinkti pasirašytus POD | Failų API iškvietimai pagal dieną ar užsakymą arba vienas ZIP failas dienai; kopijos el. paštu. |
| Siųsti maršrutus į jūsų sistemą | Maršrutų eksportas CSV, XLSX, XML, JSON ar TXT formatu – į failą, jūsų FTP, įmonės aplanką ar interneto adresu. |
| Ataskaitos į BI ar jūsų ERP | Ataskaitų API: užsakymai, maršrutai, vairuotojai, klientai, POD ir kasdienė pristatymų suvestinė. |
| Reaguoti į kiekvieną pristatymą | Pristatymų ataskaitų adresas, gaunantis kiekvieną ataskaitą iškart, kai ji pateikiama. |
| Apmokėti paslaugą | Stripe Checkout išankstinio mokėjimo papildymams ir automatiniam papildymui. |

## Užsakymų įkėlimas iš failo, FTP ar SFTP

Paprasčiausia integracija – failas, kurį jūsų sistema jau eksportuoja. Užsakymų ekrane **Įkelti pristatymus** nuskaito Excel ar CSV failą; kiekvieną sistemos lauką – adresą, kliento pavadinimą, užsakymo numerį, kiekį ir kt. – vieną kartą susiejate su savo stulpelio pavadinimu, ir kiekvienas vėlesnis failas įkeliamas taip pat. Fiksuoto pločio TXT failui vietoj stulpelių pavadinimų nurodote simbolių pozicijas. Eilutes galima praleisti pagal žymos žodį pastabose, antroji žyma gali pakeisti adresą, o jūs nusprendžiate, ar esamas užsakymo numeris atnaujinamas, ar pridedamas kaip naujas.

Norėdami išvengti rankinio darbo, nustatymuose pasirinkite automatinio įkėlimo būdą:

- **OptiRoutes failų serveris** – jūsų sistema dienos failą, pavadintą data, įkelia į jūsų įmonės aplanką FTP serveryje arba šifruotame SFTP serveryje.
- **Jūsų pačių FTP serveris** – OptiRoutes prisijungia jūsų nurodytu naudotoju ir įkelia šiandienos data pavadintą failą arba vėliausiai atnaujintą failą.
- **Automatinis importas ir eksportas** – užsakymai įkeliami patys, o maršrutai taip pat suplanuojami, nereikia nė spustelėti.
- **Failų API** – jūsų programinė įranga įkelia užsakymų failą per HTTPS, kaip aprašyta toliau.

Klientų ekrane Excel ar CSV failas su kliento numeriu, pavadinimu, adresu, sustojimo trukme bei atidarymo ir uždarymo laiku sukuria ar atnaujina klientus ir jų laiko langus.

## Failų API: užsakymai įeina, POD ir ataskaitos išeina

Kiekviena OptiRoutes įmonė turi savo privatų failų aplanką: įkeliamus užsakymus, pasirašytus važtaraščius su nuotraukomis ir parašais, maršrutų eksportus ir dienos pabaigos ataskaitas. **Failų API** leidžia jūsų sistemoms tiesiogiai skaityti ir rašyti šį aplanką per HTTPS, be jokio tarpinio FTP serverio. Įmonės vadovas tarp FTP ir API persijungia skiltyje **„Nustatymai“ → „API ir failai“** ir ten pat sukuria raktus – kreiptis į pagalbos tarnybą nereikia, o naujos įmonės pradeda nuo API.

| Aplankas | Kas jame yra | Kas rašo |
| --- | --- | --- |
| orders_files/ | Dienos užsakymų failas ir maršrutų eksportai. | Jūs (užsakymai), OptiRoutes (eksportai) |
| pod/YYYY/MM/DD/ | Tos dienos pasirašyti POD: pasirašytas PDF, parašas ir nuotraukos. | OptiRoutes |
| pod/ | Šaltiniai – važtaraščiai, pasirašytini vairuotojų programėlėje, po vieną PDF kiekvienam užsakymo numeriui. | Jūs |
| reports/YYYY/MM/ | Dienos pabaigos ir grąžinimų ataskaitos. | OptiRoutes |
| podBaseFile/ | Bazinė POD forma. | Jūs |
| inbox/ | Laisvas aplankas failams, kuriuos norite perduoti. | Jūs |

Įmonės aplankas failų API.

Iškvietimai apima rakto tikrinimą, aplanko turinio pateikimą, atsisiuntimą, įkėlimą (iki 50 MB failui) ir jūsų įkeltų failų trynimą, dienos POD failų sąrašą pagal užsakymą ir rūšį bei visų dienos POD failų atsisiuntimą vienu ZIP failu. Vadove pateikti kodo pavyzdžiai Python, C# ir Node.js kalbomis bei PowerShell scenarijus, kuris jūsų serverio aplanką sinchronizuoja su įmonės aplanku, – todėl prie FTP pripratusi komanda gali dirbti taip pat. Skaitykite [failų API vadove](https://srv2.optiroutes.com/api/v1/docs?lang=lt).

## Kaip apsaugoti API raktai?

- **Mažiausios teisės** – kiekvienas raktas gauna tik reikalingus leidimus: tik pasirašyti POD, visų failų skaitymas arba užsakymų ir „inbox“ failų įkėlimas.
- **Leidžiami adresai** – raktą galima apriboti jūsų serverio fiksuotais IP adresais.
- **Galiojimas ir keitimas** – raktas gali nustoti galioti po tam tikro dienų skaičiaus; sukurkite naują raktą, persijunkite, tada atšaukite senąjį – be prastovų.
- **Atšaukimas iš karto** – atšauktas raktas nustoja veikti per 30 sekundžių.
- **Auditas** – kiekvienas iškvietimas registruojamas su laiku, adresu, failu ir atsakymu ir rodomas vadovui.
- **Saugus saugojimas** – OptiRoutes saugo tik kiekvieno rakto SHA-256 kontrolinį atspaudą; ryšiai – HTTPS su TLS 1.2 ar naujesne versija, o raktas pasiekia tik savo įmonės aplanką.

Ribos: 300 užklausų per minutę vienam raktui, 50 MB failui, 20 aktyvių raktų įmonei ir iki 5 000 įrašų viename aplanko sąraše.

## Ataskaitų ir duomenų siuntimo API

Ataskaitų įrankiams ir ERP jungtims atskiras API adresu api-users.optiroutes.com teikia jūsų įmonės duomenis kaip ataskaitas ir priima siunčiamus duomenis. Vienas adresas ir vienas OptiRoutes jūsų įmonei išduotas raktas apima visus iškvietimus. Dokumentacijos puslapyje galite įklijuoti savo raktą ir pamatyti, kurios ataskaitos jums prieinamos ir koks jūsų paskyros stulpelių susiejimas: [skaitykite API dokumentaciją](https://api-users.optiroutes.com/api-docs/en).

| Ataskaita | Ką ji grąžina |
| --- | --- |
| orders | Užsakymai ir pristatymai su maršrutu ir vairuotoju. |
| routes | Maršrutai su vairuotoju ir sustojimų skaičiumi. |
| drivers | Vairuotojų duomenys. |
| customers | Klientų duomenys ir adresai. |
| pod | Pristatymų dokumentai. |
| delivery-summary | Kasdienė suvestinė pagal būseną. |

Du siuntimo iškvietimai veikia priešinga kryptimi: siunčiant užsakymus įrašomas dienos užsakymų failas ir paleidžiamas automatinis įkėlimas, o siunčiant vairuotojus, linijas ir transporto priemones pakeičiamas visas autoparkas, kaip autoparko failu. Kadangi siunčiamas vairuotojų sąrašas laikomas visu autoparku, visada siųskite visus vairuotojus, o ne tik pakeitimus.

## Maršrutų eksportas ir webhook

Maršrutų eksportas pažymėtus maršrutus įrašo CSV, XLSX, XML, JSON ar fiksuoto pločio TXT formatu. Stulpelių lentelė nustato, kurie laukai eksportuojami ir kokiomis antraštėmis, galima pridėti originalius jūsų užsakymų failo stulpelius, o naudojant prekių valdymą antrame faile pateikiama kiekviena prekė. Eksportus galima siųsti į jūsų kompiuterį, jūsų FTP serverį ar įmonės aplanką, o JSON formato eksportą – ir interneto adresu; jei siuntimas nepavyksta, sistema bando dar kartą.

Kad kiekvieną pristatymą gautumėte iškart, vairuotojų programėlės nustatymuose užpildykite **pristatymų ataskaitų adresą**: kiekviena vairuotojų pateikta pristatymo ataskaita bus siunčiama ir ten, todėl kita jūsų sistema atsinaujins pati.

## El. paštas, mokėjimai, žemėlapiai ir žinutės

- **El. paštas** – pasirašyti važtaraščiai siunčiami iš jūsų pačių Gmail paskyros su Google programos slaptažodžiu; ataskaitos, pavyzdžiui, dienos pabaigos padėklų ataskaita, siunčiamos jūsų ataskaitų el. pašto adresu; mokėję klientai iš kasos gauna kvitus, o vairuotojai – įmokų patvirtinimus.
- **Mokėjimai** – papildymai apmokami saugiame Stripe mokėjimo puslapyje, su pasirinktinai išsaugoma kortele automatiniam papildymui.
- **Adresai ir žemėlapiai** – adresai pasirenkami iš Google pasiūlymų ir prieš planuojant patikrinami žemėlapyje.
- **Navigacija** – vairuotojų programėlė kiekvieną sustojimą perduoda Waze arba, iPhone telefone, Apple Maps – pagal adresą ar tikslias koordinates.
- **SMS ir WhatsApp** – žinutės apie atvykimą ir sekimo nuorodos klientams, įspėjimai vadovams, linijos subrangovams ir maršrutų paveikslėliai vairuotojams per WhatsApp.

Planuojate integraciją su savo ERP ar sandėlio sistema? Papasakokite, ką reikia sujungti.

[Išbandyti nemokamai](https://glob-a.optiroutes.com/auth/register?utm_source=site&utm_medium=cta&utm_campaign=integrations)

## Dažniausiai užduodami klausimai

### Ar OptiRoutes gali automatiškai įkelti užsakymus iš mūsų ERP?

Taip. Jūsų ERP gali kasdien įkelti failą į OptiRoutes FTP ar SFTP serverį, į jūsų pačių FTP serverį arba per failų API, o OptiRoutes jį įkelia pati.

### Kaip pasirašytus POD perkelti į mūsų sistemą?

Per failų API: gaukite dienos POD failų sąrašą ir atsisiųskite juos arba atsisiųskite visus vienu ZIP failu. Kopija taip pat siunčiama el. paštu pagal jūsų siuntimo taisykles.

### Kas sukuria failų API raktus?

Įmonės vadovas, skiltyje „Nustatymai“, „API ir failai“. Raktai turi leidimus, pasirinktinius leidžiamus adresus ir galiojimo terminą, o juos galima bet kada atšaukti.

### Ar yra ataskaitų API?

Taip. Ataskaitų API grąžina užsakymus, maršrutus, vairuotojus, klientus, POD ir kasdienę pristatymų suvestinę, naudojant OptiRoutes išduotą raktą.

### Kokiais failų formatais galime eksportuoti maršrutus?

CSV, XLSX, XML, JSON ir fiksuoto pločio TXT, su jūsų pasirinktais stulpeliais ir antraštėmis.

---

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