Cliente para servicios web de LibreDTE

Este cliente permite realizar la integración con los servicios web de LibreDTE desde cualquier aplicación, y en cualquier lenguaje, que pueda construir un archivo JSON o bien un XML con los datos del documentos que se desea emitir.

La ejecución del cliente se hará a través de llamadas a los comandos del cliente como si fuera cualquier otro programa de la terminal.

Licencia

Este código está liberado bajo licencia AGPL.

Al ser un cliente que se ejecuta separado del programa que lo llama, puede ser utilizado tanto desde software libre como software privativo.

Si se desea modificar o distribuir este cliente, se debe hacer bajo los términos de la licencia AGPL.

Requerimientos

Para poder ejecutar el cliente es necesario tener instalado Python 3 (versión 3.4 o superior) y el SDK de LibreDTE para Python:

La instalación de Python 3 depende del sistema operativo, y en el caso de GNU/Linux es probable que ya venga incluído.

Si utiliza Microsoft Windows deberá descargar e instalar Python 3, marcar la opción "Add Python to PATH". Además revisa la instalación de LXML según se describe aquí.

Una vez instalado Python 3 deberá instalar, usando PIP, el SDK de LibreDTE. En GNU/Linux:

$ sudo pip3 install libredte

En Microsoft Windows:

> pip.exe install libredte

Si desea usar el servidor de WebSockets deberá instalar:

$ sudo pip3 install websockets

(o el equivalente en Microsoft Windows)

Instalación

Para instalar el cliente, se puede clonar directamente el proyecto:

$ git clone https://github.com/LibreDTE/libredte-cliente

O puedes descargar el archivo ZIP con el cliente comprimido.

Se recomienda agregar al PATH del sistema operativo la ruta absoluta hacia libredte-cliente ya que en esta carpeta se encuentra el programa "libredte-cliente.py" que es el comando principal que se debe ejecutar.

¿Cómo ejecuto el cliente?

La forma de ejecución dependerá del sistema operativo, algunos ejemplos son:

GNU/Linux:

$ libredte-cliente.py                           # si está en el PATH y hay permisos ejecución
$ libredte-cliente/libredte-cliente.py          # si no está en el PATH y hay permisos ejecución
$ python libredte-cliente/libredte-cliente.py   # si no está en el PATH y no hay permisos de ejecución

Microsoft Windows:

> python.exe libredte-cliente/libredte-cliente.py

Si todo fue ok en la ejecución del cliente, o sea, se recibió un código 200 desde el servicio web, entonces el retorno del cliente al sistema operativo será 0. En caso de cualquier problema será distinto de 0.

Autenticación

Para poder usar el cliente es necesario contar con el HASH del usuario y que dicho usuario esté autorizado a operar con el contribuyente que se quiere interactuar.

El HASH del usuario se obtiene de la página del perfil del usuario.

Configurar los datos para autenticación en el archivo de configuración config.yml

Comandos disponibles

Se adjunta la documentación y ejemplos de ejecución de los comandos existentes.

dte_generar

Este comando permite generar a partir de los datos en cierto formato, típicamente un archivo JSON o XML, el DTE timbrado y firmado. Dejará 5 archivos en el directorio que se le indique, estos archivos son:

temporal.json respuesta del servicio web que crea el DTE temporal.
emitido.json respuesta del servicio web que crea el DTE real (sin el XML) e incluye el track_id si el DTE fue enviado al SII.
emitido.csv mismos datos que emitido.json, pero en un archivo plano separado por punto y coma.
emitido.xml archivo XML del documento real (sólo si se pasó la opción --getXML al comando).
emitido.pdf archivo PDF del documento real, con copia cedible por defecto.

Generar DTE a partir de entrada en JSON:

$ libredte-cliente.py dte_generar --json=dte.json --dir=resultado

Generar DTE a partir de entrada en XML:

$ libredte-cliente.py dte_generar --xml=dte.xml --dir=resultado

Generar DTE a partir de entrada en XML sin normalizar (el XML trae todos los datos):

$ libredte-cliente.py dte_generar --xml=dte.xml --dir=resultado --normalizar=0

Generar DTE a partir de entrada en otros formatos, ejemplo YAML:

$ libredte-cliente.py dte_generar --archivo=dte.yml --formato=YAML --dir=resultado

Generar DTE a partir de entrada en JSON y enviar automáticamente por correo:

$ libredte-cliente.py dte_generar --hash=1234 --json=dte.json --dir=resultado --email

Es posible especificar la codificación del archivo que se leerá, y que sea transformado automáticamente a UTF-8 por el cliente antes de enviar al servicio web de LibreDTE:

$ libredte-cliente.py dte_generar --json=dte.json --dir=resultado --encoding=ISO-8859-1

dte_estado

Actualizar el estado de un envío de DTE al SII usando el servicio web del SII:

$ libredte-cliente.py dte_estado --rut=76192083 --dte=33 --folio=1

Actualizar el estado de un envío de DTE al SII usando el correo recibido desde el SII:

$ libredte-cliente.py dte_estado --rut=76192083 --dte=33 --folio=1 --metodo=email

dte_emitido_pdf

Descargar PDF y guardar en directorio donde se está llamando al comando con nombre por defecto:

$ libredte-cliente.py dte_emitido_pdf --rut=76192083 --dte=33 --folio=1

Descargar PDF y guardar en una ruta específica con un nombre de PDF personalizado:

$ libredte-cliente.py dte_emitido_pdf --rut=76192083 --dte=33 --folio=1 --pdf=/home/delaf/factura.pdf

Descargar PDF en papel contínuo y guardar en una ruta específica con un nombre de PDF personalizado:

$ libredte-cliente.py dte_emitido_pdf --rut=76192083 --dte=33 --folio=1 --pdf=/home/delaf/factura.pdf --papel=80

dte_crear_pdf

Crear un PDF localmente a partir del XML de un DTE, por el momento sólo se soportan boletas.

Crear PDF con 1 copia tributaria (por defecto):

$ libredte-cliente.py dte_crear_pdf --xml=documento.xml --pdf=documento.pdf

Crear PDF con 2 copias tributarias:

$ libredte-cliente.py dte_crear_pdf --xml=documento.xml --pdf=documento.pdf --copias_tributarias=2

imprimir

Permite imprimir un archivo PDF directamente en la impresora.

En GNU/Linux se deberá instalar el paquete de desarrollo de CUPS y pycups:

# apt-get install libcups2-dev
# pip3 install pycups

En Microsoft Windows se deberá instalar el paquete pywin32.

Imprimir en la impresora por defecto:

$ libredte-cliente.py imprimir --pdf=factura.pdf

Imprimir indicando la impresora:

$ libredte-cliente.py imprimir --pdf=factura.pdf --impresora=Brother_DCP-9020CDN

dte_sincronizar

Enviar todos los archivos XML de un directorio al servidor de LibreDTE:

$ libredte-cliente.py dte_sincronizar --dir=/ruta/a/xmls -vv

dte_masivos

Permite generar masivamente los DTE a partir de un archivo CSV.

$ libredte-cliente.py dte_masivos --emisor=76192083-9 --dir=masivos --csv=emision_masiva.csv

El comando creará en el directorio especificado una carpeta por cada DTE a generar, los archivos de la carpeta serán los mismos del comando dte_generar más un archivo solicitud.json que contiene el JSON del DTE creado a partir de los datos del CSV.

El comando permite enviar directamente los DTE por correo, para esto ejecutar el comando así:

$ libredte-cliente.py dte_masivos --emisor=76192083-9 --dir=masivos --csv=emision_masiva.csv --email

El comando permite generar sólo cotizaciones (documentos temporales) en vez de los reales, para esto ejecutar el comando así:

$ libredte-cliente.py dte_masivos --emisor=76192083-9 --dir=masivos --csv=emision_masiva.csv --cotizacion

monitor

Permite monitorear un directorio e ir creando automáticamente los DTE a medida que se van dejando los archivos con las solicitudes de DTE (ya sea en JSON, XML, YAML u otro formato soportado).

$ libredte-cliente.py monitor --emisor=76192083-9 --dir_entrada=/home/delaf/entrada --dir_salida=/home/delaf/salida

El formato por defecto de los archivos debe ser JSON, si se quiere usar otro, por ejemplo XML, ejecutar con el nombre del formato (misma opción que comando dte_generar):

$ libredte-cliente.py monitor --emisor=76192083-9 --formato=xml --dir_entrada=/home/delaf/entrada --dir_salida=/home/delaf/salida

Si el receptor tiene correo asociado se puede enviar automáticamente el DTE por correo, ejecutar así:

$ libredte-cliente.py monitor --emisor=76192083-9 --dir_entrada=/home/delaf/entrada --dir_salida=/home/delaf/salida --email

Es posible enviar a imprimir directamente el PDF a la impresora por defecto del equipo de la siguiente manera:

$ libredte-cliente.py monitor --emisor=76192083-9 --dir_entrada=/home/delaf/entrada --dir_salida=/home/delaf/salida --imprimir

Es posible especificar la codificación de los archivos que se leerán en el directorio que se estará monitoreando. Con esto, cada archivo será transformado automáticamente a UTF-8 por el cliente antes de enviar al servicio web de LibreDTE:

$ libredte-cliente.py monitor --emisor=76192083-9 --dir_entrada=/home/delaf/entrada --dir_salida=/home/delaf/salida --encoding=ISO-8859-1

El monitor se ejecutará infinitamente y cada 1 segundo revisará el directorio para comprobar si debe generar algún DTE.

websocketd

Permite crear un servidor de websockets para que la aplicación web de LibreDTE se comunique con el computador local. Esto permite, por ejemplo, imprimir directamente desde la aplicación web un DTE sin tener que bajar o abrir un PDF.

Imprimir en la impresora que el computador tenga configurada por defecto (sólo PDF):

$ libredte-cliente.py websocketd --printer_type=system

Imprimir en una impresora en red (PDF o usando ESCPOS para impresoras térmicas):

$ libredte-cliente.py websocketd --printer_uri=172.16.1.219

tdcomcl/libredte-cliente