> ## Documentation Index > Fetch the complete documentation index at: https://docs.invopop.com/llms.txt > Use this file to discover all available pages before exploring further. # Peppol > Submit invoices to the Peppol network.
View implementation guide ›
| | | | --------- | ------------------------------ | | Developer | [Invopop](https://invopop.com) | | Category | Network | | Scope | B2B, B2G | [Peppol (Pan-European Public Procurement On-Line)](https://peppol.org/) is a global network for electronic document exchange, widely adopted for e-invoicing across multiple countries. It provides a standardized protocol for companies to exchange business documents like invoices, credit notes, and purchase orders. The Peppol network is particularly popular in: * Nordic countries (Norway, Finland) * Asia-Pacific region (Japan, Singapore, Malaysia, Australia, New Zealand) * Several EU countries for business-to-government invoicing (Germany, Italy, Croatia) Invopop allows you to send and receive documents through the Peppol network using a single integration while continuing to work with our [GOBL](https://docs.gobl.org/introduction) format. The Peppol app is designed to only send and receive documents, while format-specific apps such as OASIS UBL or UN/CEFACT CII handle the generation and import of the appropriate files. **Key Features** * **Workflow Automation:** This app provides automated workflows for sending and receiving invoices through the Peppol network. * **Bidirectional Communication:** Send invoices to Peppol participants and receive invoices from the network automatically. * **Party Registration:** Register companies (Peppol participants) with proof of ownership validation for regulatory compliance. * **Multiple Format Support:** Supports both UBL 3.0 (Peppol BIS Billing) and UN/CEFACT CII formats for maximum compatibility. * **GOBL Integration:** Seamlessly converts between GOBL format and Peppol-compliant formats, allowing you to work with a single data model. * **Participant ID Management:** Automatically derives Peppol participant IDs from VAT numbers or local business identifiers. * **Visibility Control:** Configure visibility levels (SMP, SML, Peppol Directory) to control your presence in the network. Make sure to check out our [Peppol Guide](/guides/peppol) for instructions on how to send and receive invoices and set up your workflows. ## FAQ If your job fails with a `KO` error status showing `receiver not found in the peppol network`, treat this the same as an invalid email address. As countries roll out their Peppol networks, you'll encounter a mix of registered and unregistered companies, so it's important to catch these issues early. Use the Peppol **Lookup Peppol participant** step to validate the Peppol ID before sending anything to the network. We recommend to create a separate workflow for this validation and run it against customer's information. This will catch the error before creating the invoice. The following workflow actions will be available once you install and enable this app:
2
Send a document over the Peppol Network.
3
Receive and import invoices from the Peppol network, supporting both UBL and CII formats. Register a company as a Peppol participant with the network. Generate a registration link for proof of ownership submission. Wait for company identity and ownership validation. The following workflows are available to make your integration easier. Use them as templates to build upon. This workflow converts a GOBL document into the Peppol format and sends it to the network. ```json Example Peppol send invoice workflow theme={"system"} { "name": "Peppol send invoice", "description": "Send a Peppol BIS invoice through the Peppol network", "schema": "bill/invoice", "steps": [ { "id": "33e23480-10ab-11f0-a09e-7b63571a4ae2", "name": "Set state", "provider": "silo.state", "summary": "Set state to `processing`{.state .processing}", "config": { "state": "processing" } }, { "id": "2354afd0-10ab-11f0-a09e-7b63571a4ae2", "name": "Add sequential code", "provider": "sequence.enumerate", "summary": "Dynamic · Peppol · PPL000001", "config": { "name": "PPL", "padding": 6, "prefix": "PPL", "start": 1 } }, { "id": "fb06b190-10aa-11f0-a09e-7b63571a4ae2", "name": "Sign envelope", "provider": "silo.close" }, { "id": "fc5aa8d0-10aa-11f0-a09e-7b63571a4ae2", "name": "Generate UBL document", "provider": "ubl.generate", "summary": "Peppol BIS Billing v3", "config": { "doc_type": "bis-invoice-v3", "private": false, "validate_ubl": true } }, { "id": "075442a0-10ab-11f0-a09e-7b63571a4ae2", "name": "Send Peppol document", "provider": "peppol.send" }, { "id": "3037a310-10ab-11f0-a09e-7b63571a4ae2", "name": "Set state", "provider": "silo.state", "summary": "Set state to `sent`{.state .sent}", "config": { "state": "sent" } } ], "rescue": [ { "id": "39513240-10ab-11f0-a09e-7b63571a4ae2", "name": "Set state", "provider": "silo.state", "summary": "Set state to `error`{.state .error}", "config": { "state": "error" } } ] } ``` [Add to my workspace →](https://console.invopop.com/redirect/workflows/new?template=peppol-send) This workflow receives incoming documents from the Peppol network and converts them to the GOBL format. ```json Example Peppol receive invoice workflow theme={"system"} { "name": "Peppol receive invoice", "description": "Receive an invoice through Peppol", "schema": "bill/invoice", "steps": [ { "id": "db61c3c0-0fb5-11f0-b078-9fc456829eca", "name": "Import Peppol document", "provider": "peppol.import", "next": [ { "status": "OK", "code": "UBL", "steps": [ { "id": "62e94570-8fdb-11f0-a8fb-61ec9e5a76ba", "name": "Import UBL document", "provider": "ubl.import" } ], "stop": false }, { "status": "OK", "code": "CII", "steps": [ { "id": "6480ae50-8fdb-11f0-a8fb-61ec9e5a76ba", "name": "Import CII document", "provider": "cii.import" } ], "stop": false } ] }, { "id": "fdfc81a0-6e23-11f0-913b-5732f966b346", "name": "Set folder", "provider": "silo.folder", "summary": "Set folder to `Invoices · Expenses`{.font-medium}", "config": { "folder": "expenses" } }, { "id": "dd14a3e0-0fb5-11f0-b078-9fc456829eca", "name": "Set state", "provider": "silo.state", "summary": "Set state to `registered`{.state .registered}", "config": { "state": "registered" } } ], "rescue": [ { "id": "e109d2e0-0fb5-11f0-b078-9fc456829eca", "name": "Set state", "provider": "silo.state", "summary": "Set state to `error`{.state .error}", "config": { "state": "error" } } ] } ``` [Add to my workspace →](https://console.invopop.com/redirect/workflows/new?template=peppol-receive) This workflow onboards companies (Peppol participants) to Invopop before they can issue or receive invoices. ```json Example Peppol register party invoice workflow theme={"system"} { "name": "Peppol register party", "description": "Register a party with Peppol to issue and receive invoices", "schema": "org/party", "steps": [ { "id": "0adf46e0-8fdb-11f0-a8fb-61ec9e5a76ba", "name": "Register party for Peppol approval", "provider": "peppol.register.approval" }, { "id": "0e44b900-8fdb-11f0-a8fb-61ec9e5a76ba", "name": "Set state", "provider": "silo.state", "summary": "Set state to `processing`{.state .processing}", "config": { "state": "processing" } }, { "id": "12aaf950-8fdb-11f0-a8fb-61ec9e5a76ba", "name": "Wait for Peppol approval", "provider": "peppol.wait.approval" }, { "id": "7a5a4db0-0fae-11f0-b37b-0be1c251a274", "name": "Register party on Peppol", "provider": "peppol.register", "summary": "Enabled · groups: ubl-invoice", "config": { "disable": false, "doc_groups": [ "ubl-invoice" ], "visibility": "smp+sml+peppol" } }, { "id": "7c2fa9f0-0fae-11f0-b37b-0be1c251a274", "name": "Set state", "provider": "silo.state", "summary": "Set state to `registered`{.state .registered}", "config": { "state": "registered" } } ], "rescue": [ { "id": "a34e83f0-25dc-11f0-b641-350e77c28eed", "name": "Set state", "provider": "silo.state", "summary": "Set state to `error`{.state .error}", "config": { "state": "error" } } ] } ``` [Add to my workspace →](https://console.invopop.com/redirect/workflows/new?template=peppol-register) This workflow revokes participant permissions to issue and receive documents. ```json Example Peppol unregister party workflow expandable theme={"system"} { "name": "Peppol unregister party", "description": "Unregister a party from Peppol", "schema": "org/party", "steps": [ { "id": "453beac0-70a7-11f1-aca9-697108ec55ef", "name": "Unregister supplier from Peppol", "provider": "peppol.unregister" }, { "id": "7e79f610-adc5-11f0-abd8-03a58bc40d2a", "name": "Set state", "provider": "silo.state", "summary": "Set state to `void`{.state .void}", "config": { "state": "void" } } ], "rescue": [ { "id": "9141b350-adc5-11f0-abd8-03a58bc40d2a", "name": "Set state", "provider": "silo.state", "summary": "Set state to `error`{.state .error}", "config": { "state": "error" } } ] } ``` [Add to my workspace →](https://console.invopop.com/redirect/workflows/new?template=peppol-unregister) Belgium: Regular invoices are used for B2B transactions. Regular invoices must be issued when: * The customer is a registered business (has a tax identification number). * The customer needs a complete invoice with all tax details for accounting or tax purposes. To create a regular invoice, include the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon and ensure the `customer` field contains valid tax identification details. The addon will automatically set the document type to `380` when the silo entry is built (which happens automatically when saving a silo entry through the API or console). ```json Belgium standard B2B invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0859536301" }, "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0859536301" } ], "addresses": [ { "num": "127", "street": "Avenue Louise", "locality": "Ixelles", "region": "Brussels-Capital", "code": "1050", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "rate": "general" } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0208:0316597904" } ], "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0859536301" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0208:0859536301" } ], "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0859536301" } ], "addresses": [ { "num": "127", "street": "Avenue Louise", "locality": "Ixelles", "region": "Brussels-Capital", "code": "1050", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "21.0%", "ext": { "untdid-tax-category": "S" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "standard", "ext": { "untdid-tax-category": "S" }, "base": "1740.00", "percent": "21.0%", "amount": "365.40" } ], "amount": "365.40" } ], "sum": "365.40" }, "tax": "365.40", "total_with_tax": "2105.40", "payable": "2105.40" } } ``` Goods and services that are subject to VAT but taxed at a 0% rate. Zero rated goods in Belgium are: * Daily and weekly newspapers, as well as periodical publications that meet a specific criteria. * Recyclable materials such as waste and scrap intended for recycling. * Educational materials under specific conditions. To create an invoice with zero rated goods, use the tax key `zero` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon will automatically set the UNTDID 5305 tax category to `Z` (zero rated goods) when the silo entry is built. With zero-rated supplies, businesses can still reclaim input VAT on their purchases, whereas with exempt supplies they cannot. ```json Belgium zero rate invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0859536301" }, "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0859536301" } ], "addresses": [ { "num": "127", "street": "Avenue Louise", "locality": "Ixelles", "region": "Brussels-Capital", "code": "1050", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "1", "item": { "name": "Het Laatste Nieuws", "price": "2.00", "unit": "one" }, "taxes": [ { "cat": "VAT", "key": "zero" } ], "total": "2.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0208:0316597904" } ], "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0859536301" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0208:0859536301" } ], "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0859536301" } ], "addresses": [ { "num": "127", "street": "Avenue Louise", "locality": "Ixelles", "region": "Brussels-Capital", "code": "1050", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "1", "item": { "name": "Het Laatste Nieuws", "price": "2.00", "unit": "one" }, "sum": "2.00", "taxes": [ { "cat": "VAT", "key": "zero", "percent": "0%", "ext": { "untdid-tax-category": "Z" } } ], "total": "2.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "2.00", "total": "2.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "zero", "ext": { "untdid-tax-category": "Z" }, "base": "2.00", "percent": "0%", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "2.00", "payable": "2.00" } } ``` Exempt invoices are used for B2B transactions that are exempt from VAT, which also covers exemptions in internal operations. To create an exempt invoice, use the tax key `exempt` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon will automatically set the UNTDID 5305 tax category to `E` when the silo entry is built. You must also state the reason for the exemption through the [CET VATEX](https://docs.gobl.org/catalogues/cef#cef-vatex) - VAT exemption reason codes. Exempt operations are not subject to VAT but must still be reported. The `supplier` must be previously registered with the tax authority and the `customer` tax id must be valid. ```json Belgium Peppol Exempt Invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "145.00", "taxes": [ { "cat": "VAT", "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I" } } ], "total": "145.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0208:0316597904" } ], "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0195:SGUEN199904785Z" } ], "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I", "untdid-tax-category": "E" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I", "untdid-tax-category": "E" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Reverse charge invoices are used for B2B services provided to customers in other EU member states. Reverse charge must be applied when: * The customer is a registered business in another EU member state (has a valid EU VAT ID). * The service is provided to a business customer (B2B), not a consumer. * The service is subject to VAT but the customer accounts for the VAT in their own country. To create a reverse charge invoice, use the tax key `reverse-charge` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon will automatically set the UNTDID 5305 tax category to `AE` (reverse charge) when the silo entry is built. With reverse charge, no VAT is charged by the supplier. The customer accounts for VAT in their own country. Both `supplier` and `customer` VAT ID must be valid and registered in the EU VIES system. ```json Belgium reverse charge invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE" } } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0208:0316597904" } ], "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB85905495" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE", "untdid-tax-category": "AE" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE", "untdid-tax-category": "AE" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Intra-community supply invoices are used for B2B goods delivered to customers in other EU member states. Intra-community supplies must be applied when: * The customer is a registered business in another EU member state (has a valid EU VAT ID). * Goods are physically delivered to another EU member state. * The supply is exempt from VAT in the origin country and subject to VAT in the destination country. To create an intra-community supply Peppol invoice, use the tax key `intra-community` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon will automatically set the UNTDID 5305 tax category to `K` (VAT exempt for EEA intra-community supply of goods and services) when the silo entry is built. With intra-community supplies in the EU, the customer accounts for VAT in their destination country. The `supplier` must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority and the `customer` VAT ID must be valid and registered in the EU VIES system. ```json Belgium reverse charge invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$addons": [ "eu-en16931-v2017" ], "$regime": "BE", "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC" } } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0208:0316597904" } ], "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB85905495" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC", "untdid-tax-category": "K" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC", "untdid-tax-category": "K" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Outside scope invoices are used for B2B services provided to customers outside the EU. To create an outside scope Peppol invoice, use the tax key `outside-scope` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017)addon will automatically set the UNTDID 5305 tax category to `O` (Services outside scope of tax) when the silo entry is built. Services provided to non-EU customers are generally outside the scope of EU VAT. ```json Belgium outside scope theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox service", "price": "145.00", "unit": "h" }, "sum": "145.00", "taxes": [ { "cat": "VAT", "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O" } } ], "total": "145.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0208:0316597904" } ], "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0195:SGUEN199904785Z" } ], "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox service", "price": "145.00", "unit": "h" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O", "untdid-tax-category": "O" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O", "untdid-tax-category": "O" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Export invoices are used for B2B goods delivered to customers outside the EU. To create an export Peppol invoice, use the tax key `export` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon will automatically set the UNTDID 5305 tax category to `G` (Free export item, tax not charged) when the silo entry is built. Exported goods are exempt from VAT. The `supplier` must be previously registered with the tax authority. Customer tax identification is optional but recommended for record-keeping purposes. ```json Belgium export invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "uuid": "019bb71c-7205-7000-9aef-878145b9fce6", "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "export", "ext": { "cef-vatex": "VATEX-EU-G" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "BE", "$addons": [ "eu-en16931-v2017" ], "uuid": "019bb71c-7205-7000-9aef-878145b9fce6", "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0208:0316597904" } ], "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0195:SGUEN199904785Z" } ], "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "export", "ext": { "cef-vatex": "VATEX-EU-G", "untdid-tax-category": "G" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "export", "ext": { "cef-vatex": "VATEX-EU-G", "untdid-tax-category": "G" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Germany: Regular invoices are used for B2B transactions. Regular invoices must be issued when: * The customer is a registered business (has a tax identification number). * The transaction amount is €400 VAT included or above, or the customer requires a full invoice. * The customer needs a complete invoice with all tax details for accounting or tax purposes. To create a regular invoice, include the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon and ensure the `customer` field contains valid tax identification details. The addon will automatically set the document type to `380` when the silo entry is built (which happens automatically when saving a silo entry through the API or console). The `supplier` must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority and the `customer` VAT ID must be valid. ```json Germany standard B2B invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "customer": { "name": "Bavaria Solutions GmbH", "tax_id": { "country": "DE", "code": "993930191" }, "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE993930191" } ], "addresses": [ { "num": "15", "street": "Marienplatz", "locality": "München", "region": "BY", "code": "80331", "country": "DE" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "rate": "general" } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE879558966" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "customer": { "name": "Bavaria Solutions GmbH", "tax_id": { "country": "DE", "code": "993930191" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE993930191" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE993930191" } ], "addresses": [ { "num": "15", "street": "Marienplatz", "locality": "München", "region": "BY", "code": "80331", "country": "DE" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "19%", "ext": { "untdid-tax-category": "S" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "standard", "ext": { "untdid-tax-category": "S" }, "base": "1740.00", "percent": "19%", "amount": "330.60" } ], "amount": "330.60" } ], "sum": "330.60" }, "tax": "330.60", "total_with_tax": "2070.60", "payable": "2070.60" } } ``` Exempt invoices are used for B2B transactions that are exempt from VAT, which also covers exemptions in internal operations. To create an exempt invoice, use the tax key `exempt` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon will automatically set the UNTDID 5305 tax category to `E` when the silo entry is built. You must also state the reason for the exemption through the [CET VATEX](https://docs.gobl.org/catalogues/cef#cef-vatex) - VAT exemption reason codes. Exempt operations are not subject to VAT but must still be reported. The `supplier` must be previously registered with the tax authority and the `customer` tax id must be valid. ```json Germany Peppol Exempt Invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$addons": [ "eu-en16931-v2017" ], "$regime": "DE", "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Deutsche Sprachschule", "tax_id": { "country": "DE", "code": "993930191" }, "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE993930191" } ], "addresses": [ { "num": "15", "street": "Marienplatz", "locality": "München", "region": "BY", "code": "80331", "country": "DE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "lines": [ { "i": 1, "quantity": "1", "item": { "name": "Deutschkurs - Monat", "price": "120.00", "unit": "one" }, "taxes": [ { "cat": "VAT", "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I" } } ], "total": "120.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Deutsche Sprachschule", "tax_id": { "country": "DE", "code": "993930191" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE993930191" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE993930191" } ], "addresses": [ { "num": "15", "street": "Marienplatz", "locality": "München", "region": "BY", "code": "80331", "country": "DE" } ], "emails": [ { "addr": "test@example.com" } ] }, "customer": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE879558966" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "lines": [ { "i": 1, "quantity": "1", "item": { "name": "Deutschkurs - Monat", "price": "120.00", "unit": "one" }, "sum": "120.00", "taxes": [ { "cat": "VAT", "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I", "untdid-tax-category": "E" } } ], "total": "120.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "120.00", "total": "120.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I", "untdid-tax-category": "E" }, "base": "120.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "120.00", "payable": "120.00" } } ``` Reverse charge invoices are used for B2B services provided to customers in other EU member states. Reverse charge must be applied when: * The customer is a registered business in another EU member state (has a valid EU VAT ID). * The service is provided to a business customer (B2B), not a consumer. * The service is subject to VAT but the customer accounts for the VAT in their own country. To create a reverse charge invoice, use the tax key `reverse-charge` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon will automatically set the UNTDID 5305 tax category to `AE` (reverse charge) when the silo entry is built. With reverse charge, no VAT is charged by the supplier. The customer accounts for VAT in their own country. Both `supplier` and `customer` VAT ID must be valid and registered in the EU VIES system. ```json Germany reverse charge invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE" } } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE879558966" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB85905495" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE", "untdid-tax-category": "AE" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE", "untdid-tax-category": "AE" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Intra-community supply invoices are used for B2B goods delivered to customers in other EU member states. Intra-community supplies must be applied when: * The customer is a registered business in another EU member state (has a valid EU VAT ID). * Goods are physically delivered to another EU member state. * The supply is exempt from VAT in the origin country and subject to VAT in the destination country. To create an intra-community supply Peppol invoice, use the tax key `intra-community` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon will automatically set the UNTDID 5305 tax category to `K` (VAT exempt for EEA intra-community supply of goods and services) when the silo entry is built. With intra-community supplies in the EU, the customer accounts for VAT in their destination country. The `supplier` must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority and the `customer` VAT ID must be valid and registered in the EU VIES system. ```json Germany reverse charge invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC" } } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE879558966" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB85905495" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC", "untdid-tax-category": "K" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC", "untdid-tax-category": "K" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Outside scope invoices are used for B2B services provided to customers outside the EU. To create an outside scope Peppol invoice, use the tax key `outside-scope` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017)addon will automatically set the UNTDID 5305 tax category to `O` (Services outside scope of tax) when the silo entry is built. Services provided to non-EU customers are generally outside the scope of EU VAT. ```json Germany outside scope theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox service", "price": "145.00", "unit": "h" }, "sum": "145.00", "taxes": [ { "cat": "VAT", "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O" } } ], "total": "145.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE879558966" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0195:SGUEN199904785Z" } ], "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox service", "price": "145.00", "unit": "h" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O", "untdid-tax-category": "O" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O", "untdid-tax-category": "O" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Export invoices are used for B2B goods delivered to customers outside the EU. To create an export Peppol invoice, use the tax key `export` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon will automatically set the UNTDID 5305 tax category to `G` (Free export item, tax not charged) when the silo entry is built. Exported goods are exempt from VAT. The `supplier` must be previously registered with the tax authority. Customer tax identification is optional but recommended for record-keeping purposes. ```json Germany export invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "145.00", "taxes": [ { "cat": "VAT", "key": "export", "ext": { "cef-vatex": "VATEX-EU-G" } } ], "total": "145.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE879558966" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0195:SGUEN199904785Z" } ], "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "export", "ext": { "cef-vatex": "VATEX-EU-G", "untdid-tax-category": "G" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "export", "ext": { "cef-vatex": "VATEX-EU-G", "untdid-tax-category": "G" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Italy: Regular invoices are used for B2B transactions. Regular invoices must be issued when the customer is a registered business (has a tax identification number). To create a regular invoice, include the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`it-sdi-v1`](https://docs.gobl.org/addons/it-sdi-v1) addons. The addons will automatically set the document type to `380` when the silo entry is built (which happens automatically when saving a silo entry through the API or console). The `supplier` must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority and the `customer` VAT ID must be valid. ```json Italy standard B2B invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "MI", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ] }, "customer": { "name": "Roma Solutions S.r.l.", "tax_id": { "country": "IT", "code": "05140920017" }, "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT05140920017" } ], "addresses": [ { "num": "10", "street": "Via del Corso", "locality": "Roma", "region": "RM", "code": "00186", "country": "IT" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "rate": "general" } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "it-sdi-document-type": "TD01", "it-sdi-format": "FPR12", "untdid-document-type": "380" } }, "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0205:IT00159560366" } ], "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "MI", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ], "ext": { "it-sdi-fiscal-regime": "RF01" } }, "customer": { "name": "Roma Solutions S.r.l.", "tax_id": { "country": "IT", "code": "05140920017" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0205:IT05140920017" } ], "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT05140920017" } ], "addresses": [ { "num": "10", "street": "Via del Corso", "locality": "Roma", "region": "RM", "code": "00186", "country": "IT" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "22.0%", "ext": { "untdid-tax-category": "S" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "standard", "ext": { "untdid-tax-category": "S" }, "base": "1740.00", "percent": "22.0%", "amount": "382.80" } ], "amount": "382.80" } ], "sum": "382.80" }, "tax": "382.80", "total_with_tax": "2122.80", "payable": "2122.80" } } ``` Goods and services that are subject to VAT but taxed at a 0% rate. Zero rated goods in Italy are: * Daily and weekly newspapers, as well as periodical publications that meet a specific criteria. * Recyclable materials such as waste and scrap intended for recycling. * Educational materials under specific conditions. To create a reverse charge invoice, use the tax key `zero` in your invoice lines. Include the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`it-sdi-v1`](https://docs.gobl.org/addons/it-sdi-v1) addons to automatically set the UNTDID 5305 tax category to `Z` (zero rated goods) when the silo entry is built. With zero-rated supplies, businesses can still reclaim input VAT on their purchases, whereas with exempt supplies they cannot. ```json Italy zero rate invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "MI", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ] }, "customer": { "name": "Roma Solutions S.r.l.", "tax_id": { "country": "IT", "code": "05140920017" }, "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT05140920017" } ], "addresses": [ { "num": "10", "street": "Via del Corso", "locality": "Roma", "region": "RM", "code": "00186", "country": "IT" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "1", "item": { "name": "La Repubblica", "price": "2.00", "unit": "one" }, "taxes": [ { "cat": "VAT", "key": "zero" } ], "total": "2.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "it-sdi-document-type": "TD01", "it-sdi-format": "FPR12", "untdid-document-type": "380" } }, "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0205:IT00159560366" } ], "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "MI", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ], "ext": { "it-sdi-fiscal-regime": "RF01" } }, "customer": { "name": "Roma Solutions S.r.l.", "tax_id": { "country": "IT", "code": "05140920017" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0205:IT05140920017" } ], "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT05140920017" } ], "addresses": [ { "num": "10", "street": "Via del Corso", "locality": "Roma", "region": "RM", "code": "00186", "country": "IT" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "1", "item": { "name": "La Repubblica", "price": "2.00", "unit": "one" }, "sum": "2.00", "taxes": [ { "cat": "VAT", "key": "zero", "percent": "0%", "ext": { "it-sdi-exempt": "N1", "untdid-tax-category": "Z" } } ], "total": "2.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "2.00", "total": "2.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "zero", "ext": { "it-sdi-exempt": "N1", "untdid-tax-category": "Z" }, "base": "2.00", "percent": "0%", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "2.00", "payable": "2.00" } } ``` Exempt invoices are used for B2B transactions that are exempt from VAT, which also covers exemptions in internal operations. To create an exempt invoice, use the tax key `exempt` in your invoice lines. Include the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`it-sdi-v1`](https://docs.gobl.org/addons/it-sdi-v1) addons to automatically set the UNTDID 5305 tax category to `E` when the silo entry is built. You must also state the reason for the exemption through the [CET VATEX](https://docs.gobl.org/catalogues/cef#cef-vatex) - VAT exemption reason codes. Exempt operations are not subject to VAT but must still be reported. The `supplier` must be previously registered with the tax authority and the `customer` tax id must be valid. ```json Italy Peppol Exempt Invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "$regime": "IT", "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Scuola di Lingua Italiana", "tax_id": { "country": "IT", "code": "00159560366" }, "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "10", "street": "Via del Corso", "locality": "Roma", "region": "Milano-Capital", "code": "00186", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ] }, "customer": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "Milano-Capital", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ] }, "lines": [ { "i": 1, "quantity": "1", "item": { "name": "Corso di Italiano - Mese", "price": "120.00", "unit": "one" }, "taxes": [ { "cat": "VAT", "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I" } } ], "total": "120.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "it-sdi-document-type": "TD01", "it-sdi-format": "FPR12", "untdid-document-type": "380" } }, "supplier": { "name": "Scuola di Lingua Italiana", "tax_id": { "country": "IT", "code": "00159560366" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0205:IT00159560366" } ], "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "10", "street": "Via del Corso", "locality": "Roma", "region": "Milano-Capital", "code": "00186", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ], "ext": { "it-sdi-fiscal-regime": "RF01" } }, "customer": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0205:IT00159560366" } ], "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "Milano-Capital", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ] }, "lines": [ { "i": 1, "quantity": "1", "item": { "name": "Corso di Italiano - Mese", "price": "120.00", "unit": "one" }, "sum": "120.00", "taxes": [ { "cat": "VAT", "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I", "it-sdi-exempt": "N4", "untdid-tax-category": "E" } } ], "total": "120.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "120.00", "total": "120.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I", "it-sdi-exempt": "N4", "untdid-tax-category": "E" }, "base": "120.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "120.00", "payable": "120.00" } } ``` Reverse charge invoices are used for B2B services provided to customers in other EU member states. Reverse charge must be applied when: * The customer is a registered business in another EU member state (has a valid EU VAT ID). * The service is provided to a business customer (B2B), not a consumer. * The service is subject to VAT but the customer accounts for the VAT in their own country. To create a reverse charge invoice, use the tax key `reverse-charge` in your invoice lines. Include the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`it-sdi-v1`](https://docs.gobl.org/addons/it-sdi-v1) addons to automatically set the UNTDID 5305 tax category to `AE` (reverse charge) when the silo entry is built. With reverse charge, no VAT is charged by the supplier. The customer accounts for VAT in their own country. Both `supplier` and `customer` VAT ID must be valid and registered in the EU VIES system. ```json Italy reverse charge invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "Milano-Capital", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ] }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE" } } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "it-sdi-document-type": "TD01", "it-sdi-format": "FPR12", "untdid-document-type": "380" } }, "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0205:IT00159560366" } ], "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "Milano-Capital", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ], "ext": { "it-sdi-fiscal-regime": "RF01" } }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB85905495" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE", "it-sdi-exempt": "N6.9", "untdid-tax-category": "AE" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE", "it-sdi-exempt": "N6.9", "untdid-tax-category": "AE" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Intra-community supply invoices are used for B2B goods delivered to customers in other EU member states. Intra-community supplies must be applied when: * The customer is a registered business in another EU member state (has a valid EU VAT ID). * Goods are physically delivered to another EU member state. * The supply is exempt from VAT in the origin country and subject to VAT in the destination country. To create an intra-community supply Peppol invoice, use the tax key `intra-community` in your invoice lines. Include the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`it-sdi-v1`](https://docs.gobl.org/addons/it-sdi-v1) addons to automatically set the UNTDID 5305 tax category to `K` (VAT exempt for EEA intra-community supply of goods and services) when the silo entry is built. With intra-community supplies in the EU, the customer accounts for VAT in their destination country. The `supplier` must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority and the `customer` VAT ID must be valid and registered in the EU VIES system. ```json Italy reverse charge invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "Milano-Capital", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ] }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC" } } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "it-sdi-document-type": "TD01", "it-sdi-format": "FPR12", "untdid-document-type": "380" } }, "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0205:IT00159560366" } ], "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "Milano-Capital", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ], "ext": { "it-sdi-fiscal-regime": "RF01" } }, "customer": { "name": "Invopop SL", "tax_id": { "country": "ES", "code": "B85905495" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB85905495" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "street": "Calle Pradillo 42", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC", "it-sdi-exempt": "N3.2", "untdid-tax-category": "K" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC", "it-sdi-exempt": "N3.2", "untdid-tax-category": "K" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Outside scope invoices are used for B2B services provided to customers outside the EU. To create an outside scope Peppol invoice, use the tax key `outside-scope` in your invoice lines. Include the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`it-sdi-v1`](https://docs.gobl.org/addons/it-sdi-v1) addons to automatically set the UNTDID 5305 tax category to `O` (Services outside scope of tax) when the silo entry is built. Services provided to non-EU customers are generally outside the scope of EU VAT. ```json Italy outside scope theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "Milano-Capital", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox service", "price": "145.00", "unit": "h" }, "sum": "145.00", "taxes": [ { "cat": "VAT", "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O" } } ], "total": "145.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "it-sdi-document-type": "TD01", "it-sdi-format": "FPR12", "untdid-document-type": "380" } }, "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0205:IT00159560366" } ], "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "Milano-Capital", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ], "ext": { "it-sdi-fiscal-regime": "RF01" } }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0195:SGUEN199904785Z" } ], "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox service", "price": "145.00", "unit": "h" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O", "it-sdi-exempt": "N2.1", "untdid-tax-category": "O" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O", "it-sdi-exempt": "N2.1", "untdid-tax-category": "O" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Export invoices are used for B2B goods delivered to customers outside the EU. To create an export Peppol invoice, use the tax key `export` in your invoice lines. Include the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`it-sdi-v1`](https://docs.gobl.org/addons/it-sdi-v1) addons to automatically set the UNTDID 5305 tax category to `G` (Free export item, tax not charged) when the silo entry is built. Exported goods are exempt from VAT. The `supplier` must be previously registered with the tax authority. Customer tax identification is optional but recommended for record-keeping purposes. ```json Italy export invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "Milano-Capital", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "145.00", "taxes": [ { "cat": "VAT", "key": "export", "ext": { "cef-vatex": "VATEX-EU-G" } } ], "total": "145.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "IT", "$addons": [ "eu-en16931-v2017", "it-sdi-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "it-sdi-document-type": "TD01", "it-sdi-format": "FPR12", "untdid-document-type": "380" } }, "supplier": { "name": "Tecnologie Adriatico S.r.l.", "tax_id": { "country": "IT", "code": "00159560366" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0205:IT00159560366" } ], "inboxes": [ { "key": "peppol", "scheme": "0205", "code": "IT00159560366" } ], "addresses": [ { "num": "15", "street": "Via Giuseppe Verdi", "locality": "Milano", "region": "Milano-Capital", "code": "20121", "country": "IT" } ], "emails": [ { "addr": "fatturazione@tecnologieadriatico.it" } ], "ext": { "it-sdi-fiscal-regime": "RF01" } }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0195:SGUEN199904785Z" } ], "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "export", "ext": { "cef-vatex": "VATEX-EU-G", "it-sdi-exempt": "N3.1", "untdid-tax-category": "G" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "export", "ext": { "cef-vatex": "VATEX-EU-G", "it-sdi-exempt": "N3.1", "untdid-tax-category": "G" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Spain: Regular invoices are used for B2B transactions. Regular invoices must be issued when: * The customer is a registered business (has a tax identification number). * The transaction amount is €400 VAT included or above, or the customer requires a full invoice. * The customer needs a complete invoice with all tax details for accounting or tax purposes. To create a regular invoice, include the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addons and ensure the `customer` field contains valid tax identification details. The addons will automatically set the document type to `380` when the silo entry is built (which happens automatically when saving a silo entry through the API or console). The `supplier` must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority and the `customer` VAT ID must be valid. ```json Spain standard B2B invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$addons": [ "eu-en16931-v2017", "es-verifactu-v1" ], "$regime": "ES", "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Barcelona Commerce S.L.", "tax_id": { "country": "ES", "code": "B48994131" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB48994131" } ], "addresses": [ { "num": "20", "street": "Passeig de Gràcia", "locality": "Barcelona", "region": "Cataluña", "code": "08008", "country": "ES" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "rate": "general" } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "ES", "$addons": [ "eu-en16931-v2017", "es-verifactu-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "es-verifactu-doc-type": "F1", "untdid-document-type": "380" } }, "supplier": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB85905495" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Barcelona Commerce S.L.", "tax_id": { "country": "ES", "code": "B48994131" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB48994131" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB48994131" } ], "addresses": [ { "num": "20", "street": "Passeig de Gràcia", "locality": "Barcelona", "region": "Cataluña", "code": "08008", "country": "ES" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "21.0%", "ext": { "es-verifactu-op-class": "S1", "es-verifactu-regime": "01", "untdid-tax-category": "S" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "standard", "ext": { "es-verifactu-op-class": "S1", "es-verifactu-regime": "01", "untdid-tax-category": "S" }, "base": "1740.00", "percent": "21.0%", "amount": "365.40" } ], "amount": "365.40" } ], "sum": "365.40" }, "tax": "365.40", "total_with_tax": "2105.40", "payable": "2105.40" } } ``` Exempt invoices are used for B2B transactions that are exempt from VAT, which also covers exemptions in internal operations. To create an exempt invoice, use the tax key `exempt` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addons will automatically set the UNTDID 5305 tax category to `E` when the silo entry is built. You must also state the reason for the exemption through the [CET VATEX](https://docs.gobl.org/catalogues/cef#cef-vatex) - VAT exemption reason codes. Exempt operations are not subject to VAT but must still be reported. The `supplier` must be previously registered with the tax authority and the `customer` tax id must be valid. ```json Spain Peppol Exempt Invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$addons": [ "eu-en16931-v2017", "es-verifactu-v1" ], "$regime": "ES", "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Escuela de Lengua Española", "tax_id": { "country": "ES", "code": "B71353213" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB71353213" } ], "addresses": [ { "num": "20", "street": "Passeig de Gràcia", "locality": "Barcelona", "region": "Madrid-Capital", "code": "08008", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid-Capital", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "lines": [ { "i": 1, "quantity": "1", "item": { "name": "Curso de Español - Mes", "price": "120.00", "unit": "one" }, "taxes": [ { "cat": "VAT", "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I" } } ], "total": "120.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "ES", "$addons": [ "eu-en16931-v2017", "es-verifactu-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "es-verifactu-doc-type": "F1", "untdid-document-type": "380" } }, "supplier": { "name": "Escuela de Lengua Española", "tax_id": { "country": "ES", "code": "B71353213" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB71353213" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB71353213" } ], "addresses": [ { "num": "20", "street": "Passeig de Gràcia", "locality": "Barcelona", "region": "Madrid-Capital", "code": "08008", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB85905495" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid-Capital", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "lines": [ { "i": 1, "quantity": "1", "item": { "name": "Curso de Español - Mes", "price": "120.00", "unit": "one" }, "sum": "120.00", "taxes": [ { "cat": "VAT", "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I", "es-verifactu-exempt": "E1", "es-verifactu-regime": "01", "untdid-tax-category": "E" } } ], "total": "120.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "120.00", "total": "120.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "exempt", "ext": { "cef-vatex": "VATEX-EU-132-1I", "es-verifactu-exempt": "E1", "es-verifactu-regime": "01", "untdid-tax-category": "E" }, "base": "120.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "120.00", "payable": "120.00" } } ``` Reverse charge invoices are used for B2B services provided to customers in other EU member states. Reverse charge must be applied when: * The customer is a registered business in another EU member state (has a valid EU VAT ID). * The service is provided to a business customer (B2B), not a consumer. * The service is subject to VAT but the customer accounts for the VAT in their own country. To create a reverse charge invoice, use the tax key `reverse-charge` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addons will automatically set the UNTDID 5305 tax category to `AE` (reverse charge) when the silo entry is built. With reverse charge, no VAT is charged by the supplier. The customer accounts for VAT in their own country. Both `supplier` and `customer` VAT ID must be valid and registered in the EU VIES system. ```json Spain reverse charge invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$addons": [ "eu-en16931-v2017", "es-verifactu-v1" ], "$regime": "ES", "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid-Capital", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE" } } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "ES", "$addons": [ "eu-en16931-v2017", "es-verifactu-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "es-verifactu-doc-type": "F1", "untdid-document-type": "380" } }, "supplier": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB85905495" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid-Capital", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0208:0316597904" } ], "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE", "es-verifactu-op-class": "S2", "es-verifactu-regime": "01", "untdid-tax-category": "AE" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "reverse-charge", "ext": { "cef-vatex": "VATEX-EU-AE", "es-verifactu-op-class": "S2", "es-verifactu-regime": "01", "untdid-tax-category": "AE" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Intra-community supply invoices are used for B2B goods delivered to customers in other EU member states. Intra-community supplies must be applied when: * The customer is a registered business in another EU member state (has a valid EU VAT ID). * Goods are physically delivered to another EU member state. * The supply is exempt from VAT in the origin country and subject to VAT in the destination country. To create an intra-community supply Peppol invoice, use the tax key `intra-community` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addons will automatically set the UNTDID 5305 tax category to `K` (VAT exempt for EEA intra-community supply of goods and services) when the silo entry is built. With intra-community supplies in the EU, the customer accounts for VAT in their destination country. The `supplier` must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority and the `customer` VAT ID must be valid and registered in the EU VIES system. ```json Spain reverse charge invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$addons": [ "eu-en16931-v2017", "es-verifactu-v1" ], "$regime": "ES", "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid-Capital", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC" } } ], "total": "1740.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "ES", "$addons": [ "eu-en16931-v2017", "es-verifactu-v1" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "es-verifactu-doc-type": "F1", "untdid-document-type": "380" } }, "supplier": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB85905495" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid-Capital", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Benelux Industries SA/NV", "tax_id": { "country": "BE", "code": "0316597904" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0208:0316597904" } ], "inboxes": [ { "key": "peppol", "scheme": "0208", "code": "0316597904" } ], "addresses": [ { "num": "42", "street": "Rue de la Loi", "locality": "Brussels", "region": "Brussels-Capital", "code": "1040", "country": "BE" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC", "es-verifactu-exempt": "E5", "es-verifactu-regime": "01", "untdid-tax-category": "K" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "intra-community", "ext": { "cef-vatex": "VATEX-EU-IC", "es-verifactu-exempt": "E5", "es-verifactu-regime": "01", "untdid-tax-category": "K" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Outside scope invoices are used for B2B services provided to customers outside the EU. To create an outside scope Peppol invoice, use the tax key `outside-scope` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addons will automatically set the UNTDID 5305 tax category to `O` (Services outside scope of tax) when the silo entry is built. Services provided to non-EU customers are generally outside the scope of EU VAT. ```json Spain outside scope theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$addons": [ "eu-en16931-v2017" ], "$regime": "ES", "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid-Capital", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox service", "price": "145.00", "unit": "h" }, "sum": "145.00", "taxes": [ { "cat": "VAT", "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O" } } ], "total": "145.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "ES", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB85905495" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB85905495" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid-Capital", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0195:SGUEN199904785Z" } ], "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox service", "price": "145.00", "unit": "h" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O", "untdid-tax-category": "O" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "outside-scope", "ext": { "cef-vatex": "VATEX-EU-O", "untdid-tax-category": "O" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` Export invoices are used for B2B goods delivered to customers outside the EU. To create an export Peppol invoice, use the tax key `export` in your invoice lines. The [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addons will automatically set the UNTDID 5305 tax category to `G` (Free export item, tax not charged) when the silo entry is built. Exported goods are exempt from VAT. The `supplier` must be previously registered with the tax authority. Customer tax identification is optional but recommended for record-keeping purposes. ```json Spain export invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$addons": [ "eu-en16931-v2017" ], "$regime": "ES", "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "supplier": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B71353213" }, "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB71353213" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid-Capital", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "145.00", "taxes": [ { "cat": "VAT", "key": "export", "ext": { "cef-vatex": "VATEX-EU-G" } } ], "total": "145.00" } ], "payment": { "terms": { "detail": "Will be paid by 2026-06-02" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "ES", "$addons": [ "eu-en16931-v2017" ], "type": "standard", "series": "INV", "code": "PP000003", "issue_date": "2025-04-03", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B71353213" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9920:ESB71353213" } ], "inboxes": [ { "key": "peppol", "scheme": "9920", "code": "ESB71353213" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid-Capital", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Singapore Company LTD", "tax_id": { "country": "SG", "code": "199904785Z" }, "endpoints": [ { "uri": "iso6523-actorid-upis::0195:SGUEN199904785Z" } ], "inboxes": [ { "key": "peppol", "scheme": "0195", "code": "SGUEN199904785Z" } ], "addresses": [ { "street": "18 Marina Gardens Drive", "locality": "Singapore", "region": "Central Region", "code": "018953", "country": "SG" } ], "emails": [ { "addr": "billing+test@invopop.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox product", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "export", "ext": { "cef-vatex": "VATEX-EU-G", "untdid-tax-category": "G" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "export", "ext": { "cef-vatex": "VATEX-EU-G", "untdid-tax-category": "G" }, "base": "1740.00", "amount": "0.00" } ], "amount": "0.00" } ], "sum": "0.00" }, "tax": "0.00", "total_with_tax": "1740.00", "payable": "1740.00" } } ``` *** Ask and answer questions about Peppol App →