Factura Electrónica con Python


Interfaz Python de software libre para Emisión y almacenamiento electrónico de comprobantes originales AFIP - Argentina.

RG 1956/05, 1361/02, 1345/02, 2265/07, 2289/07 y 2557/09

Índice

logo-pyafipws.png


Descripción General

PyAfip.ws contienen módulos para acceder a los servicios webs de factura electrónica de la AFIP, basados en los ejemplos disponibles en el sitio de homologación:

  • wsaa.py: interface con Web-Service Autenticación y Autorización (basado en wsaa-client.php)
  • wsfe.py: interface con el Web-Service de Factura Electrónica (basado en wsfe-client.php)
  • wsbfe.py: interface con el Web-Service de Factura Electrónica Bienes de Capital - Bono Fiscal Electrónico
  • pyafipws.py: servidor COM para acceder a los servicios web desde otros lenguajes en windows (VB, VFP, Delphi, etc.)
  • pyrece.py: aplicativo factura electrónica simil SIAP RECE (gui)
  • rece.py: utilitario para factura electrónica por archivo de texto (consola)
  • receb.py: utilitario para factura electrónica bienes de capital por archivo de texto (consola)
  • rg1361.py: utilitario para almacenamiento de duplicados - SIAP SIRED (consola)

Son completamente funcionales (Fueron testeados en servidores de homologación), aunque wsfe.py es solo un ejemplo que se debe adaptar a cada caso particular. Para evitar adaptar el wsfe para cada caso, se intenta refactorizar estos ejemplos en algo más usable tanto desde python como desde linea de comando.

Observaciones

Para la traducción de los ejemplos PHP proporcinados por la AFIP, se intentó mantener la estructura de dicho código, a manera de ejemplo de traducción de php a py y para aseguramos cumplir el mismo método, facilitando la verificación y validación.

Cuando fue necesario, se agregaron funciones o objetos que emulaban a los de php, y se modificó en el caso en que las construcciones en python eran mejores.

XML

El ejemplo en php utiliza SimpleXMLElement, que es una herramienta para trabajar con XML de manera simple y orientada a objetos.

Esta herramienta se reimplementó en python encapsulando xml.dom.minidom (ver SimpleXmlElement en pyafip/ws/simplexml.py)

La principal diferencia es que no convierte los tipos (int, long, etc.). Siempre devuelve elementos xml (texuales), que hay que convertirlos explicitamente.

SOAP

Por el lado de web-services, se intento con SOAPpy, y en menor medida soap.py, y no se llegó a probar ZSI.

Aparentemente el WSAA es un webservice en java, donde no hubo problema en usar SOAPpy, pero el WSFE es .NET, donde SOAPpy no funciona por incompatibilidades en el manejo de XML.

Ante las incompatibilidades, se decidió hacer una implementación del cliente soap desde cero (ver SoapClient en pyafip/ws/soap.py), utilizando httplib2 para la conexión y SimpleXMLElement para el manejo del requerimiento y respuesta XML. Esto posibilitó armar los xml de manera compatible con el web service en .NET y comunicarse sin problemas.

Este cliente es simple y minimo, pero funcional. El unico inconveniente es que no parsea el wsdl, por lo que hay que extraer los datos del web service manualmente (SOAPAction y el espacio de nombres a utilizar). Tampoco se puede listar los métodos disponibles, pero esto no es problema ya que se puede leer el wsdl.

Al usar SimpleXmlELement, realiza la serialización simple convirtiendo a string, pero la desserialización debe ser hecha manualmente (conversión de tipos o creación de objetos).

Varios

Textos de Ancho Fijo

Para la interfaz de texto por línea de comando (consola), se desarrollaron funciones para facilitar el manejo de archivos de texto con campos de ancho fijo (formatos utilizados por ej. por COBOL y los aplicativos SIAP de la AFIP). Ver pyafip/ws/rece.py, pyafip/ws/receb.py

Interfaz por base de datos

Estamos desarrollando una herramienta generica para autorización y generación de facturas electrónicas mediante bases de datos, unificando los servicios web (WSFE, WSBFE y WSFEX).

Generación de PDF

Para crear las facturas electrónicas en formato PDF se utilizó la librería PyFpdf, mejorándola y adaptándola con los siguientes temas:

  • Impresión de código de barras (ver Interleaved2of5 en pyfpdf/FPDF.py)
  • Definición de campos por CSV, para poder modificar el diseño fácilmente (ver pyfpdf/ejemplos/form.py)
  • Mejoras y correcciones menores

Interfaz Gráfica PythonCard

Existen algunos temas menores con los unicodes entre distintas plataformas (Windows y Linux)

Ficha técnica

Instalación

  • En Debian GNU/Linux:
    apt-get install python-httplib2 python-m2crypto
    
  • En Windows:
  • Crear certificados con OpenSSL (ver PyAfipWs#Certificados)

Interfase con otros Lenguajes

Se ha desarrollado una interface COM autoinstalable para windows compatible con otros lenguajes (Visual Basic, Visual Fox Pro, Delphi, PHP, .Net, Java, etc.) y una interfase por archivo de texto simil SIAP/RECE para lenguajes que no soporten la creación de objetos COM (algunas versiones de COBOL y Fox Pro).

Más información en PyAfipWs

Aplicativo Ad-Hoc

Se ha desarrollado un aplicativo (ejecutable con interfase "visual") para windows/linux, que autoriza, genera pdf y envia los mais con facturas electrónicas.

Más información en PyRece

Novedades

Capacitación

Se ofrece soporte técnico comercial (pago), consultar por desarrollos especiales, interfaces web, etc. a  pyrece@sistemasagiles.com.ar o telefónicamente al 011-4450-0716 / 15-3048-9211

Por consultas gratuitas sobre el lenguaje python y demás, dirigirse a  PyAr.

Para soporte sin cargo de la comunidad, revisar la  lista de temas y/o  crear uno nuevo. Por novedades y consultas genereales, puede usar el  Google Groups (Foro Público). Código fuente en  GitHub.

MarianoReingart