Saltar al contenido principal
La API de Bold permite leer y actualizar datos operativos desde sistemas externos. Úsala para sincronizar catálogo, stock, pedidos, producción, compras, ventas y eventos con sistemas de gestión, herramientas de análisis, automatizaciones internas o herramientas propias.
La referencia completa se genera desde OpenAPI. Puedes consultarla en la sección Referencia de API o abrirla en https://api.bold-factory.com/docs.

​
Qué puedes integrar

Datos maestros

Productos, artículos, propiedades, variantes y unidades.

Almacén

Ubicaciones, lotes, recepciones, envíos, inventarios y stock.

Planificación

Demanda, suministro, stock proyectado, clientes y proveedores.

Producción

Recetas, versiones, órdenes, operaciones, recursos y ejecución.

Personas y permisos

Usuarios, perfiles, empleados, jornadas, calendarios, turnos y tareas.

Mantenimiento

Activos, acciones, causas, partes de trabajo, tiempos, materiales y preventivos.

Compras y ventas

Pedidos de compra, pedidos de venta, recepciones, envíos y líneas.

Notificaciones

Eventos, suscripciones personales, bandeja de app y lectura de avisos.

Analítica

Informes Power BI integrados, credenciales de apertura, duplicación y creación de informes.

Etiquetas

Plantillas, elementos de diseño y generación de documentos PDF.

​
Referencia exacta

La sección Referencia de API usa https://api.bold-factory.com/openapi/v1.json para generar rutas, parámetros, esquemas de petición y respuesta, modelos y pruebas interactivas.

Abrir referencia externa

Usa la referencia publicada por Bold si quieres verla fuera de esta documentación.

​
Patrón base

Las rutas públicas usan versión en la URL: 
GET /v1/items/products
GET /v1/warehouse/locations
GET /v1/planning/salesOrders
GET /v1/production/orders
Las respuestas y errores usan JSON. Los listados paginados devuelven una estructura común con results, pageNumber, pageSize, totalPages y totalCount.

​
Flujo recomendado

1

Crea una clave API

Crea una clave desde Panel de control > Acceso > Claves API. Usa una clave distinta por integración para poder revocarla sin afectar otros sistemas.
2

Prueba lectura antes de escribir

Empieza con rutas GET para validar autenticación, organización, permisos y paginación.
3

Sincroniza identificadores

Guarda las referencias de Bold que devuelven las rutas. Evita depender solo de nombres visibles, porque los nombres pueden cambiar.
4

Activa webhooks

Usa webhooks para enterarte de cambios sin consultar la API en bucle.

​
Convenciones

ConvenciónUso
v1Versión pública actual de la API.
referenceIdentificador funcional visible en varias entidades.
idIdentificador técnico de una entidad.
pageNumberNúmero de página, empezando en 1.
pageSizeTamaño de página. El máximo validado por Bold es 1000.
Para integraciones críticas, combina webhooks con reconciliaciones periódicas paginadas. El webhook te avisa rápido y la reconciliación detecta cualquier evento perdido.