# 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.

> **Before you start**
>
> Select **Oman** and **Sandbox** in the Invoice Portal. Oman onboarding is available in sandbox only; with production selected, the page shows *Oman SMP is available in Sandbox only*. Have the company’s VAT identification number (VATIN) issued by the Oman Tax Authority: `OM` followed by 10 digits. You also need its registered legal name in English, a branch name, and the name and version of the system that sends its invoices. Your role must allow you to create companies.

## Step 1: 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**.

## Step 2: 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**.

## Step 3: 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**.

## Step 4: 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:

| Status | Meaning |
| - | - |
| **Peppol enabled** | The registration was accepted and at least one capability is published. |
| **Publication pending** or **Outcome unknown** | The last operation is not confirmed yet. Use **Retry same operation** to repeat it with the same details. |
| **Failed** | The last operation failed. Read the error, correct the details and try again. |
| **No published capabilities** | The 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](https://docs.complyance.io/countries/om/fields/), then [send a sandbox invoice](https://docs.complyance.io/countries/om/examples/).

Source: https://docs.complyance.io/countries/om/onboarding/