n8n
بيانات الشركات في سير العمل، دون برمجة.
مع Node لـ n8n تجلب بيانات الشركات إلى سير عملك دون كود. الـ Node موثّق من n8n ويستدعي الـ API نفسها التي تستدعيها برمجياتك.
تثبيت الـ Node
تثبّت الـ Nodes الموثّقة مباشرةً من المحرر. ولا يستطيع ذلك إلا المالك أو مسؤول نسخة n8n؛ وبعد ذلك يمكن لجميع الأعضاء استخدام الـ Node.
- افتح سير عمل وانقر «+» لفتح لوحة الـ Nodes.
- ابحث عن «handelsregister.ai» واختر الـ Node الذي يحمل شارة التوثيق.
- انقر «Install».
- أنشئ بيانات اعتماد «Handelsregister.ai API» وأدخل مفتاح API الخاص بك. أو بدلًا من ذلك استخدم Bearer token.
في نسخة مستضافة ذاتيًا يمكنك أيضًا تثبيت الـ Node تحت Settings › Community Nodes باسم الحزمة @handelsregister/n8n-nodes-handelsregister-ai.
العمليات
يقدّم الـ Node نقاط نهاية الـ API كعمليات. والأرصدة هي نفسها التي في الـ API.
| العملية | ما تفعله | الأرصدة |
|---|---|---|
| Fetch Organization | ملف الشركة مع ميزات قابلة للاختيار ووضع الذكاء الاصطناعي والوقت الفعلي. | 5 + الميزات |
| Search Organizations | البحث عن الشركات بالاسم والفلاتر. يتنقل «Return All» عبر جميع النتائج، ويحدّ «Maximum Results» العدد. | 1 لكل صفحة |
| Fetch Person | ملف الشخص، بدءًا من Plus. | 15 |
| Fetch Document | مستند من السجل. يكون الملف حينها في الخاصية الثنائية «data». | 15 |
| List Signals | Signals حسب الموضوع والشركة والفترة، صفحة بعد صفحة. | 20 لكل صفحة |
| Get Signal | إشارة واحدة. | 20 |
| Get Signal Catalog | مواضيع Signals. | مجانًا |
في طلبات القراءة يعيد الـ Node المحاولة عند أخطاء الشبكة و408 و429 وأخطاء الخادم حتى ثلاث مرات. ومع «Continue On Fail» يستمر سير العمل، وتحتوي النتيجة على الحالة ورمز الخطأ وmeta.
مثال على سير عمل
يبني سير العمل هذا قائمة بجميع شركات GmbH النشطة في منطقة رمز بريدي، كلٌّ منها مع إدارتها.
- ابدأ بمشغّل، مثل «Manual Trigger» للتجربة أو «Schedule Trigger» لجدول زمني ثابت.
- أضف Node لـ handelsregister.ai بالعملية «Search Organizations». في الفلاتر اضبط الرمز البريدي والشكل القانوني GmbH والحالة نشطة.
- اضبط «Output» على عنصر واحد لكل شركة. فعّل «Return All» وحدّ العدد بـ «Maximum Results». وبذلك تعرف مسبقًا كم ملف شركة سيلي.
- أضف Node ثانيًا لـ handelsregister.ai بـ «Fetch Organization». أدخل التعبير
{{ $json.entity_id }}فيqواختر الميزة Related Persons، أي الإدارة. - اكتب النتيجة إلى وجهتك، مثل جدول بيانات أو نظام CRM الخاص بك.