Critical ZATCA Clearance Error (Certificate Permissions) in E-Invoice Extension - Phase 2 ZATCA [moderated, is English only forum]

(Clearance) ZATCA Manager.io.

ZATCA (Request Type: Invoice Clearance):

  • certificate-permissions: “User only allowed to use the vat number that exists in the authentication certificate”

  • SELF_BILLED_VALIDATION: “Buyer vat number in the provided certificate is not equal the vat number in the XML”

  1. AT (Business Details) في Manager.io : 3125397334000

  2. AT QR : 399999999900003

  3. 1	CCSID)   3999999z 31253973340000
    1	 (312539733400003)؟
    2	 (Certificate) و CCSID؟
    

Hello everyone,

I’m facing a critical issue obtaining Clearance from ZATCA using the E-Invoicing Extension in the latest version of Manager.io. All my invoice data formatting errors (address/VAT number structure) have been resolved.

However, the submission is consistently failing due to certificate errors related to the Seller’s VAT ID.

The specific errors received from ZATCA (Request Type: Invoice Clearance) are:

  • certificate-permissions: “User only allowed to use the vat number that exists in the authentication certificate

  • SELF_BILLED_VALIDATION: “Buyer vat number in the provided certificate is not equal the vat number in the XML” (This error seems to mistakenly reference the buyer, but confirms the VAT mismatch).


:magnifying_glass_tilted_left: The Data Mismatch

The core issue appears to be a conflict between the VAT ID in my system and the VAT ID tied to the ZATCA certificate (CCSID) that the extension is using for signing:

  1. VAT ID in Manager.io Business Details (Expected/Sent in XML): 312539733400003

  2. VAT ID Extracted from the certificate/local QR Code (Actual Certificate VAT): 399999999900003

It seems my current certificate is tied to the incorrect number (399999999900003).

:red_question_mark: My Question to the Community/Developer:

  1. What is the recommended method to reset or update the Certificate/CCSID within the E-Invoicing Extension settings?

  2. If I need to re-issue the certificate with ZATCA (using the correct VAT: 312539733400003), how do I ensure the Extension successfully adopts the new certificate and secret keys?

Your guidance on the correct procedure within the Manager.io E-Invoicing Extension is highly appreciated to resolve this critical clearance blockage.

Thank you.

“Add a screenshot when submitting to ZATCA.”

It seems you are still working in the Sandbox environment. Try using the Simulation environment first, and once everything is correct, then move to the Production environment with your real business data.

My entire problem is the lack of a QR code for customers who aren’t linked to Zakat and Income Tax. Why doesn’t the QR code generate automatically when issuing an invoice?

[moderated, is English only forum]

After compliance has passed, a Clearance/Reporting button should appear to report the invoice to ZATCA.


As a note, from the screenshot you shared, you are still working in the Sandbox / Pre‑Production environment. The invoice you submitted in this environment is not valid to be issued to the customer.

“In the Manager.io forum, members usually request using English so everyone can understand the discussion.”
You are in non aProduction environment
[moderated, is English only forum]

If your company is not yet required to implement eInvoice Phase II, and you want your invoices to have a Phase I QR code, you need to use an Extension to generate the Phase I QR code.


Or use custom themes to generate/display QRCode Phase I

  1. Go to Settings → Themes.
  2. Click New Theme.
  3. Enter a name and click Create.
  4. Assign this custom theme to your invoice.
  5. The QR Code will appear in your Invoice View.

If there is an explanatory video, we hope you will share it.
[moderated, is English only forum]

[moderated, is English only forum] Multidisciplinary Digital Professional via Manager Forum <notifications@manager1.discoursemail.com> كتب: