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

Listar albaranes

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

Listado paginado de albaranes con filtros por fechas, cliente, facturable y origen recurrente.

El equivalente a consultarFacturas para albaranes. es_recurrente indica si el albarán se generó desde un servicio recurrente, y facturable si computa como venta pendiente de facturar; facturado, si ya está facturado (en qué facturas, en obtenerAlbaran).

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
Albaranes con fecha a partir de esta (YYYY-MM-DD).
fecha_findate
opcional
Albaranes con fecha hasta esta (YYYY-MM-DD).
clienteIdstring
opcional
Identificador cifrado del cliente: solo sus albaranes.
solo_recurrentesbool
opcional
Con true, solo los generados desde servicios recurrentes.
facturablebool
opcional
Filtra por el flag facturable. Omite el parámetro para todos.
comisionistaIdstring
opcional
Solo los de este comisionista interno (el comisionistaId de listarComisionistas). 0 = los que no tienen.
comisionistaExternoIdstring
opcional
Solo los de este comisionista externo, el colaborador de fuera (mismo catálogo, listarComisionistas). 0 = los que no tienen.
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/delivery-notes?fecha_inicio=2026-08-01&fecha_fin=2026-08-18&solo_recurrentes=1' \
  -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/delivery-notes?fecha_inicio=2026-08-01&fecha_fin=2026-08-18&solo_recurrentes=1');
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/delivery-notes?fecha_inicio=2026-08-01&fecha_fin=2026-08-18&solo_recurrentes=1', {
  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,
        "albaranes": [
            {
                "albaranId": "aBc123XyZ…",
                "numero": "2026/0781",
                "fecha": "2026-08-05",
                "cliente": {
                    "clienteId": "dEf456…",
                    "nombre_fiscal": "FERRER INTERIORS 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
                    }
                },
                "base_imponible": 150,
                "facturable": true,
                "facturado": false,
                "es_recurrente": true
            }
        ]
    }
}