This article explains what goes on your Pennylane 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 French and English. French 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 Pennylane 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. See VAT ID on documents.
OSS logic
Nothing extra goes on the document: the lines just get the VAT rate of the customer’s country, the one Shopify charged (for example 19% Germany).
How it works
OSS applies when all of these are true on the order:
Reverse charge doesn’t apply (typically a B2C order).
The customer’s country (shipping address, or billing address if there’s none) is in the EU.
It differs from your store’s country.
Shopify charged the VAT rate of the customer’s country.
Set it up
Optional: to track OSS sales separately by country and VAT rate, turn on OSS in Pennylane: Settings » Company informations » Bookkeeping » Use the One Stop Shop (OSS) » Enable. Documents get the right VAT rate without it too.
Reverse charge logic
When Shopify applies reverse charge, the lines get 0% VAT (Pennylane code exempt). The app doesn’t add a reverse charge note (such as Autoliquidation).
How it works
Reverse charge applies when Shopify applied it to the order, and the customer’s country is in the EU and differs from your store’s country:
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 Reverse Charge (EU/UK) tax exemption and a VAT number, and Shopify charged no tax.
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 item on the document gets 0% VAT.
Set it on the order in Shopify: Payment » Charge taxes » Uncheck.
Product tax exempt
If a product is tax exempt, only its own line gets 0% VAT.
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 item on the document gets 0% VAT.
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.
Pennylane takes a VAT code for each rate, not a percentage (for example 20% France). The app picks the code of your store’s country (for OSS, of the customer’s country).
If Pennylane has no code for a rate on the order, the document isn’t created and the Monitor shows error 4-1.
If a line has more than one tax line, they’re added up.
Prices go to Pennylane without VAT. If your store’s prices include tax, the app calculates the net price.
A 0% line to a customer outside the EU is marked as an export (Pennylane code extracom). Other 0% lines get the code exempt.
✅ Discounts
Discounts come from the Shopify order. A discount shows on the line it applies to, as an amount off that line. There’s no separate discount line.
Free shipping
There’s no separate “Free shipping” line.
Free shipping discount: the shipping line shows with its own name and price, and a 100% discount (so it’s 0). The discount’s name shows in the line description.
Free shipping rate: the shipping line shows at a price of 0.
% or fixed amount discounts
A percentage or fixed discount, on an item or on the order, is taken off the line as an amount without VAT, not as a percentage. So the document total matches Shopify to the cent.
A line that is completely free shows with a 100% discount.
How it works
The discount’s name shows under the line: Title - Code if it has both, otherwise the title or the code.
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 order’s shipping address is saved as the Pennylane customer’s delivery address, so it shows on the document.
If it’s incomplete (street, postal code, city or country missing), it’s left out, and the document is still created.
If the order has no shipping address, the delivery address already saved on the customer stays.
✅ Customer phone number
If the order has a phone number, it goes on the Pennylane customer’s details. No setting needed.
How it works
We take the first one we find: billing address, customer account, checkout contact phone, shipping address.
A customer already saved in Pennylane gets the new number too.
If the order has no phone number, no number is sent, and a phone already saved on the customer stays.
Good to know
It works the same for companies (B2B) and individuals (B2C), and on every document type, 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).
✅ Issue date
The day the document is created, in Paris time.
✅ Delivery date
Pennylane has no delivery date field, so no delivery date is sent.
✅ Due date
Invoice: the same day as the issue date. The payment terms set in Pennylane aren’t used.
Proforma: valid for 30 days from the issue date.
✅ Credit note dates
Issue date: the day the credit note is created.
Delivery date: none (Pennylane has no such field).
Due date: the same day as the issue date.
✅ Document template
The app doesn’t pick a template: documents use your default template in Pennylane. You can create template variants there: Settings » Customer invoicing » Personalization » Document templates.
✅ Email template
The email uses your default email template in Pennylane: Settings » Customer invoicing » Email templates.
The template and the sender come from your Pennylane account, in the customer’s language.
The app can’t set a different template, CC or BCC.
✅ Payment method
No payment method is sent to Pennylane. When the order is paid, the invoice is marked as paid without one. See Paid status syncing.
✅ Default document language
We pick the document language from the customer’s billing country. If the country isn’t on our list, the document uses your Default document language (French by default).
How it works
Pennylane creates documents in French, English, German or Spanish.
The billing country decides (or the customer’s default address, if there’s no billing address): French-speaking countries (for example France, Belgium, Luxembourg, Monaco) » French; Germany, Austria, Switzerland, Liechtenstein » German; Spanish-speaking countries » Spanish; English-speaking countries (for example the UK, Ireland, the US) » English.
For any other country, the document uses your default language.
The language is also saved on the Pennylane customer, and the email Pennylane sends uses the same language.
Set it up
Open Pennylane | Integration app » Settings menu » Content section » Default document language field » choose Français, English, Deutsch or Español » Save
✅ Unit
The text you enter (for example pc) shows as the unit on every line, shipping included.
If you leave it blank, the lines get piece: Pennylane needs a unit on every line.
Open Pennylane | 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 Pennylane | 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 uses your default bank details in Pennylane. Set them once in Pennylane: Settings » Customer invoicing » Payments.
✅ Note (Free text)
This text goes on the document as a public note, in Pennylane’s Free text field, so your customer sees it. It shows on every document type, credit notes included.
You can use these tags: {{order_number}}, {{order_id}}, {{yyyy}}, {{yy}}, {{mm}}, {{dd}}
Open Pennylane | Integration app » Settings menu » Content section » Note (Free text) field » enter the text » Save
✅ Title
The text you enter shows as the document title in Pennylane. Leave it blank for no title.
You can use the same tags as in the Note, for example the order number.
On a credit note, the number of the invoice it corrects is added after the title, for example (F-2026-0012). With a blank title, only this shows.
Open Pennylane | Integration app » Settings menu » Content section » Title field » enter the title » Save
✅ Document numbering
There’s no numbering setting in the app. Pennylane numbers every document from your Pennylane settings: Settings » Customer invoicing » Configuration » Numbering.
Proformas get Pennylane’s own proforma numbering.
Credit notes are numbered by Pennylane too.
The document number can’t follow your Shopify order number. To keep them close, align the numbering in Pennylane by hand.
✅ Contact database behavior
Pennylane keeps a customer database. The app finds the customer there, or creates them, and updates their details when they change.
How it works
The app looks for the customer by their Shopify customer (for a guest order, by email address). If it doesn’t find them that way, it looks by email address.
Customer exists: the app updates it if the name, VAT ID, billing or shipping address, language, email or phone has changed. If the update fails, the document is still created with the existing customer.
New customer: the app creates it as a company or an individual. See Customer type in Pennylane.
The billing address comes from the order, or from the customer’s default address if there’s none.
Pennylane needs a complete billing address: street, postal code, city and country. Without it the Monitor shows error 3-2.
Guest orders (without a customer) get a document too, with the names on the billing address.
POS orders without a customer: see POS orders.
✅ Company name
The customer name in Pennylane is the first one we find:
the Company field of the billing address,
the company’s name on a Shopify B2B order,
the customer’s name (for example a sole trader),
the email address.
The person’s name is added as recipient if it’s different.
For an individual, first and last name are sent. If only one of them is there, it’s used for both. If neither is there, the document isn’t created.
The company name doesn’t decide whether we treat the customer as company (B2B) or individual (B2C): the VAT ID does. See B2C and B2B logic.
✅ Customer type in Pennylane
Pennylane saves the customer as a company or an individual:
Company: the Company field is filled in, it’s a Shopify B2B order, or a valid VAT ID goes on the document.
Individual: in every other case.
A customer already in Pennylane keeps its type (Pennylane can’t move a customer between the two). The next document is created for the existing customer.
✅ E-invoicing (tax authority)
The app creates your invoices in Pennylane as usual, and Pennylane sends them as e-invoices under the French e-invoicing reform (Pennylane is an accredited platform).
Set it up
In Pennylane:
Open Paramètres » Transmission de factures » Facturation électronique and turn on Envoi de factures électroniques.
After the identity check, click Activer l’envoi.
✅ Paid status syncing
When the Shopify order is paid, the app marks the invoice as paid in Pennylane. This works one way only: Shopify » Pennylane.
How it works
Only invoices are marked as paid. A proforma can’t be marked as paid, and credit notes aren’t marked as paid.
If you mark a document as paid in Pennylane, the app doesn’t update the Shopify order.
Good to know
If a proforma was created after the order was already paid, the invoice created later isn’t marked as paid. Mark it as paid in Pennylane by hand.
✅ 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): on the document Product Name
Product name + SKU (default): on the document Product Name SKU001
SKU only: on the document SKU001
📦 Stock sync
Not available in Pennylane | Integration. Pennylane has no stock management and no product code field. The SKU only goes onto the document.
Set it up
Open Pennylane | Integration app » Settings menu » Content section » SKU on documents field » choose an option » Save
Good to know
If a product has no SKU in Shopify, only the product name goes on the document.
Shipping and discount lines never get an SKU.
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 Pennylane with the customer details (the numéro de TVA field), so it shows on the document. In France that’s the n° de TVA intracommunautaire (for example FR12345678901). An order with a valid VAT ID counts as a company (B2B) order.
Choose where the VAT ID comes from under VAT number on documents. Only the source you choose puts a VAT ID on the document:
Company VAT number field (checkout) (default)
Address line 2
Don’t send VAT number: no VAT ID goes on the document.
Set it up
Open Pennylane | Integration app » Settings menu » Content section » VAT number on documents field » choose a source » Save
Company VAT number field (checkout)
The customer types the VAT ID into Shopify’s Company VAT number field at checkout. For a Shopify B2B company, the VAT ID of the company location is used.
Turn the field on in Shopify Admin: Settings » Checkout » Customer information » Company VAT number » Optional (or Required). It shows at checkout only after the customer enters their country and postal code.
Always with the country code: Shopify saves the VAT ID only in the EU format, with the country code first (for example FR12345678901). If the customer types it without the country code, Shopify doesn’t save it on the order, so it never reaches Pennylane. For that, use Address line 2.
This field belongs to Shopify Tax (EU/UK VAT): with Shopify Tax, Shopify checks the number and applies reverse charge when it’s due.
Address line 2
The customer types the VAT ID into Address line 2 of the billing address. It’s more flexible: a VAT ID with or without the country code goes to Pennylane, if it passes the VAT ID check below.
If Address line 2 holds a VAT ID, it’s sent as the numéro de TVA. It then isn’t part of the address.
If it isn’t a VAT ID (for example a flat number), it stays in the address, and the customer counts as an individual (B2C).
If the customer also filled in the checkout VAT field, that one doesn’t go on the document, but the customer counts as a company (B2B).
With any other source, Address line 2 is always part of the address.
In Shopify, rename the Address line 2 label in your checkout, for example to “VAT ID”. Otherwise customers type their flat number there.
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 “TVA:”) 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 store’s country).
It goes to Pennylane as the customer typed it, without the label.
Anything else (for example a flat number, a phone number or a personal ID) is left out. That’s not an error.
A SIREN or SIRET isn’t a VAT ID: it isn’t sent.
If Pennylane still rejects a VAT ID in the right format, you see an error code on the Monitor.
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.
In Pennylane, the customer is created as a company if the order has a company name or a valid VAT ID.
A SIREN that’s already on the Pennylane customer isn’t overwritten or removed.
VAT handling (reverse charge, exemptions, OSS) doesn’t depend on this: it follows the Shopify order. See Tax logic.
Issued documents don’t change.
Not available in Pennylane | Integration
Fallback VAT rate
Fallback VAT rate: not available in Pennylane | Integration.
Choose a company or department
Choosing a company or department: not available in Pennylane | Integration. The app uses the Pennylane company your API token belongs to.
Automatic dual-currency conversion
Automatic dual-currency conversion: not available in Pennylane | Integration.
Order No. field
Separate ‘Order No.’ field on documents: not available in Pennylane | Integration.
Custom email address on documents
Custom email address on documents: not available in Pennylane | Integration.