> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Südafrika Unternehmensregister-Abfrage API

> Abfrage des südafrikanischen Unternehmensregisters über Didit. Pay-per-Call ab $0.75, keine Verträge, keine Mindestabnahme.

Sucht ein südafrikanisches Unternehmen anhand der Registernummer im Handelsregister der CIPC. Didit stellt diesen Dienst über `POST /v3/database-validation/` bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Abgleichsergebnisse erhalten.

## Abdeckung

* **Abdeckung:** —
* **Land:** Südafrika
* **Service-ID:** `zaf_company_registry`
* **Datenbereich:** Behörden
* **Kategorie:** CompanyRegister

## Eingaben

| Feld | Pflicht | Beispiel |
| - | -: | - |
| `company_registration_number` | Ja | `REG-123456` |
| `company_name` | Nein | `Sample Company LLC` |
| `vendor_data` | Nein | `user-1234` |

* **Pflichteingaben:** `company_registration_number`
* **Optionale Eingaben:** `company_name`, `vendor_data`
* **Einwilligung:** nicht erforderlich
* **Verfügbarkeit im Workflow:** Im Workflow mit Feldzuordnung verfügbar
* **Abdeckung:** —
* **Preis:** \$0.75 pro erfolgreicher Abfrage

Im Workflow steht `company_registration_number` nicht auf einem Ausweisdokument, daher erzeugt kein Schritt diesen Wert allein. Erfassen Sie ihn über eine Antwort im Fragebogen, ein Extraktionsfeld von Document AI oder einen Wert, den Sie beim Erstellen der Sitzung übergeben, und ordnen Sie ihn dem Schritt Datenbankvalidierung zu. Solange er nicht zugeordnet ist, zeigt der Workflow-Editor diesen Dienst deaktiviert an und benennt die fehlende Eingabe. Zur Laufzeit wird die Prüfung bei einer fehlenden Eingabe vor jeder Abfrage übersprungen, sodass Ihnen nie eine Datenbankabfrage berechnet wird, die nicht durchgeführt werden konnte.

## Body-Parameter

**issuing\_state** `string` *required* (default: ZAF)

ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.

Beispiel: `ZAF`

**services** `string` *required* (default: zaf\_company\_registry)

Array mit der ID dieses Dienstes. Das Festlegen des Dienstes beschränkt die Anfrage auf genau diese Datenbank.

Beispiel: `zaf_company_registry`

**company\_registration\_number** `string` *required* (default: REG-123456)

Wert für `company_registration_number`, der von diesem Datenbankdienst benötigt wird.

Beispiel: `REG-123456`

**company\_name** `string`

Wert für `company_name`, der von diesem Datenbankdienst benötigt wird.

Beispiel: `Sample Company LLC`

**vendor\_data** `string` (default: user-1234)

Ihre dauerhafte Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und Störungen bei der Duplikaterkennung zu verringern.

Beispiel: `user-1234`

## Regeln für Eingaben und Validierungshinweise

* Senden Sie die oben aufgeführten Felder genau so, wie sie vom Benutzer oder aus dem Dokument erfasst wurden.
* Didit prüft Pflichtfelder, bevor die Datenbank aufgerufen wird. Anfragen, die vor der Quellenabfrage abgelehnt werden, werden nicht berechnet.

## Aufruf

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"
```

Jeder erfolgreiche Aufruf liefert HTTP `200` zurück. Das Feld **`outcome_code`** zeigt an, was tatsächlich passiert ist. So lässt sich zum Beispiel eine echte biometrische Nichtübereinstimmung (`BIOMETRIC_NO_MATCH`) von einem Selfie unterscheiden, das nicht lesbar war (`BIOMETRIC_IMAGE_UNUSABLE`). Der angezeigte `status` ist der Standardstatus der Funktion. Ihre konfigurierten [Aktionen für Partial Match / No Match](https://docs.didit.me/de/core-technology/database-validation/database-validation-warnings.md) können ihn überschreiben.

**`MATCH`** — Das Register hat die Identität bestätigt, und alle geprüften Felder stimmen überein.

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_registry",
      "service_name": "South Africa - Company Registry Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`** — Das Register hat für die übermittelten Daten keine Übereinstimmung gefunden.

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_registry",
      "service_name": "South Africa - Company Registry Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

## Zurückgegebene Daten

Welche Felder genau in `source_data` erscheinen, hängt von den Angaben des Registers ab. Das generierte Beispiel für `zaf_company_registry` dokumentiert derzeit diese normalisierte Struktur:

* Variiert je nach Antwort des Registers.

## Preise & SLAs

Abfragen des südafrikanischen Unternehmensregisters werden nur berechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.

* **Preis pro Aufruf:** \$0.75 USD.
* **Abrechnung:** pro erfolgreicher Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, Pflichtfelder fehlen oder die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
* **Latenz:** typischer p95-Wert \< 2 s.
* **Verfügbarkeit:** 99.9% pro Quartal auf Seiten von Didit; die Verfügbarkeit der nachgelagerten Quelle variiert je nach Land und Datensatz.

## Weiterlesen

* [Übersicht über die Datenbankvalidierung in Südafrika](https://docs.didit.me/api-reference/database-validation/south-africa.md)
* [Übersicht Datenbankvalidierung](https://docs.didit.me/de/core-technology/database-validation/overview.md)
* [Ergebniscodes](https://docs.didit.me/de/core-technology/database-validation/database-validation-outcome-codes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.