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

Compras y proveedores

El lado del gasto: proveedores, pedidos, albaranes y facturas de compra.

11 endpoints GET · 10 POST · 1

El espejo del área de ventas. Mismos documentos, misma forma de respuesta y los mismos criterios de importe (base imponible desde las líneas, sin IVA), pero con el proveedor como contraparte en lugar del cliente.

consultarCompras da el agregado del período con desglose por mes, proveedor o tipo de gasto; a partir de ahí bajas al documento: facturas, albaranes (lo ya recibido, esté facturado o no) y pedidos (lo cursado y aún pendiente). Cada listado tiene su obtener para el detalle línea a línea, y listarProveedores resuelve los identificadores.

Flujo típico

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

  1. /api/v1/reports/purchases Ves cuánto y en qué te has gastado
  2. /api/v1/purchase-invoices Bajas a la factura concreta
  3. /api/v1/purchase-invoices/{id} Y a sus líneas

Endpoints del área 11

GET /api/v1/suppliers/search
Buscar un proveedor
Encuentra un proveedor por como lo diría una persona, no por como está escrito en la ficha.
GET /api/v1/reports/purchases
Compras del período
Devuelve las compras entre dos fechas (facturas de compra), con serie mensual opcional.
GET /api/v1/suppliers
Listar proveedores
Devuelve los proveedores de tu cuenta, paginados y con identificadores cifrados, con buscador.
GET /api/v1/suppliers/{id}
Obtener proveedor
La ficha de un proveedor por su identificador, con sus datos fiscales y de contacto.
GET /api/v1/purchase-invoices
Listar facturas de compra
Listado paginado de facturas de compra con filtros por fechas, proveedor, estado de pago y tipo de gasto.
GET /api/v1/purchase-invoices/{id}
Obtener factura de compra
Una factura de compra por su identificador, con su proveedor y todas sus líneas.
GET /api/v1/purchase-delivery-notes
Listar albaranes de compra
Los albaranes recibidos de tus proveedores, con su base imponible.
GET /api/v1/purchase-delivery-notes/{id}
Obtener albarán de compra
Un albarán de compra por su identificador, con su proveedor y todas sus líneas.
GET /api/v1/purchase-orders
Listar pedidos de compra
Los pedidos cursados a tus proveedores, con su base imponible.
GET /api/v1/purchase-orders/{id}
Obtener pedido de compra
Un pedido de compra por su identificador, con su proveedor y todas sus líneas.
POST /api/v1/purchases/inbox
Mandar un documento de compra al buzón
Un albarán, ticket o factura de un proveedor (PDF o foto) al buzón de compras, «Por escanear». Lo lee el escáner del buzón, no esta llamada.
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.