@nestjs-fiscal/banking

O pacote banking contém as definições, contratos e entidades agnósticas (interfaces) para integrações bancárias dentro do ecossistema NestJS Fiscal BR.

Instalação

npm install @nestjs-fiscal/banking

O que este pacote contém?

Atualmente, este pacote exporta contratos e interfaces padronizadas para implementações de Banking as a Service (BaaS) e provedores bancários.

• BankProvider Interface: Define o contrato básico que todos os módulos integradores bancários (como o Firebank) devem implementar para realizar operações financeiras padronizadas (ex: gerar boletos, pagamentos via Pix, conciliação).

Exemplo de Uso (Criando seu próprio provedor)

import { BankProvider } from '@nestjs-fiscal/banking';

export class MeuBancoProvider implements BankProvider {
  async emitirBoleto(dados: any): Promise<any> {
    // Integração com a API do MeuBanco...
  }

  async consultarPagamento(idTrasnacao: string): Promise<any> {
    // ...
  }
}

A vantagem de depender deste pacote é não acoplar a sua regra de negócio a um Gateway/API bancária específica, respeitando a Inversão de Dependência da Clean Architecture.