Усі посібники

Команда та адміністрування

Друк документів Stripe

Автоматично друкуйте рахунки, кредитові ноти, комерційні пропозиції та квитанції зі Stripe за допомогою застосунку Sealed Print для Stripe.

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

Застосунок у Stripe Dashboard доступний англійською мовою, тому назви його елементів нижче наведено англійською.

Передумови

  • Обліковий запис 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 налаштовано.

Режим live і тестовий режим у 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 (експериментально, див. вище).

Що далі