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.

ReportTime limitCounted from
Sale to a business or government (seller's side)15 minutesWhen the invoice passed validation
Sale to a consumer (seller's side)30 minutesWhen the invoice passed validation
Invoice received from a supplier (buyer's side)15 minutesWhen the invoice was received

Source: Oman Peppol Authority Specific Requirements v1.0, Annex A.

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:

  1. 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.
  2. File upload. Upload, or have your system place, a CSV or JSON export. This needs nothing installed and is the quickest way to start.
  3. 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.
SystemHow it connects today
OdooAPI or export upload
SAP Business One, SAP S/4HANAAPI or export upload
Microsoft Dynamics 365 (Business Central, Finance)API or export upload
QuickBooks, Zoho BooksAPI or export upload
Spreadsheets (CSV, Excel saved as CSV)File upload
Your own softwareAPI

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.

Contact us