= Factura Electrónica con Python =
[[TracNav(noreorder|FacturaElectronica)]]

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 ==
[[Image(htdocs:logo-pyafipws.png, align=right)]]
[[TOC(noheading,inline,depth=2)]]

== 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:
 * [source:pyafip/ws/wsaa.py wsaa.py]: interface con Web-Service Autenticación y Autorización (basado en wsaa-client.php)
 * [source:pyafip/ws/wsfe.py wsfe.py]: interface con el Web-Service de Factura Electrónica (basado en wsfe-client.php)
 * [source:pyafip/ws/wsbfe.py wsbfe.py]: interface con el Web-Service de Factura Electrónica Bienes de Capital - Bono Fiscal Electrónico
 * [source:pyafip/ws/pyafipws.py pyafipws.py]: servidor COM para acceder a los servicios web desde otros lenguajes en windows (VB, VFP, Delphi, etc.)
 * [source:pyafip/ws/pyrece.py pyrece.py]: aplicativo factura electrónica simil SIAP RECE (gui)
 * [source:pyafip/ws/rece.py rece.py]: utilitario para factura electrónica por archivo de texto (consola)
 * [source:pyafip/ws/rece.py 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 [source: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 [source: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 [source:pyafip/ws/rece.py], [source: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 [source:pyfpdf/FPDF.py])
 * Definición de campos por CSV, para poder modificar el diseño fácilmente (ver [source: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 ==
 * Requisitos:
  * Python24: no se testeo con versiones anteriores (utiliza xml.dom.minidom)
  * M2Crypto: para firma y encriptación
  * httplib2: para conexiones seguras
 * Autores: MarianoReingart y MarceloAlaniz
 * Licencia: LGPLv3 y GPLv3 (ver archivos fuente)
 * Fuentes: [source:pyafip/ws pyafip/ws]
 * Repositorio SVN: [http://www.sistemasagiles.com.ar/svn/pyafip/ws/]
 * Descargables multiplataforma:
  * Ver [https://github.com/reingart/pyafipws/releases GitHub] (actualizado) y [http://code.google.com/p/pyafipws/downloads/list GoogleCode] (histórico)

== Instalación ==
 * En Debian GNU/Linux:
{{{
apt-get install python-httplib2 python-m2crypto
}}}
 * En Windows:
  * Instalar [http://www.python.org/ftp/python/2.5.2/python-2.5.2.msi Python 2.5.2]
  * Instalar [http://www.slproweb.com/download/Win32OpenSSL-0_9_7m.exe Win32OpenSSL 0.9.7m]
  * Instalar [http://chandlerproject.org/pub/Projects/MeTooCrypto/M2Crypto-0.18.2.win32-py2.5.exe M2Crypto 0.18.2] (0.19 no funciona)
  * Instalar [http://httplib2.googlecode.com/files/httplib2-0.4.0.zip httplib2]. Descomprimir y ejecutar por línea de comando: {{{c:\python25\python.exe setup.py install}}}
  * Instalar [http://starship.python.net/crew/mhammond/win32/ Extensiones Win32] para interfase COM. Ejecutar {{{c:\python25\python.exe pyafipws.py --register}}} para registrar el Servidor COM y poder acceder desde otros lenguajes.
 * 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 ==
 * Ver [http://groups.google.com.ar/group/pyafipws Grupo de Noticias en Google]

== Capacitación == 
 * Ver [http://www.clubdeprogramadores.com/cursos/CursoMuestra.php?Id=485 Curso en la ACP]


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

Por consultas gratuitas sobre el lenguaje python y demás, dirigirse a [http://www.python.org.ar/ PyAr]. 

Para soporte sin cargo de la comunidad, revisar la [https://github.com/reingart/pyafipws/issues lista de temas] y/o [https://github.com/reingart/pyafipws/issues/new crear uno nuevo]. 
Por novedades y consultas genereales, puede usar el  [https://groups.google.com/forum/#!forum/pyafipws Google Groups] (Foro Público).
Código fuente en