Register on Peppol
Publish a taxpayer's receiving capabilities to the Peppol directory.
Publishes the taxpayer's address and receiving capabilities to the Peppol directory, so other Access Points can find and invoice them.
/v1/api/taxpayers/{taxpayer_id}/peppol-registration| Field | Type | Description | |
|---|---|---|---|
| capabilities | string[] | required | Which document types the taxpayer will accept. At least one |
Capability values
| Value | Lets the taxpayer receive |
|---|---|
billing_invoice | Invoices from suppliers |
billing_credit_note | Credit and debit notes from suppliers |
selfbilling_invoice | Self-billed invoices raised by their customers |
selfbilling_credit_note | Self-billed credit notes |
mls | Delivery receipts. Register this unless you have a reason not to |
Each capability publishes separately, so a partial result is possible — some published, others
failed with a reason. Re-calling the endpoint retries only what hasn't published yet.
Registration requires an authority association
Before a taxpayer can be published, it must be connected to your Service Provider account in the
Oman Tax Authority's Fawtara portal. Until that's in place this endpoint returns
409 TAXPAYER_NOT_ASSOCIATED. This is a manual step outside the API — start it early, it
gates go-live for each taxpayer.
Remove a capability
DELETE on the same path with a capabilities body array removes specific capabilities.
DELETE /v1/api/taxpayers/{taxpayer_id}/peppol-registration
{ "capabilities": ["selfbilling_invoice"] }