Invoicing and documents
UUID (UUID)
A UUID (universally unique identifier) is a 128-bit code that identifies one document or record so that no two documents anywhere share the same identifier.
What is UUID?
A UUID is written as 32 hexadecimal characters in five groups, for example 8-4-4-4-12. The standard (RFC 4122) defines several versions. Version 4 is random. Version 5 is made from a name and a namespace with a hash, so the same input always gives the same UUID. On an e-invoice the UUID is separate from the invoice number. The number is for people and follows your sequence. The UUID is for systems: it lets a provider, a buyer and a tax authority recognise the same document without any doubt. Oman's PINT OM 1.0.1 requires a version 5 UUID on every invoice.
How a UUID works on an e-invoice
When your software issues the invoice, it creates the UUID and writes it into the XML. The UUID then follows the document everywhere: to your provider, to the buyer and into the tax report. A credit note or debit note quotes the UUID of the invoice it corrects. If your software sends the same invoice twice after a network error, the provider sees the same UUID and knows it is a retry, not a second sale.
- Created once, when the invoice is issued
- Written into the e-invoice XML
- Quoted on every credit or debit note against the invoice
- Lets a provider spot a retry of the same invoice
- Stays with the document for the whole archive period
Why it matters for your business
A UUID protects you from two common e-invoicing problems: a duplicate invoice after a retry, and a note that cannot be matched to its invoice. Software that creates the UUID once and stores it with the issued invoice avoids both. Paper & Pen issues each e-invoice once with a version 5 UUID and keeps that UUID on the invoice.
See also
Questions
Common questions
Is the UUID the same as the invoice number?
Why does Oman ask for UUID version 5?
Related terms
- E-invoicing E-invoicing is the automated creation, exchange and processing of invoices in a structured digital format between a supplier and a buyer, often directly integrated with government tax authorities.
- PINT OM PINT OM is the Oman version of the Peppol International invoice format, the XML structure and rule set that every e-invoice under Oman's Fawtara programme must follow.
- Invoice number An invoice number is a unique, sequential code assigned to a sales document to identify a specific transaction, track payments and maintain accurate accounting records.
- Credit note A credit note is a commercial document issued by a seller to a buyer, reducing or cancelling the amount owed on a previously issued invoice due to errors, returns, or damages.
- Accredited service provider An accredited service provider is a company that a tax authority has approved to receive, validate, deliver and report a business's e-invoices on its behalf.
- Debit note A debit note is a commercial document issued by a buyer to request a credit, or by a seller to increase the amount owed on an existing invoice.