Relatório IN 1888 (Relatórios de Transação)
Pré-requisitos de acesso
- Permissão (módulo):
viewGeneralJournal - Licença/Feature: Nenhuma.
- Contêiner do menu: GERAL → grupo Contabilidade
Esta página descreve um modal, não uma rota
O item Relatórios IN 1888 do menu não navega para uma tela própria. Ele abre o diálogo DownloadTransactionReportsComponent por cima da tela atual (via openTransactionReportsModal()). Não há URL navegável — feche o modal para voltar.
O que é / quando usar
Modal de exportação do relatório de transações no formato exigido pela Receita Federal (IN RFB nº 1.888). O operador escolhe um período (data inicial e final) e gera o relatório de transações dos usuários, seja baixando um CSV localmente, seja enviando os dados ao destino externo de prestação de contas. É a tela usada nos fechamentos periódicos e no cumprimento da obrigação acessória de declarar operações com criptoativos.
Pré-condições
- Permissão:
viewGeneralJournalcadastrado para a role (permissão dupla — enum CPM no backend + módulo dinâmico no DB). - Licença/Feature: Nenhuma.
- Dependências de outras telas: o backend define uma data mínima permitida (
getAllowedStartDateTransactionsReport). Períodos anteriores a essa data são bloqueados porque o ajuste que faz o relatório sair corretamente só passou a valer a partir dela.
Passo a passo
- No menu Contabilidade, clique em Relatórios IN 1888. O modal abre sobre a tela atual.
- Selecione a Data inicial (não pode ser anterior à data mínima permitida) e a Data final.
- Escolha o modo do relatório: CSV (download local) ou o envio ao destino externo.
- Clique no botão de gerar. Aguarde o spinner; uma notificação (snackbar) confirma sucesso ou erro.
Campos
| Campo | O que é | Obrigatório? | Efeito no sistema/backend |
|---|---|---|---|
| Data inicial | Início do período do relatório | Sim | Limitada por firstDateAllowed (data mínima vinda do backend). Datas anteriores são bloqueadas no datepicker. |
| Data final | Fim do período do relatório | Sim | Precisa ser maior ou igual à data inicial; caso contrário o botão de gerar fica desabilitado. |
| Modo do relatório | Como o relatório é entregue: CSV (download) ou envio externo | Sim (default CSV) | csv chama downloadUsersTransactionsReportCsv e baixa in1888-transactions-report.csv. O modo de envio chama getAllUsersTransactionsReport, que transmite os dados ao destino externo de prestação de contas (não gera download local). |
WARNING
O botão de gerar fica desabilitado enquanto: o relatório está carregando, falta data inicial ou final, ou a data inicial é posterior à final. Garanta as duas datas e um intervalo válido antes de acionar.
Ações e modais
- Gerar (modo CSV): baixa o arquivo
in1888-transactions-report.csvno padrão RFB. Snackbar de sucesso ao concluir. - Gerar (modo envio externo): dispara o envio dos dados do período ao destino externo de prestação de contas. Não baixa arquivo — a confirmação vem por snackbar.
- Fechar (X): descarta o modal sem gerar nada.
Regras de negócio / cuidados
Atenção
- Data mínima obrigatória: períodos antes da
firstDateAllowedsão bloqueados de propósito — o relatório só sai corretamente a partir da data em que os ajustes de backend entraram em produção. Não tente contornar o bloqueio. - O modo de envio externo transmite dados a um sistema de terceiros: confirme o período antes de acionar, pois é uma entrega de prestação de contas, não um rascunho.
- Locale de data: o modal ajusta o formato de data conforme o idioma do navegador (pt → dd/mm/aaaa), evitando conversão acidental para o formato norte-americano.
- Valores financeiros: os montantes do relatório vêm da camada financeira (FMS/reporting) e seguem a precisão BigNumber — não arredonde os números do CSV.