Onboard an Omani company

Register an Omani company's Peppol participant ID and link the source that sends its invoices. Have the company's VATIN, legal name, branch name and the source system's name and version ready.

Enter the company details

Open Onboard and choose Add Company, or Add Your First Company if Oman has no companies yet. In Company details, enter:

  • Company legal name (English), as registered with the Oman Tax Authority.
  • Company legal name (Arabic). It is filled in for you from the English name; check it and correct it if needed, or leave it blank.
  • Branch name.
  • VATIN, such as OM1234567890.

Select Next.

Check the participant ID

Participant ID shows the company’s Peppol participant ID, built from its VATIN: iso6523-actorid-upis::0248:OM1234567890. You cannot edit it. The scheme 0248 identifies an Omani VATIN.

Under Business card (Peppol Directory), check the English and Arabic entity names; they are listed in the Peppol Directory. Registration date and Geographical information are optional. Select Show optional directory details to add identifiers, a website or a contact. Select Next.

Add the invoice source

In Source details, enter Source name and Source version for the system that sends this company’s invoices. Keep both values: Unify requests send them together as name:version in source, such as acme-erp:1.0.0. Select Next.

Review and publish

In Review & submit, check the company, participant ID and source. Choose the Receiving capability to publish: Invoice, Credit note, Self-billed invoice or Self-billed credit note. Select Publish capability.

When it succeeds, Participant registered shows the company name and its participant ID. Select Go to dashboard.

Check the result

The company appears under Onboard with its branch, Peppol participant ID, source name and version, and a status:

StatusMeaning
Peppol enabledThe registration was accepted and at least one capability is published.
Publication pending or Outcome unknownThe last operation is not confirmed yet. Use Retry same operation to repeat it with the same details.
FailedThe last operation failed. Read the error, correct the details and try again.
No published capabilitiesThe participant exists but publishes nothing. Use Manage to publish a capability.

The status reflects the last registration operation only. It does not confirm that an invoice was delivered or reported.

To publish another receiving capability, open the company’s actions menu and choose Manage; existing capabilities stay published. View participant ID shows and copies the ID and lists the published capabilities. Each company has one branch; Add Branch is not available for Oman.

If something goes wrong

  • The form does not let you continue: check the fields marked as required. The VATIN must be OM followed by exactly 10 digits.
  • The Arabic name is not filled in: the page shows Could not translate the company name. Enter the Arabic name yourself, or leave it blank.
  • The source cannot be saved: check its name and version, then select Next again.
  • The operation was not confirmed: select Retry same operation. It repeats the request with the same details to confirm its outcome.
  • You see a permission message: ask a workspace administrator for a role that can manage companies.

Next, check the Oman invoice fields, then send a sandbox invoice.

Last updated