warningPRTubl-2.1

PT-R-003:SAF-T compliance recommended

Portuguese invoices should be SAF-T (PT) compliant for reporting.

Severity
Warning
Rule set
ubl-2.1
Country
PRT
Fix type
BLOCKED

Engine Classification

Financial or legal field · Modification blocked by policy

Reason: SAF-T (PT) compliance requires invoices to be structured according to the Portuguese Standard Audit File for Tax format. This cannot be achieved by modifying individual fields. Ensure your invoicing software is SAF-T (PT) compliant for proper tax reporting to Autoridade Tributária.

What is PT-R-003?

PT-R-003 is a warning validation rule defined in the ubl-2.1 specification (PRT national rules). It validates the SAF-T PT export requirement element in the UBL invoice XML.

This is a soft validation failure. The invoice may pass initial transmission, but non-compliant values in this field can cause problems during tax audits, buyer-side processing, or downstream VAT reconciliation.

Target path: SAF-T PT export requirement

This error requires manual correction — financial fields are protected by policy.Get API Access

Why This Error Matters

Portuguese companies must submit SAF-T files monthly.

PT-R-003 is a soft failure. The invoice may pass initial validation, but the non-compliant field can cause issues at the receiving end — tax authorities may flag it during audits, buyer ERP systems may fail to process it, or VAT reconciliation may produce mismatches. Fixing warnings before they accumulate prevents larger compliance gaps.

Validator Behavior

  • ·Generates validation warning
  • ·Fails UBL schema validation
  • ·Error returned: PT-R-003
  • ·Specification: ubl-2.1

How to Fix It

1.

Check fields

All SAF-T required fields present

2.

Configure ERP

Enable SAF-T export capability

XML Example

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

Before
<!-- Triggers validation error -->
<SAF-T PT export requirement></SAF-T PT export requirement>
After
<!-- Corrected -->
<SAF-T PT export requirement>VALID_VALUE</SAF-T PT export requirement>

Technical Reference

XPathSAF-T PT export requirement
Specubl-2.1

Common Causes

  • ·Missing SAF-T required fields
  • ·Incompatible data format

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

Frequently Asked Questions

Portuguese invoices should be SAF-T (PT) compliant for reporting.

Ensure invoice data can export to SAF-T format. This error involves a protected field — Invoice Navigator flags it in your pipeline so your team can correct it at the source.

PT-R-003 is a warning that may not always cause rejection, but should be addressed for full compliance.

Related Content

Last updated: 3 March 2026

Share this guide:

Detect PT-R-003 Before Submission

This error involves a financial or legal field that cannot be auto-modified. The compliance engine flags it immediately with a clear diagnosis so your team can fix it at the source.