Documentação

English

Português
Español

English

Português
Español

Appearance

IN 1888 Report (Transaction Reports) ​

Access prerequisites

  • Permission (module): viewGeneralJournal
  • License/Feature: None.
  • Menu container: GENERAL → Accounting group

This page describes a modal, not a route

The IN 1888 Reports menu item does not navigate to its own screen. It opens the DownloadTransactionReportsComponent dialog on top of the current screen (via openTransactionReportsModal()). There is no navigable URL — close the modal to go back.

What it is / when to use ​

Modal for exporting the transaction report in the format required by the Brazilian Federal Revenue Service (IN RFB nº 1.888). The operator selects a period (start and end date) and generates the users' transaction report, either by downloading a CSV locally or by sending the data to the external reporting destination. This is the screen used for periodic closings and for fulfilling the accessory obligation to declare crypto-asset operations.

Prerequisites ​

  • Permission: viewGeneralJournal registered for the role (dual permission — CPM enum in the backend + dynamic module in the DB).
  • License/Feature: None.
  • Dependencies on other screens: the backend defines a minimum allowed date (getAllowedStartDateTransactionsReport). Periods prior to that date are blocked because the adjustment that makes the report output correctly only took effect from that date onward.

Step by step ​

  1. In the Accounting menu, click IN 1888 Reports. The modal opens on top of the current screen.
  2. Select the Start date (cannot be earlier than the minimum allowed date) and the End date.
  3. Choose the report mode: CSV (local download) or send to external destination.
  4. Click the generate button. Wait for the spinner; a notification (snackbar) confirms success or error.

Fields ​

FieldWhat it isRequired?System/backend effect
Start dateBeginning of the report periodYesLimited by firstDateAllowed (minimum date from the backend). Earlier dates are blocked in the datepicker.
End dateEnd of the report periodYesMust be greater than or equal to the start date; otherwise the generate button is disabled.
Report modeHow the report is delivered: CSV (download) or external sendYes (default CSV)csv calls downloadUsersTransactionsReportCsv and downloads in1888-transactions-report.csv. The send mode calls getAllUsersTransactionsReport, which transmits the data to the external reporting destination (no local download is generated).

WARNING

The generate button is disabled while: the report is loading, the start or end date is missing, or the start date is later than the end date. Make sure both dates are set and the interval is valid before triggering.

Actions and modals ​

  • Generate (CSV mode): downloads the in1888-transactions-report.csv file in the RFB standard. Success snackbar upon completion.
  • Generate (external send mode): triggers the transmission of the period's data to the external reporting destination. No file is downloaded — confirmation comes via snackbar.
  • Close (X): discards the modal without generating anything.

Business rules / caveats ​

Attention

  • Mandatory minimum date: periods before firstDateAllowed are intentionally blocked — the report only outputs correctly from the date the backend adjustments went into production. Do not attempt to bypass the block.
  • External send mode transmits data to a third-party system: confirm the period before triggering, as this is a formal reporting delivery, not a draft.
  • Date locale: the modal adjusts the date format according to the browser language (pt → dd/mm/yyyy), avoiding accidental conversion to the North American format.
  • Financial values: the amounts in the report come from the financial layer (FMS/reporting) and follow BigNumber precision — do not round the numbers in the CSV.