> ## 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. # Verifica NRC Zambia (registro fiscale): API Didit > Verifica NRC Zambia (registro fiscale) via Didit: validazione su database autorevole. Da $0.20 a chiamata, senza contratti né minimi. Verifica che un numero di Zambian National Registration Card (NRC) appartenga al contribuente indicato nel registro della Zambia Revenue Authority. Il registro contiene solo il nome completo del contribuente, quindi il nome è l'unico campo confrontato. Didit espone questo servizio tramite `POST /v3/database-validation/` per permetterti di verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati. ## Copertura * **Copertura:** — * **Paese:** Zambia * **ID servizio:** `zmb_national_id` * **Dominio dei dati:** Identità * **Categoria:** TaxRegistry ## Input | Campo | Obbligatorio | Esempio | | - | -: | - | | `national_id` | Sì | `123456/78/9` | | `first_name` | Sì | `John` | | `last_name` | Sì | `Doe` | | `vendor_data` | No | `user-1234` | * **Input obbligatori:** `national_id`, `first_name`, `last_name` * **Input facoltativi:** `vendor_data` * **Consenso:** Non richiesto * **Disponibilità nel workflow:** Disponibile nel workflow * **Copertura:** — * **Prezzo:** \$0.20 per query riuscita ## Parametri del body **issuing\_state** `string` *required* (default: ZMB) Codice paese ISO 3166-1 alpha-3 per questo servizio di database. Esempio: `ZMB` **services** `string` *required* (default: zmb\_national\_id) Array che contiene questo ID servizio. Fissare il servizio mantiene la richiesta limitata a questo specifico database. Esempio: `zmb_national_id` **national\_id** `string` *required* (default: 123456/78/9) Numero di identità nazionale per questo servizio. Esempio: `123456/78/9` **first\_name** `string` *required* (default: John) Nome proprio da validare. Esempio: `John` **last\_name** `string` *required* (default: Doe) Cognome da validare. Esempio: `Doe` **vendor\_data** `string` (default: user-1234) Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare i controlli indipendenti allo stesso utente finale e ridurre il rumore del rilevamento dei duplicati. Esempio: `user-1234` ## Regole di input e note di validazione * `national_id` deve usare lettere maiuscole. * `national_id` deve corrispondere a `\d{6}/?\d{2}/?\d`. ## Come effettuare la chiamata ```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)); ``` Ogni chiamata riuscita restituisce HTTP `200`. Il campo **`outcome_code`** indica cosa è effettivamente accaduto, distinguendo ad esempio una vera mancata corrispondenza biometrica (`BIOMETRIC_NO_MATCH`) da un selfie che non può essere letto (`BIOMETRIC_IMAGE_UNUSABLE`). Lo `status` mostrato è lo stato predefinito della funzionalità; le tue [azioni configurate per Partial Match / No Match](https://docs.didit.me/it/core-technology/database-validation/database-validation-warnings.md) possono sostituirlo. **`MATCH`**: il registro ha confermato l'identità e ogni campo verificato corrispondeva. ```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`**: il numero di identificazione è stato trovato, ma uno o più campi personali (di solito nome o data di nascita) non corrispondono completamente. ```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`**: il registro non ha restituito alcuna corrispondenza per i dati inviati. ```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`**: il numero del documento inviato non corrisponde ad alcun record del registro. ```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" } } ] } ``` ## Dati restituiti I campi esatti esposti in `source_data` dipendono da ciò che restituisce il registro. L'esempio generato per `zmb_national_id` documenta attualmente questa struttura normalizzata: * `first_name` * `full_name` * `identification_number` * `last_name` * `registration_status` ## Prezzi e SLA Le query del registro NRC dello Zambia (registro fiscale) vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione. * **Prezzo per chiamata:** \$0.20 USD. * **Fatturazione:** per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene respinta prima di raggiungere la fonte. * **Latenza:** p95 tipico \< 2 s. * **Disponibilità:** 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia in base al paese e al dataset. ## Continua a leggere * [Panoramica della Validazione su database per lo Zambia](https://docs.didit.me/api-reference/database-validation/zambia.md) * [Panoramica della Validazione su database](https://docs.didit.me/it/core-technology/database-validation/overview.md) * [Codici di esito](https://docs.didit.me/it/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.