Tesorería

Pendiente de pago

POST https://api.afer.pro/consultarPendientePago

Cuánto debes a proveedores: saldo pendiente de pago con aging y el top de facturas de compra pendientes.

El espejo de consultarPendienteCobro: los vencimientos de facturas de compra con importe pendiente, clasificados por antigüedad (no_vencido, vencido_1_30, 31_60, 61_90, mas_90 días).

El top_facturas (hasta 25, por importe pendiente) baja al detalle: qué facturas de proveedor están sin pagar y cuántos días llevan vencidas.

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/consultarPendientePago' \
  -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/consultarPendientePago');
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/consultarPendientePago', {
  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": 23400.8,
        "total_vencido": 6200.3,
        "total_no_vencido": 17200.5,
        "num_facturas": 18,
        "aging": {
            "no_vencido": 17200.5,
            "vencido_1_30": 4100.3,
            "vencido_31_60": 2100,
            "vencido_61_90": 0,
            "vencido_mas_90": 0
        },
        "top_facturas": [
            {
                "facturaCompraId": "aBc123XyZ…",
                "numero": "FRA-2026-0871",
                "fecha": "2026-07-02",
                "proveedor": {
                    "proveedorId": "dEf456…",
                    "nombre_fiscal": "SUMINISTROS BALEAR SA"
                },
                "pendiente": 3120,
                "dias_vencido": 17
            }
        ]
    }
}