Índice
¿Qué es esta integración?
La integración con Adaco (el sistema de aprovisionamiento e inventario para hostelería) conecta el stock y las ventas de Golfmanager con Adaco, de forma automática y en los dos sentidos:
Adaco → Golfmanager: el stock de los productos se actualiza en Golfmanager tomando como referencia las existencias de Adaco. Además, los productos nuevos que existan en Adaco y aún no estén en Golfmanager se crean automáticamente.
Golfmanager → Adaco: las ventas realizadas en Golfmanager se envían a Adaco (en un fichero) para que el sistema controle el consumo.
Así, Adaco actúa como fuente de la verdad del inventario y Golfmanager le informa de lo que se vende. Tú sigues vendiendo con normalidad en Golfmanager; el inventario y los pedidos se gestionan en Adaco.
"Regularizar stock" significa ajustar las existencias de un producto en Golfmanager para que coincidan con la cantidad real que indica Adaco. La integración hace este ajuste por ti: calcula la diferencia entre lo que dice Adaco y lo que hay en Golfmanager, y aplica ese ajuste.
¿Qué problema resuelve?
Mantiene el stock al día sin recuentos manuales: Golfmanager refleja automáticamente las existencias de Adaco.
Evita teclear las ventas dos veces: lo vendido en Golfmanager llega solo a Adaco.
Crea automáticamente los productos nuevos que existen en Adaco y aún no están en Golfmanager, con su precio, IVA, código de barras y subfamilia.
Deja rastro de cada sincronización: los ajustes, los envíos de ventas y los posibles errores quedan registrados en dos pantallas de registro.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta Golfmanager con Adaco mediante dos flujos automáticos diarios, cada uno por una vía técnica distinta:
Sincronización de stock (Adaco → Golfmanager): Golfmanager se conecta a Adaco con un usuario y contraseña de API, lee los productos y sus existencias por almacén (Location ID + Site ID), y ajusta el stock. Se ejecuta cada noche, automáticamente, sobre las 02:00.
Envío de ventas (Golfmanager → Adaco): Golfmanager genera un fichero CSV con las ventas del día y lo sube a Adaco por SFTP (una carpeta segura de intercambio de ficheros). Se ejecuta cada noche, automáticamente, sobre las 23:00.
Ambos flujos pueden lanzarse también manualmente cuando lo necesites (ver Cómo se usa en el día a día). Los flujos son independientes: que falle uno no afecta al otro.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Productos y existencias (PLU, descripción, precio de venta, IVA, código de barras, categoría y cantidad en stock por almacén) | Adaco → Golfmanager | Crear los productos que falten y ajustar (regularizar) el stock |
Ventas (centro de ingreso, categoría/subfamilia, PLU, descripción, unidades e importe sin impuestos) | Golfmanager → Adaco | Que Adaco controle el consumo y el inventario |
Los productos se identifican por su PLU (el código de producto de Adaco), que en Golfmanager se corresponde con el SKU (referencia) del producto. Las categorías de Adaco se enlazan con las subfamilias de Golfmanager mediante el Adaco Category ID. Cada almacén se enlaza con una ubicación de Adaco mediante su Location ID y su Site ID.
Requisitos previos (antes de activar la integración)
Tener una cuenta de Adaco con acceso de API (para el stock) y de SFTP (para las ventas).
Tener el módulo Adaco instalado en tu Golfmanager, junto con el módulo de almacén/stock. Si no lo tienes, contacta con soporte.
Las credenciales que facilita Adaco: usuario y contraseña de API, y los datos de SFTP (URL con puerto, usuario, contraseña y carpeta de subida).
Los identificadores de Adaco: el Location ID y el Site ID de cada almacén, y el Category ID de cada categoría que quieras enlazar con una subfamilia.
Que las referencias coincidan: el SKU de cada producto en Golfmanager debe ser igual al PLU del mismo producto en Adaco.
Permisos adecuados: para configurar la integración y consultar los registros se necesita permiso de gestión de facturación.
Cómo se configura en Golfmanager (paso a paso)
La configuración tiene cuatro partes: las credenciales de API, los datos de SFTP, los identificadores de cada almacén y el enlace de las subfamilias. Las credenciales se rellenan en la pantalla de configuración de Adaco; los identificadores se ponen en cada almacén y en cada subfamilia.
Paso 1 — Credenciales de API (para la sincronización de stock)
Accede a Golfmanager.
Ve a Configuración > Adaco, apartado Credenciales de API de Adaco.
Introduce el Usuario (Username) de la API de Adaco.
Introduce la Contraseña (Password) de la API de Adaco.
Guarda los cambios.
Sin estos datos, Golfmanager no podrá leer el stock de Adaco. Se guardan cifrados.
Paso 2 — Datos de SFTP (para el envío de ventas)
En la misma pantalla Configuración > Adaco, ve al apartado Datos SFTP de Adaco.
Introduce la URL de SFTP con puerto (la dirección del servidor seguro de Adaco, incluyendo el puerto).
Introduce el Usuario y la Contraseña de SFTP.
Introduce el Nombre de la carpeta de subida (la carpeta del servidor donde se deja el fichero).
Introduce el Nombre del fichero. Golfmanager le añade automáticamente la fecha y la extensión
.csv, para que cada día tenga un nombre único.Guarda los cambios.
El usuario y la contraseña de SFTP también se guardan cifrados.
Paso 3 — Configurar cada almacén
Entra en la ficha de cada almacén (Warehouse).
Rellena el campo Adaco Location ID con el identificador de ubicación de Adaco.
Rellena el campo Adaco Site ID con el identificador de sitio de Adaco.
Guarda los cambios.
⚠️ Importante: un almacén que no tenga Location ID o Site ID se omite por completo en la sincronización (queda anotado en el registro de errores). Si un almacén no actualiza su stock, revisa primero estos dos campos.
Paso 4 — Enlazar las subfamilias
Entra en cada subfamilia de producto que quieras enlazar.
Rellena el campo Adaco Category ID con la categoría correspondiente de Adaco.
Guarda los cambios.
Así, los productos nuevos que cree la integración quedan clasificados en la subfamilia correcta. Si una categoría de Adaco no está enlazada con ninguna subfamilia, el producto se crea igualmente, pero sin subfamilia.
Paso 5 — Cuadrar las referencias (SKU = PLU)
La integración relaciona cada producto por su PLU de Adaco con el SKU (referencia) del producto en Golfmanager. Revisa que, para cada producto, el SKU en Golfmanager sea exactamente igual al PLU en Adaco. Si no coinciden, el stock no se ajustará sobre el producto correcto (y, si el PLU no existe en Golfmanager, se creará un producto nuevo).
Detalle de cada campo de configuración
A continuación se explica, uno por uno, cada campo que interviene en la integración: qué es, cómo afecta al sistema, cómo se comporta y un ejemplo de uso con lo que ocurre al utilizarlo.
Usuario de API (Username)
Nombre del campo: Usuario, en el apartado Credenciales de API de Adaco (Configuración > Adaco).
Descripción: el usuario con el que Golfmanager se identifica ante la API de Adaco para leer el stock.
Impacto en el sistema: es una de las dos llaves de acceso a la API. Sin él (o si es incorrecto), Golfmanager no puede leer las existencias de Adaco y la sincronización de stock falla.
Comportamiento del sistema: se envía (cifrado) en cada llamada a la API de Adaco junto con la contraseña.
Ejemplo de uso / qué ocurre: introduces el usuario que te facilita Adaco y guardas. A partir de ese momento, la sincronización nocturna de stock y el botón de regularizar podrán autenticarse correctamente.
Contraseña de API (Password)
Nombre del campo: Contraseña, en el apartado Credenciales de API de Adaco.
Descripción: la contraseña asociada al usuario de la API de Adaco.
Impacto en el sistema: completa la autenticación de la API. Si es incorrecta, Adaco rechaza la conexión y no se lee el stock.
Comportamiento del sistema: se guarda cifrada y viaja junto con el usuario en cada petición a Adaco.
Ejemplo de uso / qué ocurre: la introduces, guardas, y la conexión con la API queda lista. Si Adaco te cambia la contraseña, deberás actualizarla aquí o la sincronización empezará a fallar.
URL de SFTP con puerto
Nombre del campo: URL de SFTP con puerto, en el apartado Datos SFTP de Adaco.
Descripción: la dirección del servidor SFTP seguro de Adaco donde se deja el fichero de ventas, incluyendo el número de puerto.
Impacto en el sistema: es el destino del envío de ventas. Sin ella (o si está mal), el fichero no se puede subir y el envío de ventas falla.
Comportamiento del sistema: Golfmanager se conecta a esta dirección por SFTP para depositar el fichero CSV del día.
Ejemplo de uso / qué ocurre: introduces la dirección con su puerto (por ejemplo,
sftp.adaco.com:22). Al enviar ventas, el fichero se sube a ese servidor.
Usuario de SFTP
Nombre del campo: Usuario, en el apartado Datos SFTP de Adaco.
Descripción: el usuario con el que Golfmanager se autentica en el servidor SFTP de Adaco.
Impacto en el sistema: sin un usuario válido, el servidor SFTP rechaza la conexión y las ventas no se suben.
Comportamiento del sistema: se guarda cifrado y se usa en cada conexión SFTP.
Ejemplo de uso / qué ocurre: lo introduces y guardas. El siguiente envío de ventas (automático o manual) se conecta con este usuario.
Contraseña de SFTP
Nombre del campo: Contraseña, en el apartado Datos SFTP de Adaco.
Descripción: la contraseña del usuario de SFTP.
Impacto en el sistema: completa la autenticación SFTP. Si es incorrecta, el envío de ventas falla y queda registrado como fallido.
Comportamiento del sistema: se guarda cifrada y acompaña al usuario en la conexión SFTP.
Ejemplo de uso / qué ocurre: la introduces, guardas y el envío queda operativo. Si Adaco la cambia, actualízala aquí.
Nombre de la carpeta de subida
Nombre del campo: Nombre de la carpeta de subida, en el apartado Datos SFTP de Adaco.
Descripción: la carpeta del servidor SFTP donde Adaco espera recibir el fichero de ventas.
Impacto en el sistema: determina dónde se deja el fichero dentro del servidor. Si la dejas vacía, el fichero se sube a la raíz del servidor; si la rellenas, se sube dentro de esa carpeta.
Comportamiento del sistema: Golfmanager construye la ruta de destino combinando esta carpeta con el nombre del fichero.
Ejemplo de uso / qué ocurre: si pones
ventasy el fichero del día esSales06222026.csv, el fichero acaba enventas/Sales06222026.csv. Debe coincidir con la carpeta que Adaco te haya indicado.
Nombre del fichero
Nombre del campo: Nombre del fichero, en el apartado Datos SFTP de Adaco.
Descripción: el nombre base del fichero de ventas que se sube a Adaco.
Impacto en el sistema: define cómo se llama cada fichero. Golfmanager le añade automáticamente la fecha y la extensión
.csv, de modo que cada día se genera un fichero con nombre distinto y no se sobrescriben entre sí.Comportamiento del sistema: al exportar, Golfmanager toma este nombre base, le concatena la fecha del envío y la extensión, y sube el resultado.
Ejemplo de uso / qué ocurre: si pones
Sales, el fichero del 22 de junio de 2026 se llamaráSales06222026.csv(la fecha va en formato mes-día-año).
Adaco Location ID (en cada almacén)
Nombre del campo: Adaco Location ID, en la ficha del almacén (Warehouse).
Descripción: el identificador de la ubicación de Adaco a la que corresponde ese almacén de Golfmanager.
Impacto en el sistema: junto con el Site ID, es lo que permite leer el stock del almacén en Adaco. Si falta, el almacén se omite en toda la sincronización.
Comportamiento del sistema: Golfmanager usa el par Location ID + Site ID para pedir a Adaco los productos y existencias de esa ubicación concreta.
Ejemplo de uso / qué ocurre: rellenas el Location ID que te da Adaco para ese almacén. En la siguiente sincronización, ese almacén ya recibe el stock correspondiente; mientras esté vacío, se queda fuera y aparece anotado en el registro de errores.
Adaco Site ID (en cada almacén)
Nombre del campo: Adaco Site ID, en la ficha del almacén (Warehouse).
Descripción: el identificador del sitio de Adaco asociado a ese almacén.
Impacto en el sistema: es el segundo identificador imprescindible. Sin él, el almacén se omite aunque tenga Location ID.
Comportamiento del sistema: se combina con el Location ID para localizar exactamente la ubicación de Adaco de la que se lee el stock.
Ejemplo de uso / qué ocurre: rellenas el Site ID que te facilita Adaco y guardas. Con Location ID y Site ID correctos, el almacén entra en la sincronización nocturna y en la regularización manual.
Adaco Category ID (en cada subfamilia)
Nombre del campo: Adaco Category ID, en la ficha de la subfamilia.
Descripción: el identificador de la categoría de Adaco que se enlaza con esa subfamilia de Golfmanager.
Impacto en el sistema: cumple dos funciones. (1) Al crear productos nuevos desde Adaco, los clasifica en la subfamilia correcta. (2) Al enviar ventas, se usa como identificador de categoría del producto en el fichero.
Comportamiento del sistema: cuando Adaco envía un producto con una categoría, Golfmanager busca la subfamilia cuyo Category ID coincide y se la asigna; si no encuentra ninguna, el producto se crea sin subfamilia.
Ejemplo de uso / qué ocurre: enlazas la categoría "Bebidas" de Adaco con tu subfamilia "Bebidas" poniendo su Category ID. Los refrescos nuevos que cree la integración entrarán ya dentro de "Bebidas".
SKU / Referencia del producto (= PLU de Adaco)
Nombre del campo: SKU (Referencia), en la ficha del producto.
Descripción: la referencia del producto en Golfmanager. Es el campo que debe coincidir con el PLU (código de producto) de Adaco.
Impacto en el sistema: es la clave que enlaza cada producto de Adaco con su equivalente en Golfmanager. Determina sobre qué producto se ajusta el stock y qué PLU se envía en las ventas.
Comportamiento del sistema: al sincronizar, Golfmanager busca el producto cuyo SKU es igual al PLU recibido. Si lo encuentra, le ajusta el stock; si no, crea un producto nuevo con ese SKU.
Ejemplo de uso / qué ocurre: si en Adaco el agua tiene PLU
AGUA50, ponAGUA50como SKU del agua en Golfmanager. A partir de ahí, su stock se regulariza correctamente y sus ventas viajan con ese PLU. Si los códigos no coinciden, el stock no se ajusta donde debe.
Cómo se usa en el día a día
Una vez configurada, la integración funciona sola: cada noche sincroniza el stock (sobre las 02:00) y envía las ventas del día (sobre las 23:00). No tienes que hacer nada. Aun así, puedes lanzar ambos procesos a mano cuando lo necesites.
Regularizar el stock manualmente
Entra en la ficha del almacén que quieras actualizar.
Pulsa el botón Regularizar stock con Adaco.
Verás el aviso "La regularización de stock ha comenzado. Puede tardar unos minutos. Consulta más tarde el registro de errores de Adaco para ver los resultados."
Pasados unos minutos, revisa el registro de errores de Adaco para ver el resultado y cualquier incidencia.
Qué ocurre / comportamiento del sistema: Golfmanager se conecta a Adaco, lee los productos y existencias de ese almacén, ajusta el stock de los productos que coinciden por referencia, crea los productos nuevos que cumplan los requisitos y anota en el registro de errores todo lo que no haya podido procesar.
Enviar las ventas manualmente
Entra en Adaco > Listado de ventas.
Selecciona el periodo de fechas con el selector (por defecto, hoy). La tabla muestra las ventas que se enviarán, con columnas: Centro de ingreso, Nombre de producto, SKU, ID de subfamilia, Unidades e Importe sin impuestos.
Pulsa Subir ventas a Adaco.
Si todo va bien, verás el mensaje "Detalles de ventas enviados correctamente a Adaco". El envío queda registrado en el log de exportación de ventas.
Qué ocurre / comportamiento del sistema: Golfmanager toma las ventas del periodo (solo de productos que controlan stock), genera el fichero CSV, lo sube por SFTP a la carpeta configurada con el nombre del día y registra el envío. Si no hay ventas en el periodo, avisa con "No hay datos de ventas para exportar" y no sube ningún fichero.
Cómo comprobar que funciona
Ve a Configuración > Adaco y verifica que están guardadas las credenciales de API y los datos de SFTP.
Comprueba que al menos un almacén tiene su Location ID y su Site ID.
Comprueba que las subfamilias que quieras enlazar tienen su Category ID.
Entra en ese almacén y pulsa Regularizar stock con Adaco.
Espera unos minutos y abre el Registro de errores de Adaco: si no hay incidencias graves, el stock se habrá ajustado.
Ve a Adaco > Listado de ventas, deja el periodo en "hoy", pulsa Subir ventas a Adaco y confirma que aparece "Detalles de ventas enviados correctamente a Adaco" y un registro nuevo en el log de exportación de ventas con estado correcto.
Consultar los registros (logs)
El menú Adaco incluye dos registros para revisar qué ha pasado en cada sincronización:
Registro de errores (Error Logs): incidencias de la sincronización de stock. Cada anotación indica la fecha, el tipo de error, el almacén, el PLU del producto afectado, el Location ID y Site ID, el motivo y si fue automática o manual. Los errores que afectan a varios productos se agrupan e indican cuántos productos se han visto afectados, con el detalle de cada uno.
Registro de exportación de ventas (Sales Export Logs): cada envío de ventas a Adaco, con la fecha, el estado (correcto, fallido u omitido), si fue automático o manual, cuántas ventas se enviaron, el nombre del fichero, la ruta en el servidor y el mensaje de error si lo hubo.
Son la primera pantalla que debes revisar cuando el stock o las ventas no han salido como esperabas.
Limitaciones a tener en cuenta
Los almacenes necesitan Location ID y Site ID. Sin ambos, ese almacén se omite por completo.
Los productos se enlazan por referencia (SKU = PLU). Si no coinciden exactamente, el stock no se ajusta sobre el producto correcto.
Para crear un producto nuevo desde Adaco hacen falta tres cosas: PLU, nombre y un IVA que ya exista en Golfmanager. Si falta alguno, el producto no se crea y se anota en el registro de errores.
Los productos sin stock o con stock cero se omiten en la regularización.
El envío de ventas solo incluye productos que controlan stock. Las ventas de productos que no gestionan stock no viajan en el fichero.
Depende de servicios externos: si la API o el SFTP de Adaco no están accesibles, la sincronización o el envío fallarán y quedarán registrados.
La sincronización no es instantánea: los procesos automáticos se ejecutan una vez al día (stock sobre las 02:00, ventas sobre las 23:00); el resto del tiempo, el stock puede diferir hasta la siguiente sincronización (o hasta que la lances a mano).
La regularización automática procesa los almacenes uno a uno, con una pausa entre ellos para no saturar a Adaco; con muchos almacenes, el proceso completo puede tardar bastante.
No hay devolución de stock a Adaco: Golfmanager informa de las ventas, pero los ajustes de inventario y los pedidos se gestionan en Adaco.
Preguntas frecuentes
¿Qué es el PLU y por qué tiene que coincidir con el SKU?
El PLU es el código con el que Adaco identifica cada producto. En Golfmanager ese código se corresponde con el SKU (referencia) del producto. La integración usa esa igualdad para saber qué producto de Golfmanager es cada producto de Adaco: busca el producto cuyo SKU es igual al PLU. Si los códigos no coinciden exactamente, el stock no se ajustará sobre el producto correcto y, si el PLU no existe como SKU en Golfmanager, se creará un producto nuevo.
¿Cada cuánto se actualiza el stock y a qué hora?
La sincronización de stock (Adaco → Golfmanager) se ejecuta automáticamente cada noche, sobre las 02:00. Entre una sincronización y la siguiente, el stock de Golfmanager puede diferir del de Adaco. Si necesitas actualizarlo antes, usa el botón Regularizar stock con Adaco en la ficha del almacén.
¿Cada cuánto se envían las ventas y a qué hora?
El envío de ventas (Golfmanager → Adaco) se ejecuta automáticamente cada noche, sobre las 23:00, e incluye las ventas del día. También puedes enviarlas a mano en cualquier momento desde Adaco > Listado de ventas, eligiendo el periodo que quieras.
¿Puedo lanzar la sincronización a mano sin esperar a la noche?
Sí. Para el stock, entra en la ficha del almacén y pulsa Regularizar stock con Adaco. Para las ventas, ve a Adaco > Listado de ventas, elige el periodo y pulsa Subir ventas a Adaco. Ambos procesos quedan registrados igual que los automáticos, marcados como "manual".
Un almacén no actualiza su stock. ¿Por qué?
La causa más habitual es que al almacén le falta el Adaco Location ID o el Adaco Site ID. Un almacén sin ambos identificadores se omite por completo en la sincronización y se anota en el registro de errores con el motivo "LocationId o siteId no válidos. Se omite la regularización de stock". Entra en la ficha del almacén, rellena los dos campos y guarda.
En el registro veo "N productos no tienen PLU". ¿Qué significa y qué hago?
Significa que Adaco ha enviado productos sin código PLU, y sin PLU la integración no puede identificarlos ni regularizarlos, así que los omite. La solución está en Adaco: revisa esos productos y asígnales su PLU. En el detalle del registro puedes ver de qué productos se trata.
Veo "N productos no tienen IVA / tarifa de impuesto". ¿Cómo lo resuelvo?
Aparece cuando la integración intenta crear un producto nuevo desde Adaco pero el IVA que indica Adaco no existe como tipo de impuesto en Golfmanager. Sin un IVA equivalente, el producto no se crea. La solución es crear o ajustar en Golfmanager el tipo de IVA correspondiente para que su porcentaje coincida con el que envía Adaco; en la siguiente sincronización el producto ya podrá crearse.
Veo "N productos no tienen nombre". ¿Qué pasa?
Son productos que Adaco envía sin descripción. Como un producto necesita nombre para crearse, la integración los omite en la creación. Añade la descripción de esos productos en Adaco y volverán a procesarse en la siguiente sincronización.
Veo "N productos no tienen stock o tienen stock cero". ¿Es un error?
No es un error grave: es simplemente un aviso de que esos productos llegan con stock cero o sin stock desde Adaco, y por eso se omiten en la regularización (no se ajusta nada sobre ellos). Si esperabas que tuvieran existencias, revisa su stock en Adaco.
El stock de un producto concreto no se ajusta, pero el resto sí. ¿Por qué?
Casi siempre es porque el SKU de ese producto en Golfmanager no coincide con su PLU en Adaco. Al no encontrar coincidencia exacta, la integración no ajusta su stock (y, si el PLU no existe como SKU, puede haber creado un producto duplicado nuevo). Corrige la referencia (SKU) para que sea idéntica al PLU.
Veo "No se han encontrado productos en Adaco para locationId... siteId...". ¿Qué significa?
Quiere decir que la combinación de Location ID y Site ID de ese almacén es válida para conectar, pero Adaco no ha devuelto ningún producto para esa ubicación. Comprueba en Adaco que esos identificadores corresponden a la ubicación correcta y que esa ubicación tiene productos.
Veo "No se han encontrado almacenes en Golfmanager". ¿Qué reviso?
Significa que no hay ningún almacén configurado con Location ID y Site ID, así que la sincronización no tiene dónde aplicar el stock. Configura al menos un almacén con sus dos identificadores de Adaco.
¿La integración crea productos nuevos por su cuenta? ¿Qué necesita para crearlos?
Sí. Si Adaco envía un producto cuyo PLU no existe como SKU en Golfmanager, la integración lo crea automáticamente. Para poder crearlo necesita tres datos: PLU, nombre (descripción) y un IVA que ya exista en Golfmanager. Si le falta cualquiera de los tres, no lo crea y lo anota en el registro de errores. Al crearlo, además, le asigna el precio de venta y el código de barras que vengan de Adaco y lo marca para que controle stock.
¿En qué subfamilia queda un producto nuevo creado desde Adaco?
En la subfamilia cuyo Adaco Category ID coincide con la categoría que envía Adaco. Si la categoría de Adaco no está enlazada con ninguna subfamilia (porque no has rellenado su Category ID), el producto se crea igualmente, pero sin subfamilia. Por eso conviene enlazar todas las categorías que uses.
¿Qué precio y qué IVA se asignan al producto nuevo?
El precio de venta se toma del dato de precio que envía Adaco (si no viene, se queda a 0 y deberás revisarlo). El IVA se asigna buscando, entre los tipos de impuesto de Golfmanager, el que coincide con el porcentaje que indica Adaco; si no existe ninguno equivalente, el producto no llega a crearse (ver la pregunta sobre "no tienen IVA").
¿Qué información viaja en el fichero de ventas que se sube a Adaco?
Por cada línea de venta, el fichero incluye: el centro de ingreso (el TPV donde se vendió), el identificador de categoría (el Category ID de la subfamilia), el PLU (el SKU del producto), la descripción del producto, las unidades vendidas y el importe sin impuestos. Solo se incluyen productos que controlan stock.
Hay ventas que no aparecen en el fichero. ¿Por qué?
El envío de ventas solo incluye productos que controlan stock. Las ventas de productos que no gestionan stock (por ejemplo, ciertos servicios) no se incluyen en el fichero de Adaco, porque Adaco gestiona inventario. Si esperabas ver un producto y no está, comprueba si ese producto tiene activado el control de stock.
¿Cómo se llama el fichero que se sube y por qué cambia cada día?
El nombre se forma con el nombre base que configuraste, más la fecha del envío, más la extensión .csv. Por ejemplo, si el nombre base es Sales, el fichero del 22 de junio de 2026 será Sales06222026.csv (la fecha va en formato mes-día-año). Cambia cada día para que los envíos no se sobrescriban entre sí.
Al subir ventas me sale "No hay datos de ventas para exportar". ¿Qué pasa?
Significa que en el periodo seleccionado no hay ventas que enviar (de productos con stock). No se sube ningún fichero. Revisa que el periodo del selector incluye días con ventas; recuerda que por defecto muestra "hoy".
Me sale "Error al enviar los detalles de ventas a Adaco". ¿Qué reviso?
Quiere decir que Golfmanager no ha podido subir el fichero por SFTP. Lo más habitual es que la URL con puerto, el usuario, la contraseña o la carpeta de subida de SFTP sean incorrectos, o que el servidor de Adaco no esté accesible en ese momento. Revisa esos datos en Configuración > Adaco y vuelve a intentarlo; el detalle del fallo queda en el registro de exportación de ventas.
¿Dónde compruebo si las ventas se enviaron de verdad?
En el Registro de exportación de ventas (Sales Export Logs) del menú Adaco. Cada envío aparece con su estado (correcto, fallido u omitido), si fue automático o manual, cuántas ventas se enviaron, el nombre del fichero, la ruta y el mensaje de error si lo hubo. Es la forma fiable de confirmar que un envío salió bien.
En el registro de ventas veo un envío con estado "omitido". ¿Es un problema?
No. El estado omitido aparece cuando el envío automático se ejecutó pero no había ventas que enviar ese día (el motivo registrado es "No se encontraron ventas para exportar"). Simplemente no se generó fichero porque no había nada que mandar.
¿Qué pasa si Adaco no está disponible cuando toca sincronizar?
Si la API de stock o el SFTP de ventas no responden, ese proceso falla y queda registrado (en el registro de errores o en el de exportación de ventas, según el caso). No se pierde nada: en la siguiente ejecución automática, o lanzándolo a mano, se vuelve a intentar.
¿Puedo reenviar las ventas de un día anterior o de un periodo concreto?
Sí. En Adaco > Listado de ventas, usa el selector de fechas para elegir el periodo que quieras (un día, varios días, un rango) y pulsa Subir ventas a Adaco. Se generará y subirá el fichero con las ventas de ese periodo.
¿La regularización automática tarda mucho si tengo muchos almacenes?
Puede tardar. Para no saturar a Adaco, la sincronización automática procesa los almacenes uno a uno con una pausa entre ellos. Con muchos almacenes configurados, el proceso completo de la noche puede llevar un rato; no es un fallo, es el ritmo controlado de las llamadas.
¿Qué permisos necesito para configurar la integración y ver los registros?
Necesitas permiso de gestión de facturación. Con ese permiso puedes acceder a la pantalla de configuración de Adaco y a los dos registros (errores y exportación de ventas).
¿Las credenciales que introduzco se guardan de forma segura?
Sí. El usuario y la contraseña de la API y el usuario y la contraseña de SFTP se guardan cifrados. No se muestran en claro una vez guardados.
He cambiado el PLU de un producto en Adaco. ¿Qué ocurre en Golfmanager?
Como la integración enlaza por la igualdad SKU = PLU, si cambias el PLU en Adaco y no actualizas el SKU en Golfmanager, la integración dejará de encontrar el producto existente y, al ver un PLU "nuevo", podría crear un producto duplicado. Si cambias un PLU en Adaco, actualiza también el SKU del mismo producto en Golfmanager para mantenerlos cuadrados.
Buenas prácticas recomendadas
Cuadra las referencias antes de empezar: que el SKU de cada producto en Golfmanager coincida exactamente con su PLU en Adaco.
Configura todos los almacenes con su Location ID y Site ID, y todas las subfamilias que uses con su Category ID.
Revisa que los IVA de Adaco existan en Golfmanager antes de la primera sincronización, para que los productos nuevos se puedan crear sin problemas.
Tras la implantación, revisa los registros los primeros días para detectar productos sin IVA, sin nombre o sin PLU, y corregirlos en Adaco.
Usa el envío manual cuando necesites poner al día un periodo concreto sin esperar al proceso nocturno.
Si cambias credenciales o identificadores en Adaco, actualízalos también en Golfmanager para que la integración no empiece a fallar.