تكامل واجهة برمجة التطبيقات لزاتكا: الجانب التقني للفوترة الإلكترونية

بعض المنشآت اللي تقيّم الفوترة الإلكترونية زاتكا تبي أكثر من نظرة عامة — تبي تعرف وش يصير فعليًا على المستوى التقني بين نظام المحاسبة ومنصة زاتكا. هذي الصفحة تغطي هذا، بمستوى مفيد لشخص تقني أو مسؤول مالي مهتم بالتفاصيل، بدون افتراض إنك متخصص تكامل أصلًا.

وش تسويه واجهة برمجة تطبيقات الفوترة الإلكترونية لزاتكا فعليًا

تحت المرحلة الثانية، برنامج الفوترة ما بس ينشئ مستند متوافق، هو يتواصل مباشرة مع أنظمة زاتكا. العملية عمومًا تشمل تسجيل جهاز أو نظام لدى زاتكا للحصول على هوية ختم تشفيري (CSID)، إنشاء كل فاتورة بهيكل XML اللي تتطلبه زاتكا، تطبيق توقيع رقمي ورمز استجابة سريعة، ثم تقديم الفاتورة لزاتكا — للتخليص قبل ما تصير صحيحة (B2B)، أو للإبلاغ بعد وقت قصير من الإصدار (B2C). هذي الطبقة هي اللي تحوّل "فاتورة فيها الحقول الصحيحة" إلى "فاتورة زاتكا فعليًا اعترفت فيها".

أساسيات فوترة XML

معيار الفوترة الإلكترونية لزاتكا مبني على UBL 2.1، صيغة XML واسعة الاستخدام للمستندات التجارية المنظّمة، مُكيّفة بحقول وقواعد خاصة بزاتكا. بدل PDF مسطّح، الفاتورة توجد كبيانات منظّمة — كل بند وسطر ضريبة وتفصيل طرف يقع في حقل محدد، وهذا اللي يخلي التحقق آليًا ممكنًا بدل قراءة إنسان. لهذا السبب فاتورة PDF عليها الأرقام الصحيحة مطبوعة مو نفس شي فاتورة متوافقة مع المرحلة الثانية: الهيكل تحتها لازم يكون صحيح، مو بس الشكل الظاهر.

وين وصل تكامل بوكسارة عبر واجهة برمجة التطبيقات

بصراحة عن وضعنا الحالي: توافق بوكسارة مع المرحلة الأولى، اللي يغطي الفوترة المنظّمة ورمز الاستجابة السريعة، شغّال اليوم. تكامل واجهة برمجة التطبيقات للمرحلة الثانية — تسجيل CSID وإنشاء XML والتقديم اللحظي لزاتكا — قيد التطوير الفعلي وما زال غير متاح للاستخدام من العملاء. نبنيه على مواصفات زاتكا التقنية المنشورة، مو نخمّن المتطلبات، لكننا نفضّل نقول لك إنه غير جاهز على إننا ندّعي غير ذلك.

لو منشأتك تقيّم موردين تقنيًا لموعد قريب من المرحلة الثانية، تواصل مع support@booksara.com عشان إجابة دقيقة وحالية، مو الاعتماد على صفحة منتج عامة زي هذي.

الأسئلة الشائعة

الفوترة الإلكترونية زاتكا تتطلب تكامل واجهة برمجة تطبيقات؟

تحت المرحلة الثانية، نعم — الفواتير لازم تُقدَّم لأنظمة زاتكا للتخليص أو الإبلاغ، وهذا يتطلب من برنامج الفوترة يتكامل مع واجهة برمجة تطبيقات زاتكا مو بس إنشاء مستند.

وش صيغة XML اللي تستخدمها الفوترة الإلكترونية لزاتكا؟

معيار زاتكا مبني على UBL 2.1، صيغة XML منظّمة للمستندات التجارية، بحقول وقواعد تحقق خاصة بزاتكا فوقها.

وش هوية الختم التشفيري (CSID) في الفوترة الإلكترونية زاتكا؟

تُصدرها زاتكا أثناء التسجيل، وتُستخدم لختم كل فاتورة رقميًا، تحقق إنها صادرة من نظام مسجّل محدد.

بوكسارة يوفّر تكامل واجهة برمجة تطبيقات زاتكا حاليًا؟

بوكسارة متوافق بالكامل مع المرحلة الأولى اليوم. تكامل واجهة برمجة التطبيقات للمرحلة الثانية قيد التطوير الفعلي وغير متاح للعملاء بعد — تواصل مع الدعم لإجابة حالية لو هذا يؤثر على موعد امتثالك.

تكامل واجهة برمجة التطبيقات مهم بس للمنشآت الكبيرة؟

لا. المرحلة الثانية تنطبق على المنشآت المسجّلة بضريبة القيمة المضافة عبر دفعات زاتكا اللي تمتد بعد المنشآت الكبيرة مع الوقت، فيستاهل تفهمها حتى لو منشأتك مو في دفعة مبكرة.

لنظرة أوسع على متطلبات المرحلة الثانية وكيف تشتغل الدفعات، شوف صفحة المرحلة الثانية زاتكا. ابدأ مجانًا مع بوكسارة للامتثال الكامل بالمرحلة الأولى اليوم.