# ربط دفتر يومية المبيعات بزاتكا

جهز بيانات الشركة، واختر وضع الواجهة البرمجية، ثم هيئ كل دفتر يومية مبيعات بكلمة مرور لمرة واحدة من بوابة فاتورة، وجدد الربط أو أعده حين تنتهي شهادته.

ما دام دفتر يومية المبيعات غير مهيأ فلا شهادة له لدى هيئة الزكاة والضريبة والجمارك (زاتكا)، ولا يمكن تأكيد أي فاتورة فيه. نفذ الخطوات التالية مرة لكل دفتر مبيعات، فلكل دفتر شهادته وسلسلة فواتيره.

## قبل أن تبدأ {#before-you-start}

- دولة الشركة هي المملكة العربية السعودية وحزمتها هي الحزمة السعودية (انظر [إعدادات المحاسبة](/docs/accounting-start-here/accounting-settings)).
- تحتاج إلى أن يكون **الدور** في مستخدمك **المدير**، وإلى صلاحية **المدير** على **المحاسبة**.
- تطلب التهيئة كلمة مرور لمرة واحدة (OTP) تنشئها من بوابة فاتورة التابعة لزاتكا.

## أكمل بيانات الشركة {#company}

افتح **الإعدادات/المستخدمون والشركات/الشركات** ثم الشركة. وحين تكون دولتها **المملكة العربية السعودية** يعرض النموذج العنوان السعودي: الشارع، والحي في السطر الثاني، والمدينة، والمحافظة، و**رقم المبنى** و**معرف قطعة الأرض**، ثم **خطة التعريف** و**رقم التعريف** (رقم السجل التجاري مثلا)، ويطبعان تحت عنوان الشركة في الفواتير.

- يحمل **معرف الضريبة** الرقم الضريبي: 15 رقما أولها وآخرها 3، وإلا رفضت الفواتير.
- إذا نقص الاسم أو الرقم الضريبي أو الشارع أو المدينة أو المحافظة أو الدولة فشلت التهيئة، وسرد تبويب **زاتكا** في الدفتر ما ينقص بعد عبارة **يرجى تعيين ما يلي في** واسم الشركة.
- يجب ألا تتجاوز كل قيمة ترسل إلى زاتكا 64 بايت، ومنها رمز الدفتر واسمه واسم الشركة مجتمعة في قيمة واحدة. والحرف العربي يشغل بايتين، فقد يمنع اسم عربي طويل التهيئة.

## اختر وضع الواجهة البرمجية {#api-mode}

افتح **الفوترة/التهيئة/الإعدادات**. فبعد قسم **الأقلمة المالية** مباشرة يظهر قسم **الفوترة الإلكترونية في المملكة العربية السعودية** إذا كانت الشركة الحالية في السعودية. ويذكر إعداده **أوضاع الواجهة البرمجية لنظام زاتكا** الخطوات الثلاث، ويحدد حقل الوضع فيه وجهة الفواتير:

- **Sandbox** (الافتراضي): بيئة زاتكا التجريبية المشتركة، وتملأ نافذة **تهيئة** كلمة المرور لمرة واحدة تلقائيا.
- **المحاكاة (قبل الإنتاج)**: بيئة تجريبية خاصة بالشركة.
- **الإنتاج**: البيئة الفعلية، ويذكر تحذير بأن كل فاتورة ترسل فيها تحتسب ضمن التزام ضريبة القيمة المضافة.

انقر **حفظ**. وتغيير الوضع لاحقا يفك ربط كل دفاتر الشركة، فيجب تهيئة كل منها من جديد، ويسجل كل دفتر مبيعات في سجل محادثته عبارة **تم تغيير وضع الواجهة البرمجية لنظام زاتكا إلى** متبوعة بالوضع الجديد. وبعد أول فاتورة مقبولة في **الإنتاج** يرفض النظام التغيير. أما النسخة التجريبية من قاعدة البيانات فتعاد إلى **Sandbox**.

## هيئ الدفتر {#onboard}

1. افتح **الفوترة/التهيئة/المحاسبة/دفاتر اليومية** ثم دفتر المبيعات. يأتي تبويب **زاتكا** بعد **قيود اليومية** و**الإعدادات المتقدمة**.
2. يعرض التبويب عبارة **تهيئة دفتر اليومية هذا**. انقر **تهيئة**.
3. في نافذة **أدخل الرقم السري لمرة واحدة** اكتب الرمز الذي حصلت عليه من بوابة فاتورة في الحقل **كلمة المرور لمرة واحدة**، ثم انقر **تأكيد**.

ينفذ جاه عندها كل شيء دفعة واحدة: ينشئ المفتاح الخاص للشركة إن لم يوجد، ويطلب شهادة بكلمة المرور، ويجتاز فحوص الامتثال الستة لدى زاتكا (فاتورة ضريبية ومبسطة، وإشعار دائن ومدين لكل منهما)، ويتسلم شهادة الإنتاج، ويبدأ سلسلة فواتير الدفتر. ثم يعرض التبويب **تم بنجاح: تمت تهيئة دفتر اليومية وهو صالح حتى** مع تاريخ الانتهاء، ويسجل سجل المحادثة **تمت تهيئة دفتر اليومية مع زاتكا بنجاح**. ويمكنك الآن [إرسال الفواتير](send-an-invoice-to-zatca).

وإذا رفضت زاتكا عرض التبويب **خطأ: لم تتم تهيئة دفتر اليومية** مع السبب. صحح السبب وانقر **تهيئة** مرة أخرى.

## جدد الربط أو أعده {#renew}

- يطلب الزر **تجديد** كلمة مرور جديدة بعد انتهاء الشهادة، ويرفض النظام التجديد قبل ذلك. وخارج **Sandbox** يوقف الدفتر المنتهي فواتيره برسالة **لم يعد دفتر اليومية صالحا. يرجى تجديده.**
- يسأل الزر **إعادة التجهيز**: **هل ترغب حقا في إعادة تهيئة دفتر اليوميات هذا مع زاتكا؟**، فإذا اخترت **نعم** نفذ التهيئة كاملة من جديد بكلمة مرور جديدة، ويبدأ السلسلة من أولها، ويسجل **تمت إعادة تهيئة دفتر اليومية مع زاتكا بنجاح**.
- يرفض النظام **تهيئة** و**إعادة التجهيز** ما دامت فاتورة من الدفتر تنتظر رد زاتكا، فأرسلها أولا.

## الأسئلة الشائعة {#faq}

### لا يوجد تبويب زاتكا في الدفتر. {#no-tab}

لا يظهر التبويب إلا في دفتر من نوع **المبيعات** لشركة في السعودية.

### تبويب زاتكا فارغ. {#empty-tab}

لا تظهر رسائله وأزراره إلا لمن **الدور** في مستخدمه **المدير**.

### هل أعود إلى Sandbox بعد الإنتاج؟ {#back-to-sandbox}

لا، متى قبلت فاتورة في **الإنتاج** ثبت الوضع للشركة.

---

- Source: https://jaah.app/ar/docs/e-invoicing-zatca/connect-a-sales-journal-to-zatca
- Updated: 2026-10-23
- Version: الفوترة الإلكترونية (زاتكا) 19.0.0.3