Queue and targets
Workflows
Run documents through steps in order, such as signatures, AI analysis, e-invoices and emails, and send them on afterwards.
A workflow is a target with steps. A document sent to it runs through its steps in order and then goes to the targets of the workflow, for example: request signatures first, then print the signed document on the office printer. You choose a workflow like any other target: when uploading, as a printer URL, for an email address or API endpoint, or as your default target.
These steps are available:
- Signatures: you choose who signs where, the signers sign by email link, and the document is sealed. Because this needs your input, the job waits for you first.
- AI analysis: AI reads values from the document after your instruction, for example a customer number or an email address.
- Convert into an e-invoice: AI reads the invoice, the data are checked with the official rules and embedded into the PDF as ZUGFeRD or XRechnung.
- Send by email: sends the document as an attachment, for example to an address an earlier step read from the document.
Steps can return values that later steps use, much like the outputs of a CI pipeline: the step Convert into an e-invoice returns, among others, the buyer's email address, and Send by email can send the e-invoice to it.
Prerequisites
- Signatures need a plan with electronic signatures (Team, Business, or Free with pay per use). See Electronic signatures.
- AI analysis and Convert into an e-invoice count AI actions: Team and Business include a monthly volume, Free uses pay per use. One AI action covers up to five pages. See Plans and billing.
- Send by email needs email in your plan and the outbound channel Email switched on by an admin under Settings → Outbound channels. Every email counts as an email.
- To print afterwards: a destination or group. See Install the relay client.
One-time setup
- Go to Targets → Workflows and select New workflow.
- Enter a name, for example "E-invoice". The identifier is filled in from it; it appears in the printer URL
(
…/ipp/print/<token>/<identifier>) and after+in email addresses. - Under Steps, select Add step and choose a step. Add as many as you need; the arrows change the order. Steps that your plan does not include are greyed out with the reason.
- Fill in the settings of each step:
- AI analysis: an Instruction and the Values to read, each with a name such as
customer_emailand a description. - Convert into an e-invoice: the Format (ZUGFeRD or XRechnung) and what happens If the invoice fails the checks: Stop the job, or Continue with the original document.
- Send by email: To, Subject, Message and Language. The braces button next to a field inserts a value of an earlier step, for example the buyer's email address.
- AI steps have a Step ID, for example
invoice. Later steps refer to its values with it, for example${{ steps.invoice.outputs.buyer_email }}.
- AI analysis: an Instruction and the Values to read, each with a name such as
- Under Afterwards send to, choose destinations or groups. Leave it empty to keep the document in Sealed Print; signature participants and email recipients still get it.
- Optionally switch on Share with all members, then select Create.
Every source now shows a printer URL for the workflow. Add it on your computer like any other printer URL.
To be told when a document waits for you, switch on Email me when one of my documents waits for me on the Account page.
Example: send invoices as e-invoices
- Create a workflow "E-invoice" with the steps Convert into an e-invoice (step ID
invoice) and Send by email. - In To of the email step, select the braces button and Buyer's email address. The field then shows
${{ steps.invoice.outputs.buyer_email }}. - Optionally insert the invoice number into the Subject the same way, and choose an office printer under Afterwards send to for a paper copy.
- Send invoices to the workflow, for example from Stripe with the Sealed Print app for Stripe.
Every time
- Send the document to the workflow: print to its printer URL, choose it under Target when you upload in the
Queue with Add document, or email it to an address whose target is the workflow (or with
+<identifier>). - AI steps and emails run on their own; the job shows "In processing" with the current step. The job detail lists the values every step returned.
- With a Signatures step, the signature editor opens right away after an upload. Otherwise the job appears in the Queue with "Waiting for you to prepare the signatures"; open it and select Prepare signatures, add the signers, place the fields and send (see Electronic signatures).
- After the last step the document goes to the targets of the workflow, or stays in Sealed Print. Emails of a Send by email step appear as deliveries of the job, each with its status.
Identifiers after the workflow replace its targets afterwards: …/contract/office runs the workflow "contract" and
then prints on the destination "office".
To run an existing job through a workflow, open it and choose More → Run workflow. A job that was already delivered is duplicated first.
Troubleshooting
- The job waits and nobody prepares the signatures: a waiting workflow ends after the retention period. Select Discard if the job is no longer needed.
- "The job is in a workflow": jobs in a workflow cannot be sent, retried or duplicated until the workflow has finished.
- "The invoice does not pass the e-invoice checks. The details show what is missing.": the job detail names the missing data or the failed rules. XRechnung needs more data than ZUGFeRD, for example the buyer reference and the seller's contact person, phone and email. Choose Continue with the original document if invoices should go on anyway.
- "The document is already signed. Convert invoices into e-invoices before the signatures.": put the step Convert into an e-invoice before Signatures.
- "The email step found no valid recipient.": the value used in To was empty, for example because the invoice shows no email address of the buyer.
- "The plan does not include AI steps. On Free, turn on pay per use under Settings → Billing.": see Plans and billing.
- Emails are sent later than expected: a workflow sends at most 100 emails per hour; further emails wait for the next hour.
- The button New workflow is disabled: your plan includes none of the steps. See Plans and billing.
- "The identifier hold is reserved for documents without a target.": choose a different identifier.