Dígito verificador RUC Equador

Caracteres não numéricos, comprimentos incorretos, códigos de província inválidos e terceiros dígitos reservados são rejeitados com um erro invalid_input claro. Execute grátis no navegador ou chame a API do KIT; ambos os caminhos compartilham a mesma aritmética pura, sem ida e volta de rede e sem consulta ao registro do SRI.

Como funcionam os tipos de RUC e os dígitos de controle no Equador

Como cada passo é aritmética modular de pesos fixos, os mesmos treze dígitos sempre produzem o mesmo veredito de validade no navegador, no Worker ou em um harness offline — por isso a capacidade é publicada como motor parse de nível A e não como chamada a um modelo nem consulta ao vivo ao SRI.

Como validar um RUC com esta API

Envie um campo ruc que contenha apenas caracteres de zero a nove e tenha exatamente treze dígitos. Cadeias vazias, ruc ausente, comprimentos diferentes de treze, códigos de província fora de zero-um a vinte e quatro e trinta, e terceiros dígitos sete ou oito falham antes de qualquer soma ponderada e não são faturados. Prefira esta capacidade quando precisar do relatório de tipo específico do Equador e do roteamento oficial dual módulo dez / módulo onze; um verificador genérico de formato de ID fiscal multi-país não aplicará os ramos do terceiro dígito do SRI nem as regras de estabelecimento. Espaços, pontos, hífens, letras e pontos decimais são rejeitados como entrada não numérica com invalid_input para que um formulário nunca aceite um valor limpo em silêncio: remova qualquer máscara de formatação no seu cliente antes da chamada. Em caso de sucesso, o motor devolve ruc como cadeia de dígitos normalizada, valid como booleano, type como um de natural_person, public_entity ou private_company, type_label como descrição breve, third_digit, province_code, algorithm como modulo_10 ou modulo_11, check_position (nove ou dez), check_digit conforme enviado, expected_check_digit quando um dígito decimal pôde ser calculado, establishment como bloco de filial final, length treze e algorithm_id ruc_ecuador. Valid é true apenas quando o dígito de controle coincide e o bloco de estabelecimento está no intervalo não nulo permitido para esse tipo; um dígito errado ainda devolve um payload estruturado com valid false para que você possa mostrar «esperado X, obtido Y» sem uma segunda requisição. Como o caminho é parse puro, sem relógio, fonte aleatória ou rede, a mesma entrada sempre produz o mesmo JSON na ferramenta gratuita do navegador e na API. A US$ 0,002 por solicitação bem-sucedida você pode proteger importações em massa de CRM, portões de faturamento eletrônico e auditorias de arquivos de parceiros sem negociar um nível personalizado.

Onde a validação do RUC se encaixa em fluxos reais de produto

Os fluxos de onboarding de fintech e marketplaces equatorianos pedem o RUC cedo; validar dígitos de controle e tipo no blur reduz envios falhos e tickets de suporte sem chamar o SRI a cada tecla. Sistemas contábeis e de faturamento eletrônico que emitem comprobantes electrónicos devem colocar em quarentena linhas cujo dígito de controle já não coincida ou cujo bloco de estabelecimento seja todo zeros antes de o documento chegar à autorização. Não trate um dígito de controle correto como prova de que o contribuinte existe nos sistemas do SRI, de que o RUC está ativo ou de que o estabelecimento está autorizado a emitir faturas — só prova que a cadeia de treze dígitos está aritmeticamente bem formada sob as regras oficiais dependentes do tipo, o mesmo critério de honestidade que se aplica a qualquer ferramenta de checksum fiscal. Importações de folha e RH de contratados independentes podem condicionar o armazenamento a valid true e exibir type_label para que o operador veja se o número é pessoa natural, sociedade privada ou entidade pública. Trabalhos de qualidade de dados recalculam expected_check_digit para cada coluna RUC de uma exportação ERP e marcam divergências antes de chegarem à declaração fiscal ou aos arquivos de retenção.