Cifra controllo RUC Ecuador

Caratteri non numerici, lunghezze errate, codici provincia non validi e terze cifre riservate vengono rifiutati con un errore invalid_input chiaro. La esegua gratis nel browser o chiami l'API KIT; entrambi i percorsi condividono la stessa aritmetica pura, senza andata e ritorno di rete né consultazione del registro SRI.

Come funzionano i tipi di RUC e le cifre di controllo in Ecuador

Poiché ogni passo è aritmetica modulare a pesi fissi, le stesse tredici cifre producono sempre lo stesso verdetto di validità nel browser, nel Worker o in un harness offline: per questo la capacità è pubblicata come motore parse di livello A e non come chiamata a un modello né query SRI in tempo reale.

Come convalidare un RUC con questa API

Invii un campo ruc che contenga solo caratteri da zero a nove e sia lungo esattamente tredici cifre. Stringhe vuote, ruc assente, lunghezze diverse da tredici, codici provincia fuori da zero-uno a ventiquattro e trenta, e terze cifre sette o otto falliscono prima di qualsiasi somma ponderata e non vengono fatturati. Preferisca questa capacità quando le serve il reporting di tipo specifico per l'Ecuador e il routing ufficiale duale modulo dieci / modulo undici; un controllore generico di formato ID fiscale multi-paese non applicherà i rami della terza cifra SRI né le regole di stabilimento. Spazi, punti, trattini, lettere e punti decimali vengono rifiutati come input non numerico con invalid_input affinché un modulo non accetti mai un valore ripulito in silenzio: rimuova qualsiasi maschera di formattazione nel client prima della chiamata. In caso di successo il motore restituisce ruc come stringa di cifre normalizzata, valid come booleano, type come uno tra natural_person, public_entity o private_company, type_label come breve descrizione, third_digit, province_code, algorithm come modulo_10 o modulo_11, check_position (nove o dieci), check_digit come inviato, expected_check_digit quando è stato possibile calcolare una cifra decimale, establishment come blocco filiale finale, length tredici e algorithm_id ruc_ecuador. Valid è true solo quando la cifra di controllo coincide e il blocco stabilimento è nell'intervallo non nullo consentito per quel tipo; una cifra errata restituisce comunque un payload strutturato con valid false così può mostrare «atteso X, ricevuto Y» senza una seconda richiesta. Poiché il percorso è parse puro, senza orologio, sorgente casuale né rete, lo stesso input produce sempre lo stesso JSON nello strumento gratuito del browser e sull'API. A $0.002 per richiesta riuscita può proteggere importazioni massicce di CRM, gate di fatturazione elettronica e audit di file partner senza negoziare un livello personalizzato.

Dove la convalida del RUC si inserisce nei flussi di prodotto reali

I flussi di onboarding fintech e marketplace in Ecuador chiedono il RUC presto; convalidare cifre di controllo e tipo al blur riduce invii falliti e ticket di supporto senza chiamare l'SRI a ogni battuta. I sistemi contabili e di fatturazione elettronica che emettono comprobantes electrónicos devono mettere in quarantena le righe la cui cifra di controllo non coincide più o il cui blocco stabilimento è tutto zeri prima che il documento raggiunga l'autorizzazione. Non tratti una cifra di controllo corretta come prova che il contribuente esista nei sistemi SRI, che il RUC sia attivo o che lo stabilimento sia autorizzato a emettere fatture: dimostra solo che la stringa a tredici cifre è aritmeticamente ben formata secondo le regole ufficiali dipendenti dal tipo, lo stesso livello di onestà che si applica a qualsiasi strumento di checksum fiscale. Le importazioni payroll e HR di collaboratori indipendenti possono condizionare l'archiviazione a valid true e mostrare type_label affinché l'operatore veda se il numero è persona fisica, società privata o ente pubblico. I job di qualità dei dati ricalcolano expected_check_digit per ogni colonna RUC di un export ERP e segnalano le discrepanze prima che raggiungano la dichiarazione fiscale o i file di ritenuta.