Validar CPF e CNPJ
Confere os dígitos verificadores de um CPF ou CNPJ e devolve o número formatado.
CPF é o documento de pessoa física no Brasil (11 dígitos) e CNPJ o de pessoa jurídica (14 caracteres). Os dois terminam em dígitos verificadores calculados a partir dos demais. Estas rotas conferem só essa conta, sem consultar a Receita Federal: um número pode estar "válido" e não existir de verdade. Servem para avisar o cliente de um erro de digitação antes de enviar o formulário.
Exigem o módulo cpf-cnpj-validation ligado na loja.
Validar CPF
/api/v1/storefront/validate/cpfPúblicaValida um CPF
Corpo da requisição
cpfstringobrigatórioCPF do cliente com ou sem pontuação.
Exemplo de requisição
Resposta
200CPF válido
200CPF inválido (ainda é 200)
Campos da resposta
validbooleantrue quando os dígitos verificadores conferem. Sequências de um dígito só (111.111.111-11) são sempre inválidas.formattedstringO CPF no formato
000.000.000-00 sempre que o texto tem exatamente 11 dígitos, mesmo que seja inválido. Com outra quantidade de dígitos, volta o texto enviado, sem mudança.Erros
| Status | Quando | Corpo |
|---|---|---|
| 400 | Corpo que não é JSON. | {"error":"invalid request body"} |
| 403 | Módulo cpf-cnpj-validation desligado. | {"error":"module_disabled","module":"cpf-cnpj-validation"} |
Validar CNPJ
/api/v1/storefront/validate/cnpjPúblicaValida um CNPJ
Corpo da requisição
cnpjstringobrigatórioCNPJ da empresa com ou sem pontuação.
Exemplo de requisição
Resposta
200CNPJ válido
Campos da resposta
validbooleantrue quando os dígitos verificadores conferem. Aceita o CNPJ alfanumérico (letras e números); letras minúsculas são tratadas como maiúsculas. Sequências de um caractere só são inválidas.formattedstringO CNPJ no formato
00.000.000/0000-00 quando tem 14 caracteres válidos; caso contrário volta o texto enviado.Erros
| Status | Quando | Corpo |
|---|---|---|
| 400 | Corpo que não é JSON. | {"error":"invalid request body"} |
| 403 | Módulo cpf-cnpj-validation desligado. | {"error":"module_disabled","module":"cpf-cnpj-validation"} |