ZATCA Onboarding
Each signing unit taken through ZATCA’s onboarding: choose the environment (the Developer Portal sandbox, simulation, or production), enter the one-time password from the Fatoora portal, run the compliance checks (one sample of each document the unit issues), then request the production certificate. Renew before the certificate expires — a warning is raised 30 days ahead. The keys and ZATCA’s secrets are sealed and never shown. Register the unit itself under ZATCA Signing Units first.
Where to find it
- Module: Accounting
- Group: Close & Compliance
- Section: E-invoicing
- Screen: ZATCA Onboarding
Address in the console: /accounting/zatca-onboarding
Read-only list · 12 columns · 6 actions
This list is read-only: its records are written by the work that produces them. A correction, where one is possible at all, is made where the record was created.
What the list shows
These are the columns of the list, in the order they are drawn. Any of them can be sorted on, filtered on, hidden, or exported.
| Column | Kind | Field name |
|---|---|---|
| Unit | Code | code |
| Name | Text | name |
| Branch | Text | branch_name |
| Environment | Status | environment |
| Status | Status | status |
| Step reached | Status | onboarding_step |
| What happened | Text | onboarding_message |
| Checks passed | Date and time | compliance_passed_at |
| Certificate expires | Date | certificate_expires_at |
| Days left | Number | certificate_days_left |
| Renewal pending | Yes or no | renewal_pending |
| Last counter (ICV) | Number | last_icv |
What you can do here
Onboard (OTP) primary
Request the compliance certificate
Asks for: Environment* One-time password (OTP)*
Run compliance checks
Asks for confirmation: Send one sample of each document this unit is registered for to ZATCA’s compliance check?
Request production certificate primary
Asks for confirmation: Request the production certificate? From then on this unit stamps the company’s invoices and they are cleared or reported with ZATCA.
Renew certificate
Renew the production certificate
Asks for: One-time password (OTP)*
Compliance results
The last compliance run
Fatoora calls
Onboarding requests and answers (secrets are never kept)
* required
The rules that apply here
Everything on this screen obeys the platform rules rather than rules of its own. The ones worth knowing before you use it:
- Narrowing a list — search, conditions, sort, totals, export and saved views.
- What may be changed — the five grounds a record may not be edited on.
- Companies and business units — what the switcher above this list is doing to it.