pyafipws

pyafipws

Pyafipws包含有关AFIP（阿根廷的“ IRS”）和其他政府机构的Web服务的Python模块，主要与电子发票，几种税收和可追溯性有关。

版权所有2008-2022（c）Mariano Reingart [email protected]（创建者和维护者）。版权所有。

许可证：LGPLV3+，具有“商业”例外，可以包括IT并分发出Prepierary计划

一般信息：

• 主要项目网站：https：//github.com/reingart/pyafipws（git存储库）
• 用户手册：（ http：//www.sistemasagiles.com.ar/trac/wiki/manualpyafipws（西班牙语）
• 文档：https：//github.com/reingart/pyafipws/wiki（西班牙/英语）
• 商业支持：http：//www.sistemasagiles.com.ar/（西班牙语）
• 社区网站：http：//www.pyafipws.com.ar/（西班牙）
• 公共论坛：http：//groups.google.com/group/pyafipws（社区支持，无需“免费”访问）

项目结构：

• Python库（每个Web服务的辅助类别，用于轻松使用其方法和属性）
• PYAFIPWS：类似OCX的Windows组件 - 对象模型接口与旧版编程语言兼容（VB，VFP，Delphi，PHP，VB.NET等）
• libpyafipws：dll/.so编译的共享库（将Python方法展示到C/C ++/C＃）
• 使用简化的输入和OUPUT文件（TXT，DBF，JSON）使用控制台（命令行）工具
• Pyrece GUI和Facturalibre Web应用程序作为完整的参考实现
• Java，.net（C＃，VB.NET），Visual Basic，Visual Fox Pro，Delphi，C，PHP的示例。
• SAP（ABAP），PowerBuilder，Fujitsu Net Cobol，Clarion等的次要代码片段样品。
• openerp/odoo的模块-Tryton

实施的功能：

• 支持的替代互换格式：TXT（固定的Lenght Cobol），CSV，DBF（Clipper/XBase/Harbor），XML，JSON，ETC。
• 完全自动化以请求身份验证和发票授权（CAE，COE等）
• 高级XML操纵，缓存和代理支持。
• 可定制的PDF生成和视觉设计器（CSV模板）
• 电子邮件，条形码（PIL），安装（NSIS），配置（.ini），调试和其他MISC实用程序

到目前为止支持Web服务：

AFIP：

• WSAA：授权和身份验证，包括数字加密签名
• WSFEV1：国内市场（电子发票） - 英语 -
• WSMTXCA：国内市场（电子发票） - 尾能文章和条形码 -
• WSCT：旅游（电子发票） - 游客的“免税”增值税退款 -
• WSBFEV1：税收奖金（电子发票）
• WSFEXV1：外贸（电子发票） - 英语 -
• WSCTG：农业（谷物可追溯性代码）
• WSLPG：农业（谷物清算 - 发票）
• WSLTV：农业（绿色烟草 - 发票）
• WSLUM：农业（牛奶 - 发票）
• WSLSP：农业（牛/牲畜 - 发票）
• WSCDC：发票验证
• 纳税人重新：检查卖方和买家注册的数据库

阿尔巴：

• COT：省级运输代码（又名电子运输票据）

Anmat/Sedronar/Senasa（SNT）：

• 焦点：国家医学毒品可追溯性计划
• Trazarenpre：受控化学前体可追溯性计划
• Trazafito：植物检测性可追溯性计划

安装说明：

笔记：

• 建议新应用使用Python 3.9：https：//www.python.org/downloads/
• Python 2.7仍然支持旧应用程序，但兼容性将很快删除

您可以看到.github目录的详细工作流程和自动化命令以构建项目。

快速启动

这些说明适用于Ubuntu/Debian。在Windows中，您可以使用PowerShell。

您可以下载压缩文件：https：//github.com/reingart/pyafipws/archive/main.zip并解开它。

然后安装依赖项和项目本身：

 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

您需要数字证书（.crt）和私钥（.KEY）来验证（有关更多信息和说明，请参见证书生成）。您可以使用作者的测试证书/密钥：

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

您应该复制并配置rece.ini以设置路径和URL：

 cp conf/*.ini .

然后，您可以执行WSAA脚本以进行身份​​验证（获取令牌并签名）和WSFEv1处理电子发票：

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

使用最后一个命令，您应该获取用于测试目的的电子自动化代码（CAE）（示例发票数据，请勿在生产中使用！）。

虚拟环境（测试）：

以下命令克隆存储库，创建Virtualenv并在此处安装软件包（包括依赖项的最新版本），以避免与其他库发生冲突：

 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

运行python setup_win.py py2exe在Windows中构建并“编译”可执行文件。有关特定步骤和更多详细信息，请参见GitHub操作。

只需执行pytest即可运行自动化的Python测试。对于Windows，请参阅pester测试的tests/powershell目录。

依赖安装（开发）：

对于肥皂服务，需要Pysimplesoap（该库的衍生，灵感来自PHP SOAP扩展）：

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

使用“ stable_py3k”分支Reingart（有关更多信息，请参见requirements.txt ）

对于PDF生成，您将需要PYFPDF（PHP的FPDF库，Python端口）：

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

在Windows上，您可以在下载版本上看到可用的安装程序用于评估目的

有关更多信息，请参见Wiki中的源代码安装步骤