Все руководства

Команда и администрирование

Печать документов Stripe

Автоматически печатайте счета, кредит-ноты, коммерческие предложения и чеки из Stripe с помощью приложения Sealed Print для Stripe.

Приложение Sealed Print для Stripe печатает документы, которые Stripe создаёт в вашей учётной записи: счета, кредит-ноты, коммерческие предложения и чеки об оплате. Для каждого вида документа вы решаете, печатать ли его, когда и куда. Приложение отправляет каждый документ на API-эндпоинт вашей организации, поэтому каждый из них становится заданием от имени владельца эндпоинта, как любой другой документ.

Что понадобится

  • Учётная запись Stripe, в которой вам разрешено устанавливать приложения (роль Stripe «Administrator»).
  • Администратор включает входящий канал REST API в разделе Настройки → Входящие каналы.
  • API-эндпоинт, назначение которого должно получать документы.
  • Для нескольких идентификаторов на один вид документа или для группы назначений нужен тариф Team (см. Группы назначений).
ДокументМожет печататься
СчетаКогда счёт выставлен, отправлен или оплачен
Кредит-нотыКогда кредит-нота создана
Коммерческие предложенияКогда предложение выставлено или принято
Чеки (экспериментально)Когда платёж прошёл успешно или возвращён

Stripe предоставляет чеки только как веб-страницу. Sealed Print печатает их PDF-версию, которую Stripe не документирует; если Stripe её изменит, чеки перестанут печататься, пока мы не адаптируем приложение. Собственные счета Stripe за его комиссии доступны только в Stripe Dashboard и не могут быть напечатаны приложением.

Однократная настройка

  1. В Sealed Print перейдите в Источники → Конечные точки API и выберите Новый API-эндпоинт. Выберите Маршрут, в который должны попадать документы, и скопируйте URL эндпоинта.
  2. В Stripe Dashboard установите приложение Sealed Print из Stripe App Marketplace и откройте его настройки.
  3. Вставьте URL в поле «API endpoint URL».
  4. В разделе «Documents» включите «Print automatically» для каждого вида документа, который нужен на бумаге. Выберите, «When» он печатается, количество «Copies» и, если он не должен попадать в назначение эндпоинта, «Identifiers» назначений, групп или рабочего процесса через запятую.
  5. Выберите «Save», затем «Check connection». Когда появится сообщение «Everything is ready», новые документы будут печататься. Поле «API endpoint URL» и дальше показывает подключённый URL, поэтому позже видно, какой endpoint настроен.

В Stripe живой и тестовый режимы имеют отдельные настройки, поэтому всё можно сначала проверить на тестовых данных.

Каждый раз

  • Новые документы печатаются сами. Они появляются в очереди как задания с названием документа, например «Invoice INV-0042 – Example Ltd», с входящим каналом REST API.
  • Каждый документ печатается один раз на событие, даже если Stripe отправит событие повторно.
  • Чтобы напечатать счёт вручную, откройте его в Stripe Dashboard и выберите «Print with Sealed Print» на панели Sealed Print. При этом используются идентификаторы и число копий из правила для счетов, даже если автоматическая печать выключена.
  • Если первым идентификатором указан рабочий процесс, документы проходят через него, например чтобы сначала быть подписанными (см. Рабочие процессы). Идентификатор hold оставляет их в Sealed Print, пока кто-нибудь их не отправит.
  • Чтобы отправлять счета клиентам в виде электронных счетов (ZUGFeRD или XRechnung), укажите для счетов идентификатор рабочего процесса с шагами Преобразовать в электронный счет и Отправить по электронной почте. Шаг отправки отправляет счет на адрес электронной почты покупателя, считанный из счета (см. пример в Рабочие процессы).

Устранение неполадок

  • «Check connection» показывает, что мешает печати, с теми же сообщениями, которые приложение использует ниже.
  • «The URL of the API endpoint was renewed»: кто-то выбрал Создать новый URL. Вставьте новый URL.
  • «The API endpoint no longer exists»: создайте новый эндпоинт и вставьте его URL.
  • «There is no destination, group or workflow with the identifier …»: проверьте написание идентификатора у назначения, а также что владелец эндпоинта может в него печатать (назначение другого пользователя должно быть открыто для всех).
  • «The inbound channel REST API is turned off»: администратор включает его в разделе Настройки → Входящие каналы.
  • Счёт не печатается: у черновиков нет PDF. Stripe создаёт его, когда счёт выставляется.
  • Чек не печатается: Stripe не предоставил чек в формате PDF (экспериментально, см. выше).

Что дальше