الحدود ورسائل حد معدل الطلبات¶
توجد أربعة حدود مختلفة، ولكل منها سلوك مختلف. حدّد الحد الذي واجهته بحسب ما كنت تفعله.
| كنت | الحد | الحل |
|---|---|---|
| تُصدر فاتورة في التطبيق | الحصة الشهرية من الفواتير | رقِّ باقتك، أو انتظر بداية الشهر الجديد |
| ترسل طلبات API متتابعة بسرعة | 200 طلب في الدقيقة | أبطئ ثم أعد المحاولة |
| تكتب بيانات كثيرة عبر API | الاستخدام العادل، إذا فعّله Clix | تواصل مع الدعم |
| تستخدم الأدوات العامة المجانية | 10 في اليوم، أو 100 في الشهر | سجّل الدخول، أو رقِّ باقتك |
الحصة الشهرية من الفواتير¶
تسمح باقتك بعدد محدد من الفواتير في كل شهر ميلادي: 15 في باقة مجاني، و200 في باقة احترافي، وبلا حد في باقة أعمال.
توجد مهلة سماح بنسبة 10% فوق الحد، مقرّبة إلى الأعلى. في باقة مجاني تكون الفاتورة رقم 17 آخر فاتورة مسموح بها، وفي باقة احترافي الفاتورة رقم 220.
لا يُحذف شيء عند بلوغ الحد. لا تستطيع إنشاء فواتير جديدة، وكل ما عدا ذلك يعمل كالمعتاد. تتجدد الحصة الساعة 00:00 من اليوم الأول من الشهر، بتوقيت الرياض.
لتواصل إصدار الفواتير الآن، رقِّ باقتك من الاشتراك. ترقية واحدة فقط تسري فورًا قبل وصول تحويلك: أول انتقال من باقة مجاني إلى باقة احترافي شهري، مرة واحدة لكل منشأة. أي ترقية أخرى تبدأ عند وصول تحويلك إلى Clix، خلال يوم عمل واحد. راجع الترقية إلى باقة مدفوعة.
ما الذي يُحتسب
كل فاتورة أُنشئت خلال الشهر، بحسب تاريخ إصدارها: الفواتير الضريبية والمبسطة، وإشعارات الدائن والمدين. الفاتورة التي رفضتها زاتكا تُحتسب أيضًا، وكذلك النسخة المصحّحة التي تحل محلها. المسودات والمعاينات لا تُحتسب.
حد معدل طلبات API — 429¶
{ "detail": "Rate limit exceeded. Please try again later.",
"limit": 200, "window": 60, "retry_after": 12 }
200 طلب في الدقيقة لكل مفتاح API، ضمن نافذة ثابتة مدتها 60 ثانية. لكل مفتاح عدّاده الخاص، منفصلًا عن الأشخاص الذين يستخدمون التطبيق. والشخص المسجّل دخوله في التطبيق له أيضًا 200 طلب في الدقيقة.
انتظر عدد الثواني المذكور في retry_after ثم تابع. والأفضل: اقرأ X-RateLimit-Remaining في كل استجابة، ونظّم وتيرة طلباتك قبل أن يصل إلى الصفر. إعادة المحاولة فورًا تزيد المشكلة سوءًا.
هذا الحد لا علاقة له بباقتك، والترقية لن ترفعه.
الاستخدام العادل — 403¶
{ "code": "fair_use_limit",
"detail": "Your organisation has reached its fair-use limit for this month. Viewing and downloading still work. Contact support to continue." }
هذا قيد على عمليات الكتابة الناجحة: الإنشاء والتعديل والحذف. وهو معطّل ما لم يفعّله Clix للمنصة كلها أو لمنشأتك. عند تفعيله، يرفض عمليات الكتابة بعد تجاوز الحصة الشهرية لباقتك مضافًا إليها 10%. يحدد Clix هذه الحصة لكل باقة ولا ينشرها؛ ولا حد لها في باقة أعمال. القراءة والتنزيل والعرض تبقى متاحة.
إنه 403 وليس 429. إعادة المحاولة لن تزيله، ويتجدد في اليوم الأول من الشهر بتوقيت Asia/Riyadh. تواصل مع support@goclix.ai، فهذا القيد يُحل بالنقاش، وليس حاجزًا نهائيًا.
حدود الأدوات العامة¶
الأدوات المجانية — قراءة رمز الاستجابة السريعة (QR)، والتحقق وفق متطلبات زاتكا، وحساب ضريبة القيمة المضافة — لها عدّاد منفصل ولا تستهلك من حصة فواتيرك:
| المستخدم | الحصة |
|---|---|
| غير مسجّل الدخول | 10 في اليوم لكل عنوان IP، تتجدد عند منتصف الليل بتوقيت UTC |
| باقة مجاني | 100 في الشهر |
| الباقات المدفوعة، ومنها باقة احترافي قبل وصول أول تحويل لها | بلا عدّاد |
الحد الأقصى لحجم الملفات المرفوعة فيها 5 MiB.
روابط الفواتير المشتركة¶
تنتهي صلاحية رابط المشاركة بعد 30 يومًا، ولا يقدّم أكثر من 60 مشاهدة في الساعة. إذا توقف الرابط عن العمل، فالأرجح أن صلاحيته انتهت. أنشئ رابطًا جديدًا من الفاتورة.
معرفة وضعك الحالي¶
- في التطبيق: تعرض لوحة التحكم اسم باقتك، وتعرض صفحة الاشتراك الباقة الحالية وتاريخ الفوترة.
- عبر API: يعيد
GET /api/usage/current/الحقولinvoices_usedوinvoices_limitوinvoices_allowed. تحقّق منinvoices_allowedقبل تشغيل دفعة من الفواتير.
قيمة api_calls_used تظهر دائمًا 0
هذه الحقول مثبّتة على الصفر للحفاظ على التوافق، ولا تُحتسب طلبات API شهريًا. استخدم عدّادات الفواتير. راجع الاستخدام والحصص.