errorPRTubl-2.1

PT-R-001:Portuguese NIF required

Portuguese invoices must include NIF (Numero de Identificacao Fiscal).

Severity
Fatal
Rule set
ubl-2.1
Country
PRT
Fix type
INPUT REQUIRED

Engine Classification

Business data required · Explicit input workflow · No assumptions made

Required input: Portuguese NIF

What is PT-R-001?

PT-R-001 is a fatal validation rule defined in the ubl-2.1 specification (PRT national rules). It validates the CompanyID element under PartyTaxScheme in the UBL invoice XML.

When this rule fires, the invoice is non-compliant and will be rejected by Peppol access points and national validation services. The sending system receives a rejection response and the invoice does not reach the buyer.

Target path: XPath: //cac:PartyTaxScheme/cbc:CompanyID

Why This Error Matters

NIF required for Portuguese tax compliance.

PT-R-001 is a hard failure. Invoices that trigger this rule are rejected at the access point and never reach the recipient. In Peppol networks, this means your sending system receives an MLR (Message Level Response) with a rejection status. The invoice must be corrected and re-sent, adding delay to your payment cycle.

Validator Behavior

  • ·Causes invoice rejection
  • ·Fails UBL schema validation
  • ·Error returned: PT-R-001
  • ·Specification: ubl-2.1

How to Fix It

1.

Get NIF

9-digit tax number

2.

Add to invoice

PT + 9 digits in CompanyID

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: //cac:PartyTaxScheme/cbc:CompanyID
Specubl-2.1

Common Causes

  • ·Missing seller NIF
  • ·Invalid NIF format

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

Frequently Asked Questions

Portuguese invoices must include NIF (Numero de Identificacao Fiscal).

Add 9-digit Portuguese NIF with PT prefix. You can also use Invoice Navigator's automatic Fixer tool to correct this instantly.

Yes, PT-R-001 is a critical error that will cause invoice rejection. It must be fixed before submission.

Related Errors

Last updated: 27 February 2026

Share this guide:

Handle PT-R-001 Automatically in Your Pipeline

The compliance engine auto-remediates this error with controlled safety policies and evidence pack generation.