Cifre di controllo CNPJ
Inserisca la base 112223330001 e otterrà le cifre di controllo 81, quindi il CNPJ completo è 11222333000181; oppure incolli 14 cifre per confermare le due finali. Utile per fatture, registrazione dei fornitori e pulizia dei dati. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Numero
- 112223330001
- Modalità di calcolo
- Compute
- Input
- 112223330001
- Cifre di controllo
- 81
- Cifra di controllo 1
- 8
Un CNPJ brasiliano (Cadastro Nacional da Pessoa Jurídica) termina con due cifre di controllo che dimostrano che l'identificativo aziendale a quattordici cifre è stato digitato o memorizzato senza una trasposizione né un errore di una sola cifra. Questa capacità implementa la regola ufficiale mod-11 della Receita Federal usata su ogni CNPJ: dodici cifre base identificano l'iscrizione radice e la filiale, poi due cifre finali sono derivate con sequenze di pesi fisse e una regola di resto sotto undici. Usi la modalità compute quando dispone solo della base a dodici cifre e le servono entrambe le cifre di controllo per un modulo, una fattura o un'importazione di dati anagrafici; usi la modalità validate quando un partner, un ERP o un utente invia un CNPJ completo a quattordici cifre e le serve un flag valid chiaro più la coppia attesa per i messaggi di errore.
Come si calcolano le cifre di controllo del CNPJ brasiliano
Un CNPJ ha sempre quattordici cifre quando è scritto senza punteggiatura. Le prime otto formano il numero di iscrizione radice assegnato alla persona giuridica; le successive quattro identificano la filiale (0001 è la filiale abituale della sede); le ultime due sono cifre di controllo e non si scelgono mai liberamente.
Per calcolare la prima cifra di controllo, moltiplichi le dodici cifre base per la sequenza di pesi 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2 da sinistra a destra, sommi i prodotti, prenda tale somma modulo undici e mappi il resto: se il resto è minore di due la cifra è zero, altrimenti è undici meno il resto.
Per calcolare la seconda cifra di controllo, aggiunga la prima alla base di dodici cifre e ripeta lo stesso mapping mod-11 con i tredici pesi 6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2. La stringa completa di quattordici cifre deve portare esattamente quelle due cifre finali. L'algoritmo è deterministico e locale: nessuna chiamata di rete alla Receita Federal, nessuna consultazione di catalogo e nessun orologio.
Rispetto ai validatori di ID fiscali multi-paese, l'intento di ricerca qui è stretto: chi ha bisogno del calcolatore di cifre di controllo CNPJ Brasile per basi a dodici cifre, non di un verificatore generale CPF o RFC.
Dove le cifre di controllo CNPJ si inseriscono nei flussi reali
I team finance e anagrafica ricevono basi aziendali interne a dodici cifre e devono aggiungere le cifre di controllo ufficiali del CNPJ prima di scrivere l'identificativo su fatture, file di pagamento bancario o profili venditore di marketplace che rifiutano ID fiscali non validi. I portali di conti fornitori convalidano CNPJ a quattordici cifre nell'onboarding dei fornitori così una sola trasposizione non crea un fornitore fantasma né uno scostamento di pagamento.
I job di qualità dei dati percorrono ogni colonna CNPJ in un export CRM o ERP, chiamano la modalità validate e mettono in quarantena le righe dove valid è false, catturando sia modifiche umane sia bug dei generatori. Non tratti un CNPJ che passa il controllo come prova di iscrizione attiva presso la Receita Federal o di un regime fiscale specifico; dimostra solo che le due cifre mod-11 sono coerenti con la base a dodici cifre sotto i pesi standard.
Casi d'uso
Revisionare le colonne CNPJ negli export ERP e CRM
Convalidi in batch ogni CNPJ a quattordici cifre in un file fornitori o clienti e metta in quarantena le righe la cui coppia di controllo non corrisponde più al valore atteso ricalcolato.
Domande frequenti
Cosa sono le cifre di controllo del CNPJ brasiliano?
Sono le ultime due cifre di un CNPJ a quattordici cifre, calcolate con due somme ponderate mod-11 successive così errori di digitazione e importazione sono di solito intercettati prima che l'identificativo sia memorizzato o stampato su una fattura.
Cosa succede con lunghezza errata, lettere o punteggiatura?
Basi tutte identiche sono rifiutate in compute; CNPJ completi tutti identici restituiscono valid false in validate. I task di validazione falliti non sono fatturati.
Lo strumento delle cifre di controllo CNPJ Brasile è gratuito?
Lo strumento nel browser è gratuito e gira in locale.
Cosa indicano i gruppi di cifre di un CNPJ?
Le prime otto cifre sono la radice dell'iscrizione dell'azienda, le quattro successive identificano la sede o la filiale, di solito 0001 per la sede principale, e le ultime due sono cifre di controllo mai scelte liberamente.
Un CNPJ valido significa che l'azienda è attiva?
No. Superare il controllo indica solo che le cifre sono coerenti con la regola modulo 11. Lo strumento non interroga la Receita Federal, quindi non prova che l'iscrizione sia attiva.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/enc/cnpj-brazil \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":"112223330001"}'const res = await fetch("https://api.kit.forhosting.com/enc/cnpj-brazil", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": "112223330001"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/cnpj-brazil",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": "112223330001"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/cnpj-brazil", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":"112223330001"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":"112223330001"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/cnpj-brazil", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"number": "112223330001"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.cnpj_brazil",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Input non numerici, lunghezze errate e stringhe di cifre tutte identiche falliscono con invalid_input o valid false invece di una pulizia silenziosa, così non memorizza mai un identificativo fiscale a metà. La stessa aritmetica pura gira gratis nel browser e al prezzo pubblicato dell'API.
Contratto di input, modalità e comportamento di errore
Invii un campo number che contenga solo caratteri da zero a nove. Una lunghezza errata è un errore esplicito che nomina la modalità e la lunghezza inviata —dodici per compute, quattordici per validate— così i moduli client possono mostrare «servono dodici cifre» senza indovinare. Stringhe vuote, number assente, valori di mode non validi e basi a dodici cifre tutte identiche in modalità compute falliscono prima che qualsiasi somma ponderata sia affidabile per l'archiviazione e non sono fatturate. Preferisca compute quando crea o completa identificativi aziendali; preferisca validate quando condiziona una ricerca o un'importazione a un CNPJ completo da un utente o un file partner. Spazi, punti, barre, trattini, lettere e punti decimali sono rifiutati come input non numerico con invalid_input così un valore pulito in silenzio non raggiunge mai l'archiviazione. La modalità compute è predefinita: il motore richiede esattamente dodici cifre, restituisce check_digits come stringa di due caratteri, restituisce check_digit_1 e check_digit_2 individualmente, e restituisce with_check come il CNPJ a quattordici cifre che Lei può stampare o persistere. La modalità validate richiede esattamente quattordici cifre; la risposta indica valid true quando entrambe le cifre finali coincidono con expected_check_digits ricalcolati e la stringa non è una sequenza tutta identica come quattordici zeri. Validate include sempre payload (le prime dodici cifre), le coppie di controllo date e attese, repeated_digits e length quattordici. Alias come digits, cnpj e code sono accettati per lo stesso campo di carico così le integrazioni che già parlano di «cnpj» non devono rinominare. Poiché il percorso è parse puro senza orologio, fonte casuale né rete, lo stesso corpo JSON produce sempre lo stesso risultato JSON sullo strumento gratuito del browser e sull'API a $0.002 per richiesta riuscita.
Dove le cifre di controllo CNPJ si inseriscono nei flussi reali
I moduli di registrazione e-commerce e B2B possono ricalcolare expected_check_digits e mostrare una correzione amichevole quando un'azienda brasiliana incolla un numero con l'ultima coppia digitata male.
Casi di integrazione
Completare una base CNPJ a 12 cifre per le fatture
Chiami la modalità compute con la base a dodici cifre, memorizzi with_check e inserisca il CNPJ a quattordici cifre nella NFe, nel file di bonifico o nel profilo venditore del marketplace.
Convalidare CNPJ completi digitati o importati all'ingresso
Quando un modulo o un CSV invia quattordici cifre, chiami la modalità validate e blocchi il salvataggio se valid è false, mostrando expected_check_digits per correggere un singolo refuso.
Domande tecniche
Come calcola le cifre di controllo CNPJ con questa API?
Esegua un POST con number esattamente a dodici cifre e mode compute (o ometta mode). La risposta include check_digits, check_digit_1, check_digit_2 e with_check (il CNPJ completo a quattordici cifre).
Come convalida un CNPJ completo a quattordici cifre?
Esegua un POST con la stringa di quattordici cifre e mode validate. La risposta include valid, check_digits, expected_check_digits, payload (cifre senza l'ultima coppia) e repeated_digits.