Critical ZATCA Clearance Error (Certificate Permissions) in E-Invoice Extension - Phase 2 (خطأ حرج في تخليص ZATCA (أذونات الشهادة) في إضافة الفاتورة الإلكترونية - المرحلة الثانية)

[Ali_Ah]

أهلاً بالجميع،

أواجه مشكلة في الحصول على تخليص (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. رقم VAT في إعدادات العمل (Business Details) في Manager.io هو: 312539733400003

2. رقم VAT المُستخرج من فك تشفير رمز QR الذي تولد محلياً هو: 399999999900003

3. أفترض أن شهادتي الرقمية (المرتبطة بـ CCSID) قد تم إصدارها بالرقم 399999999900003، بينما الفاتورة ترسل الرقم 312539733400003.

سؤالي هو:

1. هل يجب عليّ إعادة إصدار الشهادة بالكامل باستخدام الرقم الصحيح (312539733400003)؟

2. إذا كان الأمر كذلك، فهل هناك إجراء مباشر في الإضافة لتسهيل عملية تحديث الشهادة (Certificate) و CCSID؟

أرجو الإفادة بخطوات التحديث الصحيحة داخل الإضافة لحل مشكلة عدم تطابق VAT بشكل نهائي وبدء عملية التخليص بنجاح.

وشكراً.

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).

---

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).

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.

[Mohamed_Abd_Elazeem]

“Add a screenshot when submitting to ZATCA.”

[Mabaega]

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.

[Ali_Ah]

[Ali_Ah]

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?

[Ali_Ah]

[Ali_Ah]

انا مشكلتي في عدم وجود كيو ار كود عند اصدار الفاتورة علما بان المؤسسة لدينا ليست في مرحلة ربط مع الزكاة والدخل اريد اكيو ار كود عند اصدار الفاتورة

[Mabaega]

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.

[Mohamed_Abd_Elazeem]

“In the Manager.io forum, members usually request using English so everyone can understand the discussion.”
You are in non aProduction environment
لم تتبع الخطوات الربط الفعلي ولكن تستخدم الربط التجريبي لذلك الكيو ار كود غير صحيح لا بد ربط النظام مع منصة فاتورة

[Mabaega]

@Ali_Ah

My entire problem is the lack of a QR code for customers who aren’t linked to Zakat and Income Tax.

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.

ZATCA Phase 1 QR Code Generator

A simple extension that creates QR codes for Saudi Arabian tax invoices. Installation Go to Settings → Extensions in Manager. Create a new extension with: Extension Name: ZATCA Phase 1 QR Code Generator Source: Url Endpoint https:// www.luboshasko.com/extensions/sa/zatca-phase-1-qr-generator/ Placement: sales-invoice-view Click Create button. Quick Start Click View button on any invoice [image] Click ZATCA Phase 1 QR Code Generator button. [image] Follow the prompts

---

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.

[Ali_Ah]

If there is an explanatory video, we hope you will share it.
اذا كان هناك فيديو توضيحي نامل منكم مشاركته

في الأحد، ١٦ نوفمبر ٢٠٢٥، ١١:٣٥ ص Multidisciplinary Digital Professional via Manager Forum <notifications@manager1.discoursemail.com> كتب: