A specification based on Universal Business Language (UBL) that enables the exchange of compliant business documents worldwide via our e-business platform Pagero Online.
Introduction
Pagero Universal Format, hereafter referred to as "PUF", is a business document specification developed and maintained by Pagero Group.
PUF is based on Universal Business Language version 2.3 (UBL 2.3).
Certain elements require the use of PUF specific code lists. Below you will find all these lists.
In the specification for each message/document type you will find an overview on where the different code lists are applicable.
In some of these code lists PUF only points towards an external code list to be used.
Other times the code list to be used is a mix between values defined specifically for PUF and other external list(s).
Lastly, in some cases, all the values are defined solely for PUF.
Version and changelog
| Version | Date | Description |
|---|---|---|
1.0 |
2022-12-19 |
First version published. |
1.1 |
2023-05-04 |
|
1.2 |
2023-09-04 |
Updated PUF-020-ERRORCLASSIFICATIONCODE |
1.3 |
2024-06-18 |
Added Philippine specific codes. Rearrange PUF-009-TAXTYPESCHEME |
1.4 |
2024-07-31 |
Added Türkiye specific codes. Updated PUF-008-IDENTIFICATIONSCHEME |
1. PUF-001-REGISTRATIONDATA
The value consist of "country code:type of value".
The country code states which country the value is applicable for.
| Value | Description |
|---|---|
|
Initials of the province where the Company is registered. |
|
The registration number in the "companies register". |
|
Only in the case of a company (SpA, SApA, SRL), the element must be filled in with the share capital |
|
Only in the case of a joint-stock company or limited liability company, the element must be filled in to indicate if there is a single shareholder or several shareholders. Allowed values: SU or SM. SU = Sole shareholder. |
|
Indication of whether the Company is in liquidation or not. Allowed values: LS or LN. LS = In liquidation. |
|
Book in the register of the company. |
|
In which register the company is located. |
|
Sheet in the register of the company. |
|
Folio in the register of the company. |
|
Section in the register of the company. |
|
Volume in the register of the company. |
|
Other registration data. |
|
Legal name. |
|
Type of company (for example SAS). |
|
Share capital, capital contributed to a company at the time of its creation. |
|
Trade and Companies Register number. |
|
Business activity classification code. |
|
Authorisation Number for Certified Exporter (e.g., ATIGA number). |
|
Supplier VAT Registration Allowed values: 0 or 1. 0 = VAT Registered. |
2. PUF-002-ADAID
The value consist of "country code:type of value".
The country code states which country the value is applicable for.
| Value | Description |
|---|---|
|
Code of the receiving unit behind French government portal. |
|
Code for the accounting office (Oficina Contable). |
|
Code for the management agency (Órgano Gestor). |
|
Code for the processing authority unit (Unidad Tramitadora). |
|
Code for the proposing agency (Órgano Proponente). |
|
General code for defining the unit of a company. |
3. PUF-003-INVOICETYPECODE
List of available general invoice type codes.
| Value | Description |
|---|---|
|
Invoice, only applicable within UBL message/document type Invoice. |
|
Credit note, only applicable within UBL message/document type CreditNote. |
|
Debit note, only applicable within UBL message/document type Invoice. |
|
Corrected invoice, only applicable within UBL message/document type Invoice. |
|
Prepayment invoice, only applicable within UBL message/document type Invoice. |
3.1. Invoice type codes Saudi Arabia
The below listed invoice type codes are available for use in Saudi Arabia.
| Value | Description |
|---|---|
|
Tax Invoice, only applicable within UBL message/document type Invoice. |
|
Credit note, only applicable within UBL message/document type CreditNote. |
|
Debit note, only applicable within UBL message/document type Invoice. |
|
Prepayment invoice, only applicable within UBL message/document type Invoice. |
3.2. Invoice subtype codes Saudi Arabia
In addition to the invoice type code it is required to provide invoice subtypes.
This should be placed in cbc:InvoiceTypeCode/@name and must follow a certain syntax.
Structure of the value must be NNPNESB (e.g. 0100000) where:
| Value | Supported values |
|---|---|
|
01 for tax invoice |
|
3rd party invoice transaction, 0 for false, 1 for true. |
|
Nominal invoice transaction, 0 for false, 1 for true. |
|
Exports invoice transaction, 0 for false, 1 for true. |
|
Summary invoice transaction, 0 for false, 1 for true. |
|
Self-billed invoice transaction, 0 for false, 1 for true. |
3.3. Invoice type codes for Philippines
The following table outlines the different invoice types, their corresponding Invoice Type Codes, and Type Code attribute.
| Invoice Type | Invoice Type Code | Invoice Type Code @name |
|---|---|---|
Sales Invoice (SI) |
380 |
01 |
Debit Note (DN) |
383 |
02 |
Credit Note (CN) |
381 |
03 |
Service Billing (SB) |
380 |
04 |
Official Receipt (OR) |
380 |
05 |
Corrective Invoice |
384 |
01-05 |
4. PUF-004-CURRENCYCODE
For available values see OpenPeppol’s code list ISO 4217 Currency codes.
5. PUF-005-INVOICEDOBJECTIDENTIFIER
For available values see OpenPeppol’s code list Invoiced object identifier scheme (UNCL 1153).
6. PUF-006-MIMECODES
List of available MIME codes.
| Value | Description |
|---|---|
|
Comma separated value file. |
|
PDF document. |
|
JPEG image. |
|
Spreadsheet document. |
|
Spreadsheet document. |
7. PUF-007-ENDPOINTSCHEME
For available values see OpenPeppol’s code list Electronic Address Scheme (EAS).
8. PUF-008-IDENTIFICATIONSCHEME
Supported values can be found in OpenPeppol’s code list ISO 6523 ICD list.
For cac:AccountingSupplierParty/cac:Party/cac:PartyIdentification/cbc:ID/@schemeID and
cac:PayeeParty/cac:PartyIdentification/cbc:ID/@schemeID an additional code list is also applicable: SEPA indicator.
For additional identification scheme identifier added in PUF see below recommendations.
8.1. Identification scheme Basque Country
| Value | Description |
|---|---|
|
Passport ID. |
|
Official ID document issued by country or territory of residence. |
|
Residence certificate. |
|
Other identifying document. |
8.2. Identification scheme Canada
| Value | Description |
|---|---|
|
Goods and Services Tax (GST) Number. |
|
Harmonized Sales Tax (HST) Number. |
|
Provincial Sales Tax (PST) Number. |
|
Quebec Sales Tax (QST) Number. |
8.3. Identification scheme Hungary
| Value | Description |
|---|---|
|
Tax number. |
|
Group member tax number. |
8.4. Identification scheme India
| Value | Description |
|---|---|
|
PAN is a 10-digit unique identification alpha-numeric number. |
|
GSTIN is a 15-digit PAN-based unique identification number assigned to every registered person under GST. |
|
Corporate Identification Number (CIN) is a 21 digits alpha-numeric unique identification number that is assigned by the Registrar of Companies (ROC). |
8.5. Identification scheme Israel
| Value | Description |
|---|---|
|
Union VAT number. |
8.6. Identification scheme Malaysia
| Value | Description |
|---|---|
|
Tax identification number. |
|
Business registration number. |
|
Passport number. |
|
Tourism tax registration number. |
|
Military Personnel identification number. |
|
For MyPR and MyKAS to use MY:NRIC scheme. |
8.7. Identification scheme Saudi Arabia
| Value | Description |
|---|---|
|
Group VAT number. |
|
National ID. |
|
Tax Identification Number. |
|
Iqama Number. |
|
Passport ID. |
|
Commercial registration number. |
|
Momra license. |
|
MLSD license. |
|
700 number. |
|
Sagia license. |
|
GCC ID. |
|
Other ID. |
8.8. Identification scheme Serbia
| Value | Description |
|---|---|
|
Unique ID number used for public entities. |
8.9. Identification scheme Türkiye
| Value | Description |
|---|---|
|
Service number. |
|
Installation number. |
|
Telephone number. |
|
Distributor number. |
|
Trade Registry number. |
|
TAPDK number issued by the Tobacco and Alcohol Market Regulatory Authority. |
|
Dealer number. |
|
Subscriber number. |
|
Meter number. |
|
EPDK number issued by the Energy Market Regulatory Authority. |
|
Branch Number. |
|
Passport number. |
|
Brokerage label. |
|
Brokerage tax number. |
|
Farmer registration number. |
|
Manufacturer number. |
|
File (dossier) number. |
|
Hospital patient number. |
|
Central Registration System number for businesses. |
|
Producer number. |
9. PUF-009-TAXTYPESCHEME
9.1. General tax type scheme codes
| Value | Description |
|---|---|
|
Goods and Services Tax. |
|
Income Tax |
|
Local Sales Tax. |
|
Percentage Tax. |
|
Sales and Services Tax. |
|
State/Provincial Sales Tax. |
|
Value Added Tax. |
9.2. Country-Specific tax type scheme codes
9.2.1. Canada
| Value | Description |
|---|---|
|
Harmonised Sales Tax (HST). |
|
Quebec Sales Tax (QST). |
|
Provincial Sales Tax (PST). |
9.2.2. India
| Value | Description |
|---|---|
|
CESS. |
|
CESS Non Ad Valorem. |
|
Central Goods and Services Tax. |
|
Integrated Goods and Services Tax. |
|
State Goods and Services Tax. |
|
State CESS. |
|
State CESS Non Ad Valorem. |
|
Union Territory Goods and Services Tax. |
10. PUF-010-PAYMENTMEANSCODE
| Value | Description |
|---|---|
|
Instrument not defined. |
|
In cash. |
|
Cheque. |
|
Credit transfer. |
|
Debit transfer. |
|
Payment to bank account. |
|
Bank card. |
|
Bankgiro. |
|
SEPA credit transfer |
|
SEPA direct debit |
|
Reference giro |
For all available codes see OpenPeppol’s list Payment means code (UNCL4461).
11. PUF-011-ALLOWANCECHARGEREASONCODE
Values can differ depending on which legal domain you are in or if there are other types of business requirements.
Below you will find links to recommended lists.
| Link | Description |
|---|---|
Allowance reason codes (UNCL5189 subset). |
|
Charge reason code (UNCL7161 subset). |
For additional codes added in PUF see below code recommendations.
11.1. Allowance reason codes Philippines
| Value | Description |
|---|---|
SC |
Senior Citizen Discount. |
PWD |
Person With Disability Discount |
12. PUF-012-TAXCATEGORYCODE
Standard european tax category codes can be found in OpenPeppol’s code list Duty or tax or fee category code (Subset of UNCL5305).
For additional codes added in PUF see below code recommendations.
12.1. Tax category codes Basque Country
| Value | Description |
|---|---|
|
Without reverse charge (default). |
|
With reverse charge. |
|
Exempt. |
|
Non-taxable under Art. 7, 14, Others. |
|
Non-taxable under location rules. |
12.2. Tax category codes Portugal
| Value | Description |
|---|---|
|
Lower rate. |
|
Standard rate. |
|
Exempt. |
|
Zero rated goods. |
|
VAT Reverse Charge. |
|
Free export item, VAT not charged. |
|
Services outside scope of tax. |
|
Reduced rate. |
|
Intermediate. |
|
Normal rate. |
|
Exempt. |
|
Others, applicable to special VAT schemes. |
|
In case of non-subjection to VAT or IS. On receipts issued without itemized tax must be filled with "NA". |
|
Intra-Community VAT. |
12.3. Tax category codes Serbia
| Value | Description |
|---|---|
|
Standard rate. |
|
Reverse Charge. |
|
Zero rated goods/tax exemption with right to deduction. |
|
Exempt from VAT/tax exemption without deduction rights. |
|
Exempt from VAT. |
|
Services outside scope of VAT. |
|
Services outside scope of VAT 2. |
|
Special procedures. |
|
Cancellation. |
12.4. Tax category codes Singapore
| Value | Description |
|---|---|
|
Local supply of goods and services. |
|
Customer accounting supply made by the supplier. |
|
Customer accounting supply made by the customer on supplier’s behalf. |
|
Supplies involving goods for export/ provision of international services. |
|
Specific categories of exempt supplies listed under regulation 33 of the GST (general) regulations. |
|
Exempt supplies other than those listed under regulation 33 of the GST (general) regulations. |
|
Supplies required to be reported pursuant to the GST legislation. |
|
Supplies outside the scope of the GST act. |
|
Supplies from a company which is not registered for GST. |
|
Overseas vendor registration regime for Business-to-Consumer (“B2C”) supplies of imported digital services. |
|
Supply of remote services accountable by the electronic marketplace under the Overseas Vendor Registration Regime. |
|
Supply of LVG accountable by the redeliverer or electronic marketplace on behalf of third-party suppliers. |
|
Own supply of LVG. |
|
Reverse charge regime for Business-to-Business (“B2B”) supplies of imported services. |
12.5. Tax category codes Türkiye
The most common tax category code is 0015, which indicates regular VAT.
| Value | Description |
|---|---|
|
GERÇEK USULDE KATMA DEĞER VERGİSİ |
Click here for a complete list of all tax category codes in Türkiye.
| Value | Description |
|---|---|
|
GELİR VERGİSİ STOPAJI |
|
KURUMLAR VERGİSİ STOPAJI |
|
GERÇEK USULDE KATMA DEĞER VERGİSİ |
|
BANKA MUAMELELERİ VERGİSİ |
|
SİGORTA MUAMELELERİ VERGİSİ |
|
KAYNAK KULLANIMI DESTEKLEME FONU KESİNTİSİ |
|
PETROL VE DOĞALGAZ ÜRÜNLERİNE İLİŞKİN ÖZEL TÜKETİM VERGİSİ |
|
KOLALI GAZOZ, ALKOLLÜ İÇEÇEKLER VE TÜTÜN MAMÜLLERİNE İLİŞKİN ÖZEL TÜKETİM VERGİSİ |
|
DAYANIKLI TÜKETİM VE DİĞER MALLARA İLİŞKİN ÖZEL TÜKETİM VERGİSİ |
|
ALKOLLÜ İÇEÇEKLERE İLİŞKİN ÖZEL TÜKETİM VERGİSİ |
|
TÜTÜN MAMÜLLERİNE İLİŞKİN ÖZEL TÜKETİM VERGİSİ |
|
KOLALI GAZOZLARA İLİŞKİN ÖZEL TÜKETİM VERGİSİ |
|
DAMGA VERGİSİ |
|
5035 SAYILI KANUNA GÖRE DAMGA VERGİSİ |
|
ELEKTRİK VE HAVAGAZI TÜKETİM VERGİSİ |
|
ÖZEL İLETİŞİM VERGİSİ |
|
5035 SAYILI KANUNA GÖRE ÖZEL İLETİŞİM VERGİSİ |
|
PETROL VE DOĞALGAZ ÜRÜNLERİNE İLİŞKİN ÖTV TEVKİFATI |
|
BORSA TESCİL ÜCRETİ |
|
ENERJİ FONU |
|
TRT PAYI |
|
ELEKTRİK TÜKETİM VERGİSİ |
|
TELSİZ KULLANIM ÜCRETİ |
|
TELSİZ RUHSAT ÜCRETİ |
|
ÇEVRE TEMİZLİK VERGİSİ |
|
4961 BANKA SİGORTA MUAMELELERİ VERGİSİ |
|
MERA FONU |
|
MOTORLU TAŞIT ARAÇLARINA İLİŞKİN ÖZEL TÜKETİM VERGİSİ (TESCİLE TABİ OLANLAR) |
|
BELEDİYELERE ÖDENEN HAL RÜSUMU |
Tax codes for tax withholding
| Value | Description |
|---|---|
|
YAPIM İŞLERİ İLE BU İŞLERLE BİRLİKTE İFA EDİLEN MÜHENDİSLİK-MİMARLIK VE ETÜT-PROJE HİZMETLERİ [GT 117-Bölüm (3.2.1)] |
|
ETÜT, PLAN-PROJE, DANIŞMANLIK, DENETİM VE BENZERİ HİZMETLER[GT 117-Bölüm (3.2.2)] |
|
MAKİNE, TEÇHİZAT, DEMİRBAŞ VE TAŞITLARA AİT TADİL, BAKIM VE ONARIM HİZMETLERİ [GT 117-Bölüm (3.2.3)] |
|
YEMEK SERVİS HİZMETİ [GT 117-Bölüm (3.2.4)] |
|
ORGANİZASYON HİZMETİ [GT 117-Bölüm (3.2.4)] |
|
İŞGÜCÜ TEMİN HİZMETLERİ [GT 117-Bölüm (3.2.5)] |
|
ÖZEL GÜVENLİK HİZMETİ [GT 117-Bölüm (3.2.5)] |
|
YAPI DENETİM HİZMETLERİ [GT 117-Bölüm (3.2.6)] |
|
FASON OLARAK YAPTIRILAN TEKSTİL VE KONFEKSİYON İŞLERİ, ÇANTA VE AYAKKABI DİKİM İŞLERİ VE BU İŞLERE ARACILIK HİZMETLERİ [GT 117-Bölüm (3.2.7)] |
|
TURİSTİK MAĞAZALARA VERİLEN MÜŞTERİ BULMA / GÖTÜRME HİZMETLERİ [GT 117-Bölüm (3.2.8)] |
|
SPOR KULÜPLERİNİN YAYIN, REKLÂM VE İSİM HAKKI GELİRLERİNE KONU İŞLEMLERİ [GT 117-Bölüm (3.2.9)] |
|
TEMİZLİK HİZMETİ [GT 117-Bölüm (3.2.10)] |
|
ÇEVRE VE BAHÇE BAKIM HİZMETLERİ [GT 117-Bölüm (3.2.10)] |
|
SERVİS TAŞIMACILIĞI HİZMETİ [GT 117-Bölüm (3.2.11)] |
|
HER TÜRLÜ BASKI VE BASIM HİZMETLERİ [GT 117-Bölüm (3.2.12)] |
|
Diğer Hizmetler [KDVGUT-(I/C-2.1.3.2.13)] |
|
HURDA METALDEN ELDE EDİLEN KÜLÇE TESLİMLERİ [GT 117-Bölüm (3.3.1)] |
|
HURDA METALDEN ELDE EDİLENLER DIŞINDAKİ BAKIR, ÇİNKO DEMİR ; ÇELİK ALÜMİNYUM VE KURŞUN KÜLÇE TESLİMLERİ [KDVGUT-(I/C-2.1.3.3.1)] |
|
BAKIR, ÇİNKO VE ALÜMİNYUM ÜRÜNLERİNİN TESLİMİ [GT 117-Bölüm (3.3.2)] |
|
İSTİSNADAN VAZGEÇENLERİN HURDA VE ATIK TESLİMİ [GT 117-Bölüm (3.3.3)] |
|
METAL, PLASTİK, LASTİK, KAUÇUK, KÂĞIT VE CAM HURDA VE ATIKLARDAN ELDE EDİLEN HAMMADDE TESLİMİ [GT 117-Bölüm (3.3.4)] |
|
PAMUK, TİFTİK, YÜN VE YAPAĞI İLE HAM POST VE DERİ TESLİMLERİ [GT 117-Bölüm (3.3.5)] |
|
AĞAÇ VE ORMAN ÜRÜNLERİ TESLİMİ [GT 117-Bölüm (3.3.6)] |
|
YÜK TAŞIMACILIĞI HİZMETİ [KDVGUT-(I/C-2.1.3.2.11)] |
|
TİCARİ REKLAM HİZMETLERİ [KDVGUT-(I/C-2.1.3.2.15)] |
|
DİĞER TESLİMLER [KDVGUT-(I/C-2.1.3.3.7.)] |
|
DEMİR-ÇELİK ÜRÜNLERİNİN TESLİMİ [KDVGUT-(I/C-2.1.3.3.8)]” |
|
Yapım İşleri ile Bu İşlerle Birlikte İfa Edilen Mühendislik-Mimarlık ve Etüt-Proje Hizmetleri[KDVGUT-(I/C-2.1.3.2.1)] |
|
Etüt, Plan-Proje, Danışmanlık, Denetim ve Benzeri Hizmetler[KDVGUT-(I/C-2.1.3.2.2)] |
|
Makine, Teçhizat, Demirbaş ve Taşıtlara Ait Tadil, Bakım ve Onarım Hizmetleri[KDVGUT- (I/C-2.1.3.2.3)] |
|
Yemek Servis Hizmeti[KDVGUT-(I/C-2.1.3.2.4)] |
|
Organizasyon Hizmeti[KDVGUT-(I/C-2.1.3.2.4)] |
|
İşgücü Temin Hizmetleri[KDVGUT-(I/C-2.1.3.2.5)] |
|
Özel Güvenlik Hizmeti[KDVGUT-(I/C-2.1.3.2.5)] |
|
Yapı Denetim Hizmetleri[KDVGUT-(I/C-2.1.3.2.6)] |
|
Fason Olarak Yaptırılan Tekstil ve Konfeksiyon İşleri, Çanta ve Ayakkabı Dikim İşleri ve Bu İşlere Aracılık Hizmetleri[KDVGUT-(I/C-2.1.3.2.7)] |
|
Turistik Mağazalara Verilen Müşteri Bulma/ Götürme Hizmetleri[KDVGUT-(I/C-2.1.3.2.8)] |
|
Spor Kulüplerinin Yayın, Reklâm ve İsim Hakkı Gelirlerine Konu İşlemleri[KDVGUT-(I/C-2.1.3.2.9)] |
|
Temizlik Hizmeti[KDVGUT-(I/C-2.1.3.2.10)] |
|
Çevre ve Bahçe Bakım Hizmetleri[KDVGUT-(I/C-2.1.3.2.10)] |
|
Servis Taşımacılığı Hizmeti[KDVGUT-(I/C-2.1.3.2.11)] |
|
Her Türlü Baskı ve Basım Hizmetleri[KDVGUT-(I/C-2.1.3.2.12)] |
|
Hurda Metalden Elde Edilen Külçe Teslimleri[KDVGUT-(I/C-2.1.3.3.1)] |
|
Hurda Metalden Elde Edilenler Dışındaki Bakır, Çinko, Demir Çelik, Alüminyum ve Kurşun Külçe Teslimi [KDVGUT-(I/C-2.1.3.3.1)] |
|
Bakır, Çinko, Alüminyum ve Kurşun Ürünlerinin Teslimi[KDVGUT-(I/C-2.1.3.3.2)] |
|
İstisnadan Vazgeçenlerin Hurda ve Atık Teslimi[KDVGUT-(I/C-2.1.3.3.3)] |
|
Metal, Plastik, Lastik, Kauçuk, Kâğıt ve Cam Hurda ve Atıklardan Elde Edilen Hammadde Teslimi[KDVGUT-(I/C-2.1.3.3.4)] |
|
Pamuk, Tiftik, Yün ve Yapağı İle Ham Post ve Deri Teslimleri[KDVGUT-(I/C-2.1.3.3.5)] |
|
Ağaç ve Orman Ürünleri Teslimi[KDVGUT-(I/C-2.1.3.3.6)] |
|
Yük Taşımacılığı Hizmeti [KDVGUT-(I/C-2.1.3.2.11)] |
|
Ticari Reklam Hizmetleri [KDVGUT-(I/C-2.1.3.2.15)] |
|
Demir-Çelik Ürünlerinin Teslimi [KDVGUT-(I/C-2.1.3.3.8)] |
13. PUF-013-TAXEXEMPTIONCODE
Values can differ depending on which legal domain you are in or if there are other types of business requirements.
For Europe, OpenPeppol’s code list VATEX code list is recommended.
13.1. Tax Exemption Codes in Italy
To provide Natura codes in Italy, use the following codelist:
| Value | Description |
|---|---|
|
escluse ex art.15 |
|
non soggette ad IVA ai sensi degli artt. da 7 a 7-septies del DPR 633/72 |
|
non soggette – altri casi |
|
non imponibili – esportazioni |
|
non imponibili – cessioni intracomunitarie |
|
non imponibili – cessioni verso San Marino |
|
non imponibili – operazioni assimilate alle cessioni all’esportazione |
|
non imponibili – a seguito di dichiarazioni d’intento |
|
non imponibili – altre operazioni che non concorrono alla formazione del plafond |
|
esenti |
|
regime del margine / IVA non esposta in fattura |
|
inversione contabile – cessione di rottami e altri materiali di recupero |
|
inversione contabile – cessione di oro e argento puro |
|
inversione contabile – subappalto nel settore edile |
|
inversione contabile – cessione di fabbricati |
|
inversione contabile – cessione di telefoni cellulari |
|
inversione contabile – cessione di prodotti elettronici |
|
inversione contabile – prestazioni comparto edile e settori connessi |
|
inversione contabile – operazioni settore energetico |
|
inversione contabile – altri casi |
|
IVA assolta in altro stato UE (prestazione di servizi di telecomunicazioni, tele-radiodiffusione ed elettronici ex art. 7-octies, comma 1 lett. a, b, art. 74-sexies DPR 633/72) |
14. PUF-014-UOMCODE
Values can differ depending on which legal domain you are in or if there are other types of business requirements.
However, OpenPeppol’s code list UN/ECE Recommendation 20 is recommended.
15. PUF-015-ITEMTYPEIDENTIFICATIONCODE
Values must be from OpenPeppol’s code list Item type identification code (UNCL7143).
16. PUF-016-INVOICESTATUSCODE
Supported values can be found in OpenPeppol’s code list Invoice status code (UNCL4343 Subset).
For additional identification scheme identifier added in PUF see below recommendations.
| Value | Description |
|---|---|
|
Validation Failure. |
17. PUF-017-CLEARANCESTATUSCODE
List of available clearance/reporting status codes.
| Value | Description |
|---|---|
|
Approved by clearance authority. |
|
Approved by clearance authority with warnings. |
|
Rejected by clearance authority. |
18. PUF-018-APPLICATIONRESPONSECODE
Supported values can be found in OpenPeppol’s code list Application Response type code (UNCL4343 Subset).
19. PUF-019-DOCUMENTREFERENCEDOCTYPECODE
List of available document type codes.
| Value | Description |
|---|---|
|
Price/sales catalogue |
|
Request for payment |
|
Commercial Invoice |
|
Credit note |
|
Debit note |
|
Corrected invoice |
|
Prepayment Invoice |
|
Tax invoice |
20. PUF-020-ERRORCLASSIFICATIONCODE
List of internal Pagero error codes that can be received in a Technical Acknowledgement.
20.1. Attachment & print errors
| Pagero error code | Description |
|---|---|
|
Attachment is missing. |
|
Duplicate legal presentation. |
|
Attachment is empty. |
|
Attachment max size exceeded. |
|
PDF out of bounds for print. |
|
Attachment matching service error. |
|
Unsupported font for print. |
|
Print service requires presentation PDF. |
20.2. Pagero Online system errors
| Pagero error code | Description |
|---|---|
|
Duplicate control mandatory. |
|
Duplicate invoice number. |
|
Duplicate interchangeid. |
|
Sender party not equals customer GLN. |
|
Sender party not equals customer name. |
|
Sender party not equals customer no id. |
|
Sender party not equals customer org no. |
|
Sender party not equals customer VAT no. |
|
Logotype waiting add approval. |
|
Logotype waiting delete approval. |
|
User not allowed to send for customer. |
|
Duplicate invoice number. |
|
Too many documents in batch. |
|
No business document found. |
|
No data found. |
20.3. Document content errors
| Pagero error code | Description |
|---|---|
|
Invalid due date. |
|
Invalid invoice row amount. |
|
Invalid OCR (Payment reference) |
|
Invalid total net amount. |
|
Invalid total net amount, no net amount. |
|
Invalid total total amount. |
|
Invalid vat amount. |
|
Missing invoice date. |
|
Buyer VAT registration Country Code missing. |
|
Seller VAT registration Country Code missing. |
|
Document type missing. |
|
No net amount in movable direction. |
20.4. Format validation errors
The 'Format Name' column helps identify the format responsible for triggering the error. If your issuing format isn’t listed, the error likely originated from the recipient’s target format.
| Pagero error code | Description | Format name |
|---|---|---|
|
Schematron validation failure. |
General |
|
XML validation failed for VAN. |
General |
|
Missing organization number. |
BGC Invoice |
|
Missing value in invoice. |
General |
|
XML validation failed. |
General |
|
Article unitCode missing. |
Peppol BIS / UBL |
|
Booking date missing. |
AdsML |
|
Buyer postal address missing. |
Pagero Original Print |
|
Buyer street name missing. |
Finvoice |
|
Buyer Tax Code invalid. |
FatturaPA |
|
BuyerLineItemNum missing. |
xCBL |
|
BuyerOrganisationUnitNumber misplaced. |
Finvoice |
|
Post Code not valid. |
FatturaPA |
|
CodiceDestinatario incorrect |
FatturaPA |
|
CodiceDestinatario missing |
FatturaPA |
|
Currency Code missing. |
Peppol BIS / UBL |
|
Date format incorrect |
FatturaPA |
|
Date pattern invalid. |
xCBL |
|
Due Date missing. |
BGC Invoice |
|
Tax Amount missing. |
Peppol BIS / UBL |
|
Invoice Row missing. |
Finvoice |
|
Tax Amount missing. |
cXML |
|
invoiceNetAmountHUF missing in invoiceVatAmount. |
invoiceData XML (Hungary) |
|
Invoice Rows missing. |
FatturaPA |
|
Note Number Invalid. |
FatturaPA |
|
Namespace missing. |
Peppol BIS / UBL |
|
Order Reference ID missing. |
Peppol BIS / UBL |
|
PenalitaPagamentiRitardati Invalid. |
FatturaPA |
|
Invoice Line missing. |
Peppol BIS / UBL |
|
Post code City missing. |
FatturaPA |
|
Invalid PrezzoTotale. |
FatturaPA |
|
Bank Details missing. |
Finvoice |
|
Bank Details missing. |
TEAPPS |
|
Seller Or Buyer Street missing. |
cXML |
|
Seller PostCode missing. |
Finvoice |
|
Seller street/post box missing. |
FatturaPA |
|
Invoice Line missing. |
Svefaktura 1.0 |
|
Taxable Amount missing. |
Peppol BIS / UBL |
|
Invalid DeliveryOrganisationTaxCode. |
Finvoice |
|
Town missing. |
FatturaPA |
|
TaxSubtotal incomplete. |
Tungsten Master Map |
|
Unit of measure missing. |
xCBL |
|
Zero rate VAT not allowed, header. |
invoiceData XML (Hungary) |
|
Zero rate VAT not allowed, line. |
invoiceData XML (Hungary) |
|
summaryGrossData missing invoiceGrossAmountHUF. |
invoiceData XML (Hungary) |
|
vatRateNetData missing vatRateNetAmountHUF. |
invoiceData XML (Hungary) |
|
vatRateVatData missing vatRateVatAmountHUF. |
invoiceData XML (Hungary) |
|
Order- or Buyer reference missing. |
Peppol BIS / UBL |
20.5. Pagero Online validation errors
| Pagero error code | Description |
|---|---|
|
Validation stop command. |
|
Validation stop command resolvable. |
|
Too many characters in invoice number. |
|
Non numerical invoice number. |
|
Invalid currency. |
|
Invalid country code. |
|
Invalid input in document. |
20.6. Compliance errors
| Pagero error code | Description |
|---|---|
|
Attachment with digsig type restricted by compliance. |
|
Attachment with digsig type restricted by country. |
|
Attachment with digsig type restricted by service provider. |
|
Compliance validation failure. |
|
Invalid email address (Resolvable). |
20.7. Factoring errors
| Pagero error code | Description |
|---|---|
|
Missing customer provided information. |
|
More than one document in batch. |
|
Not accepted by factoring provider. |
20.8. Clearance errors
| Pagero error code | Description |
|---|---|
|
Clearance rejected. |
|
Clearance validation error. |
20.9. Routing errors
| Pagero error code | Description |
|---|---|
|
Issuer not approved. |
|
Issuer not approved. |
|
Missing sender Electronic ID. |
|
Recipient not found in registry. |
|
Recipient not found. |
|
Recipient connection needs routing. |
|
Recipient connection not found. |
|
Recipient not active. |
|
Recipient not found. |
|
Recipient not reachable. |
|
Recipient request not yet approved. |
|
Routing request not yet approved. |
|
Service provider required id missing. |
|
Transit communication not allowed. |
20.10. Manual errors
| Pagero error code | Description |
|---|---|
|
Message to user. |
|
Message to service provider. |
|
General Validation error. |
20.11. Delivery result errors
| Pagero error code | Description |
|---|---|
|
General delivery result error. |
|
Invalid email address (Resolvable). |
|
Invalid buyer order number (Resolvable). |
|
Invalid personal contact name (Resolvable). |
|
Invalid receiver reference value1 (Resolvable). |
|
Invalid receiver reference value2 (Resolvable). |
|
Invalid department (Resolvable). |
Support
If you have any questions related to PUF, please create a support ticket via Pagero Support.