Update notices

6 Nov 2026: Held invoices: what is waiting for you, and where to answer it

Invoices that wait for an answer from your company are now listed together under Held, and each one asks for its answer on its own tab.

OAuth API

Changed

Status catalogue 1.2.0: excluded invoices and Sage Intacct syncs return their category

  • Invoices pushed through the API are held only for approval, as before. None of the other holds above applies to them.
  • EXCLUDED_FROM_EINVOICING is now in GET /oauth/invoices/status-codes. The status endpoint answers it with category blocked and terminal true, where it answered unknown.
  • SENT_TO_SAGE_INTACCT, SENT_TO_SAGE_INTACCT_IN_PROGRESS and SENT_TO_SAGE_INTACCT_FAILED are new, for a received invoice synced into Sage Intacct.
  • The blocked category is unchanged. Its description now says that a blocked status with terminal true stays until someone reopens or re-sends the invoice.
  • No other code, category or field changes.
Why we changed this
  • These statuses were already written on invoices but were missing from the catalogue, so an integration that switches on category was told unknown and kept polling.
  • The old blocked description said every blocked invoice moves on by itself, which is not true for an excluded invoice or one whose operations are switched off.
Reference

A reference that names a decision or the Guidelines is from the Ministry of Finance; it opens the document on its site.

What to do: If you switch on category, nothing to do. If you list codes yourself, add the four new ones.

Invoice status →

Application

New

Held lists every invoice waiting for you, and the invoice asks for the answer

  • Sales Invoices and Purchase Bills filter by All, Held, Delivered, Booked and Failed. Sales Invoices also filter by Excluded and Overdue.
  • Held lists the invoices waiting for someone in your company. Nothing is wrong with them, and they move on once answered.
  • A sales invoice is held for an approval, which is given under Invoices to Approve.
  • It is held when a customer has no TRN and is recorded as a private individual, or, in the UAE, has no type recorded. Answered as a private individual, the invoice moves to Excluded; answered in scope, a customer in the UAE still needs its TRN, so the invoice fails until it is added in your accounting system.
  • It is held for a line's tax treatment or type of goods, or for values given at invoice level.
  • A self-billed invoice you issue to a supplier is a purchase, so it is listed on Purchase Bills. It is held there for the same answers, and for the supplier's details.
  • All of these are answered on one tab of the invoice, Review PINT Mapping, which stays open from one question to the next.
  • It is held when your accounting system refused the connection while the invoice was checked. Connect it again on Connections: every invoice held for it is then checked and sent on its own.
  • An upload is held for a missing value, or for a PDF's readings to be confirmed, on its Missing details tab.
  • A purchase bill is held when a line's tax code, stock item or account cannot be settled in your system. It is answered on its Item Codes, Tax Codes and Expense Account tabs, and Save posts it within a minute.
  • On a bill, a goods line takes one of your stock items or is marked not a stock item: a bill never creates a product.
  • A self-billed invoice a customer issued to you is your sale, so it is held on Sales Invoices, on the same tabs except Expense Account. There a product can be created, except in Sage Intacct, where it is added in Sage and read with Refresh.
  • A customer or supplier answered once is remembered for its later invoices.
Why we changed this
  • These holds were added one at a time, each waiting for a different answer, and they were spread over several lists. One filter now shows everything that waits for you.
  • A sale to a natural person not carrying on business is outside the e-invoicing system (Ministerial Decision 244 of 2025, Art. 5.2). When it is not recorded whether a customer with no TRN is a private individual, we ask you instead of guessing, because sending a private individual's invoice and excluding a business's would both be mistakes.
  • On a self-billed invoice your supplier is the seller, and the rules require the seller's registration type, with the authority for a trade licence and the country for a passport. These are not part of an accounting system's supplier record, so you are asked once per supplier.
  • A received bill is not posted with a guessed tax code, product or account, because a wrong one would have to be corrected in your books.
Reference

From the PINT AE Billing 1.0.4 specification. Each ID opens the rule on the Peppol documentation.

  • IBR-173-AE ↗The seller's registration type must be Commercial/Trade license, Emirates ID, Passport or Cabinet decision.
  • IBR-172-AE ↗A trade licence (TL) must carry its authority name.
  • IBR-012-AE ↗A passport must carry its issuing country.

What to do: Open Held on Sales Invoices and on Purchase Bills, and answer each invoice on the tab it opens with.

Held invoices →Held bills →Invoices outside e-invoicing →

Documentation

Documentation

Held invoices and the status catalogue documented