Reportes

InvWallet permite generar y consultar reportes del sistema en forma asíncrona. Al solicitar un reporte, se crea un objeto con un uuid que puede consultarse hasta que su estado sea COMPLETED, momento en que el archivo queda disponible para descarga.

Estados de un reporte

Estado	Descripción
SCHEDULED	El reporte fue solicitado y está en cola
IN_PROGRESS	El reporte se está generando
COMPLETED	El reporte está listo para descargar
PENDING_REVIEW	El reporte requiere revisión antes de estar disponible
FAILED	El reporte no pudo generarse

Tipos de reporte

Tipo	Descripción
REPORT_LEDGER_ROW_BY_DATE	Tenencias diarias por cuenta. Usado para el reporte regulatorio al BCRA
REPORT_VALUED_HOLDINGS	Posición valuada actual por cuenta
REPORT_OPEN_ACCOUNTS	Listado de cuentas abiertas
REPORT_ACCOUNT_PERFORMANCE	Rendimientos por cuenta en un período
REPORT_WALLET_DAILY_BALANCE_PERFORMANCE	Balance diario y rendimiento a nivel Billetera
REPORT_RETURNS_FOR_WALLET	Retornos consolidados para la Billetera

Listar reportes

GET /api/v1/reports/

Devuelve la lista paginada de reportes generados para la billetera.

Query params

Parámetro	Tipo	Descripción
report_name	string	Filtra por nombre de reporte
report_type	string	Filtra por tipo de reporte
scope	string	Filtra por scope (ej. cuenta, billetera)
created, created__gte, created__lte, created__range	date	Filtros por fecha de creación
end_date, end_date__gte, end_date__lte, end_date__range	date	Filtros por fecha de fin del período cubierto
limit, offset	int	Paginación estándar

Respuesta 200

{
  "count": 42,
  "next": "https://.../api/v1/reports/?limit=20&offset=20",
  "previous": null,
  "results": [
    {
      "uuid": "rep_01HXYZ...",
      "report_name": "account_asset_summary",
      "report_type": "pdf",
      "scope": "account",
      "created": "2026-04-01",
      "end_date": "2026-03-31",
      "status": "COMPLETED"
    }
  ]
}

Obtener un reporte

GET /api/v1/reports/{uuid}/

Devuelve el detalle de un reporte por su uuid. Útil para hacer polling del estado antes de descargarlo.

Respuesta 200: objeto Report con los mismos campos que el listado.

Descargar un reporte

GET /api/v1/reports/{uuid}/download/

Descarga el archivo binario asociado al reporte (PDF u otro). Solo disponible cuando el estado es COMPLETED.

Reporte Trimestral

El reporte trimestral resume los movimientos, saldos y retornos de una cuenta para un asset durante un trimestre. Tiene dos modalidades:

• Self-service: la Wallet lo genera y lo descarga para entregárselo al cliente como considere.
• Por cliente: si el ACDI/AM lo requiere, puede solicitarse el reporte para una cuenta puntual, especificando account_id, asset_id, año y trimestre.

Generar reporte trimestral

POST /api/v1/reports/account_asset_summary/

Genera un PDF con el resumen de movimientos, saldos y retornos de una cuenta para un asset en un trimestre determinado. Las fechas se ajustan automáticamente a días hábiles si caen en feriado o fin de semana.

Body

{
  "account_id": "account_id78654",
  "asset_id": "asset_id12345",
  "year": 2025,
  "quarter": "Q1"
}

Campo	Tipo	Requerido	Descripción
account_id	string	Sí	ID de la cuenta
asset_id	string	Sí	ID del asset (fondo u otro)
year	int	Sí	Año del período
quarter	string	Sí	Q1, Q2, Q3 o Q4

Respuesta 201: objeto Report con el uuid para consultar el estado y descargar.

Errores comunes

• 400 — parámetros inválidos (trimestre fuera de rango, fechas inconsistentes)
• 404 — cuenta o asset inexistente

Flujo recomendado

1. POST /reports/account_asset_summary/ → guardar uuid
2. GET /reports/{uuid}/ → polling hasta status: COMPLETED
3. GET /reports/{uuid}/download/ → descargar el PDF