README

Pacote PHP para geracao e leitura de arquivos .DBK compativeis com o programa IRPF 2026 da Receita Federal do Brasil.

Requisitos

• PHP 8.2+
• Composer

Instalacao

composer require pereirapthiago/dbk-irrf

Uso Rapido

Gerar um arquivo DBK

use DbkIrrf\Aplicacao\Fabrica\FabricaDeclaracao;
use DbkIrrf\Aplicacao\Servico\GeradorDbk;
use DbkIrrf\Aplicacao\Servico\NomeadorArquivo;
use DbkIrrf\Dominio\DTO\RegistroRendimentosPJDTO;
use DbkIrrf\Dominio\Enum\EstadoCivil;
use DbkIrrf\Dominio\Enum\TipoDeclaracao;
use DbkIrrf\Dominio\Enum\UnidadeFederativa;
use DbkIrrf\Dominio\ValorObjeto\Cnpj;
use DbkIrrf\Dominio\ValorObjeto\Cpf;
use DbkIrrf\Dominio\ValorObjeto\Data;
use DbkIrrf\Dominio\ValorObjeto\ValorMonetario;

// 1. Criar declaracao base
$fabrica = new FabricaDeclaracao();
$declaracao = $fabrica->criar(
    cpf: new Cpf('41653508000'),
    anoExercicio: 2026,
    anoCalendario: 2025,
    tipoDeclaracao: TipoDeclaracao::ORIGINAL,
);

// 2. Preencher dados do header
$declaracao->header = new \DbkIrrf\Dominio\DTO\RegistroHeaderDTO(
    cpf: new Cpf('41653508000'),
    anoExercicio: 2026,
    anoCalendario: 2025,
    tipoDeclaracao: TipoDeclaracao::ORIGINAL,
    nome: 'JORGE LUCAS DA SILVA MONTANO',
    uf: UnidadeFederativa::RJ,
    dataNascimento: Data::deDateTime(new \DateTime('2000-10-10')),
    estadoCivil: EstadoCivil::SOLTEIRO,
    codigoMunicipioIbge: '5877',
    cep: '25845060',
    cidade: 'PETROPOLIS',
    cnpjFontePrincipal: new Cnpj('27865757000102'),
    impostoAPagar: ValorMonetario::deCentavos(1480109),
);

// 3. Adicionar rendimentos PJ
$declaracao->adicionarRendimentoPJ(new RegistroRendimentosPJDTO(
    cpf: new Cpf('41653508000'),
    cnpjFontePagadora: new Cnpj('27865757000102'),
    nomeFontePagadora: 'GLOBO COMUNICACAO E PARTICIPACOES S/A',
    rendimentosRecebidos: ValorMonetario::deReais(180000.00),
    contribPrevidenciaria: ValorMonetario::deReais(12000.00),
    impostoRetidoFonte: ValorMonetario::deReais(50000.00),
));

// 4. Gerar arquivo
$gerador = new GeradorDbk();
$nomeador = new NomeadorArquivo();

$nomeArquivo = $nomeador->gerarDeDeclaracao($declaracao);
// Resultado: "41653508000-IRPF-A-2026-2025-ORIGI.DBK"

$gerador->gerarParaArquivo($declaracao, "/caminho/{$nomeArquivo}");

Ler um arquivo DBK existente

use DbkIrrf\Aplicacao\Servico\LeitorDbk;

$leitor = new LeitorDbk();
$declaracao = $leitor->lerDeArquivo('/caminho/41653508000-IRPF-A-2026-2025-ORIGI.DBK');

echo $declaracao->header->nome; // "JORGE LUCAS DA SILVA MONTANO"
echo $declaracao->header->impostoAPagar->emReais(); // 14801.09

foreach ($declaracao->obterRendimentosPJ() as $rendimento) {
    echo $rendimento->nomeFontePagadora;
    echo $rendimento->rendimentosRecebidos->emReais();
}

Validar um arquivo DBK

use DbkIrrf\Infraestrutura\Validador\ValidadorRegistro;

$validador = new ValidadorRegistro();
$resultado = $validador->validarArquivo(file_get_contents('arquivo.DBK'));

if ($resultado->valido) {
    echo "Arquivo valido!";
} else {
    foreach ($resultado->erros as $erro) {
        echo $erro . "\n";
    }
}

Registros Suportados

Arquitetura

src/
├── Dominio/          # ENUMs, DTOs, Value Objects, Contratos
├── Aplicacao/        # Servicos (GeradorDbk, LeitorDbk), Fabricas
└── Infraestrutura/   # Geradores, Leitores, Formatadores, Validadores

• DDD + Clean Architecture
• DTOs fortemente tipados (zero arrays genericos)
• ENUMs para valores categoricos
• Value Objects imutaveis (Cpf, Cnpj, ValorMonetario, Data, Checksum)
• Strategy Pattern: cada registro tem seu gerador/leitor
• Factory Pattern: FabricaRegistro mapeia tipo -> gerador/leitor

Testes

composer test

Limitacoes

• Checksum: O algoritmo de checksum dos ultimos 10 digitos de cada linha nao foi descoberto. Linhas geradas usam placeholder 0000000000.
• Registros 19 e 20 (Resumo Rendimentos e Resumo Calculos): fora do escopo. Ao ler um arquivo que os contenha, serao ignorados.

Licenca

MIT