How Taxline works, step by step
One service covers the whole route of an invoice in Oman: from the system that issues it, to the buyer, to the Tax Authority, and into the archive.
Sending invoices
Your system sends Taxline the facts of each invoice. Taxline turns them into a PINT OM document, the electronic format Oman uses on the Peppol network, and checks it in two stages:
- A first check catches common mistakes, such as a missing buyer VAT number or a credit note without the invoice it corrects, and answers at once.
- The official validation applies the published Oman rule sets in full. Nothing is sent unless it passes.
A valid invoice is then delivered over Peppol. Taxline looks up the buyer in the Tax Authority's central Peppol register (the SMP), finds the buyer's service provider, and delivers the document to it over AS4, the secure Peppol transport, signed and encrypted. The receiving provider confirms receipt and then reports whether it accepted the invoice; both answers are recorded against the invoice.
Taxline handles the four document types every provider in Oman must support: the invoice, the credit note, the self-billing invoice and the self-billing credit note. For a sale to a consumer, Taxline calculates the QR code and the seller identifier the receipt must carry, so they can be printed at the till.
Receiving invoices
Invoices addressed to you arrive through the same network. Taxline receives them on your behalf, validates them, sends the sender a status message for every document, accepted or rejected, as Oman's rules require, and shows them in your dashboard next to the invoices you send.
As your service provider, Taxline also registers your business on the Peppol network once you have chosen us on the Tax Authority's Fawtara portal, so that other businesses can reach you.
Tax reporting
Every invoice exchanged in Oman is reported to the Tax Authority as a tax report, sent over the same secure Peppol connection. Taxline sends it in both roles: as the seller's provider for the invoices you issue and as the buyer's provider for the invoices you receive.
| Report | Time limit | Counted from |
|---|---|---|
| Sale to a business or government (seller's side) | 15 minutes | When the invoice passed validation |
| Sale to a consumer (seller's side) | 30 minutes | When the invoice passed validation |
| Invoice received from a supplier (buyer's side) | 15 minutes | When the invoice was received |
Taxline queues each report against its deadline, raises an alert before a limit is reached rather than after, and records the Tax Authority's answer. A rejected report is shown with the reason and what to do next.
Connecting your system
Taxline reads invoices in the format your system already produces. Nobody has to write PINT OM by hand. There are three ways in, and all three use the same saved mapping and the same checks:
- API. Your system sends each invoice to Taxline as it is issued, in its own JSON or in Taxline's format. This is the way for real-time sales and for tills.
- File upload. Upload, or have your system place, a CSV or JSON export. This needs nothing installed and is the quickest way to start.
- Direct connectors. For selected systems, Taxline will read new invoices from the system directly. These are being prepared one system at a time and are offered once each has been tested against the vendor's current version.
| System | How it connects today |
|---|---|
| Odoo | API or export upload |
| SAP Business One, SAP S/4HANA | API or export upload |
| Microsoft Dynamics 365 (Business Central, Finance) | API or export upload |
| QuickBooks, Zoho Books | API or export upload |
| Spreadsheets (CSV, Excel saved as CSV) | File upload |
| Your own software | API |
To set up a mapping, you give Taxline one sample export. Taxline suggests which of your fields holds each part of the invoice, in English or Arabic field names, and shows a preview of every invoice in the sample with any problem marked. You correct what is wrong and save. Each change creates a new version, and each invoice remembers the version that read it.
Taxline never guesses what an export does not say. If a date such as 03/04/2026 could be either 3 April or 4 March, or the currency or VAT rate is missing, you are asked to confirm it.
Problems, in plain words
The official validation reports problems as rule codes. Taxline translates each one into a sentence in Arabic and English that says what is wrong, in which field, and what to do, for example "The buyer's VAT number is missing". Your finance team can fix and resend without calling IT.
Archive
Oman's VAT Law (Royal Decree 121/2020, Article 70) requires tax invoices to be kept for ten years after the end of the tax year in which the return was filed, and fifteen years for those relating to real estate. Taxline keeps, for every document:
- your submission exactly as received;
- the PINT OM invoice as generated, and the envelope as sent or received;
- the delivery receipt and every status message;
- the tax report and the Tax Authority's answer;
- the validation result and the version of the rules used.
By default each document is kept for fifteen years after the year it was issued, because an invoice alone does not show whether it relates to real estate. Documents can be searched by invoice number, identifier, date or trading partner, and downloaded with proof that they have not been changed. How the archive is protected is described on the security page.
For developers
- A REST API with API keys, created and revoked by the account owner.
- Webhooks that report each outcome: refused with reasons, delivered, accepted or rejected by the buyer, accepted or rejected by the Tax Authority.
- Idempotency keys: the same invoice sent twice with the same key is issued once.
- Errors that name your own field, not ours, so your developer fixes the right thing.
- A separate test environment, clearly marked on every screen, so tests never reach production.
Technical documentation is shared with clients during onboarding. Ask us for it.
Want to see how your invoices would read?
Send us a sample export from your system, with real customer data removed.
