Skip to main content

Triggers

Generate X type of document when Y trigger runs

This article explains which Fakturownia documents the app creates and when: document types, triggers, exceptions, email sending and linked documents. The app always uses the Shopify order data as it is when the document is created.

📄 Available document types (WHAT to generate)

The app can create these documents in Fakturownia:

1

Invoice

2

Proforma Invoice

3

Prepayment invoice

4

Final invoice

5

Bill

6

Receipt

7

Credit note

✅ What a document needs

A document is created only if your Fakturownia account is connected, a department is selected, and the trigger of that document isn’t Never.

If something is missing, the Monitor shows an error code with the fix. See Looking up an error code.

⚡ Triggers (WHEN to generate)

For each document type, choose the event that creates it. Each document type is created automatically only once per order.

Manual generation: you can also create documents one by one from your Shopify orders. Learn more

Document triggers

For invoice, proforma invoice, prepayment invoice, final invoice, bill and receipt:

⚡ Trigger 1 » Never

The document is never created automatically.

⚡ Trigger 2 » When unpaid order is created

The document is created when an unpaid order (payment status: Pending) is created or imported.

⚡ Trigger 3 » When order is paid

The document is created when

  • a paid order is created or imported, or

  • an unpaid order becomes paid.

⚡ Trigger 4 » When order is fulfilled

The document is created when

  • a fulfilled order is created or imported, or

  • an unfulfilled order becomes fulfilled.

⚡ Trigger 5 » When any order is created

The document is created when any order is created or imported.

Credit note triggers

A credit note in Fakturownia is a correction invoice (faktura korygująca).

⚡ Trigger 1 » Never

No credit note is created automatically, whatever the refunds or cancellations.

⚡ Trigger 2 » When order is partially or fully refunded

When you refund in Shopify, the app creates a credit note.

  • Partial refund: all items are on the credit note, the refunded ones with a lower quantity. That’s on purpose: it’s the expected Polish format. An order can have several partial refunds, so several credit notes.

  • Full refund: the refunded items are on the credit note.

⚡ Trigger 3 » When order is canceled

When the order is cancelled, the app creates a correction for the whole order: every item goes to 0.

Set it up

Open Fakturownia | Integration app » Settings menu » Triggers section » Invoice field (or any other document type) » choose a trigger » Save

Good to know

  • To create a document type again for the same order, use manual generation.

  • On a new install, Invoice is set to When order is paid with email on. All other documents are set to Never.

✅ POS orders

POS orders (sales in your Shopify POS) get documents like web orders: the same triggers, document types and settings apply.

  • The document is created about 1 minute after the sale, so Shopify can add the customer to the order first.

  • With a customer on the order, the document uses the customer’s details, like a web order.

  • Without a customer, the buyer is the order’s email address. With no email either, the buyer is Shopify POS, with your store’s country.

✅ Credit note details

A Fakturownia credit note is a correction invoice that refers to the original invoice. Each item shows its quantity before and after the correction; the difference is the credited amount.

How it works

  • Credit notes are created only for invoices created by the app. Bills, receipts, prepayment and final invoices don’t get one. If there’s no such invoice, no credit note is created.

  • A credit note for the whole order (cancellation or full refund) is created only once per invoice.

  • Numbering comes from Fakturownia. See Document numbering.

  • If Email this document to the customer is ticked for credit notes, Fakturownia emails it.

  • The payment method comes from the Shopify refund (for a cancellation, from the order), matched like on invoices.

  • The correction reason is the cancellation or refund reason, in the document language.

Order adjustment support

  • If you refund in Shopify only an amount, without picking a product or shipping, the app still creates a credit note.

  • All invoice items are on it unchanged, plus a new line with the refunded amount.

✅ Orders where documents are not created

The app doesn’t check the order status: a document is created only when its trigger happens (order created, paid or fulfilled).

  • Draft orders never get a document, because they aren’t orders yet.

  • Cancelled or archived orders aren’t blocked: if the trigger happens after that, the document is created.

  • Manual generation works for every order.

🚫 Skip orders and Generate for

Choose which orders never get an automatic document, and whether each document type is made for everyone, only companies or only individuals.

Skip these orders

Pick orders that never get an automatic document, whether the customer is a company (B2B) or an individual (B2C). You find it at the bottom of the Triggers card in Settings. You can skip orders when:

  • the order has a tag: one of your tags, exact match (upper or lower case doesn’t matter),

  • the order comes from POS (in-store),

  • the order is paid with a selected payment method: Cash on Delivery (COD), PayPal or bank transfer (Bank Deposit),

  • the order contains only gift cards (an order paid with a gift card isn’t skipped),

  • the order total is 0.

If one of them matches, the Monitor shows No document with the reason, for example Skipped by your exception: order is paid with …. You can still create the document by hand with Generate document.

Payment method

  • Cash on Delivery and Bank Deposit are Shopify’s built-in manual payment methods. A manual payment method you created with your own name can’t be recognised.

  • PayPal means PayPal Express. PayPal paid through Shopify Payments can’t be recognised, so the document is created.

  • Card payments (also Apple Pay, Google Pay and Shop Pay) can’t be chosen: Shopify shows them all as Shopify Payments.

  • An order paid in parts is skipped only if every part was paid with a selected method. If any part was paid another way (for example gift card + COD), the document is created. The Monitor lists all the methods.

Tags

With a tag exception, the automatic document is created about 60 seconds after the trigger, and the tags are read again, so a tag you add right after the order still counts. A tag added after the document was created doesn’t change it.

0-value orders

Orders with a total of 0 are skipped by default, on new and existing stores. This is the Order total is 0 exception; remove it if you want documents for them.

Generate for

For invoice, proforma invoice, prepayment invoice, final invoice, bill and receipt, choose who gets it: Everyone (default), Companies or Individuals.

  • A company (B2B) is a customer whose order has a valid VAT ID (NIP). An info banner at the top of the Triggers card says the same. See B2B handling.

  • For a final invoice, the customer type at the time of the prepayment invoice counts.

  • It only decides whether the document is created. Email sending stays as you set it for each document.

  • When a document isn’t created because of Generate for, the Monitor shows it on the order with a grey Not created badge, the document type and the reason. See Not created on the Monitor.

Triggers by payment method, B2B or B2C

  • B2B / B2C: use Generate for to create a document only for companies or only for individuals.

  • Payment method: you can skip orders paid with a selected payment method (see above). Different triggers per payment method aren’t available.

Set it up

  1. Open Fakturownia | Integration app » Settings menu » Triggers section » Skip these orders » Add exception

  2. In Skip orders when, choose the exception (for tags, enter them separated by commas) » Add exception » Save

  3. For Generate for: choose Everyone, Companies or Individuals under each document type » Save

Good to know

  • By default there’s no exception except Order total is 0, and every document is for Everyone.

  • Skipped orders get no credit note. Generate for doesn’t apply to credit notes.

  • If two settings clash, you see a warning, but you can still save.

  • Documents you create by hand ignore these settings.

  • A change only affects new orders. Issued documents don’t change.

✅ Trigger delays

Some triggers wait a little before the document is created. The document is always made from the latest order data, after the wait.

Trigger delay for COD orders

  • Only for the When unpaid order is created and When any order is created triggers.

  • Cash on Delivery (COD): the trigger runs after about 30 seconds.

  • Any other payment method: the trigger runs right away.

Trigger delay for POS orders

For POS orders, every trigger runs after 60 seconds.

Trigger delay with a tag exception

If you have a tag exception, every automatic document waits 60 seconds and the tags are read again. See Tags.

✉️ Send documents in email

Tick Email this document to the customer to send the document to the order’s contact email through Fakturownia, right after it’s created. You can turn it off anytime.

How it works

  • The document is created first, then the email is sent. These are two separate steps.

  • If the email isn’t sent, the document is still created and saved. It isn’t created again, so there’s no duplicate.

  • An email is never sent twice for the same document.

  • If you fix a setting later, earlier emails aren’t sent automatically.

  • The Monitor shows under every created document what happened to its email. See Success.

Set it up

Open Fakturownia | Integration app » Settings menu » Triggers section » document type » tick Email this document to the customer » Save

🔗 Linked documents

Fakturownia links some documents to an earlier one of the same order.

Proforma invoice » Invoice

If the order already has a proforma (or one is created in the same run), the invoice is created from it and the two are linked. Fakturownia copies the items and the buyer from the proforma.

Estimate » Prepayment invoice

  • A prepayment invoice is always made from an Estimate.

  • When a trigger creates a prepayment invoice, the app uses the order’s Estimate, or creates one first, and links them.

  • By hand you can choose Prepayment invoice with new estimate (always a new one) or Prepayment invoice with existing estimate (for example to retry a rejected prepayment invoice).

  • You can’t create an Estimate on its own, and it isn’t emailed.

Prepayment invoice » Final invoice

If the order has a prepayment invoice, the final invoice is linked to it. If not, the app tries to create the final invoice without it. Fakturownia may reject that: then you see error 4-1-10.

Important linking limitation

The app always links to the latest document of the order. So if an order has several documents, the next related one (an invoice or a credit note) is linked to the latest.

Did this answer your question?