> ## 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. # Datenbankvalidierung Sambia NRC (Steuerregister) API > Sambia NRC (Steuerregister): autoritative Datenbankvalidierung über Didit. Ab $0.20 pro Abruf, ohne Verträge und Mindestabnahme. Prüft, ob eine Nummer der sambischen National Registration Card (NRC) zu dem genannten Steuerpflichtigen im Register der Zambia Revenue Authority gehört. Das Register enthält nur den vollständigen Namen des Steuerpflichtigen, daher ist der Name das einzige Feld, das verglichen wird. 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:** Sambia * **Service-ID:** `zmb_national_id` * **Datenbereich:** Identität * **Kategorie:** TaxRegistry ## Eingaben | Feld | Erforderlich | Beispiel | | - | -: | - | | `national_id` | Ja | `123456/78/9` | | `first_name` | Ja | `John` | | `last_name` | Ja | `Doe` | | `vendor_data` | Nein | `user-1234` | * **Pflichteingaben:** `national_id`, `first_name`, `last_name` * **Optionale Eingaben:** `vendor_data` * **Einwilligung:** Nicht erforderlich * **Verfügbarkeit im Workflow:** Im Workflow verfügbar * **Abdeckung:** — * **Preis:** \$0.20 pro erfolgreiche Abfrage ## Body-Parameter **issuing\_state** `string` *required* (default: ZMB) ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst. Beispiel: `ZMB` **services** `string` *required* (default: zmb\_national\_id) Array mit der ID dieses Dienstes. Das Festlegen des Dienstes beschränkt die Anfrage auf genau diese Datenbank. Beispiel: `zmb_national_id` **national\_id** `string` *required* (default: 123456/78/9) Nationale Identitätsnummer für diesen Dienst. Beispiel: `123456/78/9` **first\_name** `string` *required* (default: John) Zu validierender Vorname. Beispiel: `John` **last\_name** `string` *required* (default: Doe) Zu validierender Nachname. Beispiel: `Doe` **vendor\_data** `string` (default: user-1234) Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und das Rauschen bei der Dublettenerkennung zu verringern. Beispiel: `user-1234` ## Eingaberegeln und Validierungshinweise * `national_id` muss Großbuchstaben verwenden. * `national_id` muss `\d{6}/?\d{2}/?\d` entsprechen. ## So rufen Sie es auf ```bash cURL theme={null} curl -X POST "https://verification.didit.me/v3/database-validation/" \ -H "x-api-key: YOUR_API_KEY" \ -F "issuing_state=ZMB" \ -F "services=zmb_national_id" \ -F "vendor_data=user-1234" \ -F "national_id=123456/78/9" \ -F "first_name=John" \ -F "last_name=Doe" ``` ```python Python theme={null} from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.database_validation.validate( issuing_state="ZMB", services=["zmb_national_id"], first_name="John", last_name="Doe", national_id="123456/78/9", vendor_data="user-1234", ) print(result) ``` ```javascript Node.js theme={null} import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.databaseValidation.validate({ issuing_state: "ZMB", services: ["zmb_national_id"], first_name: "John", last_name: "Doe", national_id: "123456/78/9", vendor_data: "user-1234", }); console.log(result); ``` ```go Go theme={null} ctx := context.Background() // Reads DIDIT_API_KEY. client := didit.NewClient() result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{ IssuingState: "ZMB", Services: didit.Some([]string{"zmb_national_id"}), FirstName: didit.String("John"), LastName: didit.String("Doe"), NationalID: didit.String("123456/78/9"), VendorData: didit.String("user-1234"), }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", result) ``` ```java Java theme={null} import java.util.List; import me.didit.Didit; import me.didit.types.DatabaseValidationValidateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder() .issuingState("ZMB") .services(List.of("zmb_national_id")) .firstName("John") .lastName("Doe") .nationalId("123456/78/9") .vendorData("user-1234") .build()); System.out.println(result); ``` ```php PHP theme={null} databaseValidation->validate([ 'issuing_state' => 'ZMB', 'services' => ['zmb_national_id'], 'first_name' => 'John', 'last_name' => 'Doe', 'national_id' => '123456/78/9', 'vendor_data' => 'user-1234', ]); print_r($result->toArray()); ``` ```ruby Ruby theme={null} require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.database_validation.validate( issuing_state: "ZMB", services: ["zmb_national_id"], first_name: "John", last_name: "Doe", national_id: "123456/78/9", vendor_data: "user-1234" ) puts result.to_h ``` ```csharp .NET theme={null} using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams { IssuingState = "ZMB", Services = new string[] { "zmb_national_id" }, FirstName = "John", LastName = "Doe", NationalId = "123456/78/9", VendorData = "user-1234", }); Console.WriteLine(JsonSerializer.Serialize(result)); ``` Jeder erfolgreiche Aufruf gibt HTTP `200` zurück. Das Feld **`outcome_code`** zeigt Ihnen, was tatsächlich passiert ist. So unterscheidet es beispielsweise eine echte biometrische Nichtübereinstimmung (`BIOMETRIC_NO_MATCH`) von einem Selfie, das nicht gelesen werden konnte (`BIOMETRIC_IMAGE_UNUSABLE`). Der angezeigte `status` ist der Standardstatus der Funktion; Ihre konfigurierten [Aktionen bei Teilübereinstimmung / keinem Treffer](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 stimmten überein. ```json 200 OK — MATCH theme={null} { "request_id": "req_01H…", "status": "Approved", "issuing_state": "ZMB", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "zmb_national_id", "service_name": "Zambia NRC (tax register)", "source_data": { "first_name": "John", "full_name": "John Doe", "identification_number": "SAMPLE-ID-12345", "last_name": "Doe", "registration_status": "sample_value" }, "validation": { "full_name": "full_match", "identification_number": "full_match" } } ] } ``` **`PARTIAL_MATCH`**: Die Identifikationsnummer wurde gefunden, aber ein oder mehrere persönliche Felder (meist Name oder Geburtsdatum) stimmten nicht vollständig überein. ```json 200 OK — PARTIAL_MATCH theme={null} { "request_id": "req_01H…", "status": "In Review", "issuing_state": "ZMB", "match_type": "partial_match", "validations": [ { "outcome_code": "PARTIAL_MATCH", "service_id": "zmb_national_id", "service_name": "Zambia NRC (tax register)", "source_data": { "first_name": "John", "full_name": "John Doe", "identification_number": "SAMPLE-ID-12345", "last_name": "Doe", "registration_status": "sample_value" }, "validation": { "full_name": "no_match", "identification_number": "full_match" } } ] } ``` **`NO_MATCH`**: Das Register hat für die übermittelten Daten keinen Treffer zurückgegeben. ```json 200 OK — NO_MATCH theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "ZMB", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "zmb_national_id", "service_name": "Zambia NRC (tax register)", "source_data": { "full_name": "NO_MATCH", "identification_number": "NO_MATCH" }, "validation": { "full_name": "no_match", "identification_number": "no_match" } } ] } ``` **`DOCUMENT_NOT_FOUND`**: Die übermittelte Dokumentnummer entspricht keinem Datensatz im Register. ```json 200 OK — DOCUMENT_NOT_FOUND theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "ZMB", "match_type": "no_match", "validations": [ { "outcome_code": "DOCUMENT_NOT_FOUND", "service_id": "zmb_national_id", "service_name": "Zambia NRC (tax register)", "source_data": { "full_name": "NO_MATCH", "identification_number": "NO_MATCH" }, "validation": { "full_name": "no_match", "identification_number": "no_match" } } ] } ``` ## Zurückgegebene Daten Welche genauen Felder in `source_data` ausgegeben werden, hängt davon ab, was das Register zurückgibt. Die generierte Beispielantwort für `zmb_national_id` dokumentiert derzeit diese normalisierte Struktur: * `first_name` * `full_name` * `identification_number` * `last_name` * `registration_status` ## Preise und SLAs Abfragen des sambischen NRC (Steuerregister) werden nur abgerechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält. * **Preis pro Aufruf:** \$0.20 USD. * **Abrechnung:** pro erfolgreiche Abfrage. Ihnen werden keine Kosten berechnet, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn 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 für Sambia](https://docs.didit.me/api-reference/database-validation/zambia.md) * [Übersicht über die Datenbankvalidierung](https://docs.didit.me/de/core-technology/database-validation/overview.md) * [Outcome-Codes](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.