pyafipws

pyafipws

Pyafipws berisi modul Python untuk beroperasi dengan layanan web mengenai AFIP ("IRS" Argentina) dan lembaga pemerintah lainnya, terutama terkait dengan faktur elektronik, beberapa pajak dan keterlacakan.

Hak Cipta 2008 - 2022 (c) Mariano Reingart [email protected] (pencipta dan pemeliharaan). Semua hak dilindungi undang -undang.

Lisensi: LGPLV3+, dengan pengecualian "komersial" yang tersedia untuk memasukkannya dan didistribusikan dengan program prestasi

Informasi Umum:

• Situs Proyek Utama: https://github.com/reingart/pyafipws (git repositori)
• Panduan Pengguna: (http://www.sistemasagiles.com.ar/trac/wiki/manualpyafipws (Spanyol)
• Dokumentasi: https://github.com/reingart/pyafipws/wiki (Spanyol/Inggris)
• Dukungan Komersial: http://www.sistemasagiles.com.ar/ (Spanyol)
• Situs Komunitas: http://www.pyafipws.com.ar/ (Spanyol)
• Forum Publik: http://groups.google.com/group/pyafipws (Dukungan Komunitas, Akses "Gratis" No-Charge)

Struktur Proyek:

• Perpustakaan Python (kelas pembantu untuk setiap layanan web untuk memudahkan penggunaan metode dan atribut mereka)
• PYAFIPWS: Antarmuka Windows-Like Windows-Object-Model yang kompatibel dengan bahasa pemrograman lama (VB, VFP, Delphi, PHP, VB.NET, dll.)
• Libpyafipws: Dll/.so Compiled Shared Library (Mengekspos Metode Python untuk C/C ++/C#)
• Alat konsol (baris perintah) Menggunakan file input & ouput yang disederhanakan (txt, dbf, json)
• Pyrece GUI dan aplikasi web facturalibre sebagai implementasi referensi lengkap
• Contoh untuk Java, .net (C#, VB.NET), Visual Basic, Visual Fox Pro, Delphi, C, PHP.
• Sampel fragmen kode minor untuk SAP (ABAP), PowerBuilder, Fujitsu Net Cobol, Clarion, dll.
• Modul untuk Openerp/Odoo - Tryton

Fitur yang diimplementasikan:

• Format pertukaran alternatif yang didukung: txt (tetap cobol lenght), csv, dbf (clipper/xbase/pelabuhan), xml, json, dll.
• Otomatisasi penuh untuk meminta otentikasi dan otorisasi faktur (CAE, COE, dll.)
• Manipulasi XML tingkat lanjut, caching dan dukungan proxy.
• Generasi PDF yang dapat disesuaikan dan perancang visual (Templat CSV)
• Email, Barcode (PIL), Instalasi (NSIS), Konfigurasi (.ini), Debugging dan Utilitas Lain lainnya

Layanan Web yang didukung sejauh ini:

AFIP:

• WSAA: Otorisasi & Otentikasi, termasuk tanda tangan kriptografi digital
• WSFEV1: Pasar Domestik (Faktur Elektronik) -English-
• WSMTXCA: Pasar Domestik (Faktur Elektronik) -Artikel dan Barcodes-
• WSCT: Pariwisata (Faktur Elektronik) -Pengembalian PPN "bebas pajak" untuk wisatawan-
• WSBFEV1: Bonus Pajak (Faktur Elektronik)
• WSFEXV1: Perdagangan Luar Negeri (Faktur Elektronik) -English-
• WSCTG: Pertanian (kode penelusuran biji -bijian)
• WSLPG: Pertanian (Likuidasi Butir - Faktur)
• WSLTV: Pertanian (Tembakau Hijau - Faktur)
• WSLUM: Pertanian (Susu - Faktur)
• WSLSP: Pertanian (sapi/ternak - faktur)
• WSCDC: Verifikasi Faktur
• Registe Wajib Pajak: Database untuk Memeriksa Penjual dan Daftar Pembeli

Arba:

• COT: Kode Transportasi Operasi Provinsi (alias Catatan Pengiriman Elektronik)

Anmat/Sedronar/Senasa (SNT):

• Trazamed: Program Keterlacakan Obat Medis Nasional
• Trazarenpre: Program Keterlacakan Prekursor Kimia Terkontrol
• Trazafito: Program Keterlacakan Produk Phytosanitary

Instruksi Instalasi:

Catatan:

• Python 3.9 direkomendasikan untuk aplikasi baru: https://www.python.org/downloads/
• Python 2.7 masih didukung untuk aplikasi lama tetapi kompatibilitas akan segera dihapus

Anda dapat melihat direktori .github untuk alur kerja terperinci dan perintah otomatis untuk membangun proyek.

Start cepat

Instruksi ini untuk Ubuntu/Debian. Di Windows Anda dapat menggunakan PowerShell.

Anda dapat mengunduh file terkompresi: https://github.com/reingart/pyafipws/archive/main.zip dan unzip.

Kemudian instal dependensi dan proyek itu sendiri:

 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

Anda akan memerlukan sertifikat digital (.crt) dan kunci pribadi (.key) untuk mengotentikasi (lihat pembuatan sertifikat untuk informasi dan instruksi lebih lanjut). Sementara itu, Anda dapat menggunakan sertifikat/kunci pengujian penulis:

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

Anda harus menyalin dan mengonfigurasi rece.ini untuk mengatur jalur dan URL:

 cp conf/*.ini .

Kemudian, Anda dapat menjalankan skrip WSAA untuk mengotentikasi (mendapatkan token dan tanda) dan WSFEv1 untuk memproses faktur elektronik:

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

Dengan perintah terakhir, Anda harus mendapatkan Kode Autorisasi Elektronik (CAE) untuk tujuan pengujian (Data Faktur Sampel, jangan gunakan dalam produksi!).

Lingkungan Virtual (Pengujian):

Perintah berikut mengkloning repositori, membuat virtualEnv dan menginstal paket di sana (termasuk versi terbaru dari dependensi) untuk menghindari konflik dengan perpustakaan lain:

 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

Jalankan python setup_win.py py2exe untuk dibangun di windows dan executable "compile". Lihat tindakan GitHub untuk langkah -langkah tertentu dan detail lebih lanjut.

Cukup jalankan pytest untuk menjalankan tes Python otomatis. Untuk Windows, lihat Direktori tests/powershell untuk tes Pester.

Instalasi Ketergantungan (Pengembangan):

Untuk Soap WebServices PysimpleSoap diperlukan (spin-off perpustakaan ini, terinspirasi oleh ekstensi SOAP PHP):

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

Gunakan "stabil_py3k" cabang reingart (lihat requirements.txt untuk informasi lebih lanjut)

Untuk generasi PDF, Anda akan membutuhkan PYFPDF (pustaka FPDF PHP, port Python):

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

Di Windows, Anda dapat melihat installer yang tersedia dirilis untuk tujuan evaluasi pada rilis unduhan

Untuk informasi lebih lanjut, lihat langkah -langkah instalasi kode sumber di wiki