feat(tax): add Motamed ASA as a tax submission provider #23
Loading…
Reference in a new issue
No description provided.
Delete branch "asatsp/arc:feature/motamed-asa-provider"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
خلاصه
این درخواست «معتمد آسا» را بهعنوان روش سوم و اختیاری ارسال صورتحساب، کنار «ارسال مستقیم» و «همراه فنآوا»، اضافه میکند. پیادهسازی بر اساس همان الگوی موجود ارائهدهندگان مالیاتی (فنآوا) و جدولهای فعلی انجام شده است.
رعایت اصول توافقشده
business_tax_provider_accountsثبت میشود. ثبتنام و احراز هویت در صفحه خود آسا و با کد یکبارمصرف سامانه مودیان انجام میشود؛ حسابیکس مدرک هویتی جمع نمیکند و کلید API کسبوکار فقط پس از موافقت جداگانه مالک تحویل میشود.tax_provider_credentials،business_tax_provider_accountsوtax_settings.submission_providerاستفاده شده و رفتار «ارسال مستقیم» و فنآوا تغییر نکرده است. کد آسا در فایلهای جدا و همسبک فنآوا است و در کد مشترک فقط شاخههای کوچک اضافه شده است.آنچه اضافه شده
سرور (hesabixAPI)
app/integrations/motamed_asa/client.py: کلاینت API نسخه ۲ آسا (https://api-v2.asatsp.ir).app/services/motamed_asa_provider_service.py: اتصال کسبوکار (لینک ثبتنام، تحویل یکباره کلید، ورود دستی شناسه و رمز کلاینت برای کسبوکاری که از قبل کلید دارد، نگهداری رمزنگاریشده کلید و توکن).app/services/motamed_asa_tax_submission_service.py: ارسال اصلی، اصلاحی، ابطال و برگشت از فروش، استعلام، و ثبت پرداخت در کارپوشه. برگشت از فروش با اقلام خود سند برگشتی وreturnRows: "returned"فرستاده میشود؛ تطبیق با ردیفهای ثبتشده مرجع (شناسه کالا، مبلغ واحد، نرخ مالیات و تخفیف هر واحد)، توقف در حالت مبهم، تقسیم بین ردیفهای یکسان و ساخت اقلام باقیمانده با همه فیلدهای مالیاتی (vop، ssrv و …) طبق جدول ۱ دستورالعمل RC_IITP.IS_V7.9 در API نسخه ۲ معتمد آسا (1.0.0.71) انجام میشود. پس از قطع ارتباط، چیزی کورکورانه دوباره فرستاده نمیشود و نتیجه باinternalIdاستعلام میشود.tax_submission_service.py،tax_provider_service.py،tax_setting_service.py،tax_auto_inquiry_service.py،tax_health_check.py.adapters/api/v1/tax_settings.py(کنار عملیات فنآوا):motamed-asa/sync،motamed-asa/link،motamed-asa/credentialsmotamed-asa/invoices/{id}/payments(GET/POST، دسترسیmoadian.operate)/admin/tax-providers/motamed-asaدرadmin/tax_providers.py.رابط کاربری (hesabixUI)
app_localizations*.dartهم بهروز شدهاند.راهاندازی
v2-partner-…) را به تیم حسابیکس تحویل میدهد.آزمونها
چند مشاهده در کد فعلی (در این درخواست تغییر داده نشدهاند)
tax_auto_inquiry_serviceصورتحسابهای فنآوا را هم باMoadianClientاستعلام میکند. در این درخواست فقط صورتحسابهای معتمد آسا از این حلقه جدا شدهاند.invoice_builder، مقدارinp/insبرای اصلاحی و برگشت با معنای رسمی آنها (ins: ۱ اصلی، ۲ اصلاحی، ۳ ابطالی، ۴ برگشت) همخوان نیست. مسیر معتمد آسا این دو را خودش بر اساس نوع عملیات تعیین میکند.تیم فنی معتمد آسا
🤖 Generated with Claude Code
در مسیر ساخت صورتحساب برگشت از فروش دو مورد نیاز به اصلاح دارد:
در غیر این صورت ممکن است برگشت از نظر مبلغ یا اطلاعات مالیاتی با ردیفهای ثبتشده در صورتحساب مرجع همخوان نباشد.
درود و سپاس از بازبینی دقیق 🌹
هر دو نکته طبق روشی که پیشنهاد دادید (مانند فنآوا) حل شد و تغییرات در commit
23d5fa4bروی همین درخواست است:ins=4و فیلدreturnRows: "returned"به/api/invoice/sendفرستاده میشود.build_motamed_asa_return_invoiceو_remaining_rowحذف شدند.INVOICE_RETURN_ROW_AMBIGUOUSمتوقف میشود و حدسی زده نمیشود. ردیفهای کاملاً یکسان به ترتیب مرجع با هم برگشت میخورند.irtaxidهمان شماره مالیاتی فروش است و معتمد آسا آخرین صورتحساب زنجیره را خودش پیدا میکند. اطلاعات خریدار در برگشت فرستاده نمیشود، چون خارج از الگوست و از مرجع میآید.برای کالای تکراری با مبلغ، نرخ یا تخفیف متفاوت، حالت مبهم، تقسیم بین ردیفها و چند سطر یک کالا (سمت API) و ارسال با
returnRows(سمت حسابیکس) تست اضافه شده است. نتیجه: ۵۹ تست معتمد آسا و ۳۳۸ تست مرتبط با مالیات و صورتحساب حسابیکس قبول شدند.تیم فنی معتمد آسا
Target dart2js failed: ProcessException: Process exited abnormally with exit code 1:
lib/pages/business/tax_settings_page.dart:534:62:
Error: Member not found: 'ltr'.
SelectableText(url, textDirection: TextDirection.ltr),
^^^
lib/pages/business/tax_settings_page.dart:624:54:
Error: Member not found: 'ltr'.
textDirection: TextDirection.ltr,
^^^
lib/pages/business/tax_settings_page.dart:638:54:
Error: Member not found: 'ltr'.
textDirection: TextDirection.ltr,
^^^
lib/widgets/invoice/bom_explosion_widget.dart:526:15:
Error: The getter 'linkedMaterial' isn't defined for the type '_BomExplosionWidgetState'.
linkedMaterial?.warehouseId ?? item.suggestedWarehouseId,
^^^^^^^^^^^^^^
lib/widgets/invoice/bom_explosion_widget.dart:535:17:
Error: The getter 'linkedMaterial' isn't defined for the type '_BomExplosionWidgetState'.
if (linkedMaterial?.warehouseId != null)
^^^^^^^^^^^^^^
lib/widgets/invoice/bom_explosion_widget.dart:536:31:
Error: The getter 'linkedMaterial' isn't defined for the type '_BomExplosionWidgetState'.
'warehouse_id': linkedMaterial!.warehouseId,
^^^^^^^^^^^^^^
lib/widgets/invoice/bom_explosion_widget.dart:537:17:
Error: The getter 'linkedMaterial' isn't defined for the type '_BomExplosionWidgetState'.
if (linkedMaterial?.warehouseId == null &&
^^^^^^^^^^^^^^
Error: Compilation failed.
Command: /opt/flutter/bin/cache/dart-sdk/bin/dart compile js --platform-binaries=/opt/flutter/bin/cache/flutter_web_sdk/kernel --invoker=flutter_tool
-Ddart.vm.product=true -DAPI_BASE_URL=https://hsxn.hesabix.ir -DFLUTTER_VERSION=3.41.1 -DFLUTTER_CHANNEL=stable
-DFLUTTER_GIT_URL=https://github.com/flutter/flutter.git -DFLUTTER_FRAMEWORK_REVISION=582a0e7c55 -DFLUTTER_ENGINE_REVISION=3452d735bd
-DFLUTTER_DART_VERSION=3.11.0 -DFLUTTER_WEB_USE_SKIA=true -DFLUTTER_WEB_USE_SKWASM=false
-DFLUTTER_WEB_CANVASKIT_URL=https://www.gstatic.com/flutter-canvaskit/3452d735bd38224ef2db85ca763d862d6326b17f/ --native-null-assertions --no-source-maps
-O2 --minify -o /opt/hesabix/app/hesabixUI/hesabix_ui/.dart_tool/flutter_build/0283069ae4edfa7435724c624e593c4e/app.dill
--packages=/opt/hesabix/app/hesabixUI/hesabix_ui/.dart_tool/package_config.json --cfe-only
/opt/hesabix/app/hesabixUI/hesabix_ui/.dart_tool/flutter_build/0283069ae4edfa7435724c624e593c4e/main.dart
خطای سینتکسی وجود داره در نسخه مورد استفاده فلاتر در سرور سند باکس