---
name: فاتورة ZATCA
priority: 1
keywords: فاتورة, فواتير, مالية, ضريبة, زاتكا, ZATCA, invoice, VAT, ضريبية, إلكترونية, خصم, تحصيل
---

# فاتورة ZATCA — أداة واحدة (device mode)

## متى تستخدم
عندما يطلب العميل فاتورة، أو يحتاج إيصال بقيمة الخدمة، أو يسأل عن الضريبة.

## كيف تنفّذ (أداة واحدة فقط)

استدعِ `zatca_invoice` بالبيانات اللي معك. الأداة:
- تسجّل الفاتورة في DB
- تولّد UBL XML + QR
- **تحفظ ملفين على سطح المكتب تلقائياً**: HTML + PDF (PDF يحتاج Chrome مثبت).
- ترجع `invoiceNumber` + `savedPath` (HTML) + `pdfPath` (PDF — قد يكون null إذا Chrome غير موجود).

❗ **أداة واحدة فقط** — لا تستدعِ write_file ولا html_to_pdf بعدها لنفس الفاتورة.

عند طلب "حوّلها لـ PDF" بعد إنشاء فاتورة سابقة:
- إذا كانت `pdfPath` غير null في الجولة السابقة، الـ PDF موجود فعلاً — أخبر العميل بمساره.
- إذا كانت null (Chrome غير مثبت)، استخدم `html_to_pdf` على `savedPath` للمحاولة، أو اعترف للعميل أن PDF يحتاج Chrome.

أبلغ العميل **حرفيًا** بـ `savedPath` و `pdfPath` المرتجعة من الأداة.

## القواعد الذهبية
- ❌ **ممنوع** اختراع invoiceNumber أو أي مسار — استخدم القيم المرتجعة فقط.
- ❌ **ممنوع** قول "تم تحويل PDF" إلا إذا `pdfPath` غير null أو استدعيت `html_to_pdf` ونجحت.
- ❌ **ممنوع** قول "أرسلت للفريق" — أنت الفريق، الفاتورة جاهزة على القرص.
- ✅ بعد النجاح: أخبر العميل بـ HTML path + PDF path + رقم الفاتورة + الإجمالي.

## أمثلة
- "اعمل لي فاتورة ضريبية لأحمد محمد بـ500 ريال" → استدعِ `zatca_invoice` ثم `write_file` ثم أبلغ.
- "أبي إيصال على اسم الشركة" → اطلب VAT الشركة، استدعِ الأداتين، أبلغ.
- "بكم الإجمالي مع الضريبة على 1000 ريال؟" → احسب: 1000 + 150 = 1150 ر.س. (لا تنشئ فاتورة إلا لو طلب صراحة)
