Validação de CPF/CNPJ no Cadastro de Usuários via API

Implementamos uma validação obrigatória de CPF e CNPJ nos endpoints de criação e atualização de usuários da API Pública. A atualização garante a integridade dos dados desde o cadastro, prevenindo inconsistências no processo de faturamento, conciliação financeira e integrações de pagamento que dependem dessas informações para operar corretamente.

O que mudou?

Todos os endpoints que recebem dados de usuário geram agora uma validação condicional nos campos de documento.

1. Pessoa Física

O campo CPF não é obrigatório, mas caso seja informado, deve conter exatamente 11 dígitos. Tentativas de cadastro ou atualização com CPF preenchido com quantidade de dígitos incorreta serão rejeitadas com mensagem de erro.

2. Pessoa Jurídica

O campo CNPJ não é obrigatório, mas caso seja informado, deve conter exatamente 14 dígitos. As mesmas validações de tamanho se aplicam, com retorno de erro explícito em caso de dado inválido.

Endpoints afetados:

• POST/usuarios
• POST/usuarios/lote
• PUT/usuarios/usuarioId
• PUT/usuarios/email

Benefícios e Ganhos

🔒 Menos fraudes e chargebacks: Sistemas de antifraude e gateways de pagamento recebem os valores CPF/CNPJ desde o primeiro cadastro de forma assertiva, aumentando a confiabilidade das transações.

⚙️ Dados consistentes: A validação na entrada evita registros com documentos truncados ou inválidos, melhorando a qualidade da base de clientes e a precisão da conciliação financeira.