المستندات

ما المستندات الموجودة وبأي صيغة.

مع fetch-document تنزّل المستندات الرسمية من السجل كملف. مرّر entity_id الخاص بالشركة في company_id واختر document_type. يكلّف كل مستند تم تسليمه 15 رصيد.

أنواع المستندات

هناك خمسة أنواع من المستندات. اكتب قيم document_type تمامًا كما في الجدول، بما في ذلك الأحرف الكبيرة والصغيرة. يجلب الطلب النموذجي Aktueller Abdruck لـ Hetzner Online GmbH، Ansbach HRB 6089.

document_type
document_type	المستند	الصيغة
AD	Aktueller Abdruck (المستخرج الحالي)جميع القيود السارية اليوم. مستخرج السجل التقليدي.	PDF
CD	Chronologischer Abdruck (المستخرج الزمني)جميع القيود بترتيب زمني، بما في ذلك المشطوبة، منذ أن صار السجل يُمسك إلكترونيًا.	PDF
SI	Strukturierter Registerinhalt (محتوى السجل المنظّم)محتوى السجل بصيغة XML وفق معيار XJustiz، مناسب للمعالجة الآلية.	XML
shareholders_list	Gesellschafterliste (قائمة الشركاء)قائمة الشركاء مع حصصهم، كما تودعها الـ GmbH لدى السجل.	PDF
articles_of_association	Gesellschaftsvertrag أو Satzung (عقد التأسيس أو النظام الأساسي)العقد الذي ينظّم الشركة. يُسمّى في GmbH ‏Gesellschaftsvertrag، وفي AG وeG ‏Satzung.	PDF

curl -G "https://handelsregister.ai/api/v1/fetch-document" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'company_id=94eb910fef13f94585c48c263fa446d4' \
  --data-urlencode 'document_type=AD'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-document",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "company_id": "94eb910fef13f94585c48c263fa446d4",
        "document_type": "AD",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-document");
url.searchParams.append("company_id", "94eb910fef13f94585c48c263fa446d4");
url.searchParams.append("document_type", "AD");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

المستندات حسب الشكل القانوني

Aktueller Abdruck وChronologischer Abdruck وStrukturierter Registerinhalt متوفرة لكل شركة مسجلة. أما المستندات المودعة الأخرى فيتوقف وجودها على الشكل القانوني.

الشكل القانوني
الشكل القانوني	AD, CD, SI	قائمة الشركاء	عقد التأسيس
GmbH, UG	نعم	نعم، إلزامية	نعم، الـ Gesellschaftsvertrag
AG, SE, KGaA	نعم	لا	نعم، الـ Satzung
eG	نعم	لا	نعم، الـ Satzung
KG, GmbH & Co. KG, OHG	نعم	لا	عادةً لا
PartG, PartG mbB	نعم	لا	عادةً لا
e.K.	نعم	لا	عادةً لا

قائمة الشركاء موجودة فقط لـ GmbH وUG. للأشكال القانونية الأخرى والمستندات غير الموجودة تجيب الـ API بـ 404 ولا تحتسب شيئًا.

الصيغ

الاستجابة هي الملف نفسه، وليست JSON. تتعرف على النوع من الـ Header ‏Content-Type، وعلى اسم الملف من الـ Header ‏Content-Disposition.

يحتوي اسم الملف على الـ entity_id ونوع المستند وتاريخ الجلب، مثل document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.

قوائم الشركاء وعقود التأسيس كثيرًا ما تكون صفحات ممسوحة ضوئيًا، وبعضها دون طبقة نصية. للحصول على النص تحتاج حينها إلى OCR.

بعض المستندات متاحة من السجل فقط كصورة TIFF. تجيب الـ API حينها بـ 415 ولا تحتسب شيئًا.

في مثالنا لـ Hetzner Online GmbH كانت أحجام الملفات كالتالي: Aktueller Abdruck نحو 35 KB، وStrukturierter Registerinhalt نحو 14 KB، وGesellschaftsvertrag نحو 450 KB.

نجلب المستندات مباشرةً من السجل عند الحاجة. وقد يستغرق ذلك حتى دقيقتين. لذا اضبط مهلة الانتظار في عميلك على 120 ثانية على الأقل، أو اجلب المستند في الخلفية مع async=true. إذا لم يُجب السجل في الوقت المناسب، تحصل على 504 مع Retry-After. ولا يُحتسب شيء حينها.

fetch-document المعاملات والاستجابة والأخطاء بالتفصيل. تنزيل المستندات خطوة بخطوة إلى مستندك الأول.