Informe IN 1888 (Informes de Transacción)
Requisitos previos de acceso
- Permiso (módulo):
viewGeneralJournal - Licencia/Feature: Ninguna.
- Contenedor del menú: GENERAL → grupo Contabilidad
Esta página describe un modal, no una ruta
El elemento Informes IN 1888 del menú no navega a una pantalla propia. Abre el diálogo DownloadTransactionReportsComponent sobre la pantalla actual (mediante openTransactionReportsModal()). No existe URL navegable — cierre el modal para volver.
Qué es / cuándo usar
Modal para exportar el informe de transacciones en el formato exigido por la Receita Federal de Brasil (IN RFB nº 1.888). El operador elige un período (fecha de inicio y fecha de fin) y genera el informe de transacciones de los usuarios, ya sea descargando un CSV localmente o enviando los datos al destino externo de rendición de cuentas. Es la pantalla utilizada en los cierres periódicos y para el cumplimiento de la obligación accesoria de declarar operaciones con criptoactivos.
Requisitos previos
- Permiso:
viewGeneralJournalregistrado para el rol (permiso doble — enum CPM en el backend + módulo dinámico en la BD). - Licencia/Feature: Ninguna.
- Dependencias de otras pantallas: el backend define una fecha mínima permitida (
getAllowedStartDateTransactionsReport). Los períodos anteriores a esa fecha están bloqueados porque el ajuste que hace que el informe se genere correctamente solo entró en vigor a partir de dicha fecha.
Paso a paso
- En el menú Contabilidad, haga clic en Informes IN 1888. El modal se abre sobre la pantalla actual.
- Seleccione la Fecha de inicio (no puede ser anterior a la fecha mínima permitida) y la Fecha de fin.
- Elija el modo del informe: CSV (descarga local) o envío al destino externo.
- Haga clic en el botón de generar. Espere el spinner; una notificación (snackbar) confirma el éxito o el error.
Campos
| Campo | Qué es | ¿Obligatorio? | Efecto en el sistema/backend |
|---|---|---|---|
| Fecha de inicio | Inicio del período del informe | Sí | Limitada por firstDateAllowed (fecha mínima proveniente del backend). Las fechas anteriores quedan bloqueadas en el datepicker. |
| Fecha de fin | Fin del período del informe | Sí | Debe ser mayor o igual a la fecha de inicio; de lo contrario, el botón de generar queda deshabilitado. |
| Modo del informe | Cómo se entrega el informe: CSV (descarga) o envío externo | Sí (default CSV) | csv llama a downloadUsersTransactionsReportCsv y descarga in1888-transactions-report.csv. El modo de envío llama a getAllUsersTransactionsReport, que transmite los datos al destino externo de rendición de cuentas (no genera descarga local). |
WARNING
El botón de generar queda deshabilitado mientras: el informe está cargando, falta la fecha de inicio o de fin, o la fecha de inicio es posterior a la de fin. Asegúrese de que ambas fechas estén definidas y de que el intervalo sea válido antes de accionarlo.
Acciones y modales
- Generar (modo CSV): descarga el archivo
in1888-transactions-report.csven el estándar RFB. Snackbar de éxito al completar. - Generar (modo envío externo): dispara el envío de los datos del período al destino externo de rendición de cuentas. No descarga ningún archivo — la confirmación llega por snackbar.
- Cerrar (X): descarta el modal sin generar nada.
Reglas de negocio / consideraciones
Atención
- Fecha mínima obligatoria: los períodos anteriores a
firstDateAllowedestán bloqueados intencionalmente — el informe solo se genera correctamente a partir de la fecha en que los ajustes de backend entraron en producción. No intente eludir el bloqueo. - El modo de envío externo transmite datos a un sistema de terceros: confirme el período antes de accionarlo, ya que es una entrega formal de rendición de cuentas, no un borrador.
- Locale de fecha: el modal ajusta el formato de fecha según el idioma del navegador (pt → dd/mm/aaaa), evitando la conversión accidental al formato norteamericano.
- Valores financieros: los montos del informe provienen de la capa financiera (FMS/reporting) y siguen la precisión BigNumber — no redondee los números del CSV.