Настолен агент

1. Какво е и за какво служи

Агентът работи на един компютър (с икона до часовника). Върши две неща и нищо повече:

• Качва сканираното: всеки документ, който попадне в избраните от вас папки, стига до Asesia, без да отваряте браузъра.
• Сваля изпратеното към счетоводството (ако го включите): при «Изпращане към счетоводството» оставя пакета в папката, която чете счетоводната програма.
• Вижда само папките, които изберете. Не обхожда диска, не следва преки пътища и не качва скрити файлове или програми. В подпапките влиза само ако за тази папка сте отбелязали «Включване на подпапките».
• Не импортира нищо в счетоводната програма и никога не изтрива: каченото се премества в подпапка «subidos».

2. Кантора или фирма?

• Кантора: сканираното отива във Входящи и се разпределя автоматично между клиентите на човека, който свързва компютъра. На компютъра със счетоводната програма получава и пакетите на тези клиенти.
• Фирма: титулярят, влязъл във фирмения портал, отваря адреса /portal/agente/vincular (агентът го отваря сам с «Фирма клиент ли сте?»). Всичко сканирано отива направо във фирмата.

3. Какво е необходимо

• Компютър с Windows 10 или 11. Не е нужно да инсталирате нищо друго (нито Node.js, нито администраторски права).
• Вашият потребител в Asesia с право върху документите (кантора) или да сте титуляр (фирма).
• Компютърът да е включен и с отворена сесия в Windows, докато трябва да работи.

4. Изтегляне

1. 1В панела отворете «Входящи» и натиснете връзката «Свързване на компютър». Отваря се страницата на агента.
2. 2Натиснете «Изтегляне за Windows». Изтегля се AsesiaAgente.exe.

5. Инсталиране

1. 1Отворете AsesiaAgente.exe (от лентата за изтегляния на браузъра или от папката Изтегляния). Няма стъпки за следване: инсталира се сам, само за вашия потребител и без администраторски права.
2. 2Появява се в менюто Старт и на работния плот като «Агент на Asesia», както и в «Настройки → Приложения».
3. 3Веднага се отваря помощникът в браузъра. Когато го завършите, агентът се стартира с Windows (може да се изключи от панела му).
4. 4За обновяване изтеглете новата версия и я отворете по същия начин: затваря предишната, заменя я и запазва настройките ви.

Докато програмата няма цифров подпис, Windows може да покаже «Windows защити вашия компютър». Натиснете «Повече информация» и после «Изпълни въпреки това». Това е обичайното предупреждение за нова програма, която Windows още не познава.

6. Свързване на компютъра (без копиране)

1. 1Помощникът показва код, например «ABCD-EFGH». Натиснете «Отваряне на Asesia».
2. 2Отваря се Asesia (ако поиска вход, влезте и натиснете отново «Отваряне на Asesia»). Проверете, че се вижда името на ВАШИЯ компютър, и натиснете «Приемам».
3. 3Върнете се в помощника: след няколко секунди пише «Свързано» и минава на следващата стъпка. Токенът се пази криптиран с вашия акаунт в Windows.

Кодът изтича след 10 минути и важи само веднъж; ако изтече, натиснете «Нов код». Предпочитате да поставите токен? В помощника отворете «Предпочитам да поставя токен»: във Входящи натиснете «Токен за скенера», копирайте го, поставете го, натиснете «Проверка» и «Запазване».

7. Избор на папките, които може да вижда

Asesia ще вижда само папките, които изберете на тази стъпка, и нищо друго от компютъра:

1. 1Натиснете «Използване на Документи\Asesia\Escaneos» (агентът я създава) или «Добавяне на папка», за да изберете папката на скенера в прозореца на Windows.
2. 2Можете да добавите няколко (по една за скенер или за човек) и да премахнете всяка.
3. 3Настройте скенера да записва в една от тези папки.

Качва се това, което е в папката: PDF, JPG, PNG и WEBP, до 20 MB, и банкови извлечения (CSV, Excel, CAMT.053 или Norma 43). С отбелязано «Включване на подпапките» за дадена папка — и цялото ѝ дърво, до 8 нива (никога «subidos» или «errores»): всеки файл пристига с пътя си и се премества, като запазва подпапката си. Не се приемат цял диск, потребителската ви папка или папки на Windows. Ако папка изчезне или остане без права, панелът предупреждава.

8. Това ли е компютърът със счетоводната програма? (по желание)

• Ако на този компютър е счетоводната програма, отбележете «Да, това е компютърът на счетоводството». Пакетите ще се оставят в папката ѝ за импорт (може да се смени).
• «Разделяне по клиент»: всички заедно, подпапка по код на фирмата или по ЕИК/ДДС номер.
• Ако не, натиснете «Не сега». Може да се включи по-късно от панела на агента.

9. Проверка, че работи

1. 1На последната стъпка натиснете «Проба с документ» и изберете PDF: копира се във вашата папка и ще го видите в «Последни документи».
2. 2В Asesia се появява във Входящи (кантора) или в документите (фирма).
3. 3За пакетите: натиснете «Изпращане към счетоводството» при клиент. Когато агентът го вземе, изпращането минава в «Оставено в папката» с точния път.

«Оставено в папката» не е «импортирано»: импортирането го правите вие в счетоводната програма.

10. Стартиране с Windows и панел на агента

• Агентът се стартира сам с Windows и стои до часовника (икона на Asesia). Двойно щракване върху иконата или «Агент на Asesia» в менюто Старт отваря панела му.
• В панела: дали е свързан, последните документи, известията и какво да направите, папките, счетоводните пакети, «Стартиране с Windows», «Преглед на дневника» и «Прекратяване на връзката».

11. Ако нещо не работи

• «Няма връзка»: няма интернет или Asesia не отговаря. Документите чакат в папката си и се качват сами, когато връзката се върне.
• «Не е свързан»: някой е прекратил връзката в «Свързани компютри» или токените са отменени. Натиснете «Прекратяване на връзката» в панела и свържете отново.
• Документ отива в «errores»: сървърът го отхвърля (формат или размер). Отворете го и го запазете като PDF.
• «Избрана папка вече не съществува» или «няма права»: създайте я отново или я премахнете и изберете друга.
• Антивирусната програма го блокира: добавете «Агент на Asesia» в изключенията ѝ, докато програмата няма цифров подпис.
• Ако компютър се загуби или някой напусне: в «Свързване на компютър» → «Свързани компютри» натиснете «Прекратяване». Спира да качва веднага.

12. Премахване

1. 1Настройки на Windows → Приложения → «Агент на Asesia» → Деинсталиране.
2. 2Премахват се програмата, преките пътища и стартирането с Windows. Пита ви дали да изтрие и настройките (свързване, токен и избрани папки). Папките ви със сканирани документи не се пипат.
3. 3В Asesia, «Свързани компютри» → «Прекратяване», за да се отмени и на сървъра.

13. Mac, Linux или без права за инсталиране: версия в ZIP

Предишната версия е налична във Входящи («Изтегляне на агента»). Изисква Node.js 18 или по-нов (nodejs.org, бутон LTS), разархивира се в папка и се отваря с iniciar.bat (или iniciar.sh). Първия път иска токена от «Токен за скенера».

Primera puesta en marcha del agente de Asesia.
Pega el token que te da el panel (clic derecho o Ctrl+V) y pulsa Intro:
> eyJhbGciOiJIUzI1NiJ9.eyJraW5kIjoic2Nhbi1hZ2VudCIs…
… agente 2.2.0 en marcha · modo: cliente · carpeta: C:\Asesia-agente\entrada · servidor: https://…