gnbaron / brcpfcnpj

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

#Brcpfcnpj

Link para documentação.

##Validar Cpf/Cnpj

Foi inspirado na Gem * brcpfcnpj

Recebem strings representando números de cpf/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-xx, onde 'x' pode ser qualquer dígito de 0 a 9 e os traços (-), barra (/) e pontos (.) são opcionais.
2. O conteúdo numérico desta string, que é validado através do cálculo do 'módulo 11' dos dígitos que compõem a string.

Validando numeros de cpf

cpf = %Cpf{number: "11144477735"}
Brcpfcnpj.cpf_valid?(cpf) # ==> true

cpf = %Cpf{number: "111.444.777-35"}
Brcpfcnpj.cpf_valid?(cpf) # ==> true

Validando numero de cnpj

cnpj = %Cnpj{number: "69103604000160"}
Brcpfcnpj.cnpj_valid?(cnpj)# ==> true

cnpj = %Cnpj{number: "69.103.604/0001-60"}
Brcpfcnpj.cnpj_valid?(cnpj)# ==> true

##Formatando a String Existe a possibilidade de alem de validar, ter o retorno da String formatada. Caso a mesma seja valida terá o retorno da String em seu devido formato 69.103.604/0001-60. caso contratio tera de retorno nil.

cpf = %Cpf{number: "11144477735"}      
Brcpfcnpj.cpf_format(cpf)  # ==>"111.444.777-35"

cpf = %Cpf{number: "11144477734"}
Brcpfcnpj.cpf_format(cpf)  # ==> nil

cnpj = %Cnpj{number: "69103604000160"}
Brcpfcnpj.cnpj_format(cnpj) # ==>"69.103.604/0001-60"

cnpj = %Cnpj{number: "69103604000161"}
Brcpfcnpj.cnpj_format(cnpj) # ==> nil

##Gerador de Cpf e Cnpj

Gerando o Cpf e Cnpj com formatação

Brcpfcnpj.cpf_generate true
"468.535.974-78"

Brcpfcnpj.cnpj_generate true
"45.044.251/6215-69"

Gerando o Cpf e Cnpj sem formatação

Brcpfcnpj.cpf_generate
"02239513403"

Brcpfcnpj.cnpj_generate
"17463578863541"

Utilizando em conjunto com o Ecto

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

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" a lista de erros. Essa mensagem pode ser configurada com o parâmetro "message".

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

Em caso de duvida de uso recomendo está leitura mais

Contribuição

Diogo Beda, Tiago Henrique Engel