زاتكا المرحلة الثانية · فاتورة
كيف تعمل المرحلة الثانية لزاتكا — وأين يأتي إسناد
المنشآت الخاضعة لضريبة القيمة المضافة في المملكة يجب أن تربط حل الفوترة الإلكترونية بمنصة فاتورة التابعة لزاتكا. يمكنك بناء التكامل بنفسك، أو ترسل JSON إلى إسناد ونتولى نحن ملفات XML والشهادات وواجهات الحكومة.
ما هي زاتكا ومنصة فاتورة؟
زاتكا (هيئة الزكاة والضريبة والجمارك) الجهة المنظّمة لضريبة القيمة المضافة والفوترة الإلكترونية الإلزامية في المملكة.
فاتورة هي منصة الفوترة الإلكترونية لدى زاتكا — البوابة وواجهات برمجة التطبيقات التي يجب أن يتصل بها حل توليد الفواتير الإلكترونية (EGS) في المرحلة الثانية.
المرحلة الثانية إلزامية عند دخول منشأتك ضمن موجة التكامل المعلنة. فاتورة B2B غير المُخلَّصة لا تُعد فاتورة ضريبية صالحة للتسليم للمشتري.
Phase 1
المرحلة الأولى — التوليد
توليد وإصدار وحفظ فواتير إلكترونية منظمة بالحقول الإلزامية ورمز QR. دون إرسال مباشر عبر واجهات زاتكا.
Phase 2
المرحلة الثانية — التكامل
ربط حل EGS بمنصة فاتورة. فواتير الضريبة القياسية (B2B) عبر الإخلاء الفوري. الفواتير المبسّطة (B2C) يجب الإبلاغ عنها خلال 24 ساعة من الإصدار.
تُطبّق زاتكا المرحلة الثانية على موجات حسب الإيرادات الخاضعة للضريبة، مع إشعار مسبق قبل موعد كل مجموعة. راجع حالة موجتك في بوابة فاتورة أو إشعارات زاتكا.
كيف تمتثل بدون إسناد
تنشر زاتكا المواصفات. فريق هندسي قادر يمكنه التكامل مباشرة مع فاتورة. هذا ما يتطلبه ذلك المسار فعلياً.
ما يجب بناؤه وتشغيله
- 1
UBL 2.1 XML (الملف السعودي)
كل فاتورة بصيغة Universal Business Language XML — وليست PDF وحدها. يمكن استخدام PDF/A-3 مع XML مضمّن للعرض؛ الإخلاء والإبلاغ يتوقعان XML متوافقاً.
- 2
الختم التشفيري (CSID)
توليد زوج مفاتيح ECDSA وطلب CSR، الحصول على Compliance CSID عبر OTP من بوابة فاتورة، اجتياز فحوصات الامتثال، ثم طلب Production CSID لتوقيع الفواتير الحية.
- 3
UUID وICV وسلسلة PIH
لكل فاتورة UUID. ولكل وحدة EGS عداد فواتير متسلسل (ICV) وهاش الفاتورة السابقة (PIH) يربط الفاتورة N بـ N−1 لمنع التلاعب أو الإدراج.
- 4
واجهات الإخلاء والإبلاغ
B2B: أرسل للإخلاء ولا تسلّم المشتري إلا بعد قبول زاتكا. B2C: أصدر مع QR فوراً ثم أبلغ فاتورة خلال 24 ساعة.
- 5
QR والأرشفة والتجديد
بناء QR بصيغة TLV للفواتير المبسّطة، حفظ XML الموقّع/المُخلَّص لمدة الاحتفاظ النظامية، وتجديد شهادات CSID قبل انتهائها — عادة سنوياً.
مسار التكامل الذاتي
المسار الكامل عندما يتحدث نظام نقاط البيع أو ERP مباشرة مع فاتورة — التسجيل، التوقيع، ثم الإخلاء أو الإبلاغ.
تسجيل كل وحدة EGS
مفاتيح + CSR
ECDSA لكل وحدة EGS
OTP من فاتورة
إثبات ملكية الرقم الضريبي
Compliance CSID
ثم فحوصات الامتثال
Production CSID
توقيع الفواتير الحية
ابنِ ووقّع بنفسك
UBL 2.1 XML
الملف السعودي الكامل
ICV + PIH
عداد وسلسلة هاش
توقيع CSID
ختم تشفيري
أرسل إلى زاتكا فاتورة
B2B · إخلاء
فوريثم فقط سلّم للمشتري
B2C · إبلاغ
خلال 24 ساعةأنت تملك XML والتشفير والشهادات والطوابير والأرشفة وكل تغيّر في مواصفات زاتكا.
B2B — الإخلاء
البائع يولّد XML موقّعاً → واجهة الإخلاء → زاتكا تُعيد XML مُخلَّصاً بختمها → ثم التسليم للمشتري.
B2C — الإبلاغ
البائع يصدر الفاتورة مع QR للمشتري فوراً → ثم يبلّغ نفس الـ XML لفاتورة خلال 24 ساعة.
لماذا يتعثر الكثير من الفرق
- ▸أول فاتورة ناجحة ليست الأصعب — الحفاظ على PIH/ICV عبر الفروع لسنوات هو التحدي.
- ▸تسجيل الشهادات وفحوصات الامتثال والتجديد السنوي يحتاج إجراءات ودعم تشغيلي.
- ▸قواعد التحقق وأكواد الأخطاء تتغير؛ المكامل المباشر يتحمل كل تغيير في كوده.
- ▸بيئة التجربة والإنتاج يجب فصلهما؛ خطأ بيئة واحد يفسد مستندات ضريبية حية.
أين يأتي إسناد
إسناد طبقة وسيطة بين نظامك ومنصة فاتورة. تبقى فوترك بصيغة JSON. نحن نبني UBL، نوقّع بشهادة الوحدة، نحافظ على سلسلة PIH، نستدعي الإخلاء أو الإبلاغ، نؤرشف النتيجة، ونُعيد الحالة وUUID وQR (لـ B2C) وروابط التحميل.
مع إسناد
تطبيقك لا يتحدث بلغة UBL أو فاتورة. واجهة REST واحدة؛ نحن نتولى تعقيد الحكومة.
نظامك
- •JSON للفاتورة
- •مفتاح API
- •egs_unit_id
إسناد
- •UBL XML
- •توقيع · PIH · ICV · QR
- •إخلاء أو إبلاغ
- •أرشفة XML + PDF
فاتورة زاتكا
- •تحقق حكومي
- •ختم / إقرار
الاستجابة → الحالة · UUID · QR (B2C) · روابط XML وPDF
OTP من فاتورة فقط عند تسجيل أو تجديد الوحدة — لا XML في تطبيقك.
دورك في ثلاث خطوات
أنشئ حساباً ومفتاح API
مفاتيح التجربة تبدأ بـ zatca_test_. مفاتيح الإنتاج بـ zatca_live_. فصل صارم بين البيئتين.
سجّل وحدة EGS (OTP مرة)
نولّد المفاتيح والـ CSR ونُجري تدفق الامتثال مع زاتكا. أنت تلصق OTP من فاتورة عند التسجيل أو التجديد.
أرسل JSON للفاتورة
أرسل بيانات البائع والمشتري (B2B) والبنود وegs_unit_id. تستلم حالة الإخلاء أو الإبلاغ وQR وروابط XML وPDF.
التكامل الذاتي مقابل إسناد
| البند | ابنِه بنفسك | استخدم إسناد |
|---|---|---|
| لغة التكامل | UBL XML + تشفير | واجهة JSON REST |
| تسجيل EGS / CSID | أنت تملك CSR وOTP والاختبارات | OTP منك؛ التدفق من إسناد |
| PIH وICV لكل فرع | تصمّمه ولا تكسر السلسلة | تلقائي لكل وحدة EGS |
| إخلاء B2B | تستدعي فاتورة وتمنع التسليم | نُخلي ثم نُعيد الحالة |
| إبلاغ B2C | طوابير ونافذة 24 ساعة | نبلّغ؛ تعرض QR فوراً |
| تغيّر المواصفات | عبء على فريقك | واجهة ثابتة — نستوعب التحديثات |
| أول فاتورة في التجربة | أسابيع إلى أشهر | ساعات مع OTP التجريبي |
تجاوز XML. أطلق المرحلة الثانية.
تجربة مجانية 14 يوماً. بيئة تجربة بسرعة. نفس الواجهة عند الانتقال لشهادات الإنتاج.
ملخص للتثقيف عن المنتج. التزم دائماً بأحدث إرشادات زاتكا / فاتورة الرسمية وإشعار موجتك للالتزامات النظامية.