Skip to main content

Triggers

Generate X type of document when Y trigger runs

The app creates iDoklad documents from Shopify order data. In general, the app uses what is available on the Shopify order at the time the document is generated.

📄 Available document types (WHAT to generate)

1

Common invoice

2

Proforma Invoice

3

Sales receipt

4

Credit note

Triggers (WHEN to generate)

Extra feature: Manual generation trigger

You can generate documents one-by-one directly from your Shopify orders » Learn more about this feature

Normal document triggers:

Trigger 1 » When order is paid

The document using this trigger will be generated, if

  • paid order is created (or imported)

  • unpaid order is set to paid

Trigger 2 » When any order is created

The document using this trigger will be generated, if

  • any type of order is created (or imported)

Trigger 3 » When unpaid order is created

The document using this trigger will be generated, if

  • unpaid order is created (or imported)

Trigger 4 » When order is fulfilled

The document using this trigger will be generated, if

  • fulfilled order is created (or imported)

  • unfulfilled order is set to fulfilled

Trigger 5 » Never

The document using this trigger will never be generated

Credit note triggers:

Trigger 1 » Never

No credit notes will ever be created automatically, regardless of refunds or cancellations.

Trigger 2 » When order is partially or fully refunded

When product or shipping items are refunded in Shopify, the app creates a credit note from the refunded quantities and prices.

  • Details:

    • Partial Refund: If only some items are refunded, it is a partial refund.

    • Full Refund: If all items are refunded, it is a full refund.

    • Important:

      • There can be more than one partial refund, so there can also be more than one credit note.

      • Items that did not change are not added to the credit note.

Trigger 3 » When order is canceled

If the entire order is cancelled, a credit note is created automatically for all items.

✉️ Send documents in email

You can also check "Email this document to the customer" in order to send the generated document to the customer using iDoklad's email server. You can also disable it anytime. The email is sent right after the document is created.

ℹ️ Additionals

Tax document

The app also has an optional Tax document feature. If this checkbox is enabled and a Proforma invoice becomes paid, the app creates a linked Tax document. This Tax document is linked to the Proforma invoice. The Tax document is not sent by email.

Credit note details

  • Credit notes can be created only for:

    • Common invoices created by the app

  • The corrected items are shown with negative amounts.

  • Credit note numbering comes from your default iDoklad numbering settings:

    • Settings → Sale → Numbering

  • If email sending is enabled, the credit note can be sent through iDoklad.

  • The payment method on the credit note is the same as on the original document.

  • Order adjustment limitation

    • Order adjustments are not supported for iDoklad credit notes. This means: if you create a Shopify refund without selecting a specific product or shipping item, and you only enter a refund amount, the app will not create a credit note.

Orders where documents are not created

The app does not create automatic documents for orders with these statuses:

  • Cancelled

  • Closed

  • Draft

This applies even if the trigger would otherwise match the order.

0-value orders

If the Shopify order total is 0, the iDoklad document is still created.

Trigger delay for COD orders

  • This delay applies only to these triggers:

    • When unpaid order is created

    • When order is created

  • If the order is not Cash on Delivery, the trigger runs immediately.

  • If the order is Cash on Delivery, the trigger runs after 30 seconds.

  • During this delay, the app waits for the latest Shopify order data. The document is created from the order state after the delay.

Trigger delay for POS orders

  • For POS orders, the delay applies to all triggers.

  • If the order is a POS order, the trigger runs after 60 seconds.

  • During this delay, the app waits for the latest Shopify order data. The document is created from the order state after the delay.

Linked documents

  • If the app creates a Proforma invoice first, and later creates an invoice for the same Shopify order, the two documents are linked.

    • Condition: the order must be paid when the invoice is created.

  • Important limitation: when the app links documents, it always links to the latest document for that Shopify order.

    • For example, if there is more than one document for the same order, the app uses the latest one when creating the next related document, such as an invoice or credit note.

Sales receipt limitation

Sales receipts can only be generated with the When order is paid trigger.

Payment method / B2B / B2C based triggering:

  • At the moment, dynamic triggering based on the payment method, B2B/B2C status, or customer type is not supported.

  • Currently, you can only configure which document should be generated and when, based on the Shopify order status.

  • For example, document generation can be triggered when an order is created, paid, fulfilled, or refunded, but it cannot currently use different trigger rules based on payment method, B2B/B2C logic, or whether the customer is a company or private customer.

Did this answer your question?