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

Listar presupuestos

GET https://api.afer.pro/api/v1/estimates
Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/consultarPresupuestos

Los presupuestos emitidos, con su cliente, su estado del pipeline y su base imponible.

Listado paginado de presupuestos. La base imponible se calcula desde las líneas con el mismo criterio que en facturas y albaranes: cantidad × precio × (1 − descuento), sin IVA.

El estado es el del pipeline configurable de documentos (borrador, enviado, aceptado, rechazado… los que tengas definidos). Los identificadores para filtrar salen de consultarEstados con tipo: "presupuesto".

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.
clienteIdstring
opcional
Solo los presupuestos de este cliente.
estadoIdstring
opcional
Solo los que están en este estado del pipeline.
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/estimates?fecha_inicio=2026-01-01&fecha_fin=2026-06-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/estimates?fecha_inicio=2026-01-01&fecha_fin=2026-06-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/estimates?fecha_inicio=2026-01-01&fecha_fin=2026-06-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_presupuestos": 1,
        "pagina": 1,
        "por_pagina": 100,
        "num_paginas": 1,
        "presupuestos": [
            {
                "presupuestoId": "aBc123XyZ…",
                "numero": "PRE-2026-014",
                "fecha": "2026-03-11",
                "cliente": {
                    "clienteId": "dEf456…",
                    "nombre_fiscal": "ACME OBRAS 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
                    }
                },
                "estado": {
                    "estadoId": "gHi789…",
                    "titulo": "Aceptado"
                },
                "base_imponible": 18400.5
            }
        ]
    }
}
Notas
  • El detalle línea a línea está en obtenerPresupuesto.
  • Los presupuestos no entran en los agregados de ventas: solo cuenta lo albaraneado y facturado.