انتقل إلى المحتوى

الحدود ورسائل حد معدل الطلبات

توجد أربعة حدود مختلفة، ولكل منها سلوك مختلف. حدّد الحد الذي واجهته بحسب ما كنت تفعله.

كنت الحد الحل
تُصدر فاتورة في التطبيق الحصة الشهرية من الفواتير رقِّ باقتك، أو انتظر بداية الشهر الجديد
ترسل طلبات API متتابعة بسرعة 200 طلب في الدقيقة أبطئ ثم أعد المحاولة
تكتب بيانات كثيرة عبر API الاستخدام العادل تواصل مع الدعم
تستخدم الأدوات العامة المجانية 10 في اليوم، أو 100 في الشهر سجّل الدخول، أو رقِّ باقتك

الحصة الشهرية من الفواتير

تسمح باقتك بعدد محدد من الفواتير المرسلة إلى هيئة الزكاة والضريبة والجمارك (زاتكا) في كل شهر ميلادي: 15 في باقة مجاني، و200 في باقة احترافي، وبلا حد في باقة أعمال.

توجد مهلة سماح بنسبة 10% فوق الحد، فتستطيع منشأة على باقة احترافي الوصول إلى 220 فاتورة قبل أن يتوقف الإرسال.

لا يُحذف شيء عند بلوغ الحد. لا تستطيع إرسال فواتير جديدة، وكل ما عدا ذلك يعمل كالمعتاد. تتجدد الحصة في أول الشهر حسب توقيت Asia/Riyadh، لا حسب UTC.

لتواصل إصدار الفواتير الآن، رقِّ باقتك من الاشتراك. تسري الترقية فورًا، قبل وصول تحويلك البنكي.

ما الذي يُحتسب

الفواتير المرسلة إلى زاتكا، الضريبية والمبسطة، إضافة إلى إشعارات الدائن والمدين. المسودات والمعاينات لا تُحتسب حتى تُرسل.

حد معدل طلبات API — 429

{ "detail": "Rate limit exceeded. Please try again later.",
  "limit": 200, "window": 60, "retry_after": 12 }

200 طلب في الدقيقة لكل مفتاح API، ضمن نافذة ثابتة مدتها 60 ثانية. لكل مفتاح رصيده المستقل.

انتظر عدد الثواني المذكور في 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." }

هذا قيد على عمليات الكتابة عندما يتجاوز حجمها أنماط العمل المعتادة بكثير. القراءة والتنزيل والعرض تبقى متاحة.

إنه 403 وليس 429، فإعادة المحاولة لن تزيله، ولن يُرفع إلا مع بداية الشهر الجديد. تواصل مع support@goclix.ai، فهذا القيد يُحل بالنقاش، وليس حاجزًا نهائيًا.

حدود الأدوات العامة

الأدوات المجانية — قراءة رمز الاستجابة السريعة (QR)، والتحقق وفق متطلبات زاتكا، وحساب ضريبة القيمة المضافة — لها عدّاد منفصل ولا تستهلك من حصة فواتيرك:

المستخدم الحصة
غير مسجّل الدخول 10 في اليوم، لكل عنوان IP
باقة مجاني 100 في الشهر
الباقات المدفوعة بلا عدّاد

الحد الأقصى لحجم الملفات المرفوعة فيها 5 MiB.

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

معرفة وضعك الحالي

  • في التطبيق: تعرض لوحة التحكم اسم باقتك، وتعرض صفحة الاشتراك الباقة الحالية وتاريخ الفوترة.
  • عبر API: يعيد GET /api/usage/current/ الحقول invoices_used وinvoices_limit وinvoices_allowed. تحقّق من invoices_allowed قبل تشغيل دفعة من الفواتير.

قيمة api_calls_used تظهر دائمًا 0

هذه الحقول مثبّتة على الصفر للحفاظ على التوافق، ولا تُحتسب طلبات API شهريًا. استخدم عدّادات الفواتير. راجع الاستخدام والحصص.