الفوترة

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

تطلب ميزات fetch-organization واحدة تلو الأخرى. وكلٌّ منها يكلّف فقط عندما يُرجع بيانات:

مع جميع الميزات وكلا الرسمين الإضافيين يكلّف طلب إلى fetch-organization 215 رصيد على الأكثر. وهذا النطاق متاح مع Max.

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

الفاصل الواقع بين هذه الدرجات يكلّف بقدر الدرجة الأكثر تكرارًا التالية. المزيد تحت account/monitors.

الميزة دون بيانات لا تكلّف شيئًا. إذا أرجعت null أو قائمة فارغة، فلا تدفع مقابلها. وينطبق ذلك على كل ميزة، بما فيها insolvency_publications: فدون إعلانات إعسار تكون مجانية.

يتبع السعر الأساسي والرسوم الإضافية قواعدها الخاصة. تدفع السعر الأساسي لكل ملف شركة مسلَّم. ووضع الذكاء الاصطناعي يكلّف حتى دون نتيجة مطابقة. والوقت الفعلي يكلّف لكل جلب مباشر ناجح، حتى لو لم يتغير شيء في السجل. المزيد تحت الرسوم الإضافية.

لبعض الميزات يهم محتوى معين:

• shareholders وshareholders_deep تكلّفان فقط عندما توجد إدخالات حالية. والتاريخ وحده مجاني.
• mergers_and_acquisitions تكلّف فقط مع المعاملات أو علاقات السيطرة أو الخلافة القانونية.
• network تكلّف فقط مع رابط واحد على الأقل.
• news تكلّف بمجرد أن تحتوي القائمة على مقال واحد على الأقل.

يترك fetch-organization الميزة التي لا تشملها خطتك ولا يحتسبها.

مع البحث والتصدير والمستندات وSignals تدفع مقابل الطلب نفسه: صفحة نتائج واحدة، أو مستند واحد، أو صفحة واحدة من Signals. والبحث دون نتائج والصفحة الفارغة من Signals يُحتسبان أيضًا.

الطلب الفاشل أو المرفوض لا يكلّف شيئًا، انظر الأخطاء.

لـ fetch-organization رسمان إضافيان تفعّلهما لكل طلب.

وضع الذكاء الاصطناعي (ai_search=on-default، +20 رصيد) يجد الشركة حتى من مدخلات مبهمة ويبحث على الويب. ويُحتسب بمجرد أن يجري البحث، حتى لو لم يجد شركة أو أبلغ مصدر البيانات عن خطأ. ولا يُحتسب إلا عندما تلغي الـ API الطلب بـ 408.

الوقت الفعلي (realtime_mode=handelsregister-default، +10 رصيد) يجلب الأشخاص المسجلين مباشرةً من السجل التجاري (Handelsregister). نحتسب الرسوم عندما ينجح الجلب المباشر، بغض النظر عما يُرجعه. وحينها تكون قيمة _realtime_mode.status هي success.

أي قيمة أخرى هناك تعني أن الجلب المباشر فشل. تحصل حينها على البيانات المخزنة وتدفع مقابل بقية الطلب، دون رسوم الوقت الفعلي. وإذا استغرق الطلب وقتًا طويلًا جدًا، تجيب الـ API بـ 408 ولا تحتسب شيئًا.

تخبرك كل استجابة بتكلفتها. في استجابات JSON يكون ذلك في meta، وللمستندات في الـ Headers.

حالات الرفض عند المصادقة (401، 403) وفوق الحد (429) تأتي عادةً دون meta. ولا تكلّف شيئًا أبدًا.

تجد كل عملية احتساب تحت الحساب › الاستخدام وعبر الـ API في GET /v1/account/usage/transactions، انظر account.

قبل أن تعالج الـ API طلبًا، تتحقق مما إذا كان رصيدك يغطي أعلى تكلفة ممكنة: السعر الأساسي وجميع الميزات المطلوبة والرسوم الإضافية. وإن لم يكن كذلك، تجيب بـ 402 ولا تحتسب شيئًا.

تُظهر الاستجابة هذا الحد الأقصى في meta.request_credit_cost ورصيدك في meta.credits_remaining. وكثيرًا ما يكون المبلغ المحتسب لاحقًا أقل، لأن الميزات دون بيانات لا تكلّف شيئًا.

مثال: البيانات الأساسية مع وضع الذكاء الاصطناعي والميزة ubos تحتاج إلى 35 رصيد مسبقًا. وإذا لم تُرجع ubos بيانات، يكلّف الطلب 25 رصيد.

تجيب signals بـ Problem Details والرمز INSUFFICIENT_CREDITS.

يحصل كل حساب جديد على 150 رصيد بداية. وهي صالحة لمدة 30 يومًا.

مع اشتراك أرصدة (Plus أو Pro أو Max أو Enterprise) تحصل على أرصدة كل شهر. وهي صالحة حتى نهاية فترة الفوترة. إذا غيّرت خطتك، تنقل الأرصدة الشهرية غير المستخدمة إلى الفترة الجديدة. بدءًا من Plus يمكنك استخدام fetch-person؛ وتفتح Pro وMax بيانات إضافية.

تشتري أرصدة الشحن مرة واحدة، إضافةً إلى ذلك. ودون اشتراك أرصدة تكون صالحة لمدة 30 يومًا. وما دام اشتراك أرصدة قائمًا، لا تنتهي صلاحية أرصدة الشحن ولا أرصدة البداية.

ترى رصيدك وما تنتهي صلاحيته ومتى تحت الحساب › الأرصدة وعبر الـ API في GET /v1/account/credits.

جميع الخطط والأسعار موجودة في صفحة الأسعار.