بيئة الاختبار (Sandbox)

ما بيئة الاختبار

منشأة الاختبار منشأة تجريبية تنشئها بنفسك، مرتبطة بمنشأتك الحقيقية ومنفصلة عنها. تفتحها من مبدّل المنشآت كأي منشأة تنتمي إليها، ولا تتغير منشأتك الحقيقية أبدًا.

• تأتي ببيانات تجريبية: خمسة عملاء (منهم Demo B2B Co. بعنوان وطني كامل، ومشترٍ أجنبي) وخمسة منتجات وثلاث مسودات وفاتورتان صادرتان وإشعار دائن. تجدها بـ GET /customers?q=Demo.
• أرقامها تبدأ بـ TEST-INV- وTEST-CN-، والرقم الضريبي للبائع فيها وهمي بوضوح.
• مجانية ولا تُفوتر أبدًا، ولها حدودها: 300 فاتورة شهريًا و100 عميل و3 مستخدمين.

أنشئ واحدة

1. سجّل الدخول وافتح الإعدادات ← المطورون ← بيئة الاختبار في منشأتك أنت. تحتاج إلى صلاحية إدارة إعدادات المنشأة.
2. اختر إنشاء منشأة اختبار. يمكنك الاحتفاظ باثنتين.
3. افتحها، ثم أنشئ مفتاحًا من الإعدادات ← المطورون ← مفاتيح API. مفتاح بيئة الاختبار يبدأ بـ wbk_test_.

إعادة الضبط تفرغ بيئة الاختبار وتضيف البيانات التجريبية من جديد، وتبقى مفاتيحها. الحذف يزيلها مع كل بياناتها. وتُحذف بيئة الاختبار التي لا يستخدمها أحد 90 يومًا، بعد أسبوع من تنبيه بالبريد.

مفاتيح الاختبار ومفاتيح التشغيل لا تختلط

المفتاح الصادر في بيئة اختبار مفتاح اختبار (wbk_test_…) لا يعمل إلا عليها. ومفتاح التشغيل (wbk_…) لا يعمل على بيئة اختبار أبدًا. أيٌّ منهما يُستخدم مع النوع الآخر من المنشآت يتلقى 401 unauthorized.

نتائج محاكاة للهيئة

فواتير بيئة الاختبار وإشعاراتها لا تُرسل إلى هيئة الزكاة أبدًا. يحصل كل مستند صادر على نتيجة محاكاة بدلًا من ذلك، بالمفردات نفسها المستخدمة للمنشأة الفعلية: zatca.status يكون pending أولًا، ثم يصبح cleared (مشترٍ له رقم ضريبي، أو تصدير) أو reported (غير ذلك) بعد نحو دقيقة.

ضع علامة في وصف بند لتجربة النتائج الأخرى:

• [sandbox:reject]: rejected مع رسائل نموذجية في zatca.errors.
• [sandbox:warning]: معتمدة أو مُبلَّغ عنها مع with_warnings: true.
• [sandbox:retry]: retrying أولًا، ثم معتمدة أو مُبلَّغ عنها بعد دقيقة.

لا يخرج شيء من بيئة الاختبار

• لا يصل بريد ولا رسالة واتساب إلى أي عميل. وحدك، بصفتك مالك بيئة الاختبار، يمكن أن يصلك بريد منها.
• لا روابط دفع ولا شراء اشتراك.
• ملفات PDF فيها موسومة بـ SANDBOX وبلا رمز QR. لا شيء في بيئة الاختبار فاتورة ضريبية.

وحدة التجربة في المتصفح

مخطط لوحدة تجربة في المتصفح تقبل مفاتيح الاختبار فقط، ويُفرض ذلك في المتصفح وفي الواجهة البرمجية معًا. وإلى أن توجد، لا يطلب منك هذا التوثيق أبدًا لصق مفتاح في صفحة ويب.