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

Facturas

Todo lo que se puede hacer con una factura de venta: emitirla, listarla, leerla y bajarse su PDF.

5 endpoints GET · 4 POST · 1

El área más usada de la API y la que reúne el circuito completo de la factura, para no tener que saltar entre secciones mientras integras.

crearFactura convierte una venta de fuera —un pedido web, una reserva, un TPV propio— en factura dentro de Afer: busca al cliente por CIF, lo actualiza o lo da de alta, y admite el cobro ya registrado. consultarFacturas lista con filtros y paginación, obtenerFactura devuelve una con todas sus líneas y obtenerFacturaPdf el documento tal cual lo ve el cliente. obtenerAdjuntos sirve para éste y para el resto de documentos.

Cada factura llega con el contacto de su cliente —email, teléfono, móvil— y sus consentimientos RGPD, para poder decidir sin una segunda llamada si se le puede escribir.

Flujo típico

Un recorrido habitual por esta área, de principio a fin.

  1. /api/v1/invoices Emites la factura de la venta
  2. /api/v1/invoices Compruebas cómo quedó y con qué saldo
  3. /api/v1/invoices/{id}/pdf Te bajas el PDF para enviarlo

Endpoints del área 5

POST /api/v1/invoices
Crear factura
Crea una factura de venta con sus líneas, da de alta o actualiza el cliente de facturación y, opcionalmente, registra el cobro o sus vencimientos.
GET /api/v1/invoices
Listar facturas
Listado paginado de facturas de venta con filtros por fechas, cliente y estado de cobro.
GET /api/v1/invoices/{id}
Obtener factura
Devuelve un factura de venta concreto por su identificador, con su cabecera, su contraparte y todas sus líneas.
GET /api/v1/invoices/{id}/pdf
PDF de una factura
Genera el PDF de una factura con la plantilla de impresión de tu cuenta y lo devuelve en base64 (o como enlace).
GET /api/v1/invoices/{id}/attachments
Obtener adjuntos
Los ficheros adjuntos de un documento de venta o de compra, con su URL de descarga.
Antes de empezar

Todos estos endpoints comparten el mismo formato de llamada, autenticación por API key y envelope de respuesta: los tienes en Primeros pasos.