CaixaPostalService class

Serviço: CAIXA POSTAL (Caixa Postal do Simples Nacional)

A Caixa Postal é um sistema de comunicação entre a Receita Federal e os contribuintes do Simples Nacional.

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

• MSGCONTRIBUINTE61: Obter Lista de Mensagens por Contribuintes
• MSGDETALHAMENTO62: Obter Detalhes de uma Mensagem Específica
• INNOVAMSG63: Obter Indicador de Novas Mensagens

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

Observação sobre variáveis: O campo assuntoModelo pode conter ++VARIAVEL++ que é substituído pelo valor de valorParametroAssunto. O campo corpoModelo pode conter ++1++, ++2++, etc. que são substituídos pelos valores do array variaveis. Exemplo: "IRPF Declaração do exercício ++VARIAVEL++ processada" com valorParametroAssunto="2023" resulta em: "IRPF Declaração do exercício 2023 processada"

Exemplo de uso:

final caixaPostalService = CaixaPostalService(apiClient);

// 1. Obter lista de mensagens
final mensagens = await caixaPostalService.obterListaMensagensPorContribuinte(
  '12345678000190',
  statusLeitura: 2, // 0=Todas, 1=Lida, 2=Não lida
  indicadorFavorito: null, // 0=Não favorita, 1=Favorita, null=Sem filtro
);

// 2. Obter detalhes de uma mensagem
final detalhes = await caixaPostalService.obterDetalhesMensagemEspecifica(
  '12345678000190',
  '0001626772', // ISN da mensagem
);

// 3. Obter indicador de novas mensagens
final indicador = await caixaPostalService.obterIndicadorNovasMensagens('12345678000190');