DocsBR - Brazilian Document Validation Library

A lightweight, independent .NET library for validating Brazilian documents without external dependencies.

Features

✅ CPF - Brazilian individual taxpayer ID validation
✅ CNPJ - Brazilian company taxpayer ID validation
✅ Phone - Brazilian phone number validation with real DDDs
✅ RG - Brazilian identity document validation
✅ CEP - Brazilian postal code validation
✅ CNH - Brazilian driver license validation

Installation

dotnet add package docsbr-br

Or via Package Manager Console:

Install-Package docsbr-br

Or add to your .csproj:

<ItemGroup> <PackageReference Include="docsbr-br" Version="1.0.0" /> </ItemGroup>

Quick Start

using DocsBR.Library; var docsbr = new DocsbrValidator(); // Validate CPF bool isValidCpf = docsbr.ValidarCpf("123.456.789-09"); // Validate CNPJ bool isValidCnpj = docsbr.ValidarCnpj("12.345.678/0001-90"); // Validate Phone bool isValidPhone = docsbr.ValidarTelefone("(11) 98765-4321"); // Validate RG bool isValidRg = docsbr.ValidarRg("123456789"); // Validate CEP bool isValidCep = docsbr.ValidarCep("01310-100"); // Validate CNH bool isValidCnh = docsbr.ValidarCnh("12345678901"); // Generic validation method bool isValid = docsbr.Validar("cpf", "123.456.789-09");

Validation Details

CPF (Individual Taxpayer ID)

• Format: XXX.XXX.XXX-XX (11 digits)
• Check: Official algorithm with modulo-11
• Rejects: Sequential digits (111.111.111-11)

CNPJ (Company Taxpayer ID)

• Format: XX.XXX.XXX/XXXX-XX (14 digits)
• Check: Official algorithm with weighted multiplication
• Validation: Complete check-digit verification

Phone (Telefone)

• Format: Supports multiple formats with DDD
• DDD: Validates against all 27 Brazilian area codes
• Types: Supports fixed (10 digits) and mobile (11 digits with 9)

RG (Identity Document)

• Format: 7-9 digits with optional final X
• Standard: SP (São Paulo) check-digit algorithm
• Validation: Digit verification based on official rules

CEP (Postal Code)

• Format: XXXXX-XXX or 8 digits
• Range: 01000-000 to 99999-999
• Rejects: Invalid sequences and out-of-range codes

CNH (Driver License)

• Format: 11 digits
• Check: Complex 2-digit verification with DSC (desconto) adjustment
• Validation: Official CNH algorithm

Features Highlight

🔒 No External Dependencies - Pure .NET validation logic
⚡ High Performance - Optimized algorithms
🇧🇷 Official Standards - Uses official Brazilian government algorithms
✅ Comprehensive - Validates 6 document types
📝 Easy to Use - Simple, intuitive API

License

MIT License

Author

Igor Pieralini

Support

For issues and feature requests, visit: https://github.com/igorpieralini/docsbr-API