Base URL https://api.afer.pro Referencia aferapp.com Reservar demo
Compras y proveedores

Listar albaranes de compra

GET https://api.afer.pro/api/v1/purchase-delivery-notes
Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/consultarAlbaranesCompra

Los albaranes recibidos de tus proveedores, con su base imponible.

El espejo de consultarAlbaranes en el lado de la compra: la mercancía o el servicio que ya has recibido, esté o no facturado todavía.

La base imponible se calcula desde las líneas, sin IVA. Es la misma fuente que usa el bloque de compras del económico de proyectos.

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_iniciodate
opcional
Desde esta fecha, incluida. Formato YYYY-MM-DD.
fecha_findate
opcional
Hasta esta fecha, incluida.
proveedorIdstring
opcional
Solo los albaranes de este proveedor. Es el proveedorId de listarProveedores.
paginaint
opcional
Página a devolver. Por defecto 1.
por_paginaint
opcional
Resultados por página. Por defecto 100, máximo 500.

Ejemplo de petición

curl -X GET 'https://api.afer.pro/api/v1/purchase-delivery-notes?fecha_inicio=2026-04-01&fecha_fin=2026-04-30' \
  -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/purchase-delivery-notes?fecha_inicio=2026-04-01&fecha_fin=2026-04-30');
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/purchase-delivery-notes?fecha_inicio=2026-04-01&fecha_fin=2026-04-30', {
  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": {
        "total_albaranes": 1,
        "pagina": 1,
        "por_pagina": 100,
        "num_paginas": 1,
        "documentos": [
            {
                "albaranCompraId": "aBc123XyZ…",
                "numero": "ALB-8821",
                "fecha": "2026-04-12",
                "proveedor": {
                    "proveedorId": "pRv321…",
                    "nombre_fiscal": "SUMINISTROS BALEAR SL",
                    "nombre_comercial": "Subalear",
                    "cif": "B07999888",
                    "email": "pedidos@subalear.com",
                    "telefono": "971998877",
                    "movil": null
                },
                "base_imponible": 1240.75
            }
        ]
    }
}
Notas