1. Using Financials for EMEA
  2. QR Code Structure and Field Mapping

QR Code Structure and Field Mapping

Refer the table to know more about the message incorporated in the QR code.

The table shows details such as code, description, maximum length and mandatory columns. In the Mandatory column, you must include fields with the symbol +. Fields with the symbol ++ are optional, but you must include them if the related information exists.

Code Description Maximum Length Mandatory Source Information
A Issuer Tax Identification Number/Tax Registration Number (NIF/TRN) 9 + Manage Tax Registrations, Legal Reporting Unit Tax Profile
B Customer NIF/TRN 30 +

Customer, Tax Profile, Tax Registrations, Registration Number

For Generic customers, display '999999990'
C Customer Country 12 +

Completed by designating “Desconhecido” in

  • Non-integrated systems, if information is not known;
  • Operations performed with “Consumidor Final” (Generic customer)
D Document Type 2 + Transaction Type Regional Information, andAR Transaction Types
E Document Status 1 + Receivables transaction header, Miscellaneous, Regional Information and Invoice Status
F Document Date 8 + Receivables transaction header and Transaction Date
G Document's Unique Identification 60 + Combination of the transaction type, document sequence ID, and document number
H ATCUD 70 + Receivables transaction header, Miscellaneous, Regional Information, and ATCUD
I1 Tax Country Region 5 +

Tax reporting code value of the tax rate on the Receivables transaction that has these attributes:

  • Tax Reporting Type Code: ORA_JEPT_TAX_COUNTRY
  • Tax Reporting Code: PT or PT-AC or PT-MA

If there is only one Tax Country Region for a particular invoice, fields I1 to I8 are populated. The indication that a document exists without VAT rate is displayed in tables 4.2, 4.3, or 4.4 of the SAF-T (PT) as «0» (I1:0).
I2 Taxable Amount for Exempt VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: ISE

OR

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: SELO
I3 Taxable Amount for Reduced VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: RED
I4 Total tax amount for Reduced VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: RED
I5 Taxable Amount for Intermediate VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: INT
I6 Total tax amount for intermediate VAT 16 ++

Lines with tax rates have these tax reporting codes:

  • ORA_JEPT_TAX_COUNTRY PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE VAT
  • ORA_JEPT_TAX_VALUE INT
I7 Taxable Amount for Normal VAT rate 16 ++ Lines with tax rates have these tax reporting codes for respective tax reporting type codes:
  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: NOR
I8 Total tax amount for normal VAT 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: NOR
J1 Tax Country Region 5 ++

Tax reporting code value of the tax rate on the Receivables transaction that has these attributes:

  • Tax Reporting Type Code: ORA_JEPT_TAX_COUNTRY
  • Tax Reporting Code: PT or PT-AC or PT-MA
Note: If there is only one Tax Country Region for a particular invoice, fields I1 to I8 are populated.
J2 Taxable Amount for Exempt VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE VAT
  • ORA_JEPT_TAX_VALUE ISE

OR

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: SELO
J3 Taxable Amount for Reduced VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE VAT
  • ORA_JEPT_TAX_VALUE RED
J4 Total tax amount for Reduced VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: RED
J5 Taxable Amount for Intermediate VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: INT
J6 Total tax amount for intermediate VAT 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: INT
J7 Taxable Amount for Normal VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: NOR
J8 Total tax amount for normal VAT 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • PT or PT-AC or PT-MA: VAT
  • ORA_JEPT_TAX_TYPE: NOR
K1 Tax Country Region 5 ++

Tax reporting code value of the tax rate on the Receivables transaction has these attributes:

  • Tax Reporting Type Code = ORA_JEPT_TAX_COUNTRY
  • Tax Reporting Code = PT or PT-AC or PT-MA

NOTE: If there is only one Tax Country Region for a particular invoice, fields I1 to I8 are populated.
K2 Taxable Amount for Exempt VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: ISE

OR

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: SELO
K3 Taxable Amount for Reduced VAT rate 16 ++ Lines with tax rates have these tax reporting codes for respective tax reporting type codes:
  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: RED
K4 Total tax amount for Reduced VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: RED
K5 Taxable Amount for Intermediate VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: INT
K6 Total tax amount for intermediate VAT 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: INT
K7 Taxable Amount for Normal VAT rate 16 ++

Lines with tax rates have these tax reporting codes for respective tax reporting type codes:

  • ORA_JEPT_TAX_COUNTRY: PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE: VAT
  • ORA_JEPT_TAX_VALUE: NOR
K8 Total tax amount for normal VAT Rate 16 ++ Lines with tax rates have these tax reporting codes for respective tax reporting type codes:
  • ORA_JEPT_TAX_COUNTRY PT or PT-AC or PT-MA
  • ORA_JEPT_TAX_TYPE VAT
  • ORA_JEPT_TAX_VALUE NOR
L Not subject to VAT / non-taxable amount 16 ++ Lines with tax rates have these tax reporting codes for respective tax reporting type codes:
  • ORA_JEPT_TAX_TYPE NS
  • ORA_JEPT_TAX_VALUE NS
M Stamp Duty Amount 16 ++

Lines with tax rates have these tax reporting codes:

  • Tax Reporting Type Code: ORA_JEPT_TAX_TYPE
  • Tax Reporting Code: SELO
N Total Tax 16 + Total tax amount on the document
O Total Document Amount including Tax 16 + Total amount on the document
P Withholding Tax Amount 16 ++ Not included in the QR code message
Q

4 characters of

Hash

 4 + Receivables transaction header, Miscellaneous, Regional Information, Hash value
R Software Certificate number 4 + Receivables transaction header, Miscellaneous, Regional Information, Certificate Number
S Other Optional Information 65 ++ N/A

Known Limitations

Here are some known limitations:

  • QR code and ATCUD are not supported in Receipt transactions, as these are not included in the signature processing.
  • ATCUD is not supported in Supply Chain transactions.