search

reingart / pyfiscalprinter

Drivers for invoice/tickets fiscal printers (Epson & Hasar) Argentina - mirror of https://code.google.com/p/pyfiscalprinter/
GNU Lesser General Public License v3.0
34 stars 26 forks source link

Documentación. #2

Open injaon opened 9 years ago

injaon commented 9 years ago

Podrian, por favor, agregar un poco de documentación? Qué dependencias tiene? Cómo se instala? como se usa? etc.

Gracias.

marianobianchi commented 8 years ago

Me encantaría aportar a este proyecto. Pero lo veo difícil sin un poco de documentación. Lo primero que se me viene a la mente que podrían subir sería la documentación de los drivers para las impresoras. Es decir, que datos se deben mandar por que puerto para hacer las impresiones. Imagino que deben tenerlas a mano ya que las deben haber usado para hacer esto.

Hace rato tengo ganas de hacer un sistema de facturación que use una impresora fiscal y este proyecto me viene al pelo, por lo que me gustaría aportar todo lo que se pueda.

jlgasparrini commented 8 years ago

Yo estuve trabajando con este driver para una app Ruby on Rails, realmente es genial, pero la falta de documentación hizo muy dificultoso mi trabajo!

Lamentablemente está abandonado este proyecto y no creo que la documentación este disponible! Pero te super recomiendo que leas el código, mires bien los ejemplos y pruebes correrlos con un emulador fiscal!

Yo utilizando este emulador en una máquina virtual pude completar el desarrollo de mi aplicación sin problemas alguno.

Hace un par de meses que mi aplicación esta en producción y nunca hubo problemas, se pueden crear Facturas, Notas de Debito y Notas de Credito, todos documentos fiscales!

reingart commented 8 years ago

@marianobianchi: la documentación "oficial" no se puede subir por temas de copyright (especialmente la de EPSON y HASAR que si no recuerdo mal tenían clausulas que prohíben publicar sus manuales).

Igualmente no es tan necesario saber los protocolos de bajo nivel, ya que la idea es abstraerlo y manejarlo directamente con las clases provistas.

@jlgasparrini, no está abandonado el proyecto, pero la dedicación necesaria implica tiempo y recursos que hasta ahora no hubo interesados en aportar/contribuir/solventar. En mi caso, yo ofrezco soporte comercial pago para estos temas (tanto asesoramiento, instalación y modificaciones), y aporto todo lo que se va generando de nuevo al proyecto (por ejemplo nuevos desarrollos ver branch panama/chile).

Desde ya el proyecto está abierto a colaboraciones. Está disponible la parte de wiki para que puedan documentar las experiencias (por ej., un howto o tutorial) y en todo caso ir esbozando un manual que luego se podría ir completando gradualmente. También pueden hacer Pull Request con correcciones y sugerencias concretas.

Por ej., en respuesta a @injaon, este proyecto no tiene mayores dependencias (ver los imports), por lo que solo requiere pyserial para el uso básico (igualmente agregué un requirements.txt en 6119d4dce68f606315daccbc886f8abd60ed3906). En Windows opcionalmente posiblemente necesiten pywin32 (para instalarlo como servicio), y en Linux dbus-python (en ambos casos solo si se quiere utilizar desde otros lenguajes de programación)

El uso es bastante simple, ver test.py.

Se podrían ir documentando los pasos de instalación y los métodos. ver proyecto relacionado de factura electrónica PyAfipWs: