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.
Copyright 2008 - 2016 (C) Mariano Reingart reingart@gmail.com (creator
and maintainter). All rights reserved.
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
More information at `Python Argentina Magazine
article <http://revista.python.org.ar/2/en/html/pyafip.html>`__
(English) and `JAIIO 2012
paper <http://www.41jaiio.org.ar/sites/default/files/15_JSL_2012.pdf>`__
(Spanish)
Project Structure:
------------------
- `Python
library <http://www.sistemasagiles.com.ar/trac/wiki/FacturaElectronicaPython>`__
(a helper class for each webservice for easy use of their methods and
attributes)
- `PyAfipWs <http://www.sistemasagiles.com.ar/trac/wiki/PyAfipWs>`__:
`OCX-like <http://www.sistemasagiles.com.ar/trac/wiki/OcxFacturaElectronica>`__
Windows Component-Object-Model interface compatible with legacy
programming languages (VB, VFP, Delphi, PHP, VB.NET, etc.)
- `LibPyAfipWs <http://www.sistemasagiles.com.ar/trac/wiki/LibPyAfipWs>`__:
`DLL/.so <http://www.sistemasagiles.com.ar/trac/wiki/DllFacturaElectronica>`__
compiled shared library (exposing python methods to C/C++/C#)
- `Console <http://www.sistemasagiles.com.ar/trac/wiki/HerramientaFacturaElectronica>`__
(command line) tools using simplified input & ouput files
- `PyRece <http://www.sistemasagiles.com.ar/trac/wiki/PyRece>`__ GUI
and
`FacturaLibre <http://www.sistemasagiles.com.ar/trac/wiki/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 <https://github.com/reingart/openerp_pyafipws>`__ -
`Tryton <https://github.com/tryton-ar/account_invoice_ar>`__
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 <http://www.sistemasagiles.com.ar/trac/wiki/ManualPyAfipWs#ServicioWebdeAutenticaciónyAutorizaciónWSAA>`__:
authorization & authentication, including digital cryptographic
signature
- `WSFEv1 <http://www.sistemasagiles.com.ar/trac/wiki/ProyectoWSFEv1>`__:
domestic market (electronic invoice)
-`English <https://github.com/reingart/pyafipws/wiki/WSFEv1>`__-
- `WSMTXCA <http://www.sistemasagiles.com.ar/trac/wiki/FacturaElectronicaMTXCAService>`__:
domestic market (electronic invoice) -detailing articles and
barcodes-
- `WSBFEv1 <http://www.sistemasagiles.com.ar/trac/wiki/BonosFiscales>`__:
tax bonus (electronic invoice)
- `WSFEXv1 <http://www.sistemasagiles.com.ar/trac/wiki/FacturaElectronicaExportacion>`__:
foreign trade (electronic invoice)
-`English <https://github.com/reingart/pyafipws/wiki/WSFEX>`__-
- `WSCTG <http://www.sistemasagiles.com.ar/trac/wiki/CodigoTrazabilidadGranos>`__:
agriculture (grain traceability code)
- `WSLPG <http://www.sistemasagiles.com.ar/trac/wiki/LiquidacionPrimariaGranos>`__:
agriculture (grain liquidation - invoice)
- `wDigDepFiel <http://www.sistemasagiles.com.ar/trac/wiki/ManualPyAfipWs#wDigDepFiel:DepositarioFiel>`__:
customs (faithful depositary)
- `WSCOC <http://www.sistemasagiles.com.ar/trac/wiki/ConsultaOperacionesCambiarias>`__:
currency exchange operations autorization
- `WSCDC <http://www.sistemasagiles.com.ar/trac/wiki/FacturaElectronicaMTXCAService>`__:
invoice verification
- `Taxpayers'
Registe <http://www.sistemasagiles.com.ar/trac/wiki/PadronContribuyentesAFIP>`__:
database to check sellers and buyers register
ARBA:
- `COT <http://www.sistemasagiles.com.ar/trac/wiki/RemitoElectronicoCotArba>`__:
Provincial Operation Transport Code (aka electronic Shipping note)
ANMAT/SEDRONAR/SENASA (SNT):
- `TrazaMed <http://www.sistemasagiles.com.ar/trac/wiki/TrazabilidadMedicamentos>`__:
National Medical Drug Traceability Program
- `TrazaRenpre <http://www.sistemasagiles.com.ar/trac/wiki/TrazabilidadPrecursoresQuimicos>`__:
Controlled Chemical Precursors Traceability Program
- `TrazaFito <http://www.sistemasagiles.com.ar/trac/wiki/TrazabilidadProductosFitosanitarios>`__:
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 <http://www.sistemasagiles.com.ar/trac/wiki/ManualPyAfipWs#Certificados>`__
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 <http://hg-git.github.io/>`__ or git directly.
Dependency installation (development):
--------------------------------------
For SOAP webservices
`PySimpleSOAP <https://github.com/pysimplesoap/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 <https://github.com/reingart/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 <http://www.wxpython.org/>`__:
::
sudo apt-get install wxpython
PythonCard is being replaced by
`gui2py <https://github.com/reingart/gui2py/>`__:
::
pip install gui2py
For the WEB app, you will need `web2py <http://www.web2py.com/>`__.
On Windows, you can see available installers released for evaluation
purposes on `Download
Releases <https://github.com/reingart/pyafipws/releases>`__
For more information see the source code installation steps in the
`wiki <https://github.com/reingart/pyafipws/wiki/InstalacionCodigoFuente>`__
Raw data
{
"_id": null,
"home_page": "https://github.com/reingart/pyafipws",
"name": "PyAfipWs",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "webservice electronic invoice pdf traceability",
"author": "Mariano Reingart",
"author_email": "reingart@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/07/c3/c11be86d13d875ca23c4e892030f7f973af84f4faef8f5b86d14df326cd7/PyAfipWs-2.7.1874.tar.gz",
"platform": "UNKNOWN",
"description": "pyafipws\n========\n\nPyAfipWs contains Python modules to operate with web services regarding\nAFIP (Argentina's \"IRS\") and other government agencies, mainly related\nto electronic invoicing, several taxes and traceability.\n\nCopyright 2008 - 2016 (C) Mariano Reingart reingart@gmail.com (creator\nand maintainter). All rights reserved.\n\nLicense: GPLv3+, with \"commercial\" exception available to include it and\ndistribute with propietary programs\n\nGeneral Information:\n--------------------\n\n- Main Project Site: https://github.com/reingart/pyafipws (git\n repository)\n- Mirror (Historic): https://code.google.com/p/pyafipws/ (mercurial\n repository)\n- User Manual:\n (http://www.sistemasagiles.com.ar/trac/wiki/ManualPyAfipWs (Spanish)\n- Documentation: https://github.com/reingart/pyafipws/wiki\n (Spanish/English)\n- Commercial Support: http://www.sistemasagiles.com.ar/ (Spanish)\n- Community Site: http://www.pyafipws.com.ar/ (Spanish)\n- Public Forum: http://groups.google.com/group/pyafipws\n\nMore information at `Python Argentina Magazine\narticle <http://revista.python.org.ar/2/en/html/pyafip.html>`__\n(English) and `JAIIO 2012\npaper <http://www.41jaiio.org.ar/sites/default/files/15_JSL_2012.pdf>`__\n(Spanish)\n\nProject Structure:\n------------------\n\n- `Python\n library <http://www.sistemasagiles.com.ar/trac/wiki/FacturaElectronicaPython>`__\n (a helper class for each webservice for easy use of their methods and\n attributes)\n- `PyAfipWs <http://www.sistemasagiles.com.ar/trac/wiki/PyAfipWs>`__:\n `OCX-like <http://www.sistemasagiles.com.ar/trac/wiki/OcxFacturaElectronica>`__\n Windows Component-Object-Model interface compatible with legacy\n programming languages (VB, VFP, Delphi, PHP, VB.NET, etc.)\n- `LibPyAfipWs <http://www.sistemasagiles.com.ar/trac/wiki/LibPyAfipWs>`__:\n `DLL/.so <http://www.sistemasagiles.com.ar/trac/wiki/DllFacturaElectronica>`__\n compiled shared library (exposing python methods to C/C++/C#)\n- `Console <http://www.sistemasagiles.com.ar/trac/wiki/HerramientaFacturaElectronica>`__\n (command line) tools using simplified input & ouput files\n- `PyRece <http://www.sistemasagiles.com.ar/trac/wiki/PyRece>`__ GUI\n and\n `FacturaLibre <http://www.sistemasagiles.com.ar/trac/wiki/FacturaLibre>`__\n WEB apps as complete reference implementations\n- Examples for Java, .NET (C#, VB.NET), Visual Basic, Visual Fox Pro,\n Delphi, C, PHP.\n- Minor code fragment samples for SAP (ABAP), PowerBuilder, Fujitsu Net\n Cobol, Clarion, etc.\n- Modules for\n `OpenERP/Odoo <https://github.com/reingart/openerp_pyafipws>`__ -\n `Tryton <https://github.com/tryton-ar/account_invoice_ar>`__\n\nFeatures implemented:\n---------------------\n\n- Supported alternate interchange formats: TXT (fixed lenght COBOL),\n CSV, DBF (Clipper/xBase/Harbour), XML, JSON, etc.\n- Full automation to request authentication and invoice authorization\n (CAE, COE, etc.)\n- Advanced XML manipulation, caching and proxy support.\n- Customizable PDF generation and visual designer (CSV templates)\n- Email, barcodes (PIL), installation (NSIS), configuration (.INI),\n debugging and other misc utilities\n\nWeb services supported so far:\n------------------------------\n\nAFIP:\n\n- `WSAA <http://www.sistemasagiles.com.ar/trac/wiki/ManualPyAfipWs#ServicioWebdeAutenticaci\u00f3nyAutorizaci\u00f3nWSAA>`__:\n authorization & authentication, including digital cryptographic\n signature\n- `WSFEv1 <http://www.sistemasagiles.com.ar/trac/wiki/ProyectoWSFEv1>`__:\n domestic market (electronic invoice)\n -`English <https://github.com/reingart/pyafipws/wiki/WSFEv1>`__-\n- `WSMTXCA <http://www.sistemasagiles.com.ar/trac/wiki/FacturaElectronicaMTXCAService>`__:\n domestic market (electronic invoice) -detailing articles and\n barcodes-\n- `WSBFEv1 <http://www.sistemasagiles.com.ar/trac/wiki/BonosFiscales>`__:\n tax bonus (electronic invoice)\n- `WSFEXv1 <http://www.sistemasagiles.com.ar/trac/wiki/FacturaElectronicaExportacion>`__:\n foreign trade (electronic invoice)\n -`English <https://github.com/reingart/pyafipws/wiki/WSFEX>`__-\n- `WSCTG <http://www.sistemasagiles.com.ar/trac/wiki/CodigoTrazabilidadGranos>`__:\n agriculture (grain traceability code)\n- `WSLPG <http://www.sistemasagiles.com.ar/trac/wiki/LiquidacionPrimariaGranos>`__:\n agriculture (grain liquidation - invoice)\n- `wDigDepFiel <http://www.sistemasagiles.com.ar/trac/wiki/ManualPyAfipWs#wDigDepFiel:DepositarioFiel>`__:\n customs (faithful depositary)\n- `WSCOC <http://www.sistemasagiles.com.ar/trac/wiki/ConsultaOperacionesCambiarias>`__:\n currency exchange operations autorization\n- `WSCDC <http://www.sistemasagiles.com.ar/trac/wiki/FacturaElectronicaMTXCAService>`__:\n invoice verification\n- `Taxpayers'\n Registe <http://www.sistemasagiles.com.ar/trac/wiki/PadronContribuyentesAFIP>`__:\n database to check sellers and buyers register\n\nARBA:\n\n- `COT <http://www.sistemasagiles.com.ar/trac/wiki/RemitoElectronicoCotArba>`__:\n Provincial Operation Transport Code (aka electronic Shipping note)\n\nANMAT/SEDRONAR/SENASA (SNT):\n\n- `TrazaMed <http://www.sistemasagiles.com.ar/trac/wiki/TrazabilidadMedicamentos>`__:\n National Medical Drug Traceability Program\n- `TrazaRenpre <http://www.sistemasagiles.com.ar/trac/wiki/TrazabilidadPrecursoresQuimicos>`__:\n Controlled Chemical Precursors Traceability Program\n- `TrazaFito <http://www.sistemasagiles.com.ar/trac/wiki/TrazabilidadProductosFitosanitarios>`__:\n Phytosanitary Products Traceability Program\n\nInstallation Instructions:\n--------------------------\n\nQuick-Start\n-----------\n\nOn Ubuntu (GNU/Linux), you will need to install httplib2 and openssl\nbinding. Then you can download the compressed file, unzip it and use:\n\n::\n\n sudo apt-get install python-httplib2 python-m2crypto\n wget https://github.com/reingart/pyafipws/archive/master.zip\n unzip master.zip\n cd pyafipws-master\n sudo pip install -r requirements.txt\n\n**Note:** M2Crypto is optional, the library will use OpenSSL directly\n(using subprocess)\n\nYou'll need a digital certificate (.crt) and private key (.key) to\nauthenticate (see `certificate\ngeneration <http://www.sistemasagiles.com.ar/trac/wiki/ManualPyAfipWs#Certificados>`__\nfor more information and instructions). Provisionally, you can use\nauthor's testing certificate/key:\n\n::\n\n wget https://www.sistemasagiles.com.ar/soft/pyafipws/reingart.zip\n unzip reingart.zip\n\nYou should configure ``rece.ini`` to set up paths and URLs if using\nother values than defaults.\n\nThen, you could execute ``WSAA`` script to authenticate (getting Token\nand Sign) and ``WSFEv1`` to process an electronic invoice:\n\n::\n\n python wsaa.py\n python wsfev1.py --prueba\n\nWith the last command, you should get the Electronic Autorization Code\n(CAE) for testing purposes (sample invoice data, do not use in\nproduction!).\n\nVirtual environment (testing):\n------------------------------\n\nThe following commands clone the repository, creates a virtualenv and\ninstall the packages there (including the latest versions of the\ndependencies) to avoid conflicts with other libraries:\n\n::\n\n sudo apt-get install python-dev swig python-virtualenv mercurial python-pip libssl-dev python-dulwich\n hg clone git+https://github.com/reingart/pyafipws.git --config extensions.hggit=\n cd pyafipws\n virtualenv venv\n source venv/bin/activate\n pip install -r requirements.txt\n\n**Note:** For convenience, development is done using mercurial; You\ncould use `hg-git <http://hg-git.github.io/>`__ or git directly.\n\nDependency installation (development):\n--------------------------------------\n\nFor SOAP webservices\n`PySimpleSOAP <https://github.com/pysimplesoap/pysimplesoap>`__ is\nneeded (spin-off of this library, inspired by the PHP SOAP extension):\n\n::\n\n hg clone git+https://github.com/pysimplesoap/pysimplesoap.git --config extensions.hggit=\n cd pysimplesoap\n hg up reingart\n python setup.py install\n\nUse \"stable\" branch reingart (see ``requirements.txt`` for more\ninformation)\n\nFor PDF generation, you will need the\n`PyFPDF <https://github.com/reingart/pyfpdf>`__ (PHP's FPDF library,\npython port):\n\n::\n\n hg clone git+https://github.com/reingart/pyfpdf.git --config extensions.hggit=\n cd pyfpdf\n python setup.py install\n\nFor the GUI app, you will need `wxPython <http://www.wxpython.org/>`__:\n\n::\n\n sudo apt-get install wxpython\n\nPythonCard is being replaced by\n`gui2py <https://github.com/reingart/gui2py/>`__:\n\n::\n\n pip install gui2py\n\nFor the WEB app, you will need `web2py <http://www.web2py.com/>`__.\n\nOn Windows, you can see available installers released for evaluation\npurposes on `Download\nReleases <https://github.com/reingart/pyafipws/releases>`__\n\nFor more information see the source code installation steps in the\n`wiki <https://github.com/reingart/pyafipws/wiki/InstalacionCodigoFuente>`__",
"bugtrack_url": null,
"license": "GNU GPL v3+",
"summary": "Interfases, tools and apps for Argentina's gov't. webservices (soap, com/dll, pdf, dbf, xml, etc.)",
"version": "2.7.1874",
"split_keywords": [
"webservice",
"electronic",
"invoice",
"pdf",
"traceability"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "07c3c11be86d13d875ca23c4e892030f7f973af84f4faef8f5b86d14df326cd7",
"md5": "a8638264810892fec450e25d568638ce",
"sha256": "e619f43c967066f780af43baf5f5f9fc293e730fbab4605dadf1c2e2f4adab9e"
},
"downloads": -1,
"filename": "PyAfipWs-2.7.1874.tar.gz",
"has_sig": false,
"md5_digest": "a8638264810892fec450e25d568638ce",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 336531,
"upload_time": "2016-09-10T21:22:03",
"upload_time_iso_8601": "2016-09-10T21:22:03.435498Z",
"url": "https://files.pythonhosted.org/packages/07/c3/c11be86d13d875ca23c4e892030f7f973af84f4faef8f5b86d14df326cd7/PyAfipWs-2.7.1874.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2016-09-10 21:22:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "reingart",
"github_project": "pyafipws",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "pyafipws"
}
JSON
