DocsBRValidator 1.2.0 Prefix Reserved

Install-Package DocsBRValidator -Version 1.2.0
dotnet add package DocsBRValidator --version 1.2.0
<PackageReference Include="DocsBRValidator" Version="1.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add DocsBRValidator --version 1.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: DocsBRValidator, 1.2.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install DocsBRValidator as a Cake Addin
#addin nuget:?package=DocsBRValidator&version=1.2.0

// Install DocsBRValidator as a Cake Tool
#tool nuget:?package=DocsBRValidator&version=1.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

DocsBRValidator

Primeiramente, obrigado pelo interesse em utilizar este pacote!

Caso queira consultar uma documentação mais completa, basta clicar aqui!.

Mas então, como usar o DocsBRValidator?

Após instalar o pacote em seu projeto, a utilização dele é bastante simples, vamos lá.

Validando um CPF

Para validar um número de CPF, por exemplo, basta importar o DocumentValidator na classe em que vai utilizar:

using DocumentValidator;

Após isso, utilizaremos o CpfValidation.Validate() informando o CPF a ser validado, como no singelo exemplo abaixo:

using System;
using DocumentValidator;

namespace ValidatorTest
{
    class Program
    {
        static void Main(string[] args)
        {
            if (CpfValidation.Validate("012.123.123-00"))
                Console.WriteLine("CPF Válido!");
            else
                Console.WriteLine("CPF Inválido!");
        }
    }
}

E em quais formatos posso enviar o CPF?

O CPF, assim como todos os demais documentos, podem ser enviados com ou sem máscara.

Não importa se o documento informado, como por exemplo o CPF, está no formato 012.123.123-00, 01212312300, 01.2123-12300, etc... a validação vai funcionar corretamente.

E para validar outros documentos?

A validação dos demais tipos de documentos suportados ocorre semelhante a do CPF.

Para validar um Titulo de Eleitor, por exemplo, utilizaremos TituloEleitorValidation.Validate(), passando o numero do título, com ou sem máscara como parâmetro. Ex: TituloEleitorValidation.Validate("038361610124").

IMPORTANTE! Existe apenas uma diferença na validação de Inscrição Estadual

Devido a cada estado ter autonomia para a criação de regras de validação, se faz necessário o envio da UF juntamente com o número da inscrição.

Para validar uma Inscrição Estadual, por exemplo, utilizaremos InscricaoEstadualValidation.Validate(), passando o numero da inscrição, com ou sem máscara, e o código da UF como parâmetros. Ex: InscricaoEstadualValidation.Validate("715.626.867.315", "SP").

(*)Para inscrições de produtor rural no estado de SP, é necessário adicionar ao início da inscrição, a letra 'R', como por exemplo: InscricaoEstadualValidation.Validate("R71562686731", "SP").

Retornos esperados

No momento, não existe possibilidade de retorno com mensagem de erro personalizável (mas terá!).

O retorno destas validações é do tipo boolean, retornando true quando o documento estiver correto e false, caso contrário.

Validações já inclusas

Até o momento, o DocsBrValidator conta com as seguintes validações:

Tipo de Validação Método
Validação de CPF CpfValidation.Validate()
Validação de CNPJ CnpjValidation.Validate()
Validação de CNH CnhValidation.Validate()
Validação de PIS/PASEP PisValidation.Validate()
Validação de RG RGValidation.Validate()
Validação de Titulo de Eleitor TituloEleitorValidation.Validate()
Validação de Inscrição Estadual(**) InscricaoEstadualValidation.Validate() (novo!)

(**) Para a validação de Inscrição estadual, devem ser enviados dois parâmetros do tipo string, um com a inscrição estadual e outro com o código da UF ("SP", "BA", "SC", etc...)

Todas as demais validações acima recebem uma string como parâmetro, contendo o documento com máscara ou não.

O que vem por aí?

As novas funcionalidades previstas incluem mas não se limitam a:

  • Validação de RNE;
  • Validação de CTPS;
  • Mensagens personalizáveis, de erro e de sucesso;
  • Entre outros...

Espero que disfrute deste pacote e lembre-se: Todo o feedback construtivo é válido!
Obrigado!
  • .NETCoreApp 3.1

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.0 191 10/24/2021
1.1.1 127 9/29/2021
1.1.0 134 9/29/2021
1.0.1 113 9/24/2021
1.0.0 73 9/20/2021

Melhorias e ciração de Summarys