Consultas de Conciliaciones

GET /api/v1/payments/report/

Obtiene un reporte de pagos y conciliaciones filtrado por fecha y proveedor de pagos.

Endpoint

GET /api/v1/payments/report/

Authentication

api-key: YOUR_API_KEY

Query Parameters

Parámetro	Tipo	Requerido	Descripción
fecha	string	✓	Fecha en formato YYYYMMDD (ej: 20251225)
provider	string	✓	Proveedor de pagos (ej: facilito)

Ejemplo de solicitud

# Production
curl -X GET \
     -H "api-key: YOUR_API_KEY" \
     "https://api.erolapp.com/api/v1/payments/report/?fecha=20251225&provider=facilito"

# Staging
curl -X GET \
     -H "api-key: YOUR_API_KEY" \
     "https://be-staging.erolapp.com/api/v1/payments/report/?fecha=20251225&provider=facilito"

Response

Código de estado: 200 OK

{
    "fecha": "20251225",
    "provider": "facilito",
    "total_records": 2,
    "payments": [
        {
            "uuid": "4FEA68BB-0400-4D2B-8070-FC86AEE8E6CC",
            "valorTotal": 103.37,
            "idRubro": "532070",
            "idProducto": "d5428ba7-60bc-46fa-ad06-757885c4d9dd",
            "referencia": "0113145208",
            "idInstitucion": "D3A7DE02-C5D6-48B6-B5F6-C055D7348EC0",
            "idAgencia": "41E4F2A0-08BA-4CD7-9C47-BFC6AB687E54",
            "fechaHora": "2025-12-26T03:57:52.130976+00:00"
        },
        {
            "uuid": "0461A4A6-D2FA-404F-8EBA-9FD61692F15E",
            "valorTotal": 422.84999999999997,
            "idRubro": "532071",
            "idProducto": "8b84a5c7-cd47-42ba-a2c1-87ab07be4e1c",
            "referencia": "1214151628",
            "idInstitucion": "D3A7DE02-C5D6-48B6-B5F6-C055D7348EC0",
            "idAgencia": "41E4F2A0-08BA-4CD7-9C47-BFC6AB687E54",
            "fechaHora": "2025-12-26T03:58:38.264168+00:00"
        }
    ]
}

Campos de respuesta

Campo	Tipo	Descripción
fecha	string	Fecha consultada en formato YYYYMMDD
provider	string	Proveedor de pagos consultado
total_records	number	Total de registros encontrados
payments	array	Array de objetos de pago

Objeto Payment

Campo	Tipo	Descripción
uuid	string	Identificador único del pago
valorTotal	number	Valor total del pago
idRubro	string	Identificador del rubro
idProducto	string	Identificador del producto
referencia	string	Número de referencia del pago
idInstitucion	string	Identificador de la institución
idAgencia	string	Identificador de la agencia
fechaHora	string	Fecha y hora del pago en formato ISO 8601

Casos de uso

• Consulta de conciliaciones diarias por proveedor
• Generación de reportes de pagos por fecha específica
• Auditoría de transacciones procesadas
• Reconciliación bancaria automatizada

Notas importantes

• La fecha debe proporcionarse en formato YYYYMMDD sin separadores
• Los timestamps en la respuesta están en UTC
• El endpoint sólo retorna pagos del día específico solicitado
• Los valores monetarios pueden incluir decimales extendidos

Proveedores soportados

Proveedor	Descripción
facilito	Plataforma de pagos Facilito

Error Responses

Parámetros faltantes o inválidos

{
    "error": "Parámetros requeridos: fecha, provider",
    "code": "MISSING_PARAMETERS"
}

Fecha en formato incorrecto

{
    "error": "Formato de fecha inválido. Use YYYYMMDD",
    "code": "INVALID_DATE_FORMAT"
}

Proveedor no soportado

{
    "error": "Proveedor no soportado",
    "code": "INVALID_PROVIDER"
}