Para enviar un JSON (mediante websocket), que fiscalberry lo reciba, lo transforme en un conjunto de comandos compatible con la impresora instalada, conecte con la impresora y responda al websocket con la respuesta que nos envió la impresora.
Descarga la última versión socketio para windows
clonar repo crear enviroment (1 para kivy y otro para modo cli, consola) python3 -m venv .venv.kivy python3 -m venv .venv.cli
luego activar el enviroment que se desea usar, por ejemplo modo solo consola: source venv.cli/bin/activate
instalar requerimientos de modo consola pip install -r requirements.cli.txt
ahora ya puede ejecutar: python src/cli.py
lo mismo si se desea trabajar con interfaz kivy...
Fiscalberry es un servidor de websockets desarrollado en Python pensado para que corra en una raspberry-pi (de ahí viene el nombre de este proyecto). Pero funciona perfectamente en otros sistemas operativos.
Fiscalberry tiene drivers desarrollados para conectarse con 2 tipos de impresoras: Fiscales y Receipt.
Impresoras Fiscales compatibles: Hasar y Epson
Nueva versión con soporte para las últimas impresoras Fiscales de segunda generación (2gen) HASAR y EPSON
Modelos compatibles (HASAR: SMH/PT-250F, EPSON: TM-T900FA)
Impresoras Receipt (de comandas) compatibles: las que soportan ESC/P
Fiscalberry es un 3x1, actúa como: protocolo, servidor y driver facilitando al programador la impresión de tickets, facturas o comprobantes fiscales.
Funciona en cualquier PC con cualquier sistema operativo que soporte Python.
La idea original fue pensada para que funcione en una raspberry pi, cuyo fin es integrar las fiscales al mundo de la Internet de las Cosas (IOT).
Para los desarrolladores que desean enviar a imprimir mediante JSON (es decir, desde algún lugar de la red, internet, intranet, etc, etc) de una forma "estándar" y que funcione en cualquier impresora, marca y modelo.
usando git
git clone https://github.com/paxapos/fiscalberry.git
o directamente el ZIP: https://github.com/paxapos/fiscalberry/archive/master.zip
ATENCIÓN: Funciona con Python 2.7.* NO en Python 3!
probado bajo python 2.7.6 en Linux, Raspian, Ubuntu, Open Suse y Windows
Se necesitan varias dependencias:
sudo pip install -r requirements.txt
Si te encontras con el error "socket.gaierror: Name or service not known"
A veces, en Linux (Open Suse), ser necesario poner el nombre del equipo (hostname) en el archivo /etc/hosts, si es que aún no lo tenías. Generalmente el archivo hosts viene solo con la dirección "127.0.0.1 localhost",
para solucionarlo debés ejecutar el comando
hostname
y ver cuál es el nombre de la máquina para agregarlo al archivo /etc/hosts 127.0.0.1 nombre-PC localhost
sudo python server.py
# o iniciar como demonio linux
sudo python rundaemon.py
Ahora ya puedes conectarte en el puerto 12000 entrando a un browser y la dirección http://localhost:12000
Supongamos que tenemos este JSON genérico:
{
"ACCION_A_EJECUTAR": {
PARAMETROS_DE_LA_ACCION
...
}
}
Lo enviamos usando websockets a un host y puerto determinado (el servidor fiscalberry), éste lo procesa, envía a imprimir, y responde al cliente con la respuesta de la impresora. Por ejemplo, devolviendo el número del último comprobante impreso.
Otro ejemplo más concreto: queremos imprimir un ticket, esta acción en el protocolo fiscalberry se lo llama como acción "printTicket" y está compuesta de 2 parámetros obligatorios: "encabezado" e "items".
El "encabezado" indica el tipo de comprobante a imprimir (y también podría agregarle datos del cliente, que son opcionales). Los ítems son una lista de productos a imprimir donde, en este ejemplo, tenemos una coca cola, con impuesto de 21%, importe $10, descripción del producto "COCA COLA" y la cantidad vendida es 2.
{
"printTicket": {
"encabezado": {
"tipo_cbte": "T", // tipo tiquet *obligatorio
},
"items": [
{
"alic_iva": 21.0, // impuesto
"importe": 10, // importe
"ds": "COCA COLA", // descripcion producto
"qty": 2.0 // cantidad
}
]
}
}
Existen 2 tipos de respuesta y siempre vienen con la forma de un JSON.
Aquellos que son una respuesta a un comando enviado, comienzan con "ret" {"ret": ......}
Aquellos que son un mensaje directo de algun dispositivo conectado, vienen con "msg"
{"msg": ......}
// ejemplo retorno de un mensaje cuando no hay papel
{"msg": ["Poco papel para comprobantes o tickets"]}
Deberás enviar JSON válidos al servidor. Recomendamos usar la pagina http://jsonlint.com/ para verificar como tu programa esta generando los JSON.