This article explains which Fatture in Cloud documents the app creates and when: document types, triggers, email sending, linked documents and manual generation. The app always uses the Shopify order data as it is when the document is created.
📄 Available document types
The app can create these documents in Fatture in Cloud:
1 | Invoice |
2 | Proforma |
3 | Receipt |
4 | Credit note |
✅ What a document needs
A document is created only if your Fatture in Cloud account is connected, a company 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 create)
For each document type, choose the event that creates it. A trigger creates each document type only once per order.
Manual generation: you can also create a document by hand from any order. See Manual generation.
Invoice, proforma and receipt
Never: the document is never created automatically.
When unpaid order is created: an unpaid order is created or imported.
When order is paid: a paid order is created or imported, or an unpaid order becomes paid.
When order is fulfilled: a fulfilled order is created or imported, or an unfulfilled order becomes fulfilled.
When any order is created: any order is created or imported.
Credit note
Never: no credit note is created automatically.
When order is partially or fully refunded: every refund gets a credit note, with the refunded items (products or shipping) at their refunded quantity and price.
When order is canceled: a credit note for the whole order (every item), like a full refund.
For a refund:
Full: if the refunded amount is the order total, you get a full credit note with every invoice line, once.
Partial: otherwise you get a partial one with only the refunded items. Items that weren’t refunded don’t show. An order can have several partial credit notes.
Set it up
Open Fatture in Cloud | Integration app » Settings menu » Triggers section » Invoice field (or any other document type) » choose a trigger » Save
Good to know
On a new install, the invoice is set to When any order is created. Proforma, receipt and credit note are set to Never.
To create a document type again for the same order, use manual generation.
✅ POS orders
Orders from Shopify POS (sales in your shop) get documents like online orders: the same triggers, document types and settings apply.
The document is created about 1 minute after the sale, so Shopify can link the customer to the order first.
With a customer on the order, the customer’s details are used, as for an online order.
Without a customer, the client is the order’s email address. With no email either, it’s Shopify POS, with your shop’s country.
✅ Credit note details
In Fatture in Cloud the credit note is its own document type. It’s made only for invoices the app created.
How it works
Lines show with positive amounts.
Full credit note: Fatture in Cloud makes it from the invoice, with every line, and links it to the invoice.
Partial credit note: the refunded items with their refunded quantity and matching discount, plus the refunded shipping.
The subject of both ends with (Fattura invoice number).
Numbering: the Credit note field under Content » Numbering, for full and partial credit notes.
Email: Fatture in Cloud sends it if you tick Email this document to the customer for the credit note.
Payment method: a partial credit note matches it like the invoice does. A full one takes it from the invoice.
Order adjustment limitation
If you refund only an amount in Shopify, without picking an item or shipping, no credit note is created. If that amount is the whole order total, it counts as a full refund and you get a full credit note.
✅ Orders where documents are not created
Draft orders never get a document, because they aren’t orders yet. Once a draft becomes an order, its triggers work as usual.
🚫 Skip orders and Generate for
At the bottom of the Triggers card you can skip orders (by tag, POS, payment method, gift cards only, total 0) and create documents only for companies or only for individuals. See Skip these orders and Generate for.
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. Different triggers per payment method aren’t available.
✅ 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 30 seconds (When any order is created) or 35 seconds (When unpaid order is created).
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 other automatic document (not POS, not COD) waits 60 seconds and the order’s tags are read again. See Tags.
✉️ Send documents in email
Tick Email this document to the customer to send the document right after it’s created. Fatture in Cloud sends it to the order’s email address (or the customer’s, if the order has none), with your default sender and email template.
How it works
The document is created first, then the email goes out. 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 Fatture in Cloud | Integration app » Settings menu » Triggers section » document type » tick Email this document to the customer » Save
Good to know
On a new install, email is on for the invoice and off for the proforma, receipt and credit note.
It works for every document type, the proforma too.
🔗 Linked documents
Fatture in Cloud links some documents to an earlier one of the same order.
Proforma » Invoice
If the app already made a proforma for the order, the invoice is made from it in Fatture in Cloud. It takes the proforma’s lines, the two are linked, and the proforma stays. The invoice subject ends with (Proforma number).
The order doesn’t need to be paid.
It works the same for an invoice you create by hand.
A full credit note is linked to its invoice too. See Credit note details.
✅ Manual generation
Create a document by hand from any order, whatever your triggers.
How it works
You can create an invoice, proforma or receipt. Credit notes can’t be created by hand.
Skip these orders and Generate for don’t apply, and the document is created even if the order already has one of that type.
An invoice for an order with a proforma is made from the proforma here too.
The email follows the document’s email setting.
You see the new document ID, or an error message with its code.
Set it up
In the Shopify order, click More actions » Create Fatture in Cloud document. Or use Generate document or Try again on the Monitor.