Вход Регистрация
За разработчици на бизнес софтуер

НАПИ Агент

Връзката между вашия софтуер и НАП

НАПИ Агент свързва вашия счетоводен, ТРЗ или ERP софтуер директно с НАП. Работи скрито локално, на компютъра с квалифицирания електронен подпис, и чрез стандартен REST API подава декларации и справки и връща данните от НАП — сигурно, автоматично и без ръчна работа в портала.

Изтегли за Windows Изтегли за macOS
За интегратори → API документация →
Прозорецът с настройките на НАПИ Агент: подател, КЕП сертификат, идентификатор и API ключ от НАП
Повече от подаване

НАПИ Агент не само подава, а и връща данни от НАП

НАПИ Агент дава на вашия софтуер всичко, което е в НАП за фирмите, до които има достъп вашият КЕП.

Подаване на декларацииДДС и VIES, декларации обр. 1 и 6, справки по чл. 73, електронни трудови записи, стоки с висок фискален риск, одиторски файл.
Резултати от НАПВходящ номер, статус приета или отхвърлена и документите от обработката за всяко подаване.
Задължени лицаСписък с фирмите и лицата, за които вашият КЕП може да работи в НАП.
Задължения, лихви и плащанияДължими суми, лихви, задължения и извършени плащания към НАП.
Справки и подадени файловеПодадени декларации и подписани файлове, текущи трудови договори и каталог с услугите на НАП.
Проверка преди подаванеЛокална проверка на файловете и откриване на декларациите в папка, без обръщение към НАП.
Как работи

Вашият софтуер говори с агента, агентът — с НАП

Заявките тръгват от вашето приложение към НАПИ Агент на компютъра на потребителя, а агентът ги изпраща към НАП с КЕП и връща отговора.

Вашият софтуер Счетоводен, ТРЗ или ERP — десктоп или уеб приложение
REST API · JSON заявка → · ← отговор
НАПИ Агент На компютъра с КЕП · Windows или macOS
КЕП · HTTPS подаване → · ← данни
НАП Тестов или реален сървър
За кого е?

За разработчици на счетоводен, ERP, ТРЗ и друг бизнес софтуер

ERP системи, счетоводен софтуер, онлайн счетоводни услуги и интегратори, които искат да добавят подаване към НАП директно в собствения си продукт.

ERP за счетоводна къщаПодаване директно от менюто на ERP-а.
Онлайн счетоводствоКлиентът натиска „Подай“ в браузъра.
Автоматични справкиПериодично изтегляне на справки и задължения от НАП за множество фирми.
Групови операцииЕдин избор на файлове или ЕИК-ове обработва множество декларации наведнъж.
Настройка

Как се настройва

1

Регистрация и секретен ключ за интегратор

Регистрирате се в napi.bg и издавате секретен ключ от профила си — тестов или реален. С него вашият софтуер получава достъп до НАПИ Агент.

2

Инсталиране на НАПИ Агент

Агентът се инсталира на компютъра, на който е поставен КЕП — Windows или macOS — и работи във фонов режим в системния трей до часовника. С двойно щракване върху иконката се отварят настройките.

3

Настройка на подател

В прозореца на агента се избира КЕП, ЕИК или ЕГН на подателя и се поставя API ключът от портала на НАП. Заявка за достъп до електронните услуги на НАП през API ↗

4

Вашият софтуер извиква агента

Приложението ви изпраща заявка към агента през REST API с JSON. Потребителят потвърждава подателя, въвежда PIN веднъж, а агентът връща отговора от НАП.

API документация

Всичко за интеграцията на едно място

  • Издаване на JWT от вашия backend — примери на curl, Node.js, C#, Python и PHP
  • Всички методи на агента по групи — полета на заявката и отговора и примерна заявка
  • Готов код за всеки метод на JavaScript, TypeScript, curl, Python, C# и Go
  • Податели, цели папки, файлове без локален път, batch операции и кодове за грешка
Към API документацията →
Среди

Тестова и реална среда

Тестова среда

За разработка и проверка

  • Тестов секретен ключ за интегратор, валиден 90 дни — агентът връща примерни данни, без обръщения към НАП
  • С тестов API ключ от НАП подаванията на декларации обр. 1 и 6, електронни трудови записи и стоки с висок фискален риск отиват към тестовия сървър на НАП. Подробно за режимите →
  • Подходяща за изграждане и проверка на интеграцията
Реална среда

За работа с реални данни

  • Реален секретен ключ — 7 дни до сключване на договор, след това безсрочен
  • С реален API ключ от НАП подаванията отиват към реалния сървър на НАП
  • Агентът разпознава средата сам по API ключа от НАП
Сигурност

Сигурност и защита на данните

КЕП остава при васПодписът се извършва от картата или токена на компютъра. Частният ключ никога не го напуска.
Еднократни краткотрайни достъпиВсяка заявка носи подписан от napi.bg достъп, валиден няколко секунди и неизползваем повторно.
Само на компютъраАгентът приема заявки само от същия компютър, не от мрежата.
Потвърждение от потребителяПреди работа с НАП потребителят избира подателя, а PIN кодът се въвежда от него.
Криптирани ключовеAPI ключът от НАП и запомненият PIN се пазят криптирани от Windows или macOS.
Защитена връзка с НАПВсички обръщения към НАП и napi.bg са по HTTPS.
Безплатно тестване и цени

Условия и цени

Разработвате и тествате безплатно. Плащате едва когато вашите клиенти започнат реална работа с НАП.

Безплатно
Тестови ключове
неограничено тестване
  • Издавате колкото тестови ключове ви трябват
  • Всеки ключ е валиден 90 дни
  • Неограничен брой заявки и ЕИК-ове
  • Примерни данни — без обръщения към НАП
Регистрирай се и вземи ключ
Безплатно
Реални ключове
за финално тестване с реални данни от НАП
  • До 2 реални ключа
  • Всеки ключ е активен 7 дни
  • До 3 ЕИК-а (задължени лица) на ключ
  • Трябва ви повече време за разработка? Свържете се с нас — ще удължим безплатния период колкото е необходимо.
Издай ключ от профила
Платено
Предплатени кредити
1 кредит = 1 фирма за 1 месец
всички възможности на НАПИ Агент
  • Без ограничение на инсталациите и КЕП-овете
  • Изразходвате 1 кредит за фирма за календарен месец, в който има обръщение към НАП за фирмата
  • Обръщенията към НАП по ЕГН не се таксуват
Регистрация за интегратор

Цените на кредитите според броя на фирмите ще бъдат обявени в електронния магазин. Изразходваните кредити се следят от профила в napi.bg.

За интегратори

Готови за интеграция?

Вашият софтуер стартира НАПИ Агент с един адрес и започва да подава и да чете данни от НАП. Операциите, режимите на работа и готовият код са на страницата за интегратори.

Към страницата за интегратори → API документация
Нямате профил? Регистрирайте се и вземете тестов ключ безплатно →
# Стартиране на агента от вашия софтуер window.location.href = "napiagent://launch"; # Готов ли е? GET http://127.0.0.1:5123/api/health
Свързани продукти
НАПИ приложениеГотов десктоп клиент, ако нямате собствен софтуер за интеграция. Стоки с висок фискален рискДекларации за превоз на стоки с висок фискален риск — и от спедиторски софтуер. Електронни трудови записиЕлектронни трудови записи — и от софтуер за труд и работна заплата.

НАПИ е независим софтуерен продукт и не е свързан официално с Националната агенция за приходите. Системата използва публично достъпните API услуги на НАП в съответствие с техническите изисквания.