Команда и администрирование
Печать документов 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 и не могут быть напечатаны приложением.
Однократная настройка
- В Sealed Print перейдите в Источники → Конечные точки API и выберите Новый API-эндпоинт. Выберите Маршрут, в который должны попадать документы, и скопируйте URL эндпоинта.
- В Stripe Dashboard установите приложение Sealed Print из Stripe App Marketplace и откройте его настройки.
- Вставьте URL в поле «API endpoint URL».
- В разделе «Documents» включите «Print automatically» для каждого вида документа, который нужен на бумаге. Выберите, «When» он печатается, количество «Copies» и, если он не должен попадать в назначение эндпоинта, «Identifiers» назначений, групп или рабочего процесса через запятую.
- Выберите «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 (экспериментально, см. выше).
Что дальше
- API-эндпоинты: эндпоинт, на котором работает приложение, также для ваших собственных программ.
- Очередь и маршруты
- Рабочие процессы