Достъп до НАП през API

Достъп до услуги на НАП през API

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

1

Отворете услугата в портала на НАП

Влезте в портала на НАП с КЕП, отворете услугата „Достъп до услуги на НАП през API“ и натиснете „Ново заявление за достъп до API“.

Към услугата в портала на НАП ↗

  • API ключът е активен до деактивирането му, но не повече от 365 дни от издаването.
  • Нов ключ може да се заяви и преди изтичането на стария. Новото заявление не спира действието на издадените преди това ключове.
  • Преди изтичането на ключа НАП изпраща напомняне на имейла от заявлението.
Услугата „Достъп до услуги на НАП през API“ в портала на НАП
2

Попълнете заявлението

Данните за собственика на КЕП (електронния подпис), избраното задължено лице, имейлът и телефонът се попълват от портала. Въведете телефон, изберете „Издаване на ключ“ и в „Обхват на достъпа“ отметнете „Подаване на декларации и преглед на резултат“. Натиснете „Преглед на искането“.

„Издаване на ключ за тестови цели“ дава тестов API ключ, който насочва подаванията към тестовия сървър на НАП.
Ново заявление за достъп до услуги на НАП през API
3

Прегледайте и подайте заявлението

Проверете заявлението и го подайте. Запазете ключа веднага щом го видите на екрана. Ключът се показва само веднъж.

Преглед на заявлението за ползване на електронни услуги на НАП през API
4

Проверете пълномощните

Един API ключ, издаден на упълномощеното лице, важи за всички фирми, за които то има пълномощно с права за API достъп. Трябва да имате пълномощно с права за API достъп за всички фирми, за които подавате декларации.

5

Въведете API ключа

НАПИ приложение: за всяко упълномощено лице (или счетоводна кантора) се издава нов API ключ, като се ползва електронния подпис на лицето. Всяко лице може да подава с няколко свои подписа и с един и същи API ключ.

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

Как да тествам НАПИ4 стъпки до първото подаване
Как да тествам НАПИ

Тествайте НАПИ безплатно за 3 дни

Преди закупуване на абонамент можете да тествате НАПИ с реалните си фирми и да проверите работата на системата с вашите данни. Тестовият период е 3 дни и включва пълната функционалност на НАПИ.

1

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

Изтеглете инсталатора и инсталирайте приложението на компютъра, от който ще извършвате подаването.

Изтегли НАПИ (setup.exe)

2

Регистрирайте се в napi.bg

Безплатният тестов период започва автоматично от момента на регистрацията. Не се изисква банкова карта и след изтичането на тестовия период не се начислява такса.

Регистрирай се за 3 дни безплатно

3

Настройте НАПИ и започнете теста

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

За да тествате подаването с реалните си фирми, е необходимо да имате издаден API ключ от НАП и активни пълномощни за подаване чрез API за фирмите, които обработвате.
Бърз старт с НАПИНастройка и подаване на декларации
Бърз старт

Бърз старт с НАПИ

Без ограничения: НАПИ се закупува без ограничение в броя фирми, сертификати и машини — един абонамент покрива цялата кантора.
1

Първоначална настройка

След инсталиране попълнете данните за сертификата, с който подавате декларациите към НАП. За всеки сертификат задайте и API ключа, който сте поискали от НАП.

Задаване на подател в НАПИ
2

Заредете файловете — декларации образец 1 и 6

Изберете пътя до текстовите файлове с декларации 1 и 6 за всички фирми. Посочете месец и година, за да видите списъка само с декларациите за периода. След избора натиснете бутона „Подаване“.

Подаване на декларации 1 и 6
3

Декларации по чл. 73 от ЗДДФЛ

НАПИ поддържа и подаване на справки по чл. 73, ал. 1 ЗДДФЛ (изплатени доходи извън трудови правоотношения) и чл. 73, ал. 6 ЗДДФЛ (изплатени доходи и удържани данък и осигуровки).

Екран „Декларации по чл. 73“
4

Други декларации

Поддържат се също: стандартизиран одиторски файл чл. 3, ал. 17 Наредба №Н-18, електронни трудови записи за сключване, изменение и прекратяване на трудов договор, и ЕТЗ за промяна на работодател без прекратяване.

Екран „Други декларации“
5

Преглед на резултати

След завършване на подаването прегледайте статуса на всички декларации и експортирайте резултатите в различни формати.

Полезно: приетите декларации се показват в зелено, а отхвърлените — в червено, с подробно описание на грешката.
Преглед и експорт на резултати
Закупуване и активиране

Закупуване и активиране на абонамента

Целият процес се извършва онлайн. След успешно плащане абонаментът се активира автоматично, без допълнително потвърждение или ръчна активация.

1

Отворете електронния магазин

Закупуването на абонамент за НАПИ се извършва през електронния магазин.

Регистрацията в магазина е отделна от регистрацията в НАПИ. Можете да направите поръчка както с регистрация, така и без регистрация.

2

Изберете декларациите и периода

Добавете в количката необходимите видове декларации и справки и изберете месечен или годишен абонамент за всеки от тях.

3

Въведете имейла си от НАПИ

Посочете имейл адреса, с който сте регистрирани в napi.bg. Той се използва за свързване на закупения абонамент с вашия профил в НАПИ.

Ако все още нямате регистрация в НАПИ, можете да извършите покупката предварително. Абонаментът ще бъде свързан автоматично при регистрация в napi.bg със същия имейл адрес.

4

Въведете данните за документа

Посочете необходимите данни за издаване на платежен документ. При заявяване на фактура въведете данните на фирмата или физическото лице — име, ЕИК/ЕГН, адрес и регистрация по ДДС.

5

Потвърдете поръчката и извършете плащането

Прегледайте поръчката, приемете приложимите условия и извършете плащането онлайн.

След успешно плащане фактурата или електронната бележка се изпраща на имейл адреса, посочен при регистрацията в магазина.

6

Абонаментът се активира автоматично

След потвърждение на плащането достъпът до закупените функционалности се активира автоматично.

След това можете да инсталирате НАПИ и да започнете работа.

Виж цени и абонаменти

Изберете декларациите, от които имате нужда, и завършете поръчката в електронния магазин.

Виж цени и абонаменти → Ще бъдете пренасочени към електронния магазин на „Тейк Контрол“
Помощ за Java

НАПИ изисква Java 64-bit за работа с ДДС справки

Приложението НАПИ използва Java за комуникация с портала на НАП при подаване на ДДС справки. Ако Java не е инсталирана или е инсталирана 32-битова версия, подаването на ДДС справки няма да работи коректно. Следвайте стъпките по-долу, за да инсталирате правилната версия.

Ако виждате грешка с този или подобен текст: Can't load AMD 64-bit .dll on a IA 32-bit platform — това означава, че имате инсталирана 32-битова Java, а НАПИ изисква 64-битова. Следвайте стъпките по-долу, за да отстраните проблема.
1

Деинсталирайте старата Java

Преди да инсталирате новата версия, е препоръчително да премахнете старата Java от компютъра си. Това ще предотврати конфликти между версиите.

Отворете Control Panel (Контролен панел) → Programs (Програми) → Programs and Features (Програми и функции).

  1. В списъка намерете всички записи, започващи с Java (например Java 8 Update ..., Java(TM) ... и т.н.).
  2. Щракнете с десен бутон върху всеки запис на Java и изберете Uninstall (Деинсталирай).
  3. Следвайте указанията на екрана, за да завършите деинсталирането.
  4. Повторете за всички намерени версии на Java в списъка.
  5. Рестартирайте компютъра след деинсталирането, преди да продължите с инсталирането на новата версия.
Деинсталиране на Java от Programs and Features
Съвет: Можете също да натиснете Win + R, да напишете appwiz.cpl и да натиснете Enter, за да отворите директно прозореца с програмите.
2

Инсталирайте Java 64-bit

Отворете страницата за ръчно изтегляне на Java на адрес: https://www.java.com/en/download/manual.jsp

Изтеглете инсталацията, отбелязана в червено на изображението по-долу — Windows Offline (64-bit):

Изтегляне на Java 64-bit - изберете Windows Offline (64-bit)
  1. Стартирайте изтегления инсталационен файл.
  2. Следвайте стъпките на инсталатора и натиснете Install.
3

Инсталирайте OpenWebStart

Освен Java е необходимо да инсталирате и OpenWebStart, който се използва за стартиране на Java приложения от уеб.

Отворете страницата за изтегляне на адрес: https://openwebstart.com/download/

  1. Изтеглете OpenWebStart_windows-x64_1_13_0.exe (64-bit версията за Windows).
  2. Стартирайте изтегления файл и следвайте стъпките на инсталатора.
4

Рестартирайте компютъра

След приключване на инсталацията рестартирайте компютъра и стартирайте НАПИ.

Антивирусни програми

НАПИ се актуализира при всяко стартиране

Приложението сваля нова версия и записва файлове на диска при всяко отваряне. Част от антивирусните програми разпознават това поведение като потенциално опасно и блокират инсталацията. По-долу ще откриете как да позволите работата на НАПИ, ако използвате ESET или Panda.

Повечето антивирусни имат меню за Exclusions или Allowed applications, където можете да добавите конкретни файлове и папки. Ако не откривате такава опция, потърсете в документацията на вашата версия.

ESET — временно изключване на Folder Guard

Някои антивирусни програми не позволяват на инсталатора да записва файлове на диска. Ако и вие ползвате ESET, изключете опцията ESET Folder Guard, докато инсталирате. После може да я включите пак.

  1. Отворете ESET и изберете Setup → Computer Protection.
  2. Открийте настройката Folder Guard и натиснете Pause или изключете временно защитата.
  3. Стартирайте НАПИ и изчакайте да приключи обновяването.
  4. Включете обратно Folder Guard и добавете НАПИ към списъка с позволени приложения при нужда.

Ако опцията е заключена, ще е необходим администраторски акаунт, за да въведете паролата за настройките на ESET.

ESET настройка Folder Guard

Кликнете върху изображението, за да го отворите на цял екран.

Panda — добавяне на изключения

Panda реагира на чести обновявания с блокиране на автоматичното копиране на файлове. Добавете НАПИ към изключенията. Най-важното е да позволите на инсталатора да създава и заменя файлове при всяко стартиране.

  1. Отворете Panda и натиснете иконата на зъбно колело (Settings).
  2. Отидете в секцията Antivirus и изберете Files/Folders exclusions.
  3. Добавете файла NapiInstaller.exe и папката, в която е инсталирано приложението (например User/AppData/Local/Apps/2.0/XXXXXXXX). Името на папката е различно на всяка машина, но под нея има друга папка, съдържаща napi.exe.
  4. В секцията Application Control натиснете View details и маркирайте НАПИ като Allowed.
  5. Запазете промените, затворете Panda и стартирайте НАПИ отново, за да извърши обновяване.

Ако Panda все пак блокира инсталатора, временно изключете Real-time protection, стартирайте обновяването и след това я активирайте отново.

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