Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/scoria02/marbes2021_backend/llms.txt

Use this file to discover all available pages before exploring further.

The reporting system provides ten dedicated endpoints for analyzing the financial state of lending operations. Reports cover individual transactions (TCOL, TPROD, TCON, and fund movements), aggregated views by responsible employee or bank, and specialized breakdowns like fund origin and boveda (vault) totals. All monetary data is filtered to USD and VES — EUR is excluded from report queries. Date-range parameters follow the YYYY-MM-DD format. All endpoints require a valid JWT token in the Authorization header.
Reports filter by fecha (the operation date), not created_at. Make sure your date range matches the business date of the transactions, not when they were entered into the system.

Reporte detallado — line-by-line operations

Returns every individual operation (TCOL, TPROD, TCON, and fund movements) within the specified date range. Use this report for full transaction audits. Endpoint: GET /api/report/detallado
ParameterRequiredFormatDescription
fechaDesdeYesYYYY-MM-DDStart of date range
fechaHastaYesYYYY-MM-DDEnd of date range
curl -X GET "https://your-server:7780/api/report/detallado?fechaDesde=2026-01-01&fechaHasta=2026-01-31" \
  -H "Authorization: Bearer YOUR_TOKEN"
Key response fields:
FieldDescription
tipo_operacionOne of TCOL, TPROD, TCON, or MOVIMIENTO_FONDO
operacion_idUUID of the specific operation
monedaUSD or VES
montoTransaction amount
disponible_activoCurrent available balance (TCOL records)
prestadoAmount lent from this record
costo_bancoBank fee applied
tasa_bcvBCV exchange rate at time of operation
responsable_nombreFull name of the responsible employee
For large date ranges, response times can grow significantly. Keep queries to 3-month windows or less for best performance.

Resumen por responsable — executive summary by responsible

Returns aggregated statistics grouped by responsible employee and currency. Use this for performance reviews and executive dashboards. Endpoint: GET /api/report/resumen-responsable
ParameterRequiredFormatDescription
fechaDesdeYesYYYY-MM-DDStart of date range
fechaHastaYesYYYY-MM-DDEnd of date range
curl -X GET "https://your-server:7780/api/report/resumen-responsable?fechaDesde=2026-01-01&fechaHasta=2026-01-31" \
  -H "Authorization: Bearer YOUR_TOKEN"
Key response fields:
FieldDescription
responsable_idEmployee UUID, or sin-responsable if unassigned
total_operacionesTotal number of operations in the period
total_aportantesUnique investors handled
total_clientesUnique clients handled
total_monto_tcolSum of all TCOL amounts
total_prestado_tcolSum of amounts lent from TCOL funds
total_monto_tprodSum of all TPROD (loan) amounts
total_costo_bancoTotal bank fees charged

Origen de fondos — fund origin analysis

Breaks down fund sources per bank and investor, separating direct deposits (TCOL) from transferred funds (fund movements). Use this to understand where lending capital originates. Endpoint: GET /api/report/origen-fondos
ParameterRequiredFormatDescription
fechaDesdeYesYYYY-MM-DDStart of date range
fechaHastaYesYYYY-MM-DDEnd of date range
curl -X GET "https://your-server:7780/api/report/origen-fondos?fechaDesde=2026-01-01&fechaHasta=2026-01-31" \
  -H "Authorization: Bearer YOUR_TOKEN"

Reporte por aportante y banco — by investor and bank

Returns totals grouped by investor (aportante) and bank, useful for reconciling investor balances against specific bank accounts. Endpoint: GET /api/report/aportante-banco
curl -X GET "https://your-server:7780/api/report/aportante-banco" \
  -H "Authorization: Bearer YOUR_TOKEN"
This endpoint does not require fechaDesde or fechaHasta. It returns the current state across all dates.

Reporte por banco — totals by bank

Returns balance and lending totals grouped by bank. This is the fastest way to get a current snapshot of how much each bank holds and how much has been lent. Endpoint: GET /api/report/banco
curl -X GET "https://your-server:7780/api/report/banco" \
  -H "Authorization: Bearer YOUR_TOKEN"

Reporte general por banco — USD and VES combined

Returns a general summary per bank that includes both USD amounts and their VES equivalents. Useful for consolidated reporting in local currency. Endpoint: GET /api/report/general-por-banco
curl -X GET "https://your-server:7780/api/report/general-por-banco" \
  -H "Authorization: Bearer YOUR_TOKEN"

Total boveda — all banks plus vault breakdown

Returns the total across all banks with the boveda (vault) shown as a separate line. USD is held fixed in the vault; VES is recalculated from the USD amount using the current BCV rate. Endpoint: GET /api/report/total-boveda
curl -X GET "https://your-server:7780/api/report/total-boveda" \
  -H "Authorization: Bearer YOUR_TOKEN"

TCOL/TPROD agregado — aggregated view

Returns one row per TCOL with aggregated counts and totals of its associated TPROD loans. Use this to compare how much was collected versus how much was lent per collection record. Endpoint: GET /api/report/tcol-tprod-agregado
curl -X GET "https://your-server:7780/api/report/tcol-tprod-agregado" \
  -H "Authorization: Bearer YOUR_TOKEN"

TCOL/TPROD detalle — line-by-line TCOL and TPROD

Returns every TPROD record alongside its parent TCOL data. Use this for detailed loan-level analysis showing the full chain from collection to disbursement. Endpoint: GET /api/report/tcol-tprod-detalle
curl -X GET "https://your-server:7780/api/report/tcol-tprod-detalle" \
  -H "Authorization: Bearer YOUR_TOKEN"

TPROD por responsable y banco — TPROD by responsible and bank

Returns accepted TPROD (loan) records grouped by responsible employee and bank within a date range. Primarily used for loan performance tracking and accountability reporting. Endpoint: GET /api/report/tprod-por-responsable-banco
ParameterRequiredFormatDescription
fechaDesdeYesYYYY-MM-DDStart of date range
fechaHastaYesYYYY-MM-DDEnd of date range
curl -X GET "http://localhost:7780/api/report/tprod-por-responsable-banco?fechaDesde=2026-01-01&fechaHasta=2026-01-31" \
  -H "Authorization: Bearer YOUR_TOKEN"

TPROD detalle por responsable y banco — line-by-line

Returns individual TPROD records (one row per loan) filtered by responsible employee, bank, and date range. Use this for detailed loan-level analysis showing the full disbursement chain. Endpoint: GET /api/report/tprod-detalle-por-responsable-banco
ParameterRequiredFormatDescription
fechaDesdeYesYYYY-MM-DDStart of date range
fechaHastaYesYYYY-MM-DDEnd of date range
curl -X GET "http://localhost:7780/api/report/tprod-detalle-por-responsable-banco?fechaDesde=2026-01-01&fechaHasta=2026-01-31" \
  -H "Authorization: Bearer YOUR_TOKEN"

VES variants of investor/bank reports

The following endpoints mirror their USD counterparts but return amounts redenominated in Venezuelan bolívares (VES):
  • GET /api/report/aportante-banco-ves — investor+bank report in VES
  • GET /api/report/banco-ves — bank totals in VES
curl -X GET "http://localhost:7780/api/report/aportante-banco-ves" \
  -H "Authorization: Bearer YOUR_TOKEN"

Common parameters and constraints

ParameterRequired forFormatNotes
fechaDesdedetallado, resumen-responsable, origen-fondos, tprod-por-responsable-bancoYYYY-MM-DDInclusive start date
fechaHastadetallado, resumen-responsable, origen-fondos, tprod-por-responsable-bancoYYYY-MM-DDInclusive end date
All report endpoints only include operations with currencies USD and VES. EUR transactions are excluded from all reports. The filtering is applied automatically — no query parameter is needed.

Build docs developers (and LLMs) love