برای ووکامرس، اپنکارت، پرستاشاپ و مجنتو، بدون برنامهنویسی
اتصال فروشگاه اینترنتی به سامانه مؤدیان با افزونه رایگان معتمد آسا
افزونه رایگان معتمد آسا را روی فروشگاه خود نصب کنید تا صورتحساب الکترونیکی هر سفارش بهطور خودکار صادر و به سامانه مؤدیان فرستاده شود و وضعیت آن در صفحه سفارش دیده شود. این افزونه برای ووکامرس و EDD در وردپرس، اپنکارت ۳ و ۴، پرستاشاپ و مجنتو ۲ آماده است و برای سایتهای اختصاصی هم یک کتابخانه PHP دارد.
- دانش فنی لازم
- مدیر فروشگاه، بدون برنامهنویسی
- حجم مناسب صورتحساب
- کم تا بسیار زیاد
- راهاندازی
- نصب افزونه و چند تنظیم
- میزان خودکارسازی
- خودکار، دستی یا گروهی
معرفی روش «افزونه فروشگاه اینترنتی»
افزونه معتمد آسا فروشگاه اینترنتی شما را از راه وبسرویس نسخه ۲ آسا به سامانه مؤدیان وصل میکند. شناسه و رمز اتصال را از پنل آسا در تنظیمات افزونه وارد میکنید و از آن پس صورتحساب هر سفارشی که به وضعیت انتخابی شما برسد (بهطور پیشفرض وضعیت پایانی سفارش، مثل «تکمیلشده» یا «تحویلشده») خودکار صادر میشود. سفارشی که بیش از ۱۴ روز از ثبت آن گذشته باشد، خودکار فرستاده نمیشود و روش ارسال آن را خودتان انتخاب میکنید. ارسال دستی هر سفارش و ارسال گروهی از فهرست سفارشها هم همیشه در دسترس است.
صورتحساب نوع ۲ (مصرفکننده نهایی) پیشفرض است. اگر خریدار هنگام خرید شناسهاش را وارد کند (کد ملی همراه کد پستی برای شخص حقیقی یا شناسه ملی برای شرکت)، صورتحساب نوع ۱ به نام او صادر میشود. جای ورود شناسه در ووکامرس بخش اختیاری «صورتحساب رسمی» صفحه پرداخت است، در اپنکارت و پرستاشاپ فیلدهای کد ملی و شماره اقتصادی فرم نشانی، و در مجنتو شماره مالیاتی نشانی یا شناسهای که مدیر در صفحه سفارش وارد میکند. اگر خریدار حقیقی در سامانه مؤدیان پرونده مالیاتی نداشته باشد، افزونه آن سفارش را بهطور خودکار با نوع ۲ صادر میکند.
مبالغ بر پایه قواعد محاسبه آسا ساخته میشوند. قیمتهای تومانی به ریال تبدیل میشوند، کد تخفیف بهصورت تخفیف روی ردیفهای مربوط اعمال میشود، هزینه ارسال با شناسه خدمت خودش در صورتحساب میآید و مالیات بر ارزش افزوده یا از تنظیمات مالیات فروشگاه خوانده میشود یا از قیمتهای شامل مالیات استخراج میشود. شناسه کالا/خدمت هر محصول در صفحه آن محصول وارد میشود و در تنظیمات هم یک شناسه پیشفرض تعیین میکنید.
وضعیت هر صورتحساب، یعنی شماره منحصربهفرد مالیاتی، شماره مرجع، واکنش خریدار در کارپوشه و هر خطا با توضیح فارسی، در صفحه سفارش و ستون فهرست سفارشها دیده میشود. وقتی سفارشی را مسترد میکنید، افزونه «برگشت از فروش» یا «ابطال» را پیشنهاد میدهد و فقط پس از تأیید شما در سامانه مؤدیان ثبت میکند.
این روش مناسب شماست اگر:
- فروشگاه اینترنتی شما با ووکامرس، Easy Digital Downloads، اپنکارت، پرستاشاپ یا مجنتو ساخته شده است.
- میخواهید صورتحساب هر سفارش بدون ورود دوباره اطلاعات و بدون برنامهنویسی صادر شود.
- بیشتر به مصرفکننده نهایی میفروشید و گاهی خریدار، صورتحساب به نام خودش یا شرکتش میخواهد.
- میخواهید وضعیت سامانه مؤدیان را در صفحه خود سفارش ببینید و به سامانه جداگانهای سر نزنید.
روش دیگری مناسبتر است اگر:
- فروشگاهساز آمادهای (SaaS) دارید که اجازه نصب افزونه نمیدهد: فایل اکسل
- سامانه فروش اختصاصی دارید و تیم فنی در اختیارتان است: وبسرویس (API)
دانلود افزونه فروشگاهساز شما
نسخه ۲٫۰٫۱، منتشرشده در ۱۷ آبان ۱۴۰۵. همه افزونهها رایگاناند و با مجوز GPL منتشر میشوند. هسته محاسبات و ارسال در همه آنها مشترک است.
وردپرس: ووکامرس و EDD
ووکامرس ۶ به بالا (با ذخیرهسازی سفارش HPOS یا قدیمی و صفحه پرداخت کلاسیک یا بلوکی) و Easy Digital Downloads ۳ به بالا، روی وردپرس ۵٫۸ به بالا
- پیشنیاز
- PHP ۷٫۲ به بالا
- تنظیمات
- «ووکامرس ← معتمد آسا» (اگر فقط EDD دارید: «دانلودها ← معتمد آسا»)
راهنمای نصب
- در پیشخوان وردپرس به «افزونهها ← افزودن افزونه ← بارگذاری افزونه» بروید.
- فایل zip را انتخاب کنید و روی «هماکنون نصب کن» و سپس «فعال کردن» کلیک کنید.
دانلود فایل افزونه وردپرس: ووکامرس و EDD(۳۵۳ کیلوبایت)SHA-256:
2a1b4a4138f3a387584b5634dee2939b5cbb15568d91344e8eeba64e0cbeec08اپنکارت ۳
اپنکارت ۳٫۰٫۲ تا ۳٫۰٫۵ و نسخههای فارسی آن
- پیشنیاز
- PHP ۷٫۲ به بالا با cURL
- تنظیمات
- «افزونهها ← ماژولها ← معتمد آسا» و فهرست وضعیت سفارشها در «فروش ← معتمد آسا»
راهنمای نصب
- در پیشخوان به «افزونهها ← نصب افزونه» بروید و فایل را بارگذاری کنید.
- در «افزونهها ← افزونهها ← ماژولها»، ماژول «معتمد آسا» را نصب و سپس ویرایش کنید.
- خط زمانبند (کرون) را که در تنظیمات ماژول آمده، در کرونجاب هاست تعریف کنید.
دانلود فایل افزونه اپنکارت ۳(۳۶۴ کیلوبایت)SHA-256:
d25c8e64210bba7d805e285695cafffbfe7dab491e36d98922656564ceda793bاپنکارت ۴
اپنکارت ۴٫۰٫۲ تا ۴٫۱
- پیشنیاز
- PHP ۸ به بالا با cURL (پیشنیاز خود اپنکارت ۴)
- تنظیمات
- «افزونهها ← ماژولها ← معتمد آسا» و فهرست وضعیت سفارشها در «فروش ← معتمد آسا»
راهنمای نصب
- نام فایل را تغییر ندهید؛ اپنکارت ۴ پوشه افزونه را از نام فایل میسازد.
- در پیشخوان به «افزونهها ← نصبکننده» بروید، فایل را بارگذاری و «نصب» کنید.
- در «افزونهها ← افزونهها ← ماژولها»، ماژول «معتمد آسا» را نصب و سپس ویرایش کنید. زمانبند اپنکارت (کرون) هاست باید فعال باشد.
دانلود فایل افزونه اپنکارت ۴(۳۶۳ کیلوبایت)SHA-256:
2f5917e1e5a292b307a95d0fedd9bdfe20b5679fae3183dc8ab89d11064b4ac2پرستاشاپ
پرستاشاپ ۱٫۷٫۶ تا ۸٫۲
- پیشنیاز
- PHP ۷٫۲ به بالا با cURL
- تنظیمات
- «ماژولها ← مدیریت ماژول ← معتمد آسا ← پیکربندی»
راهنمای نصب
- در پیشخوان به «ماژولها ← مدیریت ماژول» بروید و روی «بارگذاری یک ماژول» کلیک کنید.
- فایل zip را در کادر بارگذاری رها کنید تا نصب شود، سپس روی «پیکربندی» کلیک کنید.
- خط زمانبند (کرون) را که در صفحه پیکربندی آمده، در کرونجاب هاست تعریف کنید.
دانلود فایل افزونه پرستاشاپ(۳۵۱ کیلوبایت)SHA-256:
ccddd148f3c1f96e4b66dbf64aa603cba3fccd3fd0bbd6c5b993dd09107b3fe2مجنتو ۲
مجنتو اوپنسورس و ادوبی کامرس ۲٫۴٫۴ تا ۲٫۴٫۷
- پیشنیاز
- PHP ۸٫۱ تا ۸٫۳ و کرون مجنتو فعال
- تنظیمات
- «فروشگاهها ← پیکربندی ← فروش ← معتمد آسا»
راهنمای نصب
- فایل را در ریشه مجنتو باز کنید تا پوشه app/code/AsaTsp/Connector ساخته شود.
- دستورهای bin/magento module:enable AsaTsp_Connector، setup:upgrade، setup:di:compile و cache:flush را اجرا کنید.
دانلود فایل افزونه مجنتو ۲(۳۷۰ کیلوبایت)SHA-256:
87637f177b32c056e1de32d216ee4888ccb651a2fc9e9fbd3fcbd74f5ce60cedکتابخانه PHP
سایتها و فروشگاههای اختصاصی با PHP (لاراول، یی، کدایگنایتر یا PHP ساده)
- پیشنیاز
- PHP ۷٫۲ به بالا با cURL
- تنظیمات
- در کد شما، با کلاس Config
راهنمای نصب
- فایل را در پروژه باز کنید و src/autoload.php را require کنید (یا پوشه را بهعنوان مخزن محلی Composer اضافه کنید).
- راهنمای README و نمونههای پوشه examples صدور، استعلام، برگشت و ابطال را گامبهگام نشان میدهند.
دانلود فایل افزونه کتابخانه PHP(۱۳۴ کیلوبایت)SHA-256:
7e2dbb72d4706781f6ff3c1969fc5580aec6255cd1fde3cb7cfa1659c58e2790
فهرست نسخهها و چکیده SHA-256 همه فایلها در download.asatsp.ir/Plugins/latest.json هم منتشر میشود.
امکانات افزونه در پیشخوان فروشگاه
افزونه معتمد آسا در بخش مدیریت فروشگاه صفحهای به نام «معتمد آسا» دارد. این صفحه در وردپرس (ووکامرس و Easy Digital Downloads)، اپنکارت ۳ و ۴، پرستاشاپ و مجنتو ۲ یکسان است و ارسال و پیگیری صورتحسابها، گزارش فروش و تنظیمات افزونه در زبانههای آن قرار دارد.
عکسهای این بخش از یک فروشگاه آزمایشی وردپرس با نسخه ۲٫۰٫۱، در محیط سندباکس و با سفارشهای ساختگی گرفته شدهاند.
پیشخوان و زبانههای صفحه معتمد آسا
زبانه «پیشخوان» شمار صورتحسابهای ثبتشده، ارسالنشده، در انتظار پاسخ و نیازمند اقدام را همراه با درخواستهای ۲۴ ساعت گذشته و آخرین عملیات نشان میدهد. زمان صدور خودکار و روش ارسال را از همین زبانه تغییر میدهید و «محدودیت IP» را روشن میکنید.
زبانههای دیگر این صفحه:
- «صورتحسابها»: همه صورتحسابهای فروشگاه با وضعیت، شماره مالیاتی و مبلغ. ارسال، ارسال مجدد و استعلام، تکی یا گروهی، از همین فهرست انجام میشود.
- «کالاها و خدمات»: شناسه کالا/خدمت، واحد، نرخ ارزش افزوده، کد داخلی و شرح هر محصول در صورتحساب. دکمه «استعلام» شرح رسمی و نرخ ارزش افزوده شناسه را از فهرست سامانه مؤدیان نشان میدهد.
- «گزارش عملیات»: هر درخواست افزونه به معتمد آسا با نتیجه، مدت و JSON ارسالی و دریافتی، تا ۹۰ روز. رمز اتصال و توکن در این گزارش ذخیره نمیشوند.
- «تنظیمات»: همه تنظیمات افزونه و دکمه «آزمایش اتصال».


گزارش فروش، صورتحساب و ارزش افزوده
زبانه «گزارشها» در نسخه ۲٫۰٫۱ اضافه شده است. بازه گزارش را از میان ۳۰ روز اخیر، ماه جاری، ماه گذشته، فصل جاری، فصل گذشته و امسال انتخاب میکنید یا تاریخ شروع و پایان را به شمسی وارد میکنید. مبالغ به ریال و بر پایه تاریخ صدور صورتحساباند و صورتحساب ابطالشده جزو فروش شمرده نمیشود.
این زبانه موارد زیر را نشان میدهد و هر نمودار آن دکمه «نمایش جدول» هم دارد:
- فروش فروشگاه در کنار مبلغ صورتحسابهای صادرشده در ۱۲ ماه شمسی
- شمار صورتحسابها در هر روز به تفکیک وضعیت، و سهم هر وضعیت در بازه
- ارزش افزوده چهار فصل اخیر: فروش، برگشت و خالص
- درخواستهای فروشگاه به معتمد آسا در هر روز و برای هر عملیات، با درصد موفقیت و میانگین زمان پاسخ
- پرتکرارترین دلیلهای رد یا خطا
- فایل CSV صورتحسابهای بازه برای دریافت
جدول ارزش افزوده فصلها برای بررسی و کنترل است. مبنای اظهارنامه ارزش افزوده، گزارش رسمی سامانه مؤدیان است.


سفارشهای ارسالنشده
زبانه «سفارشهای ارسالنشده» سفارشهایی را فهرست میکند که به وضعیت تعیینشده برای صدور خودکار رسیدهاند اما هنوز صورتحساب ندارند. اگر صدور خودکار خاموش باشد، این فهرست سفارشهای تکمیلشده را نشان میدهد.
فهرست را با تاریخ محدود میکنید و یک سفارش، سفارشهای انتخابشده یا با «ارسال همه» همه سفارشهای فیلترشده را میفرستید. پیشرفت «ارسال همه» روی صفحه دیده میشود و هر زمان بخواهید، میتوانید آن را متوقف کنید.
ارسال گروهی از فهرست سفارشهای فروشگاه هم بیدرنگ آغاز میشود. پس از ارسال، شمار سفارشهای ثبتشده، سفارشهای ناموفق همراه با نخستین خطا و سفارشهایی که پیشتر ثبت شده بودند، نمایش داده میشود.

سفارشهای قدیمیتر از ۱۴ روز
سامانه مؤدیان صورتحسابی را که تاریخ صدورش بیش از ۱۵ روز پیش باشد نمیپذیرد. برای همین، افزونه سفارشی را که بیش از ۱۴ روز از ثبتش گذشته است فقط به روشی میفرستد که مدیر فروشگاه هنگام ارسال انتخاب میکند:
- «ماده ۹»: تاریخ صورتحساب، تاریخ واقعی فروش میماند و صورتحساب طبق ماده ۹ فرستاده میشود. زمان ارسال، تاریخ ثبت صورتحساب در نظر گرفته میشود.
- «انتقال تاریخ به ۱۲ روز پیش»: تاریخ صدور به ۱۲ روز پیش از روز ارسال، در همان ساعت فروش، منتقل میشود و صورتحساب بهصورت عادی فرستاده میشود. در این حالت تاریخ صورتحساب با تاریخ واقعی فروش یکی نیست.
روشی که انتخاب میکنید برای آن سفارش ذخیره میشود و ارسال مجدد خودکار هم از آن پیروی میکند. ارسال خودکار و دکمههای دیگر، سفارش قدیمی را بدون این انتخاب نمیفرستند تا تاریخی که سامانه مؤدیان رد میکند ارسال نشود. چنین سفارشی در زبانه «سفارشهای ارسالنشده» میماند تا روش ارسال آن را تعیین کنید.

ابزارک معتمد آسا در صفحه اصلی پیشخوان
افزونه در صفحه اصلی پیشخوان وردپرس، اپنکارت، پرستاشاپ و مجنتو یک ابزارک اضافه میکند. این ابزارک صورتحسابهای ماه جاری و مبلغ پذیرفتهشده، موارد نیازمند اقدام، سفارشهای بدون صورتحساب، نمودار صورتحسابهای ۱۴ روز اخیر و زمان آخرین ارتباط موفق را نشان میدهد. لینکهای ابزارک به زبانههای صفحه معتمد آسا میروند.

کارهای پسزمینه فروشگاه
افزونه صورتحسابهای صف، استعلام وضعیت و ارسال مجدد را با کارهای پسزمینه فروشگاه انجام میدهد. اگر این کارها عقب بیفتند، زبانه «پیشخوان» هشدار میدهد و دکمه «اجرای کارهای عقبافتاده» را نشان میدهد. در وردپرس، دکمه «بررسی و رفع مشکل» هم کنار آن است.
«بررسی و رفع مشکل» علت را مشخص میکند:
- WP-Cron در فایل wp-config.php خاموش شده است.
- درخواست سایت به خودش (loopback) مسدود است. کد HTTP یا متن خطا برای پشتیبانی هاست نمایش داده میشود.
- WP-Cron دیر اجرا میشود، برای نمونه پشت کش کامل صفحه مثل LiteSpeed Cache.
- صف Action Scheduler ووکامرس شلوغ است.
این دکمه اگر زمانبند ۱۰ دقیقهای افزونه حذف شده باشد، آن را دوباره ثبت میکند و کارهای عقبافتاده را اجرا میکند. برای Cron Jobs هاست (cPanel، DirectAdmin یا Plesk) هم دستورهای آماده برای اجرا هر پنج دقیقه را با دکمه «کپی» میدهد: wget یا curl به نشانی اختصاصی با کلید محرمانه فروشگاه، یا php wp-cron.php وقتی سایت به خودش دسترسی ندارد.
تا وقتی علت برطرف نشده است، هر بار که مدیر فروشگاه صفحهای از مدیریت وردپرس را باز میکند و کارهای افزونه عقب افتادهاند، این کارها در پسزمینه اجرا میشوند. این کار حداکثر یک بار در دقیقه انجام میشود و صفحه را کند نمیکند.
«بررسی و رفع مشکل» و اجرای پشتیبان فقط در وردپرس است. در اپنکارت، پرستاشاپ و مجنتو، هشدار و دکمه «اجرای کارهای عقبافتاده» در دسترس است.
بهروزرسانی افزونه
نسخه تازه افزونه در بخش مدیریت خود فروشگاه اعلام میشود. در وردپرس، اپنکارت و پرستاشاپ، نصب آن با یک کلیک انجام میشود: وردپرس برای این کار از بهروزرسان خودش استفاده میکند و در اپنکارت و پرستاشاپ، دکمه بهروزرسانی در صفحه معتمد آسا است. در مجنتو، صفحه معتمد آسا مراحل بهروزرسانی را نشان میدهد.
پیش از نصب، چکیده SHA-256 هر بسته با مقدار منتشرشده در مرکز دانلود آسا مقایسه میشود و بستهای که مطابقت نداشته باشد، نصب نمیشود.
مسیر صورتحساب در روش «افزونه فروشگاه اینترنتی»
- سفارش در فروشگاه شماتکمیل سفارش یا دکمه «ارسال به سامانه مودیان»
- افزونه معتمد آساساخت صورتحساب از اقلام، تخفیف، ارسال و مالیات
- وبسرویس آساکنترل، امضا با کلید معتمد آسا و ارسال
- وضعیت کنار سفارششماره مالیاتی و نتیجه در صفحه سفارش
مراحل راهاندازی و استفاده
ثبتنام و تعریف کسبوکار
در پنل آسا کسبوکار را با شناسه یکتای حافظه مالیاتی تعریف کنید. برای آزمایش، شناسه حافظه مالیاتی محیط سندباکس را هم داشته باشید.
دریافت شناسه و رمز اتصال
در پنل، از «کسبوکارها» وارد تنظیمات کسبوکار شوید و در زبانه «اتصال API v2» اعتبارنامه صادر کنید. رمز اتصال (Client Secret) فقط یکبار و هنگام صدور نمایش داده میشود.
نصب افزونه
فایل افزونه فروشگاهساز خود را از بخش «دانلود» همین صفحه بگیرید و از بخش افزونهها یا ماژولهای فروشگاه نصب و فعال کنید.
تنظیم و آزمایش اتصال
شناسه و رمز اتصال را وارد کنید و روی «آزمایش اتصال» کلیک کنید. سپس روش مالیات بر ارزش افزوده و شناسه کالا/خدمت پیشفرض را مشخص کنید و اگر هزینه ارسال میگیرید، شناسه خدمت هزینه ارسال را هم تعیین کنید. برای شروع میتوانید محیط سندباکس را انتخاب کنید.
شناسه کالای محصولات
در صفحه هر محصول، شناسه ۱۳ رقمی کالا/خدمت را وارد کنید. لینک جستوجوی شناسه در stuffid.asatsp.ir هم در همین صفحه است.
صدور خودکار و پیگیری
از این پس صورتحساب سفارشهایی که به وضعیت انتخابی برسند بهطور خودکار صادر میشود و وضعیت هر صورتحساب هر چند دقیقه یکبار از سامانه مؤدیان بهروز میشود.
مزایا و معایب روش «افزونه فروشگاه اینترنتی»
مزایا
- رایگان و متنبازافزونه رایگان است و با مجوز GPL منتشر میشود. تنها هزینه، تعرفه معمول صورتحساب در معتمد آساست.
- بدون برنامهنویسیدر وردپرس، اپنکارت و پرستاشاپ، نصب و تنظیم در چند دقیقه و از پیشخوان خود فروشگاه انجام میشود.
- صدور خودکار، دستی و گروهیصورتحساب با رسیدن سفارش به وضعیت انتخابی صادر میشود. هر سفارش یا گروهی از سفارشها را هم میتوانید دستی بفرستید.
- انتخاب درست نوع ۱ و ۲نوع ۲ پیشفرض است و اگر خریدار شناسه وارد کند، نوع ۱ صادر میشود. کد ملی و شناسه ملی هم در زمان خرید با رقم کنترلی بررسی میشوند.
- محاسبه درست مبالغتبدیل تومان به ریال، تخفیفها، هزینه ارسال و مالیات بر ارزش افزوده با یک هسته محاسبه مشترک و آزموده ساخته میشوند.
- بدون صورتحساب تکراریهر سفارش کد داخلی یکتا دارد. اگر ارتباط وسط کار قطع شود، افزونه پیش از ارسال دوباره، وضعیت را از آسا استعلام میکند.
- برگشت و ابطال با تأیید شماافزونه برای استرداد، «برگشت از فروش» یا «ابطال» را پیشنهاد میدهد و چیزی را بدون تأیید شما در سامانه مؤدیان ثبت نمیکند.
- محیط آزمایشیپیش از ارسال واقعی، همهچیز را در محیط سندباکس سازمان آزمایش کنید.
معایب و محدودیتها
- فقط فروشگاهسازهای نصبشدنیروی فروشگاهسازهای آمادهای که اجازه نصب افزونه نمیدهند کار نمیکند. برای آنها فایل اکسل یا وبسرویس مناسب است.
- شناسه کالای درست لازم استشناسه کالا/خدمت هر محصول باید درست باشد. شناسه نادرست به رد صورتحساب در سامانه مؤدیان میانجامد.
- استرداد فقط مبلغیکاهش مبلغ بدون برگشت کالا «صورتحساب اصلاحی» میخواهد که از پنل آسا صادر میشود. افزونه در این حالت همین نکته را به شما اعلام میکند.
- زمانبند هاستدر اپنکارت، پرستاشاپ و مجنتو، برای صدور و بهروزرسانی خودکار، زمانبند (کرون) هاست باید فعال باشد. نشانی و دستور آن در تنظیمات افزونه آمده است. در وردپرس زمانبند خود وردپرس کافی است.
امنیت روش «افزونه فروشگاه اینترنتی»
فقط ارتباط خروجی به آسا
افزونه فقط با HTTPS به api-v2.asatsp.ir وصل میشود و هیچ مسیر ورودی تازهای روی فروشگاه باز نمیکند، جز نشانی زمانبند با رمز اختصاصی در فروشگاهسازهایی که به آن نیاز دارند.
رمز اتصال دوباره نمایش داده نمیشود
Client Secret پس از ذخیره در صفحه تنظیمات نشان داده نمیشود و در گزارشها نوشته نمیشود.
محدودیت IP
شناسه و رمز اتصال را میتوانید از صفحه «معتمد آسا» به نشانی IP سرور فروشگاه محدود کنید. پس از آن، معتمد آسا درخواستی را که با این شناسه از نشانی دیگری برسد نمیپذیرد.
توکن کوتاهمدت
درخواستها با توکنی ۶۰ دقیقهای انجام میشوند که خود افزونه میگیرد و تمدید میکند.
بدون کلید امضا روی سرور شما
صورتحساب با کلید معتمد آسا امضا میشود و هیچ کلید خصوصی یا گواهی روی سرور فروشگاه نگهداری نمیشود.
کمترین اطلاعات خریدار
در صورتحساب نوع ۲ هیچ شناسه هویتی از خریدار فرستاده نمیشود و فرستادن نام و شماره همراه او هم در تنظیمات قابل خاموش کردن است.
دسترسی مدیران و ثبت همه اقدامها
تنظیمات و دکمههای ارسال، برگشت و ابطال فقط برای مدیرانی است که دسترسی ویرایش سفارش دارند و هر اقدام در تاریخچه آن سفارش میماند.
آسا شرکت معتمد مالیاتی نوع اول با مجوز سازمان امور مالیاتی کشور است و از دادههای شما طبق ضوابط محرمانگی و حریم خصوصی محافظت میکند.
پیشنیازها
- یکی از فروشگاهسازهای بخش «دانلود» روی هاستی با PHP نسخه ۷٫۲ یا بالاتر و افزونه cURL (مجنتو: PHP ۸٫۱ به بالا)
- اجازه ارتباط خروجی HTTPS از هاست به api-v2.asatsp.ir
- Client ID و Client Secret صادرشده از زبانه «اتصال API v2» در تنظیمات کسبوکار
- شناسه یکتای حافظه مالیاتی فعال در پنل آسا و برای آزمایش، شناسه حافظه سندباکس
- شناسه ۱۳ رقمی کالا/خدمت برای محصولات، یا یک شناسه پیشفرض
پیشنیاز مشترک همه روشها ثبتنام رایگان در پنل آسا و دریافت شناسه یکتای حافظه مالیاتی با کلید معتمد آسا است. مراحل را در راهنمای ثبتنام و دریافت شناسه یکتا ببینید.
مستندات و منابع این روش
- جستوجوی شناسه کالا/خدمت (در زبانه جدید باز میشود)شناسه ۱۳ رقمی هر کالا یا خدمت را بینیاز از ورود پیدا کنید.
- مستندات API نسخه ۲افزونهها روی همین وبسرویس کار میکنند. این مستندات برای تیم فنی و سایتهای اختصاصی است.
- راهنمای ثبتنام و دریافت شناسه یکتاراهنمای تصویری انتخاب معتمد آسا در کارپوشه، دریافت شناسه یکتای حافظه مالیاتی و تعریف کسبوکار در پنل آسا.
- ورود به پنل آسا (در زبانه جدید باز میشود)پنل آسا در نشانی my.asatsp.ir است و صورتحسابهای همه روشها در آن مدیریت و پیگیری میشوند.
مالیات بر ارزش افزوده و واحد پول
در تنظیمات افزونه یک بار مشخص میکنید قیمتهای فروشگاه چگونه مالیات بر ارزش افزوده دارند. تا این انتخاب انجام نشود، صورتحسابی صادر نمیشود.
| انتخاب | برای فروشگاهی که… | در صورتحساب |
|---|---|---|
| از تنظیمات مالیات فروشگاه | مالیات را خود فروشگاهساز روی سبد خرید اضافه میکند | مبلغ بدون مالیات و نرخ مالیات تنظیمشده در فروشگاه |
| قیمتها شامل ارزش افزوده است | قیمتها با مالیات وارد شدهاند و جداگانه حساب نمیشوند | مبلغ خالص از قیمت استخراج میشود؛ نرخ پیشفرض یا نرخ خود محصول |
| کالاها معافاند | کالا یا خدمت معاف است و مالیاتی دریافت نمیشود | نرخ صفر |
صورتحساب سامانه مؤدیان به ریال است. قیمتهای تومان، هزار ریال و هزار تومان بهطور خودکار به ریال تبدیل میشوند و اگر واحد پول فروشگاه کد ناآشنایی داشته باشد، آن را یک بار در تنظیمات انتخاب میکنید.
وضعیتهایی که کنار هر سفارش میبینید
| وضعیت | معنا |
|---|---|
| در صف ارسال | در معتمد آسا ثبت شده و بهزودی برای سامانه مؤدیان فرستاده میشود. |
| در انتظار پاسخ سامانه | فرستاده شده و پاسخ سامانه مؤدیان هنوز نیامده است. |
| ثبت در سامانه مودیان | پذیرفته شده؛ شماره منحصربهفرد مالیاتی و شماره مرجع نمایش داده میشود. |
| نیازمند اصلاح | اطلاعاتی کم یا نادرست بوده و چیزی ثبت نشده؛ علت با توضیح فارسی آمده است. |
| رد شده | سامانه مؤدیان نپذیرفته؛ پس از رفع علت، «ارسال مجدد» نسخه اصلاحشده را میفرستد. |
| خطای اتصال / در حال بررسی نتیجه | ارتباط برقرار نشد یا وسط کار قطع شد؛ افزونه خودش دوباره تلاش یا استعلام میکند. |
| ابطال شد | صورتحساب این سفارش در سامانه مؤدیان ابطال شده است. |
استرداد، برگشت از فروش و ابطال
- استرداد بخشی از اقلام: افزونه «صورتحساب برگشت از فروش» را با اقلام باقیمانده پیشنهاد میدهد.
- استرداد همه اقلام یا کل سفارش: طبق دستورالعمل سازمان، «ابطال» صورتحساب پیشنهاد میشود.
- استرداد فقط مبلغی، بدون برگشت کالا: افزونه اعلام میکند که «صورتحساب اصلاحی» لازم است و از پنل آسا صادر میشود.
- هیچکدام بدون تأیید شما ارسال نمیشود و پیش از تأیید، نتیجه کار در پیامی روشن نمایش داده میشود.
- برگشت و ابطال فقط پس از ثبت نهایی صورتحساب فروش ممکن است. تا آن زمان، پیشنهاد در صفحه سفارش میماند.
پرسشهای متداول درباره روش «افزونه فروشگاه اینترنتی»
آیا افزونه رایگان است؟
بله. افزونه رایگان و متنباز (GPL) است و تنها هزینه، تعرفه معمول صدور صورتحساب در معتمد آساست.
شناسه و رمز اتصال را از کجا بگیرم؟
در پنل آسا از «کسبوکارها» وارد تنظیمات کسبوکار شوید و در زبانه «اتصال API v2» اعتبارنامه صادر کنید. رمز اتصال فقط یکبار و هنگام صدور نمایش داده میشود. اگر آن را ندارید، در همین زبانه رمز تازه بگیرید.
اگر قیمتهای فروشگاه به تومان باشد، مشکلی پیش میآید؟
خیر. افزونه تومان، هزار ریال و هزار تومان را بهطور خودکار به ریال تبدیل میکند، چون صورتحساب سامانه مؤدیان ریالی است.
اگر برای محصولی شناسه کالا وارد نکنم چه میشود؟
شناسه کالا/خدمت پیشفرض تنظیمات به کار میرود. اگر شناسه پیشفرض هم نباشد، صورتحساب آن سفارش «نیازمند اصلاح» میشود و نام محصولی را که شناسه ندارد میبینید.
اگر خریدار صورتحساب به نام شرکتش بخواهد، چه باید بکند؟
هنگام خرید، نوع «شخص حقوقی» و شناسه ملی شرکت را وارد کند تا صورتحساب نوع ۱ به نام شرکت صادر شود (در ووکامرس در بخش «صورتحساب رسمی» صفحه پرداخت، در اپنکارت و پرستاشاپ در فیلدهای فرم نشانی). برای شخص حقیقی، کد ملی همراه کد پستی نشانی صورتحساب لازم است. در EDD صورتحسابها همیشه نوع ۲ هستند.
اگر ارتباط وسط ارسال قطع شود، ممکن است صورتحساب تکراری صادر شود؟
خیر. هر سفارش کد داخلی یکتا دارد و آسا صورتحساب دوم با همان کد را نمیپذیرد. افزونه هم پس از قطع ارتباط، پیش از هر ارسال دوباره، وضعیت را استعلام میکند.
آیا میتوانم چند فروشگاه را به یک کسبوکار وصل کنم؟
بله. برای هر فروشگاه در تنظیمات افزونه «پیشوند کد داخلی» متفاوتی بگذارید تا کد داخلی سفارشهای فروشگاهها با هم یکی نشود.
اگر فروشگاهساز من در فهرست نباشد، چه راهی دارم؟
اگر سایت شما با PHP ساخته شده، کتابخانه PHP همین افزونهها را به کار ببرید. در غیر این صورت وبسرویس نسخه ۲ یا ورود گروهی با فایل اکسل را انتخاب کنید یا برای مشاوره رایگان با ما تماس بگیرید.
روشهای دیگر اتصال به آسا
- پنل تحت وبسادهترین راه شروع، بدون نصب و بدون نیاز به دانش فنی
- فایل اکسلتا ۵۰۰٬۰۰۰ ردیف در هر فایل، با خطایابی پیش از ثبت
- وبسرویس (API)یکپارچهسازی کامل برای تیمهای فنی و سامانههای فروش
- اتصال نرمافزار حسابداریورود صورتحسابهای سپیدار، هلو، تدبیر و سیبا به پنل آسا
- پایگاه داده اختصاصیسازگار با هر پایگاه داده، بدون تغییر در نرمافزار شما
- کارتخوانتراکنشهای کارتخوان را بدون ورود دستی به صورتحساب تبدیل کنید
شروع کار با افزونه فروشگاه اینترنتی
ثبتنام در آسا رایگان است. اگر مطمئن نیستید این روش برای کسبوکار شما مناسب است، کارشناسان آسا راهنماییتان میکنند.
ثبتنام هزینهای ندارد، به گواهی امضا نیازی نیست و ارسال صورتحساب در روزهای تعطیل هم انجام میشود.