What is UBL-TR?
UBL-TR is the XML document format, based on the open UBL standard, that Türkiye's Revenue Administration (GİB) has adopted for e-Fatura invoices and other electronic tax documents. Every piece of invoice data sits in a named field at a known place. That makes an invoice readable by software as well as by people, so it can be posted to an accounting system automatically.
Definition
UBL-TR is the XML document format, based on the open UBL standard, that Türkiye's Revenue Administration (GİB) has adopted for e-Fatura invoices and other electronic tax documents.
How does UBL-TR work?
UBL (Universal Business Language) is an open XML standard for business documents. UBL-TR is the version customised for Türkiye’s electronic document applications. GİB, the national tax authority, publishes its guides and schemas. In an e-Fatura file, the seller’s and buyer’s tax numbers, the invoice number, date, line items, unit prices, VAT rate and totals each have their own field. Every invoice also carries an ETTN, a universally unique identifier.
When do you meet UBL-TR?
Whenever a company in Türkiye sends or receives an e-Fatura, this is the file that travels in the background. Most users never see it, because the portal or integrator screen renders a readable view. The format starts to matter when you want incoming invoices posted to an ERP without manual entry, or when a group ERP outside Türkiye has to produce invoices for a Turkish entity.
How is it used in ERP integration?
The cleanest source is the UBL-TR XML fetched from an e-invoice integrator. The flow reads the XML, matches the seller to a supplier record and writes the entry to the ERP through API integration or an import file. The invoice number and ETTN are checked so the same invoice is not processed twice.
Where no XML exists, as with PDF and paper invoices, the data has to be extracted first with OCR and intelligent document processing, followed by human review. A workflow automation layer usually connects these steps.
Further reading
Turkey's verified reviews ruleTurkey's new consumer review rules and how brands and marketplaces can meet them with order matching, routing, approved replies and an audit trail.
Getting Turkish e-invoices into your ERP automaticallyMethods, matching steps and error checks for moving Turkish e-Fatura, e-Arşiv and PDF invoices into an ERP automatically.
n8n vs Make vs Zapier: how to chooseA decision guide comparing n8n, Make and Zapier on hosting, licence, billing unit, AI support and data location.Related terms
- e-Fatura (Türkiye's e-invoice system)e-Fatura is Türkiye's electronic invoice system, in which invoices follow a format set by the Revenue Administration (GİB), the national tax authority, and travel between seller and buyer through GİB's central platform.
- API integrationAPI integration is a way of connecting two or more software systems so that they exchange data and trigger actions through the application programming interfaces (APIs) each system exposes.
- Intelligent document processing (IDP)Intelligent document processing (IDP) is an automation approach that uses AI to classify documents such as invoices, contracts and forms, extract the data in them, validate it and pass it to business systems.
- OCR (Optical Character Recognition)OCR (Optical Character Recognition) is a technology that converts the text in images such as scanned documents, photos and PDFs into machine-readable text that software can search and process.
- Workflow automationWorkflow automation is an approach in which software carries out the repetitive steps of a business process, such as data transfer, approvals, notifications and reporting, according to defined rules.
Frequently asked questions
Do you need AI to read a UBL-TR file?
No. UBL-TR is structured XML. Tax numbers, line items, VAT and totals are separate fields and can be read directly. AI becomes useful for PDF and scanned paper invoices, where no structured data exists.
Is UBL-TR the same as the e-invoice formats used in the EU?
No. UBL-TR is Türkiye's own customisation of UBL, with its own rules and validation. A file that is valid in another country's UBL-based format is not automatically valid as UBL-TR. Plan a mapping step if you operate in both.
Where are the current UBL-TR rules published?
GİB, Türkiye's tax authority, publishes and updates the technical guides and schema files. When you build an integration, rely on the current guide on GİB's e-document site and on your integrator's documentation.
Let’s talk about your transformation
Tell us which work repeats every week. We will tell you honestly whether it is worth automating.
How we start
- A free first callWe pin down the problem and the goal together.
- A 2-week discovery sprintWe look at the data, the process and the tools, and decide where to start.
- A written proposalScope, architecture and timeline, in writing.