Conectar una balanza Dibal al POS de Ágil Factura

Cada parte está escrita para una persona distinta. Ubique la suya y vaya directo a sus secciones: no necesita leer las demás.

La balanza no se conecta directamente al Facturador. Cada ticket recorre cuatro piezas: dos en un PC de la tienda y dos en la nube.

1. La balanza cierra el ticket y lo envía por la red al PC de la tienda.
2. DibalCom lo guarda como un archivo de texto en una carpeta del PC.
3. El servicio de integración revisa esa carpeta cada 5 segundos y envía cada ticket al Facturador.
4. En caja, al escanear el código del ticket, el POS carga todas sus líneas.

Reúna todo lo siguiente antes de ir a la tienda:

1. Ingrese con un usuario administrador y abra Configuración avanzada → pestaña Balanza DIBAL.
2. Ponga Habilitar integración en Sí. Mientras esté en No, el Facturador rechaza los tickets y el POS no muestra la opción de escanearlos.
3. Pulse Generar token y cópielo en ese momento: se muestra una sola vez. Lo necesitará en la sección 09.
4. Anote la dirección del servicio: el dominio con el que la empresa entra al Facturador seguido de /api/dibal/tickets.

https://suempresa.dominio.com/api/dibal/tickets

El POS reconoce cada línea del ticket por el código de artículo que tiene en la balanza. Ese número debe ser igual al código interno del producto en el Facturador.

• Use códigos solo numéricos, de hasta 6 dígitos.
• Asigne a los productos pesados la unidad kilogramo: la cantidad llega en kg, por ejemplo 1,250.
• Cree los productos antes de empezar a vender. Si un producto se crea después de recibido el ticket, su código interno debe coincidir exactamente con el de la balanza, sin ceros de más.

Para entrar a cada parámetro, mantenga pulsada MENU durante 2 segundos y escriba el código. Grabe con la tecla de validar y salga con MENU.

Red

Envío de ventas y ticket

DibalCom se configura con el archivo dibctrl.txt de su carpeta de instalación. Debe guardar un archivo por cada venta en una carpeta que el servicio pueda leer. Complete los datos y copie las líneas resultantes:

Compruébelo: haga una venta en la balanza en modo ticket. En la carpeta de ventas debe aparecer un archivo cuyo nombre son solo números, como 2000150204400.txt.

El servicio funciona con Python 3.8 o superior y no requiere paquetes adicionales. Abra CMD (tecla Windows → cmd → Enter) y compruebe si ya está instalado:

python --version

Si responde Python 3.x.x, continúe en la sección 08. Si no:

1. Descargue el instalador desde python.org/downloads. No lo instale desde Microsoft Store.
2. En la primera pantalla marque Add python.exe to PATH. Sin esta casilla, los comandos de este manual no funcionan.
3. Elija Customize installation → Next → marque Install Python for all users → Install.
4. Si al terminar aparece Disable path length limit, púlselo. Luego Close.
5. Cierre CMD, abra uno nuevo y vuelva a escribir python --version.

1. Solicite la carpeta del servicio al soporte de Ágil Factura.
2. Cópiela directamente en C:\ con el nombre DibalPOSintegration, de modo que quede C:\DibalPOSintegration.
3. Verifique que dentro estén run_service.py, iniciar_servicio.bat y las carpetas src y config.

El config.ini indica al servicio dónde están los archivos, en qué formato vienen y a qué empresa enviarlos. Cree el archivo a partir del ejemplo:

cd C:\DibalPOSintegration
copy config\config.ini.example config\config.ini
notepad config\config.ini

Complete los datos, copie el resultado y reemplace todo el contenido del Bloc de notas:

Primero, una simulación

Haga una venta de prueba en la balanza y ejecute la simulación. No envía nada ni mueve archivos: solo muestra lo que enviaría.

cd C:\DibalPOSintegration
python run_service.py --dry-run

Compare con el ticket impreso los importes, pesos y códigos. Si ve importes 100 veces mayores o menores, corrija los decimales en el config.ini.

Después, el envío real

python run_service.py

2026-09-14 10:42:08 [INFO] Enviado 2013950155407.txt (...) -> HTTP 201

El servicio no lee el código de barras del ticket: lo reconstruye con la opción barcode del config.ini. Si no coincide con el que imprime la balanza, el POS no encontrará el ticket al escanearlo, aunque sí al escribir su número.

Copie del ticket de prueba los 13 dígitos bajo el código, el número de ticket y el total:

La prueba definitiva es escanear el ticket en el POS: si lo carga, quedó bien. Cada vez que cambie barcode, reinicie el servicio.

Instale el servicio como servicio de Windows: arranca solo al encender el PC, sigue funcionando aunque nadie inicie sesión y se reinicia si se detiene.

1. Descargue NSSM desde nssm.cc/download y copie nssm.exe (versión win64) a C:\DibalPOSintegration.
2. Obtenga la ruta de Python con where python y anótela.
3. Abra CMD como administrador y ejecute los comandos de abajo.
4. En la ventana de NSSM complete los tres campos de la tabla y pulse Install service.
5. Inicie el servicio y compruebe en services.msc que figura En ejecución.

# instalar
cd C:\DibalPOSintegration
nssm install DibalPOSIntegration

# iniciar
nssm start DibalPOSIntegration

La integración funciona sola cuando la balanza, DibalCom y el servicio están encendidos. Esto es lo único que hay que hacer en la tienda.

Al encender el PC cada mañana

1. Encienda la balanza y verifique que trabaje en modo ticket: la palabra LABEL no debe aparecer en su pantalla.
2. Abra DibalCom con doble clic en su icono y déjelo abierto; puede minimizarlo. Es el programa que recibe las ventas de la balanza, así que debe estar siempre abierto.
3. Solo si en el escritorio existe el icono “Servicio Balanza”: haga doble clic. Se abre una ventana negra con el mensaje Servicio iniciado en modo continuo. Déjela abierta; puede minimizarla. Si el icono no existe, el servicio ya arranca solo con el PC.

Cobrar un ticket de la balanza

1. En el POS active el interruptor Escanear ticket balanza. Aparece la barra Escanear ticket de balanza (DIBAL).
2. Escanee el código del ticket. Si el lector no lo lee, escriba el número de ticket en la misma barra.
3. Revise que se hayan cargado los productos y cobre como siempre. Puede escanear varios tickets en una misma venta.
4. Al facturar, los tickets quedan marcados y no pueden volver a cobrarse.

Si algo no funciona

Sin coincidencias. Escriba a soporte@agilfactura.com adjuntando una foto del ticket y el archivo logs\servicio.log.

Marque cada punto a medida que lo complete. El avance se guarda en este navegador.

• La integración está activa en el Facturador y el token quedó guardado.
• Los códigos de artículo de la balanza coinciden con los códigos internos de los productos.
• La balanza tiene su IP, la IP fija del PC y los puertos 3000 y 3001.
• La balanza trabaja en modo ticket y con Movimiento de día = SI.
• DibalCom genera un .txt por cada venta, con formato 2.4.
• python --version responde 3.8 o superior.
• El servicio está en C:\DibalPOSintegration.
• El config.ini tiene url, token, formato, decimales, carpeta y verificar_ssl = true.
• La simulación muestra importes y pesos iguales a los del ticket impreso.
• El envío real responde HTTP 201.
• El POS carga el ticket al escanear su código de barras.
• El servicio de Windows figura En ejecución y arranca solo.