Notes on ZATCA Phase 2 in Manager

1

Notes on version 25.8.25.2708 — ZATCA Phase 2 in Manager (Server/Cloud)

Hi all,
I’d like to share my observations with version 25.8.25.2708 on Manager Server and the Cloud edition regarding ZATCA Phase 2 (clearance/reporting + official QR).

Environment

  • Version: 25.8.25.2708

  • Editions tested: Server and Cloud

  • UI languages tried: Arabic and English

  • Goal: Test Phase 2 on Sandbox, then move to Production

What I can (and can’t) see in Settings

  • I do not see a built-in “ZATCA e-Invoicing” module under Settings → Features (in either Server or Cloud).

  • Under Extensions, I only see “ZATCA Phase 1 QR Code Generator.”

  • Switching to English does not expose any extra ZATCA option in Features.

What I did in practice

  • Used an external Relay (ZatcaEGS) via the invoice Relay field:

    https://zatcaegs.azurewebsites.net/relay

  • Configured Sandbox BasicAuth + test PFX certificate on the relay.

  • Created a test invoice (VAT 15%, test TINs for supplier and buyer) and sent it via Relay.

  • Result: accepted on Sandbox, official Phase 2 QR renders correctly. On repeated sends I sometimes get:

    This invoice has been reported and approved previously.

  • I also noticed “Uncleared Invoice” for simplified (B2C) invoices sent via Reporting (expected), while standard (B2B) invoices should go through Clearance to become Cleared before sharing with the buyer.

Expected vs. current behavior

  • Expected: a built-in ZATCA e-Invoicing module in Manager to set environment, upload certificate, enter BasicAuth, choose Reporting/Clearance, and send directly from the invoice UI.

  • Current: I don’t see such a module in Server/Cloud; only the Phase 1 QR extension is available, so I must rely on an external Relay for full Phase 2 compliance.

Questions for the developers/community

  1. Is the ZATCA e-Invoicing (Phase 2) module available in Server/Cloud for this version, or limited to specific channels (or Desktop only) at the moment?

  2. If available, where exactly can it be enabled? (Settings → Features shows nothing ZATCA-related for me, even when the UI is English.)

  3. What’s the timeline/roadmap for native Phase 2 support in Cloud/Server so we don’t need an external Relay?

  4. For Clearance on standard (B2B) invoices: what’s the best way to set the correct Invoice SubType and route to Clearance from within Manager itself?

  5. Are there any flags/toggles at the business/instance level that must be enabled to expose the ZATCA Phase 2 module?

  6. Any official guidance on managing ICV/PIH automatically to avoid duplication/rejection on retries?

Repro steps

  1. Create a new business on Server/Cloud with 25.8.25.2708.

  2. Check Settings, Features, and Extensions → no “ZATCA e-Invoicing.” Only “ZATCA Phase 1 QR Code Generator.”

  3. Create a sales invoice; set Relay to ZatcaEGS; configure Sandbox BasicAuth + PFX on the relay.

  4. Send to Sandbox → accepted, QR OK; repeated sends may show previously reported. Simplified invoices appear Uncleared (expected for Reporting). There’s no clear built-in path to choose Clearance for standard invoices without a Relay.

Closing

The Relay works well as a practical workaround, but I’d appreciate clarity on the availability/roadmap of a native ZATCA Phase 2 module in Manager Server/Cloud for this version. Any official pointers or documentation would be really helpful for KSA users.

Thanks in advance! :folded_hands:

2

Hello @Ahmed_Falahi,

The eInvoicing solution isn’t Manager.io, but rather a free open source service managed by Manager that will configure Manager and serve as a connector between Manager and ZATCA. This way any change in ZATCA or Manager is less likely to cause any major issue.

This is because Manager isn’t modular and the best way to implement localizations would be to offer a separate online service. This is especially true if you use Desktop or Server Edition and choose to delay software updates.

That aside, the ZATCA EGS solution will be fully migrated from Relay to Extensions. It is still going to be a separate online service but then you will see ZATCA EGS under Settings > Extensions.

I hope I have not left out any of your concerns unanswered.

3

In the new version Manager, Zacta has the first phase to generate QR code for each invoice, but why not add Zacta phase II directly instead of using relly? Thank you.

4

Phase 1 only generates a QR image on the invoice, but does not send any data to ZATCA. Phase 2, on the other hand, requires digital signing and reporting the invoice to ZATCA before it can be delivered to the customer. Therefore, user intervention is needed to select and manage the appropriate process.

Manager does not create country-specific invoicing features, as invoicing requirements vary widely across regions. Instead, Manager provides flexible tools such as Relay, Extensions, or APIs, which can be used by third-party applications to meet each country’s specific needs.

2 Likes