Watch
1
0
Fork
You've already forked arc
0
forked from hesabix/arc
arc/hesabixAPI/adapters/api/v1
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Motamed ASA fa730b6ab0 feat(tax): add Motamed ASA as a tax submission provider
«معتمد آسا» becomes a third, optional sending method beside «ارسال مستقیم»
and «همراه فن‌آوا». It follows the Fanava provider pattern and reuses
tax_provider_credentials, business_tax_provider_accounts and
tax_settings.submission_provider: no new table and no migration. Direct and
Fanava behaviour is unchanged; the default stays moadian_direct.

Connection (informed consent):
- The tax settings page shows what is shared with Motamed ASA and why, with
  links to its terms and to https://asatsp.ir/privacy#partner-software, and
  asks for explicit consent; consent user and time are stored as for Fanava.
- The owner signs up on Motamed ASA's own page (tax-system one-time code);
  Hesabix collects no identity documents. The business API key is handed to
  Hesabix once, after the owner agrees there; a business that already has an
  ASA API v2 key can enter its client id/secret instead.
- The business private key and memory id are not needed: the trusted
  company signs and sends.

Sending (ASA TSP API v2, https://api-v2.asatsp.ir):
- original: POST /api/invoice/send with a stable internalId per document;
  a rejected or unsent invoice is edited in place (editInvoice);
- correction: editInvoice with confirmCorrection;
- cancellation: cancelInvoice; marked cancelled only once accepted;
- sales return: ins=4 whose Body is the rows remaining after the return
  (RC_IITP.IS_V7.9 table 1), read from the chain's accepted invoice;
- timeouts are reconciled by internalId and never re-sent blindly;
- ASA issues the tax id; Hesabix stores it from the answer.

Inquiry and the tax workspace:
- inquire_tax_status, the auto-inquiry loop and the workspace health check
  read Motamed ASA invoices from ASA (inquiryInternalIds).
- The کارپوشه status (buyer reaction) and the Article 6 status (عدول /
  عدم عدول) of the document's own invoice are kept and shown as two new
  workspace columns (tax_workspace_status, tax_article6_status). A buyer
  rejection is shown there and no longer marks a registered invoice failed.
- «پرداخت‌ها و ثبت در کارپوشه» on a sent Motamed ASA invoice opens its
  payment table: every row with its registration status, and new rows
  (method, date/time, amount with VAT, trace and terminal numbers)
  registered through ASA's registerPayment; locked rows stay read-only and a
  lost answer reads the rows back instead of sending them again.

Admin: «اتصال معتمد آسا» under system settings › external services holds
the partner client id/secret Motamed ASA issues for Hesabix.

Tests: tests/test_motamed_asa_{client,invoice_payload,provider_service}.py

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 02:01:02 +03:00
..
admin feat(tax): add Motamed ASA as a tax submission provider 2026-10-20 02:01:02 +03:00
ai add cloude code plugin 2026-10-18 17:17:25 +03:30
business add some options ad bug fixes that user reported 2026-04-15 14:31:19 +03:30
helpers some bug fix in invoice save with pair documents 2026-07-09 17:19:38 +00:00
integrations bug fix in telegram token webhook 2026-07-24 20:11:27 +00:00
public update readme and date time zone 2026-05-15 13:42:50 +03:30
schema_models feat(products): add product bundles to sales invoices 2026-10-03 20:56:26 +03:30
support some bug fix in rebranding and parsian gatepay 2026-09-23 18:10:39 +00:00
__init__.py some progress and bug fix 2026-10-16 21:10:50 +03:30
accounts.py change file permissions 2026-04-14 19:34:55 +03:30
activity_logs.py change file permissions 2026-04-14 19:34:55 +03:30
announcements.py more bug fix user reported 2026-04-28 20:23:03 +03:30
auth.py some more bug fixes that users reported 2026-09-15 08:53:44 +00:00
bank_accounts.py redesign some parts of reports in calculate profit of business 2026-07-17 21:01:26 +00:00
barcode_labels.py start working on barcode studio plugin and holoo migration dot net application 2026-08-06 03:40:36 +03:30
basalam_integration.py progress in basalam and woc bridge 2026-05-14 01:30:20 +03:30
boms.py change file permissions 2026-04-14 19:34:55 +03:30
business_backups.py feat(persons): add international phone identity 2026-10-18 10:29:24 +03:30
business_currency_rates.py progress in multi fx providers 2026-07-18 08:41:51 +00:00
business_dashboard.py some progress and bug fix 2026-10-16 21:10:50 +03:30
business_data_table_settings.py more bug fix in permission control and reports 2026-05-07 22:21:45 +03:30
business_frequent_descriptions.py add most des 2026-05-17 23:37:03 +03:30
business_ftp_backup.py bug fix in local deployment 2026-04-25 02:31:13 +03:30
business_fx_auto_sync.py auto get price from providers of fx 2026-07-18 09:11:11 +00:00
business_fx_global_rates.py add fx providers 2026-07-18 08:28:23 +00:00
business_notifications.py add some new futures 2026-05-05 05:00:17 +03:30
business_users.py some bug fix in add user to business 2026-10-11 19:11:32 +03:30
businesses.py feat(persons): add international phone identity 2026-10-18 10:29:24 +03:30
cash_registers.py redesign some parts of reports in calculate profit of business 2026-07-17 21:01:26 +00:00
catalog_spec_fields.py shabaketamin new options 2026-07-09 12:50:14 +00:00
categories.py some bug ffffix that reported 2026-04-28 16:48:58 +03:30
checks.py progress in ai and arcwoc plugin 2026-05-28 11:54:27 +00:00
credit.py change file permissions 2026-04-14 19:34:55 +03:30
crm.py some improve in crm 2026-07-31 13:33:00 +00:00
crm_chat.py add basalam lfa version and some bug fix not stable yet 2026-05-12 19:13:27 +03:30
crm_chat_ws.py more bug fix in permission control and reports 2026-05-07 22:21:45 +03:30
currencies.py add some new options in multi currencies and almost bug fix in reported user notics 2026-04-22 03:06:52 +00:00
customer_club.py bug fix in local deployment 2026-04-25 02:31:13 +03:30
customers.py fix(quick-sales): harden invoice and payment workflows 2026-10-17 20:53:41 +03:30
DEPRECATION_EXAMPLES.md change file permissions 2026-04-14 19:34:55 +03:30
distribution.py almost finish dertribition plugin update 2026-09-07 17:33:35 +00:00
document_code_reservations.py add document numbering preview 2026-07-14 19:10:36 +00:00
document_numbering.py progress in main club plugin 2026-04-18 20:58:09 +00:00
documents.py almost complete multi currency progress 2026-08-10 10:48:25 +00:00
expense_income.py progress in holo2hesabix in invoices and cheques 2026-08-09 15:14:14 +03:30
fiscal_years.py some more bug fixes 2026-08-11 15:14:40 +03:30
goods_expense_income.py add external cost on prodeucts 2026-07-20 12:26:33 +00:00
health.py change file permissions 2026-04-14 19:34:55 +03:30
hscript_reports.py hscript v2 published 2026-07-26 16:46:22 +00:00
invoices.py perf(quick-sales): return lightweight invoice response 2026-10-19 01:38:22 +03:30
jobs.py some progress and bug fix 2026-10-16 21:10:50 +03:30
kardex.py fix(kardex): remove invalid backslashes from f-string 2026-09-22 04:04:22 +03:30
list_query_common.py almost complete multi currency progress 2026-08-10 10:48:25 +00:00
marketplace.py change file permissions 2026-04-14 19:34:55 +03:30
notifications.py add some new futures 2026-05-05 05:00:17 +03:30
notifications_ws.py redesign support tickets 2026-06-27 12:31:23 +00:00
opening_balance.py some bug fixes that reported 2026-07-13 23:05:46 +00:00
payment_callbacks.py some bug fix in rebranding and parsian gatepay 2026-09-23 18:10:39 +00:00
payment_gateways.py change file permissions 2026-04-14 19:34:55 +03:30
payroll.py bug fix in serializator 2026-07-05 19:38:42 +00:00
period_end_fx_revaluation.py some improve in multi currency 2026-07-25 20:39:16 +00:00
person_group_routes.py bug fix in local deployment 2026-04-25 02:31:13 +03:30
persons.py some progress and bug fix 2026-10-16 21:10:50 +03:30
petty_cash.py progress in ai and arcwoc plugin 2026-05-28 11:54:27 +00:00
ping_pong.py change file permissions 2026-04-14 19:34:55 +03:30
price_lists.py add some options ad bug fixes that user reported 2026-04-15 14:31:19 +03:30
product_attributes.py add some options ad bug fixes that user reported 2026-04-15 14:31:19 +03:30
product_bundles.py feat(products): add product bundles to sales invoices 2026-10-03 20:56:26 +03:30
product_instances.py some progress and user bug fix that reported last week 2026-05-05 17:29:47 +03:30
products.py perf(invoice): reduce large invoice loading overhead 2026-10-18 11:52:25 +03:30
profile_dashboard.py add multi tab function beta 2026-05-01 00:37:24 +03:30
projects.py change file permissions 2026-04-14 19:34:55 +03:30
public_product_catalog.py shabaketamin new options 2026-07-09 12:50:14 +00:00
public_share_links.py bug fix in invoices 2026-09-03 00:02:08 +00:00
public_storage_file_shares.py some security bug fix 2026-06-19 22:03:43 +00:00
query_schema.py progress in ai and arcwoc plugin 2026-05-28 11:54:27 +00:00
quick_sales.py feat(quick-sales): process invoices through durable outbox 2026-10-19 02:01:20 +03:30
receipts_payments.py progress in holo2hesabix in invoices and cheques 2026-08-09 15:14:14 +03:30
received_loan_facilities.py progress in basalam and woc bridge 2026-05-14 01:30:20 +03:30
repair_shop.py some bug fix in repair shop show dates 2026-07-06 10:08:35 +00:00
report_list_exports.py redesign some parts of reports in calculate profit of business 2026-07-17 21:01:26 +00:00
report_templates.py feat(report-templates): add block-based invoice studio 2026-10-19 22:16:13 +03:30
schemas.py feat(persons): add international phone identity 2026-10-18 10:29:24 +03:30
tax_product_codes.py change file permissions 2026-04-14 19:34:55 +03:30
tax_reports.py redesign market place 2026-05-21 17:44:41 +00:00
tax_settings.py feat(tax): add Motamed ASA as a tax submission provider 2026-10-20 02:01:02 +03:00
tax_types.py change file permissions 2026-04-14 19:34:55 +03:30
tax_units.py change file permissions 2026-04-14 19:34:55 +03:30
telephony.py some more bug fixes that users reported 2026-09-15 08:53:44 +00:00
telephony_softphone_ws.py android development forces 2026-08-09 03:23:51 +03:30
transfers.py some improve in multi currency 2026-07-25 20:39:16 +00:00
users.py bug fix in ai trace 2026-07-17 17:17:06 +00:00
wallet.py some bug fixes 2026-05-18 16:50:15 +00:00
wallet_webhook.py some bug fixes in top secret generator 2026-06-20 00:00:29 +00:00
warehouse_docs.py add external cost on prodeucts 2026-07-20 12:26:33 +00:00
warehouse_locations.py bug fix in local deployment 2026-04-25 02:31:13 +03:30
warehouse_reports.py almost complete multi currency progress 2026-08-10 10:48:25 +00:00
warehouses.py change file permissions 2026-04-14 19:34:55 +03:30
warranty.py change file permissions 2026-04-14 19:34:55 +03:30
woocommerce_integration.py improve arcwoc 2026-08-02 12:37:00 +00:00
workflow_marketplace.py some bug fix and progress in android build with local mirrors 2026-05-07 03:16:45 +03:30
workflows.py some bug fix and progress in android build with local mirrors 2026-05-07 03:16:45 +03:30
zohal.py change file permissions 2026-04-14 19:34:55 +03:30