InvoiceXpress Portugal

This app is only recommended for InvoiceXpress customers who wish to use GOBL to streamline their invoicing process. If you are getting started with your Portugal integration, use the AT Portugal app

Description
Actions
Workflows
Example documents

AT Portugal Guide

View implementation guide ›


Developer	Invopop
Category	Government
Scope	B2B, B2C
Country	Portugal

Invopop’s InvoiceXpress Portugal app is designed to support full compliance with Portugal’s AT e-invoicing regulation. Automate supplier onboarding, SAF-T report generation, invoice generation with ATCUD, and more. This app enables businesses (and their suppliers) to issue e-invoices in accordance with Portuguese law through InvoiceXpress.Key Features

Workflow Automation: This app provides automated workflows for issuing invoices, onboarding suppliers, and managing fiscal submissions to the Autoridade Tributária e Aduaneira (AT).
Legally Compliant PDF Invoices: Invoices are generated with all mandatory fields and a certified ATCUD code, as required by the Portuguese invoicing legislation.
SAF-T (PT) File Generation: The app makes workflow steps available to manage SAF-T (PT) entries for each supplier.
SAF-T supplier portal: Suppliers can generate SAF-T PT reports via the Supplier Portal.
Supplier Registration: Automatic registration (no onboarding process) with a single workflow step.

Make sure to check out our InvoiceXpress Guide for instructions on how to issue invoices and onboard suppliers.

The following workflows are available to make your integration easier. Use them as templates to build upon.

IX Portugal issue invoice

Example InvoiceXpress issue invoice workflow with states

{
  "name": "InvoiceXpress issue invoice",
  "description": "Issue an invoice in Portugal through InvoiceXpress",
  "schema": "bill/invoice",
  "steps": [
    {
      "id": "61b16e10-b8c9-11ef-b752-d31a7493e92d",
      "name": "Send to InvoiceXpress",
      "provider": "invoicexpress",
      "config": {
        "skip_pdf": true
      }
    },
    {
      "id": "2b65e8e0-2f21-11ef-803c-8d182b3d70cd",
      "name": "Generate PDF",
      "config": {
        "logo_height": 40,
        "locale": "pt",
        "date_format": "%Y-%m-%d"
      },
      "summary": "Portuguese",
      "provider": "pdf"
    },
    {
      "id": "6a8f6740-49a1-11ef-8c8c-7bca04ed2465",
      "name": "Set State",
      "config": {
        "state": "sent"
      },
      "summary": "Set state to `sent`{.state .sent}",
      "provider": "silo.state"
    }
  ],
  "rescue": [
    {
      "id": "6e7ea2d0-49a1-11ef-8c8c-7bca04ed2465",
      "name": "Set State",
      "config": {
        "state": "error"
      },
      "summary": "Set state to `error`{.state .error}",
      "provider": "silo.state"
    }
  ]
}

IX Portugal register supplier

Example InvoiceXpress register supplier workflow with states

{
  "name": "InvoiceXpress register supplier",
  "description": " ",
  "schema": "org/party",
  "steps": [
    {
      "id": "e78ab920-b8be-11ef-9825-f56714a03659",
      "name": "Sign Envelope",
      "provider": "silo.close"
    },
    {
      "id": "01d3e8a0-499e-11ef-b4fe-47a6daefa429",
      "name": "Set State",
      "config": {
        "state": "processing"
      },
      "summary": "Set state to `processing`{.state .processing}",
      "provider": "silo.state"
    },
    {
      "id": "dbac1680-b8be-11ef-9825-f56714a03659",
      "name": "Register InvoiceXpress issuer",
      "provider": "invoicexpress.register"
    },
    {
      "id": "0eb04c30-499e-11ef-b4fe-47a6daefa429",
      "name": "Set State",
      "config": {
        "state": "registered"
      },
      "summary": "Set state to `registered`{.state .registered}",
      "provider": "silo.state"
    }
  ],
  "rescue": [
    {
      "id": "12ad6a70-499e-11ef-b4fe-47a6daefa429",
      "name": "Set State",
      "config": {
        "state": "error"
      },
      "summary": "Set state to `error`{.state .error}",
      "provider": "silo.state"
    }
  ]
}

IX Portugal supplier

InvoiceXpress supplier example

  {
    "$schema": "https://gobl.org/draft-0/org/party",
    "uuid": "9de7584f-ea5c-42a7-b159-5e4c6a280a5c",
    "tax_id": {
      "country": "PT",
      "code": "545259045"
    },
    "name": "Hotelzinho",
    "emails": [
      {
        "addr": "[email protected]"
      }
    ],
    "addresses": [
      {
        "street": "Rua do Hotelzinho",
        "code": "1000-000",
        "locality": "Lisboa"
      }
    ]
  }

IX Portugal B2B invoice

B2B Invoice

{
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "PT",
    "uuid": "d9e9d28a-9c1d-3784-9a5b-1865eb2c231c",
    "type": "standard",
    "code": "FT IXTEST-01/1495",
    "issue_date": "2024-09-10",
    "currency": "EUR",
    "tax": {
        "prices_include": "VAT"
    },
    "supplier": {
        "uuid": "28437140-ce65-481a-a58c-9de1fc8dfedd",
        "name": "Invopop Test Supplier",
        "tax_id": {
            "country": "PT",
            "code": "508025338"
        },
        "addresses": [
            {
                "street": "R. António Enes n 8",
                "locality": "Lisboa",
                "region": "Lisboa",
                "code": "1050-023",
                "country": "PT"
            }
        ],
        "emails": [
            {
                "addr": "[email protected]"
            }
        ]
    },
    "customer": {
        "name": "Example Customer",
        "tax_id": {
            "country": "PT",
            "code": "568380630"
        },
        "addresses": [
            {
                "street": "Avenida de França 168-178",
                "locality": "Porto",
                "region": "Porto",
                "code": "4050-278",
                "country": "PT"
            }
        ]
    },
    "lines": [
        {
            "i": 1,
            "quantity": "1",
            "item": {
                "name": "Quick charge",
                "price": "80.00"
            },
            "sum": "80.00",
            "taxes": [
                {
                    "cat": "VAT",
                    "rate": "standard",
                    "percent": "23.0%"
                }
            ],
            "total": "80.00"
        }
    ],
    "ordering": {
        "period": {
            "start": "2024-09-10",
            "end": "2024-09-10"
        }
    },
    "payment": {
        "terms": {
            "due_dates": [
                {
                    "date": "2024-09-10",
                    "amount": "80.00",
                    "percent": "100%"
                }
            ]
        },
        "advances": [
            {
                "date": "2024-09-10",
                "key": "card",
                "description": "Card ending 5100",
                "amount": "80.00",
                "card": {
                    "last4": "5100"
                }
            }
        ]
    },
    "totals": {
        "sum": "80.00",
        "tax_included": "14.96",
        "total": "65.04",
        "taxes": {
            "categories": [
                {
                    "code": "VAT",
                    "rates": [
                        {
                            "key": "standard",
                            "base": "65.04",
                            "percent": "23.0%",
                            "amount": "14.96"
                        }
                    ],
                    "amount": "14.96"
                }
            ],
            "sum": "14.96"
        },
        "tax": "14.96",
        "total_with_tax": "80.00",
        "payable": "80.00",
        "advance": "80.00",
        "due": "0.00"
    }
}

Copy and paste these documents into the GOBL builder in order to preview and verify them.

🇵🇹 Invopop resources for Portugal


Compliance	Invoicing compliance in Portugal Compliance timeline
Apps	AT Portugal
Guides	AT Portugal Guide
FAQ	Portugal FAQ
GOBL	Portugal Tax Regime Portugal SAF-T Addon

Portugal FAQ

Frequently asked questions about invoicing compliance in Portugal →

Participate in our community

Ask and answer questions about the InvoiceXpress Portugal App →

Network

Government

Notify

Format

Document

Storage

Integrations

InvoiceXpress Portugal

AT Portugal Guide

Send invoice to InvoiceXpress

Cancel InvoiceXpress invoice

Register InvoiceXpress issuer

Portugal FAQ

Participate in our community