Platform / multi-tenant

This track is for a platform — an ERP vendor, another SaaS — onboarding e-invoicing on behalf of many downstream businesses through one SUMU account.

The repeatable loop, per business you onboard: register it as a taxpayer → register it on Peppol with the capabilities it needs → get it associated to your Service Provider account in the Oman Tax Authority's Fawtara portal. That last step is manual and outside the API — plan for it as a scaling bottleneck, not an afterthought.

Webhooks: register one webhook without a taxpayer_id to receive events for every business you've onboarded, or register several scoped by taxpayer_id if you need to route events to different downstream systems. See Webhooks.

Rate limits are shared across every taxpayer under your key — a heavy client's month-end batch run can throttle every other client sharing your key. See Rate limits.

Access control: if you're planning to give your own downstream customers their own restricted credentials rather than proxying every call through your backend, that isn't supported yet — see the callout on Authentication.