Pendiente de cobro

GET https://api.afer.pro/api/v1/treasury/receivables

Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/consultarPendienteCobro

Cuánto te deben: saldo pendiente con aging (antigüedad de la deuda) y el top de facturas con más importe pendiente.

La tarjeta de "dinero en la calle" del panel. Suma todos los vencimientos de facturas de venta con importe pendiente y los clasifica por antigüedad respecto a la fecha de referencia:

no_vencido (aún no toca) · vencido_1_30 · vencido_31_60 · vencido_61_90 · vencido_mas_90 días.

El top_facturas (hasta 25, ordenadas por importe pendiente) permite bajar del agregado a las facturas concretas, con sus días de retraso.

Autenticación

Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →

Este endpoint requiere autenticación con API key: sin credenciales responde 401.

Parámetros del cuerpo

El cuerpo de la petición es un objeto JSON con Content-Type: application/json.

fecha_referenciadate

opcional

Fecha contra la que se calcula el aging (YYYY-MM-DD). Por defecto, hoy.

Ejemplo de petición

curl -X GET 'https://api.afer.pro/api/v1/treasury/receivables' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET'

<?php

$ch = curl_init('https://api.afer.pro/api/v1/treasury/receivables');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: afer_tk_TU_TOKEN',
    'X-API-SECRET: afer_sk_TU_SECRET',
]);

$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);

const respuesta = await fetch('https://api.afer.pro/api/v1/treasury/receivables', {
  method: 'GET',
  headers: {
    'X-API-KEY': 'afer_tk_TU_TOKEN',
    'X-API-SECRET': 'afer_sk_TU_SECRET'
  }
});

const resultado = await respuesta.json();

Respuesta

200 · application/json

{
    "errorCode": 200,
    "errorMsg": "",
    "data": {
        "fecha_referencia": "2026-08-18",
        "total_pendiente": 96200.4,
        "total_vencido": 31500.1,
        "total_no_vencido": 64700.3,
        "num_facturas": 47,
        "aging": {
            "no_vencido": 64700.3,
            "vencido_1_30": 14200,
            "vencido_31_60": 9800.1,
            "vencido_61_90": 3500,
            "vencido_mas_90": 4000
        },
        "top_facturas": [
            {
                "facturaId": "aBc123XyZ…",
                "serie": "A",
                "numero": "2026/0412",
                "fecha": "2026-05-02",
                "cliente": {
                    "clienteId": "dEf456…",
                    "nombre_fiscal": "CONSTRUCCIONES MAYOL SL",
                    "nombre_comercial": "Ferrer Interiors",
                    "cif": "B07123456",
                    "email": "admin@ferrerinteriors.com",
                    "telefono": "971123456",
                    "movil": "600123456",
                    "rgpd": {
                        "comunicaciones_email": true,
                        "comunicaciones_whatsapp": false,
                        "comunicaciones_sms": null,
                        "tratamiento_imagenes": null
                    }
                },
                "pendiente": 8470,
                "dias_vencido": 47
            }
        ]
    }
}

Notas

Los importes pendientes son con IVA (lo que el cliente debe pagar). Se excluyen las series proforma.
Un vencimiento parcialmente pagado computa solo por lo que falta.