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

Productos e inventario

El catálogo: artículos, familias, precios por tarifa y stock.

12 endpoints GET · 8 POST · 4

El maestro de artículos, que es de donde salen los articuloId que aceptan las líneas de todos los documentos de venta y los endpoints de disponibilidad.

consultarProductos lista el catálogo con búsqueda por texto, familia o artículos bajo mínimo, y obtenerProducto da la ficha completa de uno — incluida su tabla de precios por días si es un artículo de alquiler. En Afer una tarifa no es una tabla, son las columnas de precio del artículo (pvp1, pvp2…) a las que apunta cada cliente: consultarTarifas te dice cuáles existen realmente en tu cuenta y cuántos clientes usa cada una. consultarStock es la vista de existencias y consultarFamilias el catálogo de categorías.

Flujo típico

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

  1. /api/v1/product-categories Obtienes las familias del catálogo
  2. /api/v1/products Buscas el artículo y su precio
  3. /api/v1/invoices Lo vendes usando su articuloId

Endpoints del área 12

GET /api/v1/products
Listar productos
El catálogo de artículos con referencia, familia, coste, precios por tarifa y stock.
GET /api/v1/products/{id}
Obtener producto
La ficha completa de un artículo, con sus precios por tarifa y, si es de alquiler, su tabla por días.
GET /api/v1/price-lists
Tarifas de venta
Qué tarifas de precio existen en tu cuenta, cuántos clientes usa cada una y el precio de un artículo en todas.
GET /api/v1/product-categories
Familias de artículos
Las categorías de producto de tu cuenta con el número de artículos de cada una.
GET /api/v1/products/stock
Stock de artículos
El stock de tus artículos, con el número de referencias bajo mínimo para la tarjeta de alertas del panel.
GET /api/v1/products/formats
Formatos comerciales
Las presentaciones con las que se compra y se vende cada artículo (palé, caja, saco…) y su equivalencia con la unidad base del stock.
GET /api/v1/product-taxonomies
Taxonomías de producto
Las taxonomías de producto de tu cuenta —marcas, categorías y los demás tipos— con cuántos productos lleva cada una.
POST /api/v1/product-taxonomies
Crear taxonomía
Crea una taxonomía de producto (una marca, una categoría…) del tipo que le digas.
POST /api/v1/product-categories
Crear familia de artículos
Da de alta una familia de artículos.
POST /api/v1/products
Dar de alta un producto
Crea un producto en el catálogo con su familia y sus taxonomías.
POST /api/v1/products/{id}/taxonomies
Clasificar un producto
Pone o quita la familia y las taxonomías de un producto que ya existe.
GET /api/v1/products/match
Casar líneas con el catálogo
Dime las líneas como las ha dicho alguien y te digo cuáles son productos del catálogo, con su precio y su stock.
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.