Cifra di controllo REGON Polonia
Inserisca la base 12345678 e ottenga la cifra di controllo 5: il REGON completo è 123456785. Lo strumento convalida anche numeri di 9 e 14 cifre, compresa la parte dell'ente principale dentro un'unità locale, e intercetta gli errori di battitura. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Numero
- 12345678
- Modalità di calcolo
- Compute
- Input
- 12345678
- Forma
- 9
- Cifra di controllo
- 5
Il REGON è il numero di identificazione statistica polacco assegnato da Główny Urząd Statystyczny (GUS) nel Registro ufficiale nazionale dell'attività economica (Rejestr Gospodarki Narodowej). La maggior parte delle entità riceve un REGON a nove cifre; le unità locali di organizzazioni multi-sede ricevono un REGON a quattordici cifre le cui prime nove coincidono con l'entità madre. La cifra finale di ciascuna forma è una cifra di controllo prodotta con pesi ufficiali fissi e una regola modulo undici che trasforma il resto dieci in zero. Questa capacità implementa solo quella regola: la modalità compute accetta otto cifre base per un REGON a nove o tredici cifre base per uno a quattordici e restituisce la cifra di controllo più il numero completo; la modalità validate accetta una stringa completa di nove o quattordici cifre e indica se la cifra finale corrisponde al valore atteso ricalcolato.
Come si calcola la cifra di controllo REGON (forme a 9 e 14 cifre)
Secondo la specifica GUS, un REGON standard ha sempre nove cifre decimali. Per calcolarla, moltiplichi quelle otto cifre per la sequenza ufficiale di pesi otto, nove, due, tre, quattro, cinque, sei, sette, sommi i prodotti e prenda la somma modulo undici. Se il resto è dieci, la cifra di controllo è zero; altrimenti il resto stesso è la cifra di controllo.
Un REGON a quattordici cifre estende la forma a nove con cinque cifre extra che identificano un'unità locale di un'organizzazione multi-sede. Quella cifra finale usa una sequenza ufficiale di pesi diversa sui primi tredici cifre: due, quattro, otto, cinque, zero, nove, sette, tre, sei, uno, due, quattro, otto. Di nuovo la somma è presa modulo undici e il resto dieci diventa zero.
La convalida ricalcola la cifra attesa per la lunghezza inviata e la confronta con l'ultimo carattere; per i numeri a quattordici cifre questo strumento segnala anche se il REGON madre a nove cifre incorporato supera ancora il proprio controllo, così una testata corrotta non resta nascosta dietro una cifra finale fortunata. L'algoritmo è deterministico e locale: nessuna chiamata al registro REGON, nessun orologio e nessuna casualità.
Rispetto a strumenti Luhn o PESEL generici, l'intento di ricerca qui è stretto: chi ha bisogno di un calcolatore della cifra di controllo REGON Polonia per basi di otto o tredici cifre, o di un validatore REGON a nove e quattordici cifre, non di uno strumento di identità personale o di pagamento.
Dove le cifre di controllo REGON si inseriscono nei flussi aziendali polacchi
Le piattaforme di contabilità e fatturazione elettronica ricevono basi interne di otto cifre durante l'onboarding in sandbox e devono aggiungere la cifra di controllo ufficiale GUS prima che un REGON compaia su fatture, esportazioni JPK o elenchi di fornitori. I marketplace e i portali B2B convalidano i numeri REGON a nove cifre alla registrazione dei fornitori così una sola trasposizione non crea un'entità fantasma e un documento KSeF o EDI rifiutato.
Gli operatori della vendita al dettaglio e della logistica multi-sede ricalcolano la cifra di controllo a quattordici cifre dell'unità locale quando un magazzino o una filiale viene aggiunta sotto un REGON madre, e ricontrollano la testata incorporata a nove cifre affinché i file di unità locale non divergono dal record madre.
I job ETL che caricano file anagrafici di fornitori scandiscono ogni colonna REGON in un export CSV o ERP, chiamano la modalità validate e mettono in quarantena le righe dove valid è false — catturando sia modifiche umane sia bug dei generatori.
Casi d'uso
Revisionare le colonne REGON nei dati anagrafici dei fornitori
Convalidi in batch ogni REGON a nove e quattordici cifre in un CSV di ERP, CRM o fatturazione elettronica e metta in quarantena le righe la cui cifra di controllo non corrisponde più al valore atteso ricalcolato.
Domande frequenti
Che cos'è una cifra di controllo REGON?
È la cifra finale di un numero statistico REGON polacco, calcolata con i pesi ufficiali GUS e una regola mod-11 (il resto dieci diventa zero), così gli errori di digitazione e di scansione vengono di solito rilevati prima che il numero sia archiviato o fatturato.
Cosa succede con lunghezza errata, lettere o trattini?
Le attività di convalida fallite non vengono fatturate.
Lo strumento della cifra di controllo REGON è gratuito?
Lo strumento browser è gratuito e viene eseguito in locale.
Che cos'è un REGON di 14 cifre?
Identifica un'unità locale, come una filiale o un magazzino, di un'organizzazione con più sedi. Le prime nove cifre sono il REGON dell'ente principale, altre quattro indicano l'unità e l'ultima è una seconda cifra di controllo con pesi propri.
Un REGON valido significa che l'azienda è attiva?
No. Una cifra di controllo corretta mostra solo che il numero è ben formato. Lo strumento non consulta il registro ufficiale, quindi non può dire se l'ente è attivo, autorizzato o ancora iscritto.
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/regon-poland \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":"12345678"}'const res = await fetch("https://api.kit.forhosting.com/enc/regon-poland", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": "12345678"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/regon-poland",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": "12345678"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/regon-poland", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":"12345678"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":"12345678"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/regon-poland", 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": "12345678"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.regon_poland",
"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
L'input non numerico e le lunghezze errate falliscono con invalid_input invece di un taglio silenzioso, così Lei non persiste mai un identificatore a metà. La stessa aritmetica pura viene eseguita gratis nel browser e al prezzo API pubblicato, senza consultazione di rete del registro REGON e senza affermare che un checksum valido significhi che l'entità è attiva, autorizzata o ancora iscritta.
Come si calcola la cifra di controllo REGON (forme a 9 e 14 cifre)
Le posizioni da uno a otto formano il payload emesso per l'entità giuridica o l'unità; la posizione nove è la cifra di controllo. Le posizioni da uno a nove sono il REGON madre (inclusa la sua cifra di controllo); le posizioni da dieci a tredici sono il payload dell'unità locale; la posizione quattordici è una seconda cifra di controllo.
Contratto di input, modalità e comportamento di errore
Invii un campo number che contenga solo i caratteri da zero a nove. Una lunghezza errata è un errore esplicito che nomina la modalità e la lunghezza inviata — otto o tredici per compute, nove o quattordici per validate — così i moduli client possono mostrare un messaggio chiaro senza indovinare. Stringhe vuote, number assente e valori di mode non validi falliscono prima di qualsiasi somma ponderata e non vengono fatturati. Le attività di convalida che rifiutano una forma errata non vengono addebitate; una stringa ben formata di nove o quattordici cifre che ha semplicemente la cifra di controllo sbagliata restituisce valid false senza generare eccezione. Spazi, trattini, lettere e punti decimali sono rifiutati come input non numerico con invalid_input affinché un valore silenziosamente troncato non raggiunga mai l'archiviazione. La modalità compute è quella predefinita: il motore richiede esattamente otto cifre per un REGON a nove o esattamente tredici cifre per uno a quattordici, restituisce check_digit come stringa di un carattere, restituisce with_check come il numero completo che Lei può stampare o persistere, e restituisce anche form (nove o quattordici), length e il vettore dei pesi usato per le tracce di audit. Quando calcola un REGON a quattordici cifre da tredici, la risposta include anche base9 e base9_valid così Lei vede se la testata incorporata a nove cifre corrisponde ancora ai pesi ufficiali su otto cifre. La modalità validate accetta esattamente nove o quattordici cifre; la risposta indica valid true quando la cifra finale corrisponde a expected_check_digit ricalcolato, e include sempre payload (cifre senza l'ultima), check_digit, expected_check_digit, form e length. Per la convalida a quattordici cifre, base9_valid e trailing_valid devono essere entrambi true per valid true, così un REGON madre danneggiato non viene mai accettato solo perché la quattordicesima cifra coincide per caso. Alias come digits, regon e code sono accettati per lo stesso campo di carico, così le integrazioni che parlano già di «regon» non devono rinominare. Poiché il percorso è parse puro senza orologio, fonte casuale o rete, lo stesso corpo JSON produce sempre lo stesso risultato JSON sullo strumento browser gratuito e sull'API a $0.002 per richiesta riuscita.
Dove le cifre di controllo REGON si inseriscono nei flussi aziendali polacchi
Non tratti un REGON che supera il controllo come prova che l'entità è attiva nel registro REGON, registrata ai fini IVA o autorizzata per una data attività; dimostra solo che la cifra di controllo è coerente con il payload sotto i pesi ufficiali GUS usati per i numeri statistici polacchi.
Casi di integrazione
Completare una base REGON di 8 cifre per fixture di fattura
Chiami la modalità compute con otto cifre, memorizzi with_check e usi il REGON a nove cifre in fatture di test, campioni JPK o record di fornitori in sandbox.
Convalidare REGON digitati o importati all'ingresso
Quando un modulo, un feed partner o uno scanner invia nove o quattordici cifre, chiami la modalità validate e blocchi la registrazione se valid è false, mostrando expected_check_digit per correggere un singolo errore di battitura.
Domande tecniche
Come si calcola una cifra di controllo REGON con questa API?
Invii un POST con number impostato a esattamente otto cifre (REGON a nove) o tredici cifre (REGON a quattordici) e mode compute (oppure ometta mode). La risposta include check_digit, with_check, form e il vettore dei pesi usato.
Come si convalida un REGON completo a nove o quattordici cifre?
Invii un POST con la stringa di nove o quattordici cifre e mode validate. La risposta include valid, check_digit, expected_check_digit e payload (cifre senza l'ultima). La convalida a quattordici cifre segnala anche base9_valid per il REGON madre incorporato.