Что такое API-пользователь e-Factura и зачем он нужен?
SIA e-Factura - система SFS для электронных налоговых накладных, её портал - efactura.sfs.md. Вы входите в портал со своей подписью. У программы вашей подписи нет: она входит через API-пользователя, то есть логин и пароль, которые вы создаёте в портале для своей фирмы. API-пользователь видит только накладные этой фирмы.
Contabic нужен API-пользователь, чтобы отправлять ваши накладные в e-Factura черновиком и читать оттуда полученные накладные и статус отправленных. Подпись вы не передаёте: накладную по-прежнему подписываете вы, в портале. Что значит каждый её статус, рассказано в инструкции о статусах накладной e-Factura.
Кто создаёт API-пользователя?
Директор или администратор фирмы, своей электронной или мобильной подписью. В портал вы входите через MPass с подписью, выбираете фирму и входите с ролью Administrator. Для фирмы это делается один раз.
Что понадобится:
- электронная подпись (сертификат и PIN-код) или мобильная подпись;
- ваша фирма в Cabinetul personal al contribuabilului на sfs.md, с ролью Administrator;
- логин, e-mail и пароль для API-пользователя: в пароле не меньше 5 символов, и в нём есть @ или #.
Как создать API-пользователя в портале e-Factura?
Восемь шагов, от sfs.md до Contabic. Анимация показывает их по очереди на вымышленных данных; те же шаги текстом - под ней. Портал на румынском, поэтому кнопки названы так, как в портале.
Войдите в Cabinetul personal на sfs.md
Откройте sfs.md и нажмите Cabinetul personal вверху справа. На открывшейся странице нажмите Autentifică-te prin mpass.
Войдите через MPass с подписью
Выберите Semnătura electronică, затем свой сертификат и введите PIN-код подписи. Если у вас мобильная подпись, выберите Semnătura mobilă; остальные шаги те же.
Выберите фирму и роль Administrator
В окне Selectați rolul companiei выберите свою фирму в списке, затем роль Administrator.
Откройте e-Factura в разделе Servicii
Нажмите Servicii в меню слева и выберите e-Factura в списке электронных услуг. Портал e-Factura (efactura.sfs.md) откроется в новой вкладке.
Перейдите в Setările, затем в Utilizatorii companiei
В e-Factura нажмите Setările в верхней панели, затем Utilizatorii companiei в списке слева.
Нажмите Creează un utilizator API
Откроется форма Creează un Utilizator nou API, роль API User в ней уже выбрана.
Введите логин, имя, e-mail и пароль и нажмите Register
Заполните Numele Utilizatorului (login), имя и фамилию, E-mail и Parola: не меньше 5 символов, с @ или #. Нажмите Register. Новый пользователь появится в списке с ролью API User. Запишите логин и пароль.
Введите логин и пароль в Contabic
Вернитесь в Contabic, к шагу Conectează e-Factura, и введите логин в поле Utilizator SFS, а пароль в поле Parolă SFS, точно как в портале. Нажмите Conectează SFS: Contabic проверит их в SFS, прежде чем сохранить.
Официальная инструкция SFS для программ, которые отправляют накладные через API-пользователя: Ghid de integrare semi-automatizată e-Factura (PDF, на румынском).
Куда ввести API-пользователя в Contabic?
- В начале, на шаге Conectează e-Factura. После того как вы добавили фирму, Contabic показывает тот же путь по порталу, а под ним поля Utilizator SFS и Parolă SFS и кнопку Conectează SFS. Подписи нет под рукой? Нажмите Mai târziu.
- Позже, кнопкой Conectează SFS. Пока у вашей фирмы не подключён аккаунт e-Factura, над вашими накладными есть кнопка Conectează SFS с теми же двумя полями.
- В бухгалтерском бюро - в Setări → Acces SFS. Владелец аккаунта вводит там логин и пароль и нажимает Salvează. Там же Verifică заново проверяет аккаунт в SFS, а статус показывает «Configurat, verificat la» с датой или «Configurat, neverificat».
- Директор фирмы, которую ведёт бюро, тоже может подключить его из своего кабинета, пока бухгалтер не подключил аккаунт, уже подтверждённый SFS.
Везде Contabic проверяет логин и пароль в SFS, прежде чем сохранить. Если SFS их отклоняет, ничего не сохраняется.
Что Contabic хранит от API-пользователя и как?
- Логин и пароль - для вашей фирмы и только для неё. У каждой фирмы свой API-пользователь; Contabic не использует его для другой фирмы.
- Пароль зашифрован (Fernet: AES-128 с HMAC), а ключ шифрования хранится отдельно от базы данных, в конфигурации сервера.
- Пароль нельзя прочитать обратно. Ни один экран Contabic его не показывает, даже вам: чтобы сменить пароль, вы вводите его заново.
- Только владелец аккаунта фирмы в Contabic меняет или удаляет доступ к SFS. Сотрудники отправляют через него накладные, не видя его.
- При удалении доступа пароль удаляется полностью, а не просто отключается.
- Если SFS отклонит пароль, Contabic перестанет пробовать, чтобы ваш аккаунт не заблокировали.
Как сменить или отозвать API-пользователя?
Новый пароль в Contabic. Сохранённый пароль прочитать нельзя, поэтому его меняют, вводя заново. В бухгалтерском бюро владелец аккаунта вводит его в Setări → Acces SFS и нажимает Salvează; Contabic проверяет пароль в SFS, прежде чем сохранить. Там же Șterge accesul удаляет логин и пароль из Contabic. У вас своя фирма в Contabic Facturi и нужен другой API-пользователь? Напишите нам на contact@contabic.md.
Отзыв в портале. API-пользователем управляют в портале e-Factura, где его создали: он в разделе Setările → Utilizatorii companiei. Отозванный там пользователь больше не проходит в SFS: Contabic видит отказ и больше не пробует.
Что делать, если Contabic не принимает API-пользователя?
SFS отклоняет пароль
Contabic проверяет логин и пароль в SFS, прежде чем сохранить. Если SFS их отклоняет, ничего не сохраняется, и вы видите сообщение (приложение на румынском):
SFS a refuzat aceste date de acces. Nimic nu a fost salvat. Verificați utilizatorul și parola în portalul efactura.sfs.md.
Введите логин точно так, как в поле Numele Utilizatorului (login), а не e-mail, и пароль вместе с @ или #. Если SFS позже отклонит уже сохранённый пароль, Contabic перестанет пробовать, чтобы ваш аккаунт не заблокировали, и попросит ввести пароль заново.
Аккаунт принадлежит другой фирме
При проверке SFS принимает любой верный логин и пароль любой фирмы. Поэтому Contabic смотрит и на накладные этого аккаунта в SFS: если они принадлежат другой фирме, он его не сохраняет и сообщает, чей это аккаунт, например:
Utilizatorul API „firma_api” este al firmei ALTA FIRMA SRL (IDNO 1003600000001), nu al firmei FIRMA TA SRL. Nu l-am salvat. În portalul e-Factura, creează utilizatorul API al firmei FIRMA TA SRL.
Войдите в портал, выбрав свою фирму с ролью Administrator, и создайте API-пользователя там. Аккаунт, у которого ещё нет ни одной накладной, так распознать при сохранении нельзя; если он окажется чужим, Contabic остановит его при первом чтении из SFS.
Что работает без API-пользователя?
Начать можно и без него. Накладные сохраняются в Contabic со статусом Salvată, и вы отправляете их в SFS кнопкой Trimite la SFS, когда подключите аккаунт. В бухгалтерском бюро заявки директора всё равно доходят до бухгалтера.