API для печати первичных документов

УПД, счёт-фактура, счёт, счёт-договор, акт выполненных работ, ТОРГ-12, товарно-транспортная накладная, коммерческое предложение - программно, по REST. Следим за изменениями налогового законодательства за вас. Быстрое подключение, прозрачные цены.

Подключиться Документация API

service-online.su с 2010 года · 50+ типов документов в системе

Что доступно сейчас

Скоро

• Excel (XLS) как альтернатива PDF - формат уже работает в веб-интерфейсе, добавляем в API

Нужна другая форма? Напишите - добавим. На сайте уже более 50 типов документов, любой можно добавить в API; сроки оговорим под вашу задачу.

Как это работает

После согласования вы получаете Bearer-токен. Все запросы - HTTP POST с JSON {form_id, data}. Два эндпоинта под разные сценарии:

POST /api/v1/documents/print
Передаёте JSON → получаете ссылку на готовый PDF. Сервер всё делает сам, без участия человека. Файл живёт около 30 минут - скачиваете и сохраняете у себя.

POST /api/v1/documents/prepare
Передаёте JSON → получаете ссылку на форму с предзаполненными данными (так выглядит пустая форма «счёт на оплату»; представьте её с заполненными полями вашего клиента). Нужен, когда конечному пользователю надо внести мелкие правки перед печатью: поправить сумму прописью, добавить комментарий, исправить опечатку, скорректировать наименование позиции. Пользователь открывает ссылку в браузере, правит, нажимает «Печать» сам. Ссылка одноразовая, живёт около 10 минут.

Структура запроса у обоих одинаковая. Пример для /print:

curl -X POST https://service-online.su/api/v1/documents/print \
  -H 'Authorization: Bearer YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "form_id": "upd",
    "data": {
      "seller": {"type": "ip", "name": "Иванов И. И.", "inn": "123456789012"},
      "buyer":  {"name": "ООО Покупатель", "inn": "7709876543"},
      "doc":    {
        "number":   "42",
        "date":     "2026-05-01",
        "currency": "643",
        "item": [
          {"tovar_name": "Услуга А", "tovar_kol": "1", "tovar_cena": "10000", "tovar_nds": "20"}
        ]
      }
    }
  }'

# Ответ:
# {"url": "/blank/upd/abc12345/upd-20260501-42.pdf", "expires_at": "2026-05-01T12:30:00Z"}

Полная документация и интерактивный «Try it» →

Почему service-online.su

• Интеграция, а не отдельный сервис. Ваши клиенты не регистрируются у нас, данные передаёте через API.
• Прозрачные цены. Базовый тариф указан прямо на странице, без «оставьте заявку».
• Российские бухгалтерские реалии. УПД, корректировки, XML для ЭДО, актуальные ставки НДС - следим за налоговым законодательством с 2010 года.
• Без обвязок. HTTP POST с JSON-телом, в ответ PDF. Никаких SDK, никаких странных протоколов.

Тарифы

Частые вопросы

В каком формате возвращается документ?

Сейчас: PDF. Эндпоинт /print возвращает JSON со ссылкой на готовый PDF, скачиваете по ней.
Скоро: Excel (XLS) - формат уже работает в веб-интерфейсе, в API добавим в ближайшее время. XML для ЭДО - по запросу.

Что происходит с PDF после генерации? Сколько он живёт?

После генерации PDF лежит на нашем сервере по временной ссылке около 30 минут, чтобы вы успели его скачать, затем автоматически удаляется. Долговременного архива у нас нет - скачайте сразу или проксируйте через свой сервер, если нужно долгосрочное хранение. Если нужна постоянная ссылка на документ - напишите, собираем запросы и добавим, если будет спрос.

Поддерживается ли НДС во всех режимах?

Да: с НДС, без НДС, ставки 0% / 10% / 20%, режимы «в т.ч.» (например "tovar_nds": "20") и «сверху» ("tovar_nds": "+20").

Можно задать произвольный номер документа?

Да, поле doc.number принимает любую строку.

Можно одним вызовом получить пакет «договор + счёт + УПД»?

Сейчас нет - это отдельные вызовы по каждой форме.

Нужна форма, которой нет в списке. Что делать?

Напишите - добавим. На сайте более 50 типов документов, добавить любую из них в API - выполнимая задача. Если форма редкая (нужна только вам) - обсудим, входит в стоимость или оплачивается отдельно.

Связаться

Или просто напишите: