pyafipws

PyAfipWs contains Python modules to operate with web services regarding AFIP (Argentina's "IRS") and other government agencies, mainly related to electronic invoicing, several taxes and traceability.

License: GPLv3+, with "commercial" exception available to include it and distribute with propietary programs

General Information:

Main Project Site: https://github.com/reingart/pyafipws (git repository)
Mirror (Historic): https://code.google.com/p/pyafipws/ (mercurial repository)
User Manual: (http://www.sistemasagiles.com.ar/trac/wiki/ManualPyAfipWs (Spanish)
Documentation: https://github.com/reingart/pyafipws/wiki (Spanish/English)
Commercial Support: http://www.sistemasagiles.com.ar/ (Spanish)
Community Site: http://www.pyafipws.com.ar/ (Spanish)
Public Forum: http://groups.google.com/group/pyafipws (community support, no-charge "gratis" access)

More information at Python Argentina Magazine article (English) and JAIIO 2012 paper (Spanish)

Project Structure:

Python library (a helper class for each webservice for easy use of their methods and attributes)
PyAfipWs: OCX-like Windows Component-Object-Model interface compatible with legacy programming languages (VB, VFP, Delphi, PHP, VB.NET, etc.)
LibPyAfipWs: DLL/.so compiled shared library (exposing python methods to C/C++/C#)
Console (command line) tools using simplified input & ouput files (TXT, DBF, JSON)
PyRece GUI and FacturaLibre WEB apps as complete reference implementations
Examples for Java, .NET (C#, VB.NET), Visual Basic, Visual Fox Pro, Delphi, C, PHP.
Minor code fragment samples for SAP (ABAP), PowerBuilder, Fujitsu Net Cobol, Clarion, etc.
Modules for OpenERP/Odoo - Tryton

Features implemented:

Supported alternate interchange formats: TXT (fixed lenght COBOL), CSV, DBF (Clipper/xBase/Harbour), XML, JSON, etc.
Full automation to request authentication and invoice authorization (CAE, COE, etc.)
Advanced XML manipulation, caching and proxy support.
Customizable PDF generation and visual designer (CSV templates)
Email, barcodes (PIL), installation (NSIS), configuration (.INI), debugging and other misc utilities

Web services supported so far:

AFIP:

WSAA: authorization & authentication, including digital cryptographic signature
WSFEv1: domestic market (electronic invoice) -English-
WSMTXCA: domestic market (electronic invoice) -detailing articles and barcodes-
WSCT: tourism (electronic invoice) -"tax free" VAT refund for tourists-
WSBFEv1: tax bonus (electronic invoice)
WSFEXv1: foreign trade (electronic invoice) -English-
WSCTG: agriculture (grain traceability code)
WSLPG: agriculture (grain liquidation - invoice)
WSLTV: agriculture (green tobacco - invoice)
WSLUM: agriculture (milk - invoice)
WSLSP: agriculture (cattle/livestock - invoice)
wDigDepFiel: customs (faithful depositary)
WSCOC: currency exchange operations autorization
WSCDC: invoice verification
Taxpayers' Registe: database to check sellers and buyers register

ARBA:

COT: Provincial Operation Transport Code (aka electronic Shipping note)

ANMAT/SEDRONAR/SENASA (SNT):

TrazaMed: National Medical Drug Traceability Program
TrazaRenpre: Controlled Chemical Precursors Traceability Program
TrazaFito: Phytosanitary Products Traceability Program

Installation Instructions:

Quick-Start

On Ubuntu (GNU/Linux), you will need to install httplib2 and openssl binding. Then you can download the compressed file, unzip it and use:

sudo apt-get install python-httplib2 python-m2crypto
wget https://github.com/reingart/pyafipws/archive/master.zip
unzip master.zip
cd pyafipws-master
sudo pip install -r requirements.txt

Note: M2Crypto is optional, the library will use OpenSSL directly (using subprocess)

You'll need a digital certificate (.crt) and private key (.key) to authenticate (see certificate generation for more information and instructions). Provisionally, you can use author's testing certificate/key:

wget https://www.sistemasagiles.com.ar/soft/pyafipws/reingart.zip
unzip reingart.zip

You should configure rece.ini to set up paths and URLs if using other values than defaults.

Then, you could execute WSAA script to authenticate (getting Token and Sign) and WSFEv1 to process an electronic invoice:

python wsaa.py
python wsfev1.py --prueba

With the last command, you should get the Electronic Autorization Code (CAE) for testing purposes (sample invoice data, do not use in production!).

Virtual environment (testing):

The following commands clone the repository, creates a virtualenv and install the packages there (including the latest versions of the dependencies) to avoid conflicts with other libraries:

sudo apt-get install python-dev swig python-virtualenv mercurial python-pip libssl-dev python-dulwich
hg clone git+https://github.com/reingart/pyafipws.git --config extensions.hggit=
cd pyafipws
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

Note: For convenience, development is done using mercurial; You could use hg-git or git directly.

Dependency installation (development):

For SOAP webservices PySimpleSOAP is needed (spin-off of this library, inspired by the PHP SOAP extension):

hg clone git+https://github.com/pysimplesoap/pysimplesoap.git --config extensions.hggit=
cd pysimplesoap
hg up reingart
python setup.py install

Use "stable" branch reingart (see requirements.txt for more information)

For PDF generation, you will need the PyFPDF (PHP's FPDF library, python port):

hg clone git+https://github.com/reingart/pyfpdf.git --config extensions.hggit=
cd pyfpdf
python setup.py install

For the GUI app, you will need wxPython:

sudo apt-get install wxpython

PythonCard is being replaced by gui2py:

pip install gui2py

For the WEB app, you will need web2py.

On Windows, you can see available installers released for evaluation purposes on Download Releases

For more information see the source code installation steps in the wiki

psgreco/pyafipws