Configuration¶
Everything lives on one page: the event's Settings → Invoicing (PT). (It's labelled "(PT)" to tell it apart from pretix's own "Invoicing" entry, which configures pretix's internal invoices.) For a guided first setup, start with Getting started; this page is the reference for each option.
The same page exists on the organizer, for settings shared by all of its events; see Organizer-wide settings. Both pages link back to this documentation.

General¶
| Setting | Default | Description |
|---|---|---|
| Invoicing provider | none | The provider cards: No invoicing, Fact.pt or Moloni. With none, nothing is issued. Only the selected provider's section is shown, saved and used. |
| Product reference prefix | pretix- |
Put in front of every product's reference in the provider's catalog. Only matters for a provider that keeps a catalog (Moloni); see Products. |
| Issue documents automatically | on | Issues the invoice-receipt once an order is paid and the credit note once it's fully refunded. Turn it off for a manual-only mode: nothing is issued unless you use the buttons on an order's page. See Manual-only issuance. |
| The custom invoice-address field holds the buyer's tax number | off | Collects a NIF from every buyer, not only businesses. See Tax numbers (NIF). |
| Require the tax number at checkout | off | Makes the NIF mandatory for Portuguese business buyers, and for every Portuguese buyer when pretix requires an invoice address. Needs the option above. See Requiring the NIF. |
| Let buyers itemize the invoice by attendee | off | Adds a checkbox to the checkout's contact form. When the buyer ticks it, every ticket gets its own invoice line carrying the attendee's name. See Invoice lines. |
| Show the invoice on the buyer's order page | on | Adds download buttons for the invoice and any credit note beside the ticket downloads. The PDF is proxied through pretix, so your provider credentials never reach the browser. |
E-mail¶
pretix's own order e-mails can't attach these documents (they only attach pretix's own invoices), so the plugin sends its own, one per document.
| Setting | Default | Description |
|---|---|---|
| E-mail the invoice-receipt to the buyer | off | Sends the PDF once the invoice-receipt is issued. |
| E-mail the credit note to the buyer | off | Sends the PDF once the credit note is issued; the text names the invoice it cancels. |
Issuing by hand from the Control panel sends the e-mail too. Whether each document went out is shown on its row in the order's Invoicing (PT) panel (E-mailed to the buyer / Could not be e-mailed to the buyer). A failed e-mail is logged and never marks the issuance as failed: the document already exists at the provider.
Provider settings¶
Below the E-mail section comes the selected provider's own section. Each has its own page:
- Fact.pt: API token, sandbox switch, VAT rate, unit and item type.
- Moloni: the connection, company, document series, VAT, payment methods and product defaults.
Some fields (VAT rate, company, document set…) turn into dropdowns populated live from your provider account as soon as valid credentials are typed, with no need to save first. Fields that depend on another one (Moloni's per-company settings) reload when it changes. If a lookup fails, the line under the provider's section says why, and the fields stay plain inputs holding their saved values.
Not in use yet
Picking a provider card is not enough. Until the page is saved with everything the provider needs, its section shows a blue Not in use yet notice and nothing is issued through it. The notice disappears once the provider is both selected and fully configured.
The settings fields tell browsers and password managers (Bitwarden, 1Password, LastPass, Dashlane) not to autofill them, so your pretix login never ends up in a provider's credentials.
Organizer-wide settings¶
Everything on this page can be set once for all of an organizer's events: the provider, its credentials and connection, the general options and the e-mail options. Open the organizer's Settings → Invoicing (PT) (it needs the permission to change organizer settings) and fill it in as you would an event's.

- Events inherit it. An event with nothing of its own uses the organizer's settings as they are, including later changes to them. Its settings page shows the inherited values and says so at the top, with a link to the organizer's page.
- An event can still differ. Saving an event's page stores only the values that differ from the organizer's. Those then belong to the event: they keep applying even if the organizer's value changes later, and even if you set them back to the same value. An event can also pick No invoicing, or another provider, on its own.
- Going back. Once an event has values of its own, the note at the top of its page offers Use the organizer's settings. After a confirmation, it removes everything the event stored itself, its own provider connection included. Documents already issued are not affected.
Two things stay per event:
- The plugin has to be enabled on each event (Settings → Plugins). The organizer's settings are defaults, and nothing is issued for an event where the plugin is off.
- Moloni's payment methods table, since which payment methods are accepted is decided per event.
A Moloni connection made on the organizer is shared by its events; see One connection for every event.
Clearing an inherited value
An optional dropdown left empty on an event means "use the organizer's", so an event can't clear a value the organizer set (Moloni's exemption reason, for example), only replace it.
Tax numbers (NIF)¶
By default the buyer's tax number is read from pretix's VAT ID field on the invoice address. pretix only offers that field to business customers, so individuals have nowhere to enter a NIF and are invoiced as final consumers.
To collect it from everyone:
-
Under pretix's Settings → Invoicing, open the Address form tab and fill in Custom recipient field label, e.g.
NIF. An invoice address has to be asked for (Ask for invoice address) for the form to appear at all.
-
Turn on The custom invoice-address field holds the buyer's tax number here.
The custom field is then used whenever the VAT ID field is empty, and it becomes the one tax number field at checkout:

- pretix's internal reference field, which pretix's own Portuguese translation labels "NIF (Número de Contribuinte)" for business buyers, is hidden so there is no second "NIF" box.
- For Portuguese addresses pretix's VAT ID field is hidden too, businesses included. A buyer from another EU country still sees it, since reverse-charge handling needs it.
Numbers are accepted with spaces, dots or dashes and a PT prefix (PT 237.892.294 is fine).
Portuguese numbers that fail their check digit are ignored rather than sent, so a typo turns the
document into a final-consumer one instead of a rejected one. To stop the typo at checkout instead,
see Requiring the NIF.
Without a tax number, the document is issued to a final consumer (999999990). A buyer who
gave neither a name nor a company is invoiced as "Consumidor Final", never under their e-mail
address.
Don't require the VAT ID
With the custom field as the NIF, pretix's own Require VAT ID option would reject Portuguese business buyers, since the field they'd have to fill is hidden. Leave it off, and use Require the tax number at checkout instead.
Requiring the NIF¶
With Require the tax number at checkout on, the custom NIF field becomes mandatory for buyers with a Portuguese address, depending on who they are and on pretix's own Require invoice address option (pretix Settings → Invoicing):
| Buyer | Require invoice address off | Require invoice address on |
|---|---|---|
| Business | NIF required | NIF required |
| Individual | NIF optional | NIF required |
- A number that is typed has to pass its check digit either way; the buyer is told it isn't a valid Portuguese tax number and can't continue until it's fixed or removed.
- Buyers with an address outside Portugal are never asked, and neither are free orders, which get no invoice.
- The option needs The custom invoice-address field holds the buyer's tax number; the page refuses to save one without the other.

The field is marked as required in the checkout's invoice address form, and the rule is checked again when the order is placed. Two places it doesn't reach: the buyer's later change invoice address page is only checked in the browser, and orders created outside the shop's checkout (through the API, for example) aren't checked at all.
Invoice lines¶
Every document carries every non-cancelled position and every fee of the order (payment, service, shipping fees…), so its total is the order total.
- Identical tickets (same product, price and rate) share one line with a quantity.
-
With Let buyers itemize the invoice by attendee on and the checkbox ticked at checkout, each ticket gets its own line, named
<product> — <attendee name>.
-
Each line shows the pretix product name and the price actually paid.
- A voucher or an automatic discount shows as a line discount: the line carries the listed
price, the percentage taken off, and a name that says what did it, e.g.
Regular ticket (voucher TWENTY). Providers only take percentages, so for a fixed-amount voucher the unit price can print a fraction of a cent off; the totals are exactly what was paid. A ticket made free by a 100% voucher stays on the document at a 100% discount. - Anything else at 0.00 (a bundled add-on, a free product) is left off the document.
Free orders get no document. An order whose total is 0.00 is never invoiced, automatically or by hand; its panel says This order is free: there is nothing to invoice. If a later change makes it cost something, it is invoiced then.
Providers receive net unit prices and add their configured VAT on top. pretix prices are gross, so the net is derived to 8 decimal places and chosen so that the document's total equals what the buyer paid, cent for cent, even across several lines at the same rate.
Manual-only issuance¶
With Issue documents automatically off, paying an order or completing a refund issues nothing. Documents come only from the buttons on the order's Invoicing (PT) panel: Issue invoice now and Issue credit note. Everything else works the same, including e-mails and the buyer's downloads.
Use it for an event where only some orders need an official document, or while you're still checking the provider's output.
Billing changes after invoicing¶
Each issued document records the billing data it was made out with (name, NIF, address). If the buyer later edits their invoice address on their order page, pretix's order modified hook compares the two and, when they differ:
- the order's Invoicing (PT) panel shows a warning naming the invoice;
- the event's contact e-mail (pretix Settings → General) receives a message with a link to the order.
Nothing is credited or re-issued on its own. To accept the change, press Issue credit note, then Issue invoice now on the order page; the new invoice uses the new data. The e-mail repeats on every later save while the data still differs. Documents issued by plugin versions before 0.7 carry no snapshot and never warn.