Сертифицированные счета в вашем продукте. FIZ передаёт каждый счёт в AT.
FIZ выставляет от имени каждого клиента счета, которые ваше приложение запрашивает через API, и возвращает номер и PDF.
Для SaaS, маркетплейсов, платформ бронирования и программ для управления бизнесом. У каждого клиента свой аккаунт в FIZ, и клиент разрешает доступ вашему приложению.
Тестовое приложение без платного плана
- Гость
- Joana Lopes
- Проживание
- 2 ночи, двухместный номер
- Счёт от
- Casa do Largo, Lda
- Итого
- 180,00 €
- Счёт
- FT FIZ2026/57
Как FIZ выставляет счета из вашего приложения
Каждая продажа в Португалии требует сертифицированного счёта. FIZ выставляет его от имени каждого клиента через ваше приложение, поэтому вашему продукту не нужен собственный сертификат AT.
FIZ подключает приложение к каждому клиенту
FIZ показывает владельцу запрошенные разрешения. Владелец нажимает «Разрешить» и возвращается в ваше приложение.
FIZ выставляет счёт от имени клиента
Приложение передаёт через API данные покупателя, товары и суммы. В ответ FIZ возвращает номер счёта и PDF.
FIZ передаёт счёт в AT
FIZ делает это в момент выставления, как программа с сертификатом AT № 3041. Счета хранятся и в аккаунте клиента в FIZ.
Счета от имени продавца, с его NIF
Ваше приложение подключается к каждому клиенту с профилем в FIZ, будь то ИП или компания. На маркетплейсе таким клиентом является каждый продавец со своим NIF.
Новый клиент создаёт аккаунт FIZ прямо из вашего приложения, с email и NIF, и подключает AT сразу или позже. Затем он возвращается в ваше приложение.
А если подключение к AT будет позже?
До этого приложение уже может подключиться к клиенту и создавать черновики. Чтобы выставлять счета, профилю клиента нужны подключение к AT, включённая автоматическая передача счетов и серия счетов на этот год; приложение видит через API, чего не хватает.
- Casa do Largo, LdaКомпанияГотова выставлять счета
- Marta RibeiroИПГотова выставлять счета
- Loja Ponte, LdaКомпанияТолько черновики: нет подключения к AT
Одно подключение на профиль, с разрешения владельца
Что ваше приложение делает через API
Приложение создаёт карточки клиентов, товары и черновики. По его запросу FIZ выставляет счета, упрощённые счета, fatura‑recibo и кредит‑ноты на всю сумму, регистрирует оплаты с выдачей квитанции и аннулирует документы.
Разрешения владелец выдаёт один раз, и FIZ выставляет каждый документ по запросу приложения, без отдельного подтверждения. Приложение видит только свои записи, если не запросит доступ ко всем данным по счетам.
С какими данными работает приложение?
Название, NIF, CAE и серии профиля, счета, карточки клиентов и товары. К транспортным документам, счетам по расписанию, шаблонам, предварительным счетам и банковским транзакциям у приложения доступа нет.
Доступ клиентов к FIZ оплачивают клиенты или ваша платформа
Меняется только то, кто оплачивает доступ к FIZ: подключение к AT, разрешения и выставление счетов в обоих случаях одинаковые.
Что входит, если платит платформа?
Доступ через API и выставление документов через ваше приложение. Остальные платные функции FIZ, например декларации или PDF без логотипа FIZ, зависят от плана каждого клиента.
Каждый клиент оплачивает свой план FIZ
Если у клиента ещё нет платного плана, FIZ покажет ему планы при подключении вашего приложения.
Планы, в которых есть APIВаша платформа оплачивает доступ клиентов
Клиентам не нужен свой платный план. Условия мы согласуем с вами, а клиент при подключении видит, что доступ оплачивает ваша платформа.
Где виден ваш бренд, а где FIZ
Клиент видит FIZ при регистрации, при подключении к AT и когда разрешает доступ вашему приложению. Если у клиента платный план, PDF счёта выходит без логотипа FIZ.
В повседневной работе клиент выставляет счета, не выходя из вашего приложения.
- В вашем приложении
- Название и доменИнтерфейсПриём оплаты за ваш продукт
- Вне вашего приложения
- Аккаунт клиентаПодключение к ATУправление подключением
Владелец может отключить приложение в любой момент на странице «Интеграции» в FIZ. Аккаунт и выставленные документы остаются в FIZ.
- Reservas MarРазрешил: Rui Marçal
- Agenda NorteРазрешил: Rui Marçal
Начните с тестового приложения
Тестовое приложение подключается без платного плана к вашему профилю и профилям до 20 указанных вами людей. Счета в тесте настоящие; профиль компании выставляет их в пробный период или с платным планом. Клиенты подключаются к рабочему приложению (Production), одобренному FIZ.
Частые вопросы о FIZ для платформ
Нужен ли клиенту аккаунт в FIZ?
Да. Регистрация из вашего приложения ведёт клиента сразу к созданию профиля, без выбора плана. Профиль описывает деятельность, которую клиент уже ведёт как ИП или компания: создание профиля не открывает новую компанию.
Кто может разрешить подключение?
Владелец профиля в FIZ: ИП или владелец компании. Одно разрешение подключает к приложению один профиль; для другого профиля владелец даёт разрешение отдельно.
В каких планах FIZ есть API?
Все платные планы: Auto, Prime, Auto Pro и Prime Pro для ИП, FIZ Pro и FIZ Max для компаний. Клиент оплачивает план FIZ и получает также остальные функции этого плана.
Как протестировать интеграцию до подключения клиентов?
С помощью тестового приложения (Development): укажите email тестировщиков, даже если у них ещё нет аккаунта в FIZ. Каждый подключает профиль, владельцем которого является.
Пример на Node.js из GitHub подключает профиль и создаёт карточку клиента, товар и черновик счёта.
Что нужно, чтобы подключить первых клиентов?
Отдельное рабочее приложение (Production) с публичными HTTPS‑адресами и политикой конфиденциальности. Отправьте его на проверку на странице «Интеграции» в FIZ; после одобрения ваши клиенты смогут его подключить.
Если изменить уже одобренные настройки, приложение вернётся в черновик и будет недоступно клиентам, пока FIZ не одобрит его снова.
Когда нужен ключ API, а когда OAuth?
Ключ API подключает к FIZ системы того, кто его создал, например собственный сайт или CRM. OAuth подключает ваше приложение к каждому клиенту с разрешения владельца.
Может ли клиент пользоваться несколькими приложениями и FIZ напрямую?
Да. У каждого приложения своё подключение и свои записи, а клиент продолжает пользоваться FIZ с тем планом, который у него есть.
Кто на маркетплейсе выставляет счета за комиссии платформы?
Ваша компания, от своего имени. Если профиль вашей компании в FIZ тоже подключён к приложению, эти счета выставляет FIZ. Счета за продажи по‑прежнему выставляются от имени каждого продавца.
Как обсудить с FIZ свою платформу?
Расскажите нам по email, что делает ваша платформа и сколько клиентов вы планируете подключить. Остальное согласуем с вами, в том числе кто оплачивает доступ.