مكتوبة لمنصّتك
إجاباتك عن المنصة والمدفوعات والبيانات الشخصية تعيد كتابة المهارة بحيث يحصل مشروع Node أو Django أو Laravel على توجيه يناسب كوده فعلاً.
مفتوح المصدر · رخصة MIT
أجب عن أسئلة قصيرة حول ما تبنيه، واحصل على حزمة مهارات جاهزة للاستخدام مع Claude Code أو Cursor أو Codex أو أي وكيل يقرأ AGENTS.md — تغطي الامتثال السعودي، ونظافة الأمن، وانضباط الهيكلة.
يستغرق حوالي ٣ دقائق. بدون حساب. لا شيء يغادر متصفحك.
---
name: zatca-phase2
description: ZATCA Phase 2 e-invoicing rules for Saudi Arabia
version: 0.4.2
status: reviewed
last_verified: 2026-03-18
---
# ZATCA Phase 2
> This is engineering guidance, not legal advice. Verify every
> rule against the official ZATCA documentation linked in /sources.
## When this applies
You are working on a product that issues invoices to Saudi customers
and is using **Node.js** as the backend stack.
## Non-negotiables
- Every B2B invoice must be cleared with ZATCA **before** being
delivered to the buyer.
- Every B2C invoice must be reported within **24 hours** of issuance.
- Every invoice XML must include a cryptographic stamp derived from
the taxpayer's CSID certificate.
## Your stack specifics
```ts
// Use the UBL builder — don't hand-roll the XML.
import { buildInvoiceXML, stamp } from "@zatca/ubl";
```
See references/invoice-b2c.xml for a full sample.
§ ٠١
حين يفتح وكيل البرمجة الذكي مستودعك، يبحث عن تعليمات. المهارة وثيقة قصيرة ومركّزة — وربما سكربتات مساعدة — تُخبر الوكيل بقواعد مجال واحد محدّد: كيف يتعامل مع الفواتير في السعودية، كيف يبعد الأسرار عن الكوميتات، أين يرسم الحد بين كود المشرف وكود المستخدم. المهارات الجيدة تحوّل الوكيل من «متدرب ذكي» إلى «زميل قرأ دليل الشركة».
إجاباتك عن المنصة والمدفوعات والبيانات الشخصية تعيد كتابة المهارة بحيث يحصل مشروع Node أو Django أو Laravel على توجيه يناسب كوده فعلاً.
مهارات السعودية (ZATCA المرحلة الثانية، نظام حماية البيانات، نفاذ) تشحن مع إخلاءات مسؤولية، وروابط مصدر، وتاريخ تحقق — لا قديمة ولا صامتة.
اختر Claude Code أو Cursor أو Codex أو AGENTS.md عاديًا. نفس المحتوى القانوني، مُقدَّم بصيغة كل وكيل.
§ ٠٢
كل مهارة مُرقَّمة ومؤرَّخة ومُراجَعة. العناصر التي ما زالت تحت المراجعة مُعلَّمة بوضوح — استخدمها كنقطة انطلاق، لا كحُجَّة نهائية.
إذا لم يكن للمستودع CI يُضيفه الوكيل. وإذا وُجد يُبقيه نظيفًا — Lint وفحص الأنواع والاختبارات ونظافة الترحيلات كقواعد يستطيع الوكيل فرضها فعليًا.
أبقِ الكود المُنشأ قابلاً لكتابة اختبارات له. فواصل نظيفة وآثار جانبية معزولة ولا singletons مخفية — حتى تبقى مجموعة الاختبارات أصلاً من الدرجة الأولى مع نمو الكود.
ملاحظات تكامل عملية لقنوات الدفع المحلية في السعودية — التعامل مع BIN وخصائص 3DS وتوقعات التسوية والفخاخ التي تفوتها الأدلة العامة.
يمنع الوكيل من اختراع نقاط نهاية وهمية لنفاذ أو يقين. يشرح مسار الموافقة ونمط التكامل والسلوكيات التي لا يمكن نشرها دون اعتماد.
ضوابط هندسية لنظام حماية البيانات الشخصية في السعودية — الموافقة والاحتفاظ والتقليل والتصدير كقواعد يستطيع الوكيل فرضها فعليًا في الكود.
ضوابط هندسية لفوترة زاتكا المرحلة الثانية — بنية XML ومسار التوقيع وخطوات التسجيل التي يجب على وكيل البرمجة مراعاتها قبل كتابة الكود.