ACBrLib REINF Node.js

Pacote Node.js para integração com a ACBrLibReinf, fornecendo uma interface de alto nível para envio e consulta de eventos do REINF (Retenções e Outras Informações Fiscais) da Receita Federal do Brasil.

📋 Sobre

O acbrlib-reinf-node permite que aplicações Node.js/TypeScript integrem facilmente com o sistema REINF da Receita Federal, facilitando:

• Criação e envio de eventos REINF
• Consulta de protocolos e recibos
• Validação de eventos
• Configuração de parâmetros do contribuinte

🏗️ Arquitetura

Este pacote estende a ACBrLibBaseMT, oferecendo métodos específicos para REINF:

ACBrLibBaseMT (do @projetoacbr/acbrlib-base-node)
    ↳ ACBrLibReinfMT

📦 Instalação

npm install @projetoacbr/acbrlib-reinf-node

🚀 Uso Básico

const ACBrLibReinfMT = require('@projetoacbr/acbrlib-reinf-node').default;

🔧 Principais Funcionalidades

Configuração do Contribuinte

• setIDContribuinte(id) - Define ID do contribuinte
• setIDTransmissor(id) - Define ID do transmissor
• setTipoContribuinte(tipo) - Define tipo do contribuinte (1=PF, 2=PJ)
• setVersaoDF(versao) - Define versão do layout DF

Gestão de Eventos

• criarEventoReinf(arquivoIni) - Cria evento a partir de arquivo INI
• validar() - Valida evento carregado
• enviarReinf() - Envia evento para a Receita Federal

Consultas

• consultarReinf(protocolo) - Consulta evento por protocolo
• consultarReciboReinf(params...) - Consulta recibo detalhado

Utilitários

• obterCertificados() - Lista certificados digitais disponíveis

📋 Pré-requisitos

Bibliotecas Nativas

• Linux: libacbrreinf64.so
• Windows: ACBrReinf64.dll

Observações Técnicas

• Windows: Usar convenção de chamada cdecl
• Ambos: Utilizar versão MT (Multi-Thread)

Como Obter as Bibliotecas

• Downloads PRO: ACBrLib PRO
• Downloads DEMO: ACBrLib DEMO

⚙️ Configuração

O pacote utiliza um arquivo de configuração acbrlib.ini para definir parâmetros da biblioteca.

📚 Dependências

• @projetoacbr/acbrlib-base-node - Funcionalidades base
• koffi - Interface FFI para bibliotecas nativas

📖 Documentação

Para documentação completa da ACBrLib, visite: Documentação Oficial ACBrLib

📄 Licença

Este projeto está licenciado sob LGPL-2.1 - veja o arquivo LICENSE para detalhes.

🤝 Contribuição

Contribuições são bem-vindas! Veja nosso repositório principal para mais informações.

⚠️ Status

Em Desenvolvimento - Este pacote está em fase de desenvolvimento e pode conter funcionalidades incompletas.