Tesorería

Pendiente de cobro

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 POST 'https://api.afer.pro/consultarPendienteCobro' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET' \
  -d '{}'

<?php

$data = [
];

$ch = curl_init('https://api.afer.pro/consultarPendienteCobro');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    '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/consultarPendienteCobro', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'afer_tk_TU_TOKEN',
    'X-API-SECRET': 'afer_sk_TU_SECRET'
  },
  body: JSON.stringify({})
});

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"
                },
                "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.