pyafipws

pyafipws

Pyafipws contient des modules Python pour fonctionner avec les services Web concernant AFIP ("IRS" d'Argentine) et d'autres agences gouvernementales, principalement liées à la facturation électronique, à plusieurs taxes et à la traçabilité.

Copyright 2008 - 2022 (c) Mariano Reingart [email protected] (Créateur et entretien). Tous droits réservés.

Licence: LGPLV3 +, avec une exception "commerciale" disponible pour l'inclure et distribuer avec des programmes propulsaires

Informations générales:

• Site principal du projet: https://github.com/reingart/pyafipws (référentiel GIT)
• Manuel d'utilisation: (http://www.sistemasagiles.com.ar/trac/wiki/manualpyafipws (espagnol)
• Documentation: https://github.com/reingart/pyafipws/wiki (espagnol / anglais)
• Support commercial: http://www.sistemasagiles.com.ar/ (espagnol)
• Site communautaire: http://www.pyafipws.com.ar/ (espagnol)
• Forum public: http://groups.google.com/group/pyafipws (support communautaire, accès "gratuit")

Structure du projet:

• Python Library (une classe d'assistance pour chaque service Web pour une utilisation facile de leurs méthodes et attributs)
• PYAFIPWS: Interface de composant Windows-Object de type OCX compatible avec les langages de programmation hérités (VB, VFP, Delphi, PHP, VB.NET, etc.)
• Libpyafipws: bibliothèque partagée DLL /.
• Outils de console (ligne de commande) utilisant des fichiers d'entrée et d'ouput simplifiés (TXT, DBF, JSON)
• Applications Web Pyrece GUI et Factturalibre comme implémentations de référence complètes
• Exemples pour Java, .NET (C #, VB.NET), Visual Basic, Visual Fox Pro, Delphi, C, PHP.
• Échantillons de fragments de code mineurs pour SAP (ABAP), PowerBuilder, Fujitsu Net COBOL, Clarion, etc.
• Modules pour OpenderP / Odoo - Tryton

Fonctionnalités implémentées:

• Formats d'échanges alternatifs pris en charge: TXT (COLL COBOL), CSV, DBF (Clipper / Xbase / Harbour), XML, JSON, etc.
• Automatisation complète pour demander l'authentification et l'autorisation des factures (CAE, COE, etc.)
• Manipulation XML avancée, mise en cache et support de proxy.
• Génération PDF personnalisable et concepteur visuel (modèles CSV)
• Email, Barcodes (PIL), installation (NSIS), configuration (.ini), débogage et autres services publics de divers

Les services Web sont pris en charge jusqu'à présent:

AFIP:

• WSAA: Autorisation et authentification, y compris la signature cryptographique numérique
• WSFEV1: Marché intérieur (facture électronique) -English-
• WSMTXCA: Marché intérieur (facture électronique) - Articles et codes à barres
• WSCT: Tourisme (facture électronique) - remboursement de la TVA "libre d'impôt" pour les touristes-
• WSBFEV1: bonus fiscal (facture électronique)
• Wsfexv1: commerce extérieur (facture électronique) -English-
• WSCTG: Agriculture (code de traçabilité des grains)
• WSLPG: Agriculture (liquidation des grains - facture)
• WSLTV: Agriculture (tabac vert - facture)
• WSLUM: Agriculture (lait - facture)
• WSLSP: Agriculture (bétail / bétail - facture)
• WSCDC: Vérification des factures
• Régiste des contribuables: base de données pour vérifier les vendeurs et les acheteurs

Arba:

• COT: Code de transport de l'opération provinciale (note d'expédition électronique)

Anmat / Sedronar / Senasa (SNT):

• Trazamed: Programme national de traçabilité des médicaments médicaux
• Trazarenpre: Programme de traçabilité des précurseurs chimiques contrôlés
• Trazafito: Programme de traçabilité des produits phytosanitaires

Instructions d'installation:

Notes:

• Python 3.9 est recommandé pour les nouvelles applications: https://www.python.org/downloads/
• Python 2.7 est toujours pris en charge pour les applications héritées, mais la compatibilité sera bientôt supprimée

Vous pouvez voir le répertoire .github pour des workflows détaillés et des commandes automatisées pour créer le projet.

Démarrer rapidement

Ces instructions sont pour Ubuntu / Debian. Dans Windows, vous pouvez utiliser PowerShell.

Vous pouvez télécharger le fichier compressé: https://github.com/reingart/pyafipws/archive/main.zip et unzip.

Puis installez les dépendances et le projet lui-même:

 pip download https://github.com/reingart/pyafipws/archive/main.zip
python -m zipfile -e main.zip  .
cd pyafipws-main
pip install -r requirements.txt --user
python setup.py install

Vous aurez besoin d'un certificat numérique (.crt) et d'une clé privée (.key) pour s'authentifier (voir la génération de certificat pour plus d'informations et d'instructions). Provisoirement, vous pouvez utiliser le certificat / clé de test de l'auteur:

 wget https://www.sistemasagiles.com.ar/soft/pyafipws/reingart.zip -O reingart.zip
python -m zipfile -e reingart.zip .

Vous devez copier et configurer rece.ini pour configurer des chemins et des URL:

 cp conf/*.ini .

Ensuite, vous pouvez exécuter le script WSAA pour authentifier (obtenir un jeton et signe) et WSFEv1 pour traiter une facture électronique:

 python -m pyafipws.wsaa
python -m pyafipws.wsfev1 --prueba

Avec la dernière commande, vous devriez obtenir le code d'autorisation électronique (CAE) à des fins de test (exemples de données de facture, n'utilisez pas dans la production!).

Environnement virtuel (test):

Les commandes suivantes clonaient le référentiel, crée un virtualenv et y installer les packages (y compris les dernières versions des dépendances) pour éviter les conflits avec d'autres bibliothèques:

 git clone https://github.com/reingart/pyafipws.git
cd pyafipws
python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
pip install -r requirements-dev.txt

Exécutez python setup_win.py py2exe pour construire dans Windows et "compiler" des exécutables. Voir les actions GitHub pour des étapes spécifiques et plus de détails.

Exécutez simplement pytest pour exécuter des tests Python automatisés. Pour Windows, consultez tests/powershell pour les tests Pester.

Installation de dépendance (développement):

Pour SOAP Webservices, Pysimplesoap est nécessaire (spin-off de cette bibliothèque, inspirée par l'extension SOAP PHP):

 git clone https://github.com/pysimplesoap/pysimplesoap.git -b stable_py3k
cd pysimplesoap
python setup.py install

Utilisez la branche "stable_py3k" Reingart (voir requirements.txt pour plus d'informations)

Pour la génération de PDF, vous aurez besoin du PYFPDF (bibliothèque FPDF de PHP, port Python):

 git clone https://github.com/reingart/pyfpdf.git
cd pyfpdf
python setup.py install

Sur Windows, vous pouvez voir les installateurs disponibles publiés à des fins d'évaluation sur les versions de téléchargement

Pour plus d'informations, consultez les étapes d'installation du code source dans le wiki