Для веб-агентств и разработчиков
Ваш клиент продаёт. Заказ фискализируется сам.
Делаете магазины клиентам в Сербии? Tezga это одобренный ESIR (IB 1597) с REST API и webhook. Заказ из магазина становится фискальным чеком через V-PFR, без устройства у клиента и без перепечатывания.
Путь одного заказа
- 01
Магазин
Заказ оплачен или получает статус, который вы выбрали.
- 02
Tezga API
Принимает заказ и выдаёт чек, один на заказ.
- 03
Налоговое управление
V-PFR фискализирует чек и возвращает номер PFR и QR.
- 04
Обратно
Номер чека, ссылка для проверки и PDF, а покупателю по желанию чек по почте.
Выберите путь для магазина
Готовые связи с магазинами есть в тарифах Posao и Biznis. Все связи в одном месте, вместе с Wix и Gomag через API, на странице Интеграции.
Все интеграции- WooCommerceПолная двусторонняя связь без плагина: заказы забираются каждые 30 минут, а номер чека записывается обратно в заказ.
- ShopifyДвусторонняя связь через custom-приложение в админке магазина.
- PrestaShop, OpenCart, Magento, BigCommerceЧерез webhook: магазин отправляет заказ, Tezga в ответе возвращает чек.
- Собственный сайт, приложение или автоматизацияОтправляете JSON, получаете фискальный чек. Тот же API используют n8n, Make и Zapier.
Технический минимум
POST https://pos.narbiz.com/api/integrations/order?provider=custom
X-Tezga-Api-Key: tzg_…
X-Tezga-Signature: sha256=… (опционально, HMAC-SHA256 тела)
Content-Type: application/json- Ключ и подпись
- API-ключ в заголовке X-Tezga-Api-Key, по одному на интеграцию. Тело по желанию подписывается секретом HMAC-SHA256. OAuth и mTLS мы не предлагаем.
- Без дублей чеков
- Каждый запрос несёт ваш externalId. Тот же externalId возвращает существующий чек, никогда не новый.
- События webhook
- racun.fiskalizovan, racun.greska, refundacija.izvrsena, storno.izvrsen. Тело подписано HMAC, а если ваш сервер не отвечает, отправка повторяется через 1, 5, 15, 60, 360 минут.
- Ограничение запросов
- По умолчанию 120 запросов в минуту на компанию для выдачи и 240 для чтения. К объявленному пику продаж мы поднимаем ограничение заранее.
Как выглядит работа с клиентом
На нас активация, правильность фискализации, документация и поддержка при интеграции. На клиенте аккаунт, оплата и элемент безопасности, а на вас код и решение, когда идёт продакшн. Подключение магазина делаем вместе с вами.
- 1
Клиент открывает свой аккаунт
Чек несёт PIB компании, которой принадлежит аккаунт, поэтому у каждого клиента свой аккаунт, свой элемент безопасности и своя подписка. Один аккаунт не выдаёт чеки для нескольких компаний.
- 2
Клиент сам вводит элемент безопасности
Сертификат, пароль и PAK клиент вводит в Настройки, Фискализация. Вы их не получаете и они вам не нужны; хранятся зашифрованными и не покидают сервер.
- 3
Клиент создаёт API-ключ для вашей интеграции
Именованный ключ, один на интеграцию. Клиент приостанавливает или отзывает его когда захочет, а ключ можно привязать к IP-адресам вашего сервера.
- 4
Тест на среде Налогового управления
Интеграцию вы проверяете на официальной sandbox-среде Налогового управления, с тестовым элементом безопасности. Ваш код не меняется до продакшна.
- 5
Переход на продакшн
Замена адреса и сертификата в настройках. API-ключ и код остаются теми же, поэтому новой разработки нет.
Частые вопросы
Может ли агентство выдавать чеки для нескольких клиентов с одного аккаунта?
Нет. Фискальный чек несёт PIB компании, которой принадлежит аккаунт, поэтому у каждого клиента свой аккаунт, свой элемент безопасности и своя подписка. Условия использования запрещают выдачу чеков третьим лицам через собственный аккаунт, кроме случаев, когда это отдельно оговорено в письменной форме.
Нужен ли плагин для WooCommerce?
Нет. WooCommerce подключается к Tezga полной двусторонней связью без плагина: Tezga забирает заказы каждые 30 минут и по кнопке Забрать, а номер чека записывает обратно в заказ.
Что происходит, когда V-PFR Налогового управления не отвечает?
Документ выдаётся и не теряется, а API возвращает HTTP 202 с ok:false и сообщением. Затем Tezga сама повторяет фискализацию и уведомляет вас через webhook, когда пройдёт. Тот же externalId никогда не создаёт другой чек, даже когда два запроса приходят одновременно.
Сколько длится интеграция?
До первого тестового чека обычно полдня рабочего времени с готовым программистом: один вызов для выдачи, один для проверки состояния и один для сторно. Переход на продакшн это изменение настроек, а не новая разработка.
Делаете магазин для клиента?
Напишите нам с описанием магазина (платформа, что продаётся, как оплачивается) и мы ответим конкретно, с примерами вызовов для этого случая.
Есть клиент, которому нужна фискализация?
Напишите нам с описанием магазина (платформа, что продаётся, как оплачивается) и мы ответим конкретно, с примерами вызовов для этого случая.