Skip to main content
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:
Las respuestas y errores usan JSON. Los listados paginados devuelven una estructura común con results, pageNumber, pageSize, totalPages y totalCount.

​
Consistencia entre módulos

Algunas acciones actualizan más de un módulo. Por ejemplo, una recepción aumenta stock físico y también puede cambiar datos usados por planificación. Esos cambios relacionados pueden tardar unos segundos en aparecer en todas las vistas y consultas. Si tu integración encadena operaciones, vuelve a leer el recurso antes de tomar decisiones críticas y usa reintentos breves cuando dependas de datos calculados. Para integraciones críticas, combina webhooks con reconciliaciones paginadas. El webhook avisa rápido y la reconciliación confirma el estado final.

​
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 endpoints GET para validar autenticación, tenant, permisos y paginación.
3

Prueba lectura antes de escribir

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

Sincroniza identificadores

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

Sincroniza identificadores

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

Activa webhooks

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

​
Convenciones

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.