Qué es la API de Fidel, qué recursos expone y cómo empezar a integrarla.
API REST para leer y escribir los datos de tu cuenta de Fidel: catálogo, precios, stock, categorías, listas de precio, clientes, presupuestos, ventas y pedidos.
JSON sobre HTTPS, autenticación con token Bearer (OAuth 2.0). No hay SDK ni librería que instalar: cualquier lenguaje o herramienta capaz de hacer una petición HTTP puede consumirla.
Especificaciones técnicas 🔧
| Estilo | REST |
| Protocolo | HTTPS |
| Formato | JSON, propiedades en camelCase |
| Autenticación | OAuth 2.0, resource owner password credentials |
| Vigencia del token | 24 horas |
| Listados | Paginados, con filtrado y ordenamiento por query string |
| Codificación | UTF-8 |
Recursos disponibles 📦
| Recurso | Endpoint base | Operaciones |
|---|---|---|
| Productos | /api/products | Consulta del catálogo con precios, stock e imágenes. Filtros por rubro, marca, rango de precio y búsqueda. Incluye destacados, ofertas y novedades. |
| Categorías | /api/categories | Consulta de categorías y subcategorías. |
| Listas de Precio | /api/price-lists | Consulta de las listas de precio de venta habilitadas. |
| Clientes | /api/customers | Consulta de la cartera de clientes y detalle individual. |
| Presupuestos | /api/budget-sales | Consulta de presupuestos de venta y su detalle. |
| Ventas | /api/sales | Consulta de ventas registradas y su detalle. |
| Pedidos | /api/orders | Alta de pedidos. |
Cada recurso tiene su página en el menú lateral, con los parámetros disponibles, el esquema de respuesta y un panel para ejecutar la petición desde el navegador.
Casos de uso 🎯
Sincronización de catálogo con un e-commerce. Replicar productos, precios, stock e imágenes hacia una tienda online.
→ GET /api/products, GET /api/categories, GET /api/price-lists
Ingesta de pedidos desde canales externos. Registrar en Fidel los pedidos generados en una tienda, una app de vendedores o un formulario de mayoristas.
→ POST /api/orders, GET /api/customers
Alimentación de un tablero de BI. Exponer ventas y presupuestos a Power BI, Looker o cualquier herramienta de análisis.
→ GET /api/sales, GET /api/budget-sales
Aplicaciones internas. Catálogo para el equipo comercial, alertas de stock, comparadores de precio, integraciones con sistemas propios.
→ Cualquier combinación de los endpoints anteriores
Autenticación, en resumen 🔑
# 1. Obtener el token (una vez cada 24 hs)
POST {{URL_BASE}}/token
grant_type=password&username=...&password=...&account=...
# 2. Usarlo en cada petición
GET {{URL_BASE}}/api/products
Authorization: Bearer {access_token}
account: {account}El detalle completo, con ejemplos ejecutables, está en Primeros Pasos.
Empezá acá 🚀
Primeros Pasos — obtención del token, primera consulta, paginación, formato de respuestas y errores comunes. Incluye un script completo listo para ejecutar.
Rate Limit — límite de peticiones, comportamiento ante 429 y patrón de reintentos. Leerlo antes de pasar a producción evita reescribir código después.
Si algo no queda claro o encontrás un comportamiento inesperado, contactá a nuestro equipo de soporte.