الفوترة الإلكترونية (زاتكا) — إصدار فواتير إلكترونية والتحقق من الامتثال عبر منصة فاتورة. استخدم عندما يسأل المستخدم عن الفوترة الإلكترونية أو زاتكا أو فاتورة.
منصة فاتورة الرسمية من هيئة الزكاة والضريبة والجمارك (ZATCA) للفوترة الإلكترونية في المملكة العربية السعودية.
export ZATCA_API_KEY=your_base64_certificateالمصادقة تتم عبر Basic Auth باستخدام الشهادة المشفرة بـ base64:
Authorization: Basic <base64(certificate:secret)>
curl -s -X POST "https://gw-fatoora.zatca.gov.sa/e-invoicing/core/compliance" \
-H "Content-Type: application/json" \
-H "Accept-Version: V2" \
-H "Authorization: Basic $ZATCA_API_KEY" \
-d '{
"csr": "BASE64_ENCODED_CSR"
}'
الفواتير المبسطة (أفراد) تُرسل عبر نظام الإبلاغ (Reporting):
curl -s -X POST "https://gw-fatoora.zatca.gov.sa/e-invoicing/core/invoices/reporting/single" \
-H "Content-Type: application/json" \
-H "Accept-Version: V2" \
-H "Accept-Language: ar" \
-H "Authorization: Basic $ZATCA_API_KEY" \
-d '{
"invoiceHash": "INVOICE_HASH",
"uuid": "INVOICE_UUID",
"invoice": "BASE64_ENCODED_XML"
}'
الفواتير الضريبية (شركات) تُرسل عبر نظام الاعتماد (Clearance):
curl -s -X POST "https://gw-fatoora.zatca.gov.sa/e-invoicing/core/invoices/clearance/single" \
-H "Content-Type: application/json" \
-H "Accept-Version: V2" \
-H "Accept-Language: ar" \
-H "Authorization: Basic $ZATCA_API_KEY" \
-d '{
"invoiceHash": "INVOICE_HASH",
"uuid": "INVOICE_UUID",
"invoice": "BASE64_ENCODED_XML"
}'
curl -s -X POST "https://gw-fatoora.zatca.gov.sa/e-invoicing/core/compliance/invoices" \
-H "Content-Type: application/json" \
-H "Accept-Version: V2" \
-H "Accept-Language: ar" \
-H "Authorization: Basic $ZATCA_API_KEY" \
-d '{
"invoiceHash": "INVOICE_HASH",
"uuid": "INVOICE_UUID",
"invoice": "BASE64_ENCODED_XML"
}'
| النوع | الوصف | الآلية |
|---|---|---|
| فاتورة مبسطة (B2C) | للأفراد | إبلاغ (Reporting) |
| فاتورة ضريبية (B2B) | للشركات | اعتماد (Clearance) |
| إشعار دائن | إرجاع/خصم | نفس آلية الفاتورة الأصلية |
| إشعار مدين | إضافة مبلغ | نفس آلية الفاتورة الأصلية |
🧾 نتيجة الفوترة الإلكترونية: