errorcountryPRTpeppol-bis-3

BR-PT-01:Portuguese NIF required

Fix: Add Portuguese NIF with PT prefix. Provide the required value in the free validator.

Portuguese invoices must include the 9-digit NIF (tax number).

Severity
Fatal
Rule set
peppol-bis-3
Country
PRT
Fix type
INPUT REQUIRED

Engine Classification

Business data required · Explicit input workflow · No assumptions made

Required input: Portuguese NIF

What is BR-PT-01?

BR-PT-01 is a fatal validation rule defined in the peppol-bis-3 specification (PRT national rules). It validates the CompanyID element under Party > PartyTaxScheme in the UBL invoice XML.

When this rule fires, the invoice is rejected by Peppol access points and never reaches the buyer.

Target path: XPath: /Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID

Why This Error Matters

Portuguese NIF is required for all B2B invoicing in Portugal.

BR-PT-01 is a hard failure — the invoice must be corrected and re-sent before it can reach the recipient.

Validator Behavior

  • ·Causes invoice rejection
  • ·Rejected by PEPPOL Access Points
  • ·Error returned: BR-PT-01
  • ·Specification: peppol-bis-3

How to Fix It

1.

Get NIF

9-digit Portuguese tax number

2.

Add PT prefix

Format: PT + 9 digits

3.

Validate checksum

NIF has control digit

XML Example

Generic example based on the rule's target XPath. Your actual XML structure may differ.

Before
<!-- Missing or empty element triggers cbc:CompanyID error -->
<cbc:CompanyID></cbc:CompanyID>
After
<!-- Provide the required value -->
<cbc:CompanyID>VALID_VALUE</cbc:CompanyID>

Technical Reference

XPathXPath: /Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
Specpeppol-bis-3

Code Example

<cac:PartyTaxScheme>
  <cbc:CompanyID>PT123456789</cbc:CompanyID>
  <cac:TaxScheme>
    <cbc:ID>VAT</cbc:ID>
  </cac:TaxScheme>
</cac:PartyTaxScheme>

Common Causes

  • ·Missing PT prefix
  • ·Invalid NIF
  • ·Wrong length

Seeing this in production? The API handles BR-PT-01 automatically. See the fix response →

Commonly Seen In

Portuguese invoicing systems

Frequently Asked Questions

Portuguese invoices must include the 9-digit NIF (tax number).

Add Portuguese NIF with PT prefix. Invoice Navigator detects this error and prompts for the required business data before applying a safe fix.

Yes, BR-PT-01 is a critical error that will cause invoice rejection. It must be fixed before submission to ensure your invoice is accepted by the recipient's system.

BR-PT-01 requires specific business data to resolve. Invoice Navigator detects the error and guides you through providing the needed information, then applies the fix with full audit documentation.

BR-PT-01 is commonly seen in exports from Portuguese invoicing systems. These software packages sometimes generate invoices that need adjustment to meet full compliance standards.

Related Content

Last updated: 3 March 2026

Share this guide:

Validate your invoice

Drop your XML here to check for BR-PT-01

Fix BR-PT-01 with guided input

Upload your invoice and we'll ask for the missing data, then apply a safe, auditable fix.