Skip to main content

Content

This article explains what goes on your Fatture in Cloud documents: the Content settings in the app, and what the app does automatically. Need something that isn’t here? Tell us in the chat. 😊

✅ App language

The app works in Italian and English. Italian is the default.

Switch it with the Language menu at the top of the app.

✅ Tax logic

The VAT on your documents always follows the Shopify order.

Our app always works from your Shopify order data, your Shopify tax settings and your Fatture in Cloud settings. Tax setups (VAT rules, OSS, exemptions and so on) depend a lot on your business and country. Please check yours with a tax advisor or accountant.

B2C and B2B logic

  • Individual (B2C): the order has no valid VAT ID.

  • Company (B2B): the order has a valid VAT ID (Partita IVA). See VAT ID on documents.

OSS logic

When OSS applies, the line gets the VAT rate Shopify charged (the rate of the customer’s country), with a Fatture in Cloud VAT rate marked N7. The document shows N7 - VAT paid in another EU country. No setting is needed.

How it works

OSS applies when all of these are true on the order:

  • Reverse charge doesn’t apply (typically a private customer).

  • The customer’s country is in the EU. That’s the shipping address country, or the billing address country if there’s no shipping address.

  • It differs from your shop’s country.

If your account has no N7 VAT rate at that percentage, the app creates it for you (for example OSS 21%).

Reverse charge logic

When Shopify applies reverse charge, the lines get 0% and the VAT summary on the document shows Fatture in Cloud’s reverse charge text: 0% - Inversione contabile ai sensi dell’art.7 ter D.P.R. 633/72.

How it works

Reverse charge applies when Shopify applied it to the order:

  • the customer entered a valid EU VAT number at checkout and Shopify Tax applied reverse charge, or

  • for a B2B order, the company location has the EU reverse charge tax exemption and a VAT number, and Shopify charged no tax.

The customer’s country (shipping address, or billing address if there’s none) must also be in the EU and differ from your shop’s country.

The app uses your 0% VAT rate with natura N6.9. Without one, another 0% EU rate, and last any 0% rate.

Good to know

A “Reverse Charge (EU/UK)” exemption on the customer isn’t enough without a valid VAT number.

Order tax exempt

If the order is tax exempt, every line gets 0%, with the first active 0% VAT rate in your Fatture in Cloud account.

Set it on the order in Shopify: Payment » Charge taxes » Uncheck.

Product tax exempt

If a product is tax exempt, its line gets 0%, with the same 0% VAT rate.

Set it on the product in Shopify: Product » Price » Charge tax on this product » Uncheck.

Customer tax exempt

If the customer is tax exempt, every line gets 0%, with the same 0% VAT rate.

Set it on the customer in Shopify: Customer » Tax details » Don’t collect tax » Check.

How it works

  • The tax details you see on the Shopify order page (rate, included or excluded, amount) go on the document. So set up your Shopify taxes correctly.

  • Shopify calculates the tax from the shipping address.

  • Each line gets the VAT rate Shopify charged on it.

  • The same rate must be active in your Fatture in Cloud VAT rates (Impostazioni » Aliquote IVA). If it’s missing, the document isn’t created and the Monitor shows error 4-1: add the rate and click Try again.

  • Prices are sent without VAT, so the totals match the order.

✅ Fallback VAT rate

There’s no fallback VAT rate in this app. If your Fatture in Cloud account doesn’t have the order’s VAT rate, the Monitor shows error 4-1. See Tax logic.

✅ Discounts

Discounts come from the Shopify order. A discount shows on the line it applies to, as a percentage in the discount column. There’s no separate discount line.

Free shipping

Free shipping isn’t a new line: the shipping line keeps its original price with a 100% discount, and the discount’s name in the description.

A shipping method that costs 0 shows as a 0 line.

% or fixed amount discounts

  • Both show as a percentage in the discount column on the item’s line.

  • A fixed amount becomes the matching percentage of the line’s full value.

  • An order discount is spread over the items.

How it works

  • The discount name goes in the line description: title - code, or whichever exists.

  • If one item has more than one discount (for example an item and an order discount), the names are separated by commas.

✅ Shipping address on the document

The shipping address isn’t shown on the document. The document shows the billing address.

✅ Customer phone number

If the order has a phone number, it goes on the Fatture in Cloud client and in the client details on the document. No setting needed.

How it works

  • We take the first one we find: billing address, customer account, the customer’s default address, checkout contact phone, shipping address.

  • It shows exactly as the customer typed it.

  • A client already saved in your Fatture in Cloud account gets the new number.

  • If the order has no phone number, the client keeps the one it has.

Good to know

  • It works the same for companies (B2B) and individuals (B2C), and on every document the app creates, credit notes included.

  • Issued documents don’t change.

✅ Currency

The document uses the currency the customer paid in at checkout (the order’s presentment currency).

If it differs from your shop currency, the exchange rate goes to Fatture in Cloud too, calculated from the order total.

✅ Issue date

The day the document is created, in Italian time.

✅ Delivery date

Same as the issue date: there’s no separate supply date. Also called sale date, date of taxable supply or tax date.

✅ Due date

The issue date: the app sends one payment, due on the day the document is created, for the document total.

An invoice made from a proforma keeps the due date Fatture in Cloud takes over from the proforma.

✅ Credit note dates

  • Issue date: the day the credit note is created.

  • Delivery date: the day the credit note is created.

  • Due date: for a partial credit note, the day it’s created. A full credit note takes it from the invoice.

✅ Document template

The app doesn’t pick a template: documents use your default template in Fatture in Cloud. You can create template variants there: Settings » Personalization.

✅ Email template

Emails go out from Fatture in Cloud, with your default sender address and the subject and text set there: Settings » Account » Email Templates.

✅ Payment method

The app matches the Shopify payment method’s name to your Fatture in Cloud payment methods (Metodi di pagamento). There’s no app setting for it.

  • The exact name first, then a partial match (for example PayPal Express Checkout » PayPal).

  • No match: the app reloads your payment methods and tries again.

  • Still no match: your default payment method in Fatture in Cloud. No default: it’s left empty.

✅ Default document language

A document is written in the language of the customer’s billing country, if Fatture in Cloud has it. For any other country, the document uses your Default document language (Italiano by default).

How it works

  • Fatture in Cloud has Italian, English, German, French and Spanish. For example, a customer in Austria gets German, one in Belgium French, one in Malta English.

  • For any other country (for example Hungary), the document uses your default language.

  • Without a billing address, the customer’s default address counts.

Set it up

Open Fatture in Cloud | Integration app » Settings menu » Content section » Default document language field » choose Italiano, English, Deutsch, Français or Español » Save

✅ Unit

The text you enter (for example pc) shows as the unit on every line, shipping included. Leave it blank for no unit. It’s blank by default.

Open Fatture in Cloud | Integration app » Settings menu » Content section » Unit field » enter the unit » Save

✅ Shipping line name on documents

Give every shipping line on your documents one fixed name, for example Shipping.

How it works

  • Blank (default): the shipping line gets the shipping method name from the Shopify order.

  • Filled in: your text replaces the shipping line name on every document, so all shipping lines get the same name.

  • Useful when a carrier app uses a different name on every order (for example the parcel locker’s name), which makes reports hard to read.

Set it up

Open Fatture in Cloud | Integration app » Settings menu » Content section » Shipping line name on documents field » enter the name » Save

Good to know

  • Only the name changes. Price, VAT and quantity stay the same.

  • It applies to every shipping line (including free shipping) and every document type the app creates, including credit notes.

  • The text isn’t translated: it shows exactly as you type it.

  • It applies to documents created after you save, including manual generation. Issued documents don’t change.

✅ Bank account

The app doesn’t send bank details. Fatture in Cloud adds its default from your payment method settings, which you set once: Impostazioni » Metodi di pagamento (Settings » Payment methods).

✅ Note

The text you enter goes on the document as a public note (Notes in Fatture in Cloud), so your customer sees it.

You can use these tags: {{order_number}}, {{order_id}}, {{yyyy}}, {{yy}}, {{mm}}, {{dd}}

Open Fatture in Cloud | Integration app » Settings menu » Content section » Note field » enter the text, for example Shopify order: {{order_number}} » Save

✅ Subject

The text you enter shows as the document’s subject in Fatture in Cloud. Leave it blank for no subject.

  • You can use the same tags as in the Note, for example the order number.

  • An invoice made from a proforma gets (Proforma number) at the end, a credit note (Fattura invoice number).

Open Fatture in Cloud | Integration app » Settings menu » Content section » Subject field » enter the text » Save

✅ Numbering

Choose a Fatture in Cloud numbering series for each document type, only for documents this app creates. Leave it blank to use your default series.

How it works

  • There are four fields: Invoice, Proforma, Receipt and Credit note. Full and partial credit notes both use the Credit note field.

  • Fatture in Cloud gives the number itself, so don’t type a number.

  • Shopify order numbers and document numbers can’t be synced automatically. You can only align the numbering by hand.

Set it up

Open Fatture in Cloud | Integration app » Settings menu » Content section » Numbering » enter a series for the document type (for example /A, /B or Principale) » Save

Example

If you enter /SHOPIFY, a document number looks like 1/SHOPIFY/2026.

✅ Company

Every document is created in the Fatture in Cloud company chosen here.

How it works

  • After you connect, the app picks your first company automatically. When you connect again, your earlier choice stays.

  • Manage more companies (for example as an accountant)? Choose another one from the list. It saves right away.

  • Without a company, no document is created and the Monitor shows error 1-2.

Set it up

  1. Open Fatture in Cloud | Integration app » Settings menu » Content section » Company field

  2. Added a company in Fatture in Cloud? Click Refresh list now.

  3. Choose the company.

✅ Contact database behavior

Fatture in Cloud keeps a client list (Clienti). The app looks for the client by Partita IVA, then codice fiscale, then email.

How it works

  • The data comes from the billing address. If there’s none, from the customer’s default address. Address lines 1 and 2 go on one line.

  • A client needs a name, a company name or an email. Without any of them you get error 3-1.

If the client exists

We update its name, type, Partita IVA, codice fiscale, address, email and phone if they changed. Everything else stays.

If the client doesn’t exist

We create it from the order’s billing details.

POS orders without customer data

The client’s name is the order’s email. With no email, it’s Shopify POS, with your shop’s country.

✅ Company name

The client name comes from the Company field of the billing address.

  • Company filled in: the client’s name is the company name. If it’s empty, the Shopify B2B company’s name is used.

  • No company: the first and last name, in separate fields. With no name, the email address.

A company name alone doesn’t make the customer a company (B2B): the VAT ID decides. See B2C and B2B logic.

✅ Customer type in Fatture in Cloud

Fatture in Cloud saves the client as a company or an individual (person). Only the company name decides this:

  • Company name on the billing address (or a Shopify B2B company): company.

  • No company name: individual.

This is separate from company (B2B) or individual (B2C) in the app, for example in Generate for: there the VAT ID decides.

✅ Electronic invoices (SDI)

Electronic invoicing (fattura elettronica) through SDI is mandatory in Italy. The app doesn’t send documents to SDI: it creates them as regular documents, not e-invoices. You send each e-invoice from Fatture in Cloud.

Set it up

In Fatture in Cloud:

  1. Turn on electronic invoicing: Impostazioni » Fatturazione elettronica. It needs a paid Fatture in Cloud plan.

  2. Send each e-invoice with Firma e invia. It isn’t sent automatically.

Step-by-step guide from Fatture in Cloud: Attiva la fatturazione elettronica

✅ Paid status syncing

When the Shopify order is paid, or created as paid, the document in Fatture in Cloud is marked paid too. This works one way only: Shopify » Fatture in Cloud.

How it works

  • The order’s invoice is marked paid. If the order has no invoice, its proforma.

  • Receipts are always paid.

  • It needs a payment account in Fatture in Cloud: the one set on the matched payment method, or else your first account that isn’t virtual. Without one, the document stays unpaid.

Good to know

  • If the order only has a proforma, it’s marked paid only when one of your documents uses the When order is paid trigger.

  • If you mark a document as paid in Fatture in Cloud, the app doesn’t update the Shopify order.

✅ SKU on documents

In Shopify every product variant can have an SKU (for example, SKU001). Choose how it shows in the line items:

  • No SKU (Product name only) (default): on the document Product Name

  • Product name + SKU: on the document Product Name SKU001

  • SKU only: on the document SKU001

Send the SKU to Fatture in Cloud’s product code field

Under the dropdown is the Send SKU to Fatture in Cloud’s product code field checkbox, ticked by default. The SKU then also goes into Fatture in Cloud’s product code field (Codice) on every product line. Untick it to leave that field empty.

It doesn’t change the product name, so you can combine it with any option above, for example Product name + SKU.

📦 Stock sync

Not available in Fatture in Cloud | Integration. The SKU only goes onto the document; stock in Fatture in Cloud doesn’t change.

Set it up

Open Fatture in Cloud | Integration app » Settings menu » Content section » SKU on documents field » choose an option » tick or untick the product code checkbox » Save

Good to know

  • If a product has no SKU in Shopify, only the product name goes on the document, without a product code.

  • Shipping lines never get an SKU. Discounts show on the product’s line, not as a separate line.

  • It applies to every document type the app creates, including credit notes.

  • A change only affects documents created after you save. Issued documents don’t change.

✅ VAT ID on documents

The customer’s VAT ID goes to Fatture in Cloud with the client details, into the Partita IVA field, so it shows on the document. In Italy that’s the Partita IVA: 11 digits, with or without IT (for example IT12345678901). An order with a valid VAT ID counts as a company (B2B) order, otherwise as individual (B2C).

VAT number on documents

Choose where the app takes the VAT ID from. Only the source you choose puts a VAT ID on the document.

  • Company VAT number field (checkout) (default): the customer types it into Shopify’s Company VAT number field at checkout. For a Shopify B2B company, the VAT number of the company location is used.

  • Address line 2: the customer types it into Address line 2 of the billing address.

  • Don’t send VAT number: no VAT ID goes on the document.

VAT ID check

Whatever the source, the app checks that the value looks like a VAT ID:

  • Spaces, dots, dashes, slashes and a typed label (for example “P.IVA:”) are removed first.

  • Accepted: an EU VAT number with the country code (all 27 EU countries, and GB, XI, CH, NO), or a number without the country code in the format of the billing country (or your shop’s country), for example an Italian Partita IVA of 11 digits.

  • It goes to Fatture in Cloud as the customer typed it, without the label.

  • A personal codice fiscale isn’t a VAT ID, so it isn’t sent.

  • Anything else (for example a flat number or a phone number) is left out. That’s not an error.

  • If Fatture in Cloud still rejects a VAT ID in the right format, you see an error code on the Monitor.

Company VAT number field (checkout)

  • Always with the country code: Shopify saves the VAT number only in the EU format, with the country code first (for example IT12345678901). Typed without it, the customer can enter it, but Shopify doesn’t save it on the order, so it never reaches Fatture in Cloud. For a VAT ID without the country code, use Address line 2.

  • The field shows at checkout only after the country and the postal code are filled in.

  • This field belongs to Shopify Tax (EU/UK VAT): with Shopify Tax, Shopify checks the number and applies reverse charge when it’s due. If you just want to collect any tax number, use Address line 2.

Address line 2

  • More flexible than the checkout field: a VAT ID with or without the country code goes to Fatture in Cloud, if it passes the VAT ID check.

  • If it’s a VAT ID, Address line 2 doesn’t go into the address. If it isn’t, it stays part of the address, and the customer is an individual (B2C).

  • With any other source, Address line 2 is always part of the address.

Rename the field first. In your Shopify admin, rename the “Address line 2” label in the checkout texts, for example to “VAT ID”. Otherwise customers type their flat number there.

Set it up

  1. Open Fatture in Cloud | Integration app » Settings menu » Content section » VAT number on documents field » choose a source » Save

  2. For the checkout field: Shopify Admin » Settings » Checkout » Customer information » Company VAT number » Optional (or Required) » Save

Good to know

  • Generate for and the Monitor use the company (B2B) or individual (B2C) decision. See Generate for.

  • If the source doesn’t match (for example Address line 2 is chosen, but the customer filled in the checkout field), the customer counts as a company (B2B), but no VAT ID goes on the document.

  • With Don’t send VAT number, the company (B2B) or individual (B2C) decision still works, from the checkout field.

  • A codice fiscale that’s already on the Fatture in Cloud client isn’t overwritten.

  • VAT handling (reverse charge, exemptions, OSS) doesn’t depend on this: it follows the Shopify order. See Tax logic.

  • The VAT ID isn’t saved on the Shopify order.

  • A change only affects new documents.

Not available in Fatture in Cloud | Integration

Automatic dual-currency conversion

Automatic dual-currency conversion: not available in Fatture in Cloud | Integration.

Order No. field

Separate ‘Order No.’ field on documents: not available in Fatture in Cloud | Integration.

Custom email address on documents

Custom email address on documents: not available in Fatture in Cloud | Integration.

Did this answer your question?