--- title: "Интеграции и API: файлове, поръчки и POD | OptiRoutes" description: "Свържете OptiRoutes с вашата ERP: качване на Excel и CSV, FTP или SFTP, API за файлове за поръчки и подписани POD, API за отчети, експорт и webhooks." url: https://optiroutes.com/bg/integrations/ lang: bg-BG updated: 2026-10-24 --- # Интеграции и API OptiRoutes се свързва със системите, които вече използвате. Поръчките постъпват от файл в Excel или CSV, от FTP или SFTP или чрез защитен API за файлове; подписаните стокови разписки, експортите на маршрути и отчетите се връщат по същия път. API за отчети предоставя данните ви на BI инструменти, а уеб адреси получават отчетите за доставки и експортите на маршрути в момента, в който се случват. ## Какви интеграции предлага OptiRoutes? | Нужда | Как го прави OptiRoutes | | --- | --- | | Зареждане на поръчките за деня | Качване на Excel или CSV, автоматично зареждане от FTP, SFTP или API за файлове, в CSV, JSON или TXT с фиксирана ширина. | | Събиране на подписани POD | Извиквания на API за файлове по ден или по поръчка или един ZIP за деня; копия по имейл. | | Изпращане на маршрутите към вашата система | Експорт на маршрути в CSV, XLSX, XML, JSON или TXT — във файл, към вашия FTP, папката на фирмата или уеб адрес. | | Отчети към BI или вашата ERP | API за отчети: поръчки, маршрути, шофьори, клиенти, POD и дневно обобщение на доставките. | | Реакция на всяка доставка | Адрес за отчети за доставки, който получава всеки отчет в момента на създаването му. | | Плащане за услугата | Stripe Checkout за предплатени зареждания и автоматично зареждане. | ## Зареждане на поръчки от файл, FTP или SFTP Най-простата интеграция е файлът, който системата ви вече експортира. В екрана за поръчки **Зареди доставки** прочита файл в Excel или CSV; съпоставяте всяко поле в системата — адрес, име на клиента, номер на поръчка, количество и т.н. — с името на вашата колона веднъж и всеки следващ файл се зарежда по същия начин. За TXT файл с фиксирана ширина задавате позиции на символите вместо имена на колони. Редове могат да се пропускат по ключова дума в забележките, втора ключова дума може да замени адреса, а вие решавате дали съществуващ номер на поръчка се актуализира, или се добавя като нов. За да премахнете ръчната намеса, изберете метод за автоматично зареждане в настройките: - **Файловият сървър на OptiRoutes** — вашата система оставя дневния файл, именуван по датата, в папката на фирмата ви на FTP сървъра или на криптирания SFTP сървър. - **Собственият ви FTP сървър** — OptiRoutes се свързва с потребителя, който му дадете, и зарежда файла с днешна дата в името или най-скоро обновения файл. - **Автоматичен импорт и експорт** — поръчките се зареждат сами, а маршрутите също се планират, без да е нужно щракване. - **API за файлове** — вашият софтуер качва файла с поръчки през HTTPS, както е описано по-долу. В екрана за клиенти файл в Excel или CSV с клиентски номер, име, адрес, време за престой и час на отваряне и затваряне създава или актуализира клиентите и техните времеви прозорци. ## API за файлове: поръчки навътре, POD и отчети навън Всяка фирма в OptiRoutes има собствена частна папка с файлове: поръчките, които зарежда, подписаните стокови разписки със снимките и подписите им, експортите на маршрути и отчетите в края на деня. **API за файлове** позволява на вашите системи да четат и записват в тази папка директно през HTTPS, без FTP сървър по средата. Мениджърът на фирмата превключва между FTP и API в **Настройки → API и файлове** и създава ключовете там — не е нужна заявка към поддръжката, а новите фирми започват с API. | Папка | Какво съдържа | Кой записва | | --- | --- | --- | | orders_files/ | Дневният файл с поръчки и експортите на маршрути. | Вие (поръчки), OptiRoutes (експорти) | | pod/YYYY/MM/DD/ | Подписаните POD за този ден: подписаният PDF, подписът и снимките. | OptiRoutes | | pod/ | Изходни стокови разписки за подписване в приложението за шофьори, по един PDF за всеки номер на поръчка. | Вие | | reports/YYYY/MM/ | Отчети за края на деня и за връщанията. | OptiRoutes | | podBaseFile/ | Базовият формуляр за POD. | Вие | | inbox/ | Свободна папка за файлове, които искате да предадете. | Вие | Папката на фирмата в API за файлове. Извикванията обхващат проверка на ключа, изброяване на папка, изтегляне, качване (до 50 MB на файл) и изтриване на качени от вас файлове, изброяване на файловете с POD за деня по поръчка и вид и изтегляне на всички файлове с POD за деня като един ZIP. Ръководството включва примерен код на Python, C# и Node.js и PowerShell скрипт, който поддържа папка на вашия сървър синхронизирана с папката на фирмата — така екип, свикнал с FTP, може да продължи да работи по същия начин. Прочетете го в [ръководството за API за файлове](https://srv2.optiroutes.com/api/v1/docs?lang=bg). ## Как са защитени API ключовете? - **Минимални права** — всеки ключ получава само разрешенията, от които се нуждае: само подписани POD, четене на всички файлове или качване на поръчки и файлове във входящата папка. - **Разрешени адреси** — ключът може да бъде ограничен до фиксираните IP адреси на вашия сървър. - **Срок на валидност и смяна** — ключът може да изтече след определен брой дни; създайте нов ключ, превключете към него и след това анулирайте стария, без прекъсване. - **Незабавно анулиране** — анулираният ключ спира да работи до 30 секунди. - **Одит** — всяко извикване се записва с час, адрес, файл и отговор и се показва на мениджъра. - **Сигурно съхранение** — OptiRoutes пази само SHA-256 отпечатък на всеки ключ; връзките са през HTTPS с TLS 1.2 или по-нова версия, а ключът има достъп само до папката на собствената си фирма. Ограничения: 300 заявки на минута на ключ, 50 MB на файл, 20 активни ключа на фирма и до 5000 записа в едно изброяване на папка. ## API за отчети и подаване на данни За инструменти за отчети и конектори към ERP отделен API на api-users.optiroutes.com предоставя данните на фирмата ви като отчети и приема подадени данни. Един адрес и един токен, издаден от OptiRoutes за вашата фирма, обхващат всяко извикване. Страницата с документацията ви позволява да поставите токена си и да видите кои отчети са отворени за вас и съпоставянето на колоните за вашия акаунт: [прочетете документацията на API](https://api-users.optiroutes.com/api-docs/en). | Отчет | Какво връща | | --- | --- | | orders | Поръчки и доставки, с маршрут и шофьор. | | routes | Маршрути, с шофьор и брой спирки. | | drivers | Данни за шофьорите. | | customers | Данни и адреси на клиентите. | | pod | Документация за доставките. | | delivery-summary | Дневно обобщение по статуси. | Две извиквания за подаване работят в обратна посока: подаването на поръчки записва файла с поръчки за деня и стартира автоматичното зареждане, а подаването на шофьори, линии и превозни средства заменя целия автопарк, както файл с автопарка. Тъй като подаденият списък с шофьори се счита за целия автопарк, винаги изпращайте всички шофьори, а не само промените. ## Експорт на маршрути и webhooks Експортът на маршрути записва отбелязаните маршрути в CSV, XLSX, XML, JSON или TXT с фиксирана ширина. Таблица с колони определя кои полета излизат и под какво заглавие, могат да се добавят оригинални колони от файла ви с поръчки, а при управление на артикули втори файл изброява всеки артикул. Експортите могат да отиват на компютъра ви, към вашия FTP сървър или в папката на фирмата, а при JSON експортът може да се изпрати и на уеб адрес; ако изпращането е неуспешно, системата опитва още веднъж. За всяка доставка в момента, в който се случва, попълнете **адреса за отчети за доставки** в настройките на приложението за шофьори: всеки отчет за доставка, който шофьорите правят, се изпраща и там, така че друга ваша система да се актуализира сама. ## Имейл, плащания, карти и съобщения - **Имейл** — подписаните стокови разписки се изпращат от собствения ви Gmail акаунт с парола за приложения на Google; отчети като отчета за палетите в края на деня отиват на имейла ви за отчети; плащащите клиенти получават разписки, а шофьорите — потвърждения за внесени суми от касата. - **Плащания** — зарежданията се плащат на защитена страница за плащане на Stripe, с възможност за запазване на карта за автоматично зареждане. - **Адреси и карти** — адресите се избират от предложенията на Google и се проверяват на картата преди планирането. - **Навигация** — приложението за шофьори предава всяка спирка на Waze или на Apple Maps на iPhone, по адрес или по точни координати. - **SMS и WhatsApp** — съобщения за пристигане и връзки за проследяване до клиентите, предупреждения до мениджърите, линии до подизпълнителите и изображения на маршрути до шофьорите в WhatsApp. Планирате интеграция с вашата ERP или складова система? Кажете ни какво трябва да свържете. [Започнете безплатно](https://glob-a.optiroutes.com/auth/register?utm_source=site&utm_medium=cta&utm_campaign=integrations) ## Често задавани въпроси ### Може ли OptiRoutes да зарежда поръчки автоматично от нашата ERP система? Да. Вашата ERP система може да оставя дневен файл на FTP или SFTP сървъра на OptiRoutes, на собствения ви FTP сървър или да го качва чрез API за файлове, а OptiRoutes го зарежда сам. ### Как да получим подписаните POD в нашата система? Чрез API за файлове: изброявайте и изтегляйте файловете с POD за даден ден или ги изтеглете всички като един ZIP. Копие се изпраща и по имейл според правилата ви. ### Кой създава API ключовете за API за файлове? Мениджърът на фирмата, в „Настройки“, „API и файлове“. Ключовете имат разрешения, по избор разрешени адреси и срок на валидност и могат да бъдат анулирани по всяко време. ### Има ли API за отчети? Да. API за отчети връща поръчки, маршрути, шофьори, клиенти, POD и дневно обобщение на доставките, с токен, издаден от OptiRoutes. ### В какви файлови формати можем да експортираме маршрутите? CSV, XLSX, XML, JSON и TXT с фиксирана ширина, с избраните от вас колони и заглавия. --- OptiRoutes · 1235 Jefferson Ave, Redwood City, CA 94062, USA · yoni@optiroutes.com · https://optiroutes.com/bg/