CASO DE USO

Valide funcionarios antes da rodada de folha de pagamento

O HRIS cadastra 200 funcionarios novos. A rodada mensal de folha os envia ao orgao de seguridade social. Cinco voltam com erro porque o CPF/CUIL/RFC esta mal formado na base — talvez um dado mal digitado no onboarding, talvez uma migracao legada com caracteres errados. Esses cinco funcionarios nao recebem este mes. Validar o formato do tax ID antes da folha converte esse problema operacional em uma correcao de dados.

Entrar na lista de espera Ler documentacao

O PROBLEMA

Erro de tax ID trava o pagamento do funcionario

Quando um batch de folha falha por tax ID malformado, a linha fica em estado de erro no orgao de seguridade social. O funcionario afetado precisa esperar a proxima rodada ou uma retificadora fora de ciclo — cenario que nenhum time de people ops quer.

Dados carregados sem validacao no cadastro

Na maioria dos HRIS, o tax ID e digitado no cadastro sem validacao de checksum. Um onboarding apressado, um copy/paste com caractere extra, e o dado fica errado ate a primeira folha — onde so entao o erro aparece.

Cada pais tem seu orgao e seu formato

BR usa CPF contra INSS. AR usa CUIL contra ANSES. MX usa RFC contra IMSS. CL usa RUT contra Previred. Cada um com seu algoritmo de digito verificador, suas regras de prefixo, seu esquema de rejeicao. Um time de payroll multi-pais multiplica o problema.

Retificadoras sao caras e visiveis

Quando um funcionario nao recebe por erro de dado em folha, chega rapido no inbox do CFO. Uma retificadora fora de ciclo custa tempo de financas, tempo de people ops e quebra confianca com o funcionario.

POR QUE AS SOLUCOES PADRAO NAO SAO SUFICIENTES

Por que o HRIS sozinho nao detecta isso

Validacao basica no HRIS

BambooHR, Workday e similares validam formato basico (comprimento, caracteres) mas nao implementam checksum correto para cada pais LATAM. Digitos verificadores ficam sem verificar no cadastro.

Confiar na rejeicao do orgao

INSS/ANSES/IMSS retornam o erro so ao processar o batch — quando ja e tarde para corrigir antes da rodada.

Auditoria manual pre-batch

Revisar manualmente 500 tax IDs antes de cada folha nao escala. E os erros raros (DV invalido por transposicao de digito) sao os que mais facilmente passam.

COMO O NORMADATA AJUDA

Como o Normadata ajuda

Chame verify/tax-id no cadastro do funcionario no HRIS e opcionalmente como auditoria pre-batch antes da rodada mensal. Se valid=false, o funcionario fica com flag de revisao antes de chegar ao orgao.

Complemente com verify/bank para validar Pix/CBU/CLABE do funcionario antes do deposito — um salario rebatido por chave Pix malformada e o mesmo problema operacional sob outro angulo.

Uma API, mesmo schema para CPF (BR), CUIL (AR), RFC (MX), RUT (CL). Sua integracao no HRIS nao quebra ao expandir para um novo pais.

VEJA EM ACAO

Veja em acao

# Validate CUIL before payroll run (liquidacion AR)
$ curl -X POST api.normadata.io/v1/verify/tax-id \
  -H "X-API-Key: nd_a8f3b2c1d4e5f6g7h8i9j0k1l2m3n4o5" \
  -d '{"country":"AR","type":"cuil","value":"20-31456789-0"}'

{
  "valid": true,
  "normalized": "20314567890",
  "identifier": {
    "type": "CUIL",
    "contributor_type": "persona_fisica"
  }
}

# Then validate the CBU for the salary deposit
$ curl -X POST api.normadata.io/v1/verify/bank \
  -H "X-API-Key: nd_..." \
  -d '{"country":"AR","type":"cbu","value":"0170099220000067802779"}'

LIMITACOES

O que o Normadata nao faz aqui

—O Normadata nao se conecta a INSS, ANSES, IMSS, Previred nem a qualquer orgao de seguridade social. Nao cadastra funcionarios, nao consulta historico trabalhista, nao calcula contribuicoes nem retencoes.

—O Normadata nao processa pagamentos. A transferencia do salario via banco, carteira ou rail e responsabilidade do seu sistema de folha. Validamos o dado antes.

Ver limitacoes completas

PERGUNTAS FREQUENTES

Perguntas frequentes

Integra com BambooHR, Workday ou Senior?

Nao temos integracoes nativas. A forma normal de usar o Normadata a partir de um HRIS e via middleware ou webhook: quando um funcionario e criado ou modificado, sua integracao chama o Normadata, e se valid=false e marcado para revisao.

Valida historico trabalhista ou so o formato atual?

Apenas o formato atual do tax ID. Se o funcionario tem um CPF bem formado mas esta inativo no INSS, o Normadata nao tem como saber — isso exige consulta ao orgao, que nao fazemos.

Ver validadores →

See endpoint in docs →

Integre o Normadata no seu stack

Acesso antecipado. Entre na lista e daremos acesso à API.

Entrar na lista de espera Ler documentacao