PagtoWebService class

Serviço: PAGTOWEB (Sistema de Pagamentos do Simples Nacional)

O PAGTOWEB é o sistema para consulta de pagamentos do Simples Nacional.

Este serviço disponibiliza APENAS 3 serviços oficiais da API SERPRO:

• PAGAMENTOS71: Consultar pagamentos com filtros
• CONTACONSDOCARRPG73: Contar documentos de pagamento
• EMITECOMPROVANTEPAGAMENTO72: Emitir comprovante de pagamento em PDF

Métodos de conveniência: Este serviço também oferece métodos auxiliares que facilitam o uso dos 3 serviços principais, pré-configurando filtros específicos. Estes métodos NÃO são serviços distintos da API.

Documentação oficial: .cursor/rules/pagtoweb.mdc

Exemplo de uso:

final pagtoWebService = PagtoWebService(apiClient);

// Consultar pagamentos
final pagamentos = await pagtoWebService.consultarPagamentos(
  contribuinteNumero: '12345678000190',
  dataInicial: '2024-01-01',
  dataFinal: '2024-12-31',
);
print('Total de pagamentos: ${pagamentos.totalRegistros}');

// Emitir comprovante
final comprovante = await pagtoWebService.emitirComprovante(
  numeroDocumento: '123456789',
  codigoTipoDocumento: '001',
);
print('Comprovante PDF: ${comprovante.pdfBase64}');