Brcpfcnpj

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #llm #android #rust #docker #kubernetes #awesome-list #vue #ios #mcp #openai #open-source

(★ 79)

Validação,Formatação e Gerador Cpf/Cnpj em Elixir

File Explorer

Download Latest Version (.zip)

- - elixir.yml
- config.exs
- brcpfcnpj.ex
- changeset.ex
- cpfcnpj.ex
- brcpfcnpj_test.exs
- changeset_test.exs
- cnpj_test.exs
- cpf_test.exs
- test_helper.exs
.formatter.exs
.gitignore
.tool-versions
LICENSE
mix.exs
mix.lock
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Brcpfcnpj

![Build Status](https://github.com/williamgueiros/Brcpfcnpj/actions/workflows/elixir.yml/badge.svg)
[![Inline docs](http://inch-ci.org/github/williamgueiros/Brcpfcnpj.svg?branch=master)](http://inch-ci.org/github/williamgueiros/Brcpfcnpj)

Coleção de funções para validação e formatação de CPF e CNPJ. Veja a
[documentação online](http://hexdocs.pm/brcpfcnpj/).

## Como usar

Adicione ao `mix.exs` do seu projeto:

```elixir
defp deps do
  [{:brcpfcnpj, "~> 1.0.0"}]
end
```

## Validação de CPF/CNPJ

As funções recebem `Strings` representando o número do CPF ou CNPJ e verificam a validade destes números usando dois
critérios:

1. O formato da String, que deve seguir o padrão `XX.XXX.XXX/XXXX-XXX`, onde `X` pode ser qualquer dígito de `0` a `9`,
sendo os traços `-`, barra `/` e pontos `.` opcionais.
2. O conteúdo numérico desta String, validado através do cálculo do `módulo 11` dos dígitos que compõem a String.

A função `Brcpfcnpj.cpf_valid?/1` verifica se uma String é um CPF válido:

```elixir
cpf = "11144477735"
Brcpfcnpj.cpf_valid?(cpf) # ==> true

cpf = "111.444.777-35"
Brcpfcnpj.cpf_valid?(cpf) # ==> true

````

A função `Brcpfcnpj.cnpj_valid?/1` verifica se uma String é um CNPJ válido:

```elixir
cnpj = "69103604000160"
Brcpfcnpj.cnpj_valid?(cnpj)# ==> true

cnpj = "69.103.604/0001-60"
Brcpfcnpj.cnpj_valid?(cnpj)# ==> true

cnpj = "12ABC34501DE35"
Brcpfcnpj.cnpj_valid?(cnpj)# ==> true
````

## Formatando a String

As funções `Brcpfcnpj.cpf_format/1` e `Brcpfcnpj.cnpj_format` retornam a String válida no devido formato. Se a String
não for válida, as funções retornam nil.

```elixir
cpf = "11144477735"
Brcpfcnpj.cpf_format(cpf)  # ==>"111.444.777-35"

cpf = number: "11144477734"
Brcpfcnpj.cpf_format(cpf)  # ==> nil

````

```elixir
cnpj = "69103604000160"
Brcpfcnpj.cnpj_format(cnpj) # ==>"69.103.604/0001-60"

cnpj = "69103604000161"
Brcpfcnpj.cnpj_format(cnpj) # ==> nil
````

## Gerando números CPF e CNPJ

Use as funções `Brcpfcnpj.cpf_generate/1` e `Brcpfcnpj.cnpj_generate/1` para gerar CPFs e CNPJs válidos. O parâmetro indica se os números devem ser formatados.

```elixir
Brcpfcnpj.cpf_generate(true)
"468.535.974-78"

Brcpfcnpj.cnpj_generate(true)
"45.044.251/6215-69"

Brcpfcnpj.cnpj_generate(true)
"6K.ZBP.GHM/4V7K-39"
````

Sem formatação:

```elixir
Brcpfcnpj.cpf_generate()
"02239513403"

Brcpfcnpj.cnpj_generate()
"17463578863541"

Brcpfcnpj.cnpj_generate()
"HKW8ZUAH582899"
````

## Ecto

O modulo `Brcpfcnpj.Changeset` contém algumas funções que podem ser utilizadas em conjunto com a API de Changesets
do Ecto.

```elixir
import Brcpfcnpj.Changeset

def changeset(model, params \\ :empty) do
  model
  |> cast(params, @required_fields, @optional_fields)
  |> validate_cnpj(:cnpj)
  |> validate_cpf(:cpf)
end
```

Por padrão esses validadores adicionam a mensagem "Invalid CNPJ/CPF" na lista de erros. Essa mensagem pode ser
configurada com o parâmetro `message`:

```elixir
validate_cnpj(:cnpj, message: "Cnpj Inválido")
```

Em caso de duvida [veja mais detalhes](https://github.com/williamgueiros/Brcpfcnpj/issues/3#issuecomment-191368591).

## CNPJ alfanuméricos

A partir de janeiro de 2026 será possivel ter caracteres alfanuméricos no CNPJ. Essa biblioteca tem suporte para esses caracteres a partir da versão 2.0.0.
Por favor atualizem a versão antes do prazo entrar em efeito senão poderá acontecer falsos negativos nas validações.

## Contribuições

* [Diogo Beda](https://github.com/diogobeda)
* [Tiago Henrique Engel](https://github.com/tiagoengel)
* [Prakash](https://github.com/prem-prakash)
* [João Thallis](https://github.com/joaothallis)
* [Esdras](https://github.com/esdras)
* [Vítor Trindade](https://github.com/VitorTrin)

## Agradecimentos

Inspirado na gem [brcpfcnpj](https://github.com/tapajos/brazilian-rails/tree/master/brcpfcnpj).

Brcpfcnpj

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Brcpfcnpj

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README