UBL-TR is the Turkish customisation of UBL 2.1, set by the Revenue Administration (GİB). It is the format of e-Fatura, the e-invoice between businesses registered for it, in use since 5 March 2010, and also of e-Arşiv Fatura and e-İrsaliye. Invoices carry the identifier TR1.2 and a scenario, and are signed or sealed before they travel through GİB. Klarbon plans to open UBL-TR invoices; this is not available yet.
What is in a UBL-TR invoice?
| Element | Holds |
|---|---|
UBLVersionID |
2.1 |
CustomizationID |
TR1.2 |
ProfileID |
the scenario, such as TEMELFATURA, TICARIFATURA, IHRACAT, KAMU or EARSIVFATURA |
ID |
a 16-character invoice number: a 3-character prefix, the year and a 9-digit sequence |
UUID |
the universal unique identifier (ETTN) |
CopyIndicator |
original or copy |
| Signature | electronic signature or financial seal (mali mühür), XAdES |
| Property | Value |
|---|---|
| Authority | Gelir İdaresi Başkanlığı (GİB), the Turkish Revenue Administration |
| Current guides | UBL-TR 1.2.1, with code lists updated separately |
| Legal basis | Tax Procedure Law general communiqués 397 and 509 |
| Transport | an envelope (zarf) through GİB's central system, directly or through a private integrator |
GİB's UBL-TR guides describe the customisation, each element and the code lists (GİB UBL-TR guides). Its integration guide explains the envelopes, the system responses and the basic and commercial scenarios (GİB integration guide). The technical architecture page lists every package and guide (GİB).
e-Fatura, e-Arşiv Fatura and Peppol BIS
| e-Fatura | e-Arşiv Fatura | Peppol BIS | |
|---|---|---|---|
| Buyer | a business registered for e-Fatura | anyone else, including consumers | any Peppol receiver |
| Format | UBL-TR | UBL-TR | UBL 2.1 to EN 16931 |
| Route | through GİB | to the buyer, reported to GİB | the Peppol network |
According to GİB, an e-Fatura is not a new kind of document; it has the same legal standing as a paper invoice (GİB).
What does Klarbon do with UBL-TR?
Opening UBL-TR invoices is planned, not available yet. Klarbon does not sign, seal or send invoices to GİB. It opens UBL invoices that follow EN 16931; see the invoice viewer.
Related
Frequently asked questions
What is UBL-TR?
The Turkish customisation of UBL 2.1, set by the Revenue Administration (Gelir İdaresi Başkanlığı, GİB). It keeps the elements Turkey needs, makes some optional ones mandatory and fixes the code lists. The current guides are UBL-TR 1.2.1.
What is the difference between e-Fatura and e-Arşiv Fatura?
e-Fatura goes between two businesses registered for e-Fatura, through GİB's system. e-Arşiv Fatura is for buyers who are not registered for e-Fatura, including consumers, and is reported to GİB rather than delivered through it.
What are TEMELFATURA and TICARIFATURA?
Invoice scenarios in the ProfileID. In the basic scenario the invoice is simply delivered. In the commercial scenario the buyer can accept or reject it with an application response.
Is UBL-TR compatible with Peppol or EN 16931?
Not directly. UBL-TR is a UBL 2.1 subset with its own identifier, TR1.2, Turkish code lists and rules, so a Peppol BIS invoice is not a valid e-Fatura and the reverse also holds.
Sources
- GİB, about e-Fatura (in Turkish) ebelge.gib.gov.tr
- GİB, e-Fatura legislation and technical architecture, with the UBL-TR guides and packages (in Turkish) ebelge.gib.gov.tr
- GİB, UBL-TR 1.2.1 guides (ZIP, in Turkish) ebelge.gib.gov.tr
- GİB, e-Fatura integration guide, version 1.10 (PDF, in Turkish) ebelge.gib.gov.tr