Esta integración es para ti si tus pedidos nacen en Holded: ventas a tiendas o distribuidores, pedidos por teléfono o por email que metes como pedido de venta. En cuanto creas uno, nos llega para prepararlo. Y en Holded ves en todo momento cómo va: su estado, el transportista, el número de seguimiento y el stock real que tienes en nuestro almacén.
Si vendes en una tienda online (Shopify, WooCommerce…) y Holded solo lo usas para facturar, no necesitas esta integración: conecta tu tienda y listo.
Antes de empezar
Tienes que ser administrador de la cuenta de Holded.
Todos los planes de Holded incluyen la API, pero cada uno con una cuota de llamadas al mes. Te lo explicamos más abajo, en «La cuota de la API de Holded».
Una cuenta de Holded solo puede estar conectada a una cuenta de Furgox.
1. Crea la clave de API en Holded
En Holded, entra en Ajustes → API.
Pulsa Generar nueva clave y ponle un nombre que reconozcas, por ejemplo
Furgox.Marca estos permisos:
inventory:sales-orders.readinventory:sales-orders.writeinventory:products.readinventory:products.writeinventory:warehouses.readinventory:warehouses.writecontacts:contacts.readdevelopers:webhooks.readdevelopers:webhooks.write
Copia la clave. Holded solo la enseña una vez: si cierras la ventana sin copiarla, tendrás que generar otra.
2. Pégala en Furgox
En tu panel, abre Integraciones, pulsa Conectar tienda y elige Holded. Pega la clave y pulsa Conectar con Holded.
Verás una casilla, marcada de serie: crear el almacén «Furgox» como almacén por defecto. Déjala marcada si toda tu mercancía está con nosotros: así tus pedidos nuevos salen de ese almacén en Holded sin que tengas que elegirlo cada vez.
3. Qué hacemos al conectar
Comprobamos la clave y sus permisos. Si falta alguno, te decimos cuál.
Creamos en tu Holded el almacén «Furgox» (si ya tienes uno con ese nombre, usamos ese). Ahí verás el stock real que hay en nuestro almacén.
Damos de alta los avisos de Holded para enterarnos al momento de cada pedido de venta nuevo o cambiado.
Leemos tu catálogo, con sus variantes, SKU y código de barras.
Qué pasa a partir de ahora
Pedidos
Cada pedido de venta que crees en Holded nos llega en segundos. Entran los pedidos pendientes que crees a partir de la conexión; los borradores y los pedidos antiguos no. Las líneas de servicios, como los portes, no se preparan: solo los productos.
La dirección de envío es la que pongas en el pedido. Si el pedido usa la del cliente, la tomamos de su ficha en Holded: su dirección de envío o, si no tiene, la de facturación.
Si prefieres revisar cada pedido antes de que se prepare, activa Aceptar los pedidos yo mismo en la ficha de Holded de tu panel.
Estado y seguimiento en Holded
En el apartado de seguimiento del pedido, en Holded, vas viendo cada paso: en preparación, preparado, enviado, entregado, incidencia, devuelto o cancelado.
Cuando sale del almacén escribimos el transportista y el número de seguimiento y lo marcamos como enviado. Cuando se entrega, apuntamos también la fecha de entrega.
Stock
El almacén «Furgox» de tu Holded refleja las unidades reales que hay en nuestro almacén, según entra mercancía y salen pedidos. Solo tocamos los productos que ya han llegado a Furgox: lo que aún no nos has enviado se queda como lo tengas.
Al marcar un pedido como enviado, Holded descuenta el stock del almacén del pedido. Si el pedido estaba en otro almacén tuyo de Holded, le devolvemos esas unidades, porque en realidad han salido del nuestro.
Productos
Tu catálogo de Holded es la referencia: cuando creas o cambias un producto, lo vemos al momento. Los packs no se importan como producto propio: se preparan sus componentes. Más en Qué hacemos con tu catálogo.
La cuota de la API de Holded
Holded limita las llamadas a su API según tu plan: unas 500 al mes en Starter, 2.000 en Basic, 7.500 en Standard y más en los planes superiores. Por eso los pedidos nos llegan por avisos, que no gastan cuota, y solo escribimos en Holded cuando algo cambia.
Aun así, cada pedido gasta unas cinco llamadas: leer el pedido y el cliente, y escribir el estado y el envío. Con el plan Starter da para unos 100 pedidos al mes. Si mueves más, te conviene un plan superior.
Si se agota la cuota del mes, paramos la sincronización hasta que Holded la renueve y te avisamos en el panel. Mientras tanto seguimos preparando los pedidos que ya nos han llegado.
Lo que no hacemos
No creamos facturas ni tocamos tu contabilidad en Holded: tu facturación sigue igual.
No cambiamos tus SKU de Holded: el vínculo con cada producto va por su identificador interno.
Si cancelas o borras un pedido en Holded antes de que lo preparemos, lo cancelamos. Si ya estaba preparado, te avisamos para que lo veamos juntos.
Si algo no sale bien
«Holded no ha aceptado la clave»
Holded responde igual a una clave mal copiada que a una a la que le falta un permiso. Revisa que la has pegado entera y que tiene marcados todos los permisos de la lista. Si dudas, genera una nueva.
«Holded no nos deja recibir avisos de pedidos nuevos»
Holded solo permite que un programa reciba cada tipo de aviso. Si ya tienes otro conectado, revisamos tus pedidos cada 30 minutos en lugar de al momento, lo que gasta más cuota. Si ese otro programa ya no lo usas, bórralo en Ajustes → Webhooks de Holded y vuelve a conectar.
Un pedido no me llega
Comprueba que no es un borrador y que está pendiente.
Los pedidos fechados antes de conectar no entran.
Si el pedido no tiene dirección, ni en él ni en la ficha del cliente, o sus productos no están en tu catálogo, te avisamos en el panel. Corrígelo en Holded y entra solo.
He regenerado o borrado la clave en Holded
La clave antigua deja de funcionar y la ficha pasa sola a Desconectada. Pulsa Reconectar y pega la nueva: se actualiza la conexión que ya tenías, sin perder pedidos ni histórico. Más en Sincronizar, desconectar o eliminar una tienda.
¿Dudas con los permisos o con la cuota? Escríbenos desde el chat del panel y lo miramos contigo.