ووکامرس، اپنکارت، پرستاشاپ و مجنتو؛ بدون برنامهنویسی
اتصال فروشگاه اینترنتی به سامانه مؤدیان با افزونه رایگان معتمد آسا
افزونه رایگان معتمد آسا را روی فروشگاه خود نصب کنید تا صورتحساب الکترونیکی هر سفارش خودکار صادر و به سامانه مؤدیان فرستاده شود و وضعیت آن کنار همان سفارش دیده شود؛ برای ووکامرس و EDD در وردپرس، اپنکارت ۳ و ۴، پرستاشاپ و مجنتو ۲، بههمراه یک کتابخانه PHP برای سایتهای اختصاصی.
- دانش فنی لازم
- مدیر فروشگاه؛ بدون برنامهنویسی
- حجم مناسب صورتحساب
- کم تا بسیار زیاد
- راهاندازی
- نصب افزونه و چند تنظیم
- میزان خودکارسازی
- خودکار، دستی یا گروهی
روش «افزونه فروشگاه اینترنتی» چیست و برای چه کسی مناسب است؟
افزونه معتمد آسا فروشگاه اینترنتی شما را از راه وبسرویس نسخه ۲ آسا به سامانه مؤدیان وصل میکند. شناسه و رمز اتصال را از پنل آسا در تنظیمات افزونه وارد میکنید و از آن پس صورتحساب هر سفارشی که به وضعیت انتخابی شما برسد (بهطور پیشفرض وضعیت پایانی سفارش، مثل «تکمیلشده» یا «تحویلشده») خودکار صادر میشود. ارسال دستی هر سفارش و ارسال گروهی از فهرست سفارشها هم همیشه در دسترس است.
صورتحساب نوع ۲ (مصرفکننده نهایی) پیشفرض است. اگر خریدار هنگام خرید شناسهاش را وارد کند، یعنی کد ملی همراه کد پستی برای شخص حقیقی یا شناسه ملی برای شرکت، صورتحساب نوع ۱ به نام او صادر میشود: در ووکامرس در بخش اختیاری «صورتحساب رسمی» صفحه پرداخت، در اپنکارت و پرستاشاپ در فیلدهای کد ملی و شماره اقتصادی فرم نشانی، و در مجنتو از شماره مالیاتی نشانی یا شناسهای که مدیر در صفحه سفارش وارد میکند. اگر خریدار حقیقی در سامانه مؤدیان پرونده مالیاتی نداشته باشد، افزونه همان سفارش را خودکار با نوع ۲ صادر میکند.
مبالغ با همان قواعد آسا ساخته میشوند: قیمتهای تومانی به ریال تبدیل میشوند، کد تخفیف تخفیف همان ردیفها میشود، هزینه ارسال با شناسه خدمت خودش در صورتحساب میآید و مالیات بر ارزش افزوده یا از تنظیمات مالیات فروشگاه خوانده میشود یا از قیمتهای شامل مالیات استخراج میشود. شناسه کالا/خدمت هر محصول در صفحه همان محصول وارد میشود و یک شناسه پیشفرض هم در تنظیمات دارید.
وضعیت هر صورتحساب، یعنی شماره منحصربهفرد مالیاتی، شماره مرجع، واکنش خریدار در کارپوشه و هر خطا با توضیح فارسی، در صفحه سفارش و ستون فهرست سفارشها دیده میشود. وقتی سفارشی را مسترد میکنید، افزونه «برگشت از فروش» یا «ابطال» را پیشنهاد میدهد و فقط پس از تأیید شما در سامانه مؤدیان ثبت میکند.
مناسب است اگر…
- فروشگاه اینترنتی شما با ووکامرس، Easy Digital Downloads، اپنکارت، پرستاشاپ یا مجنتو ساخته شده است.
- میخواهید صورتحساب هر سفارش بدون ورود دوباره اطلاعات و بدون برنامهنویسی صادر شود.
- بیشتر به مصرفکننده نهایی میفروشید و گاهی خریدار، صورتحساب به نام خودش یا شرکتش میخواهد.
- میخواهید وضعیت سامانه مؤدیان را کنار خود سفارش ببینید، نه در یک سامانه جدا.
روش دیگری انتخاب کنید اگر…
- فروشگاهساز آمادهای (SaaS) دارید که اجازه نصب افزونه نمیدهد: فایل اکسل
- سامانه فروش اختصاصی دارید و تیم فنی در اختیارتان است: وبسرویس (API)
دانلود افزونه فروشگاهساز شما
نسخه ۱.۰.۰، منتشرشده در ۶ آبان ۱۴۰۵. همه افزونهها رایگاناند و با مجوز GPL منتشر میشوند؛ هسته محاسبات و ارسال در همه آنها یکی است.
وردپرس: ووکامرس و EDD
ووکامرس ۶ به بالا (با ذخیرهسازی سفارش HPOS یا قدیمی و صفحه پرداخت کلاسیک یا بلوکی) و Easy Digital Downloads ۳ به بالا، روی وردپرس ۵٫۸ به بالا
- پیشنیاز
- PHP ۷٫۲ به بالا
- تنظیمات
- «ووکامرس ← معتمد آسا» (اگر فقط EDD دارید: «دانلودها ← معتمد آسا»)
راهنمای نصب
- در پیشخوان وردپرس به «افزونهها ← افزودن افزونه ← بارگذاری افزونه» بروید.
- فایل zip را انتخاب کنید، «هماکنون نصب کن» و سپس «فعال کردن» را بزنید.
دانلود فایل افزونه وردپرس: ووکامرس و EDD(۱۱۹ کیلوبایت)SHA-256:
81b0a6b77f655319e9e52877d84ce426490a3725dab9fbfc7495883a04754c26اپنکارت ۳
اپنکارت ۳٫۰٫۲ تا ۳٫۰٫۵ و نسخههای فارسی آن
- پیشنیاز
- PHP ۷٫۲ به بالا با cURL
- تنظیمات
- «افزونهها ← ماژولها ← معتمد آسا»؛ فهرست وضعیت سفارشها در «فروش ← معتمد آسا»
راهنمای نصب
- در پیشخوان به «افزونهها ← نصب افزونه» بروید و فایل را بارگذاری کنید.
- در «افزونهها ← افزونهها ← ماژولها»، ماژول «معتمد آسا» را نصب و سپس ویرایش کنید.
- خط زمانبند (کرون) را که در تنظیمات ماژول آمده، در کرونجاب هاست تعریف کنید.
دانلود فایل افزونه اپنکارت ۳(۱۲۶ کیلوبایت)SHA-256:
3cf06b63e009079a7243c782fcaa655c6f8f7984b187a7cd72952e10a41c4b5dاپنکارت ۴
اپنکارت ۴٫۰٫۲ تا ۴٫۱
- پیشنیاز
- PHP ۸ به بالا با cURL (همان نیاز اپنکارت ۴)
- تنظیمات
- «افزونهها ← ماژولها ← معتمد آسا»؛ فهرست وضعیت سفارشها در «فروش ← معتمد آسا»
راهنمای نصب
- نام فایل را تغییر ندهید؛ اپنکارت ۴ پوشه افزونه را از نام فایل میسازد.
- در پیشخوان به «افزونهها ← نصبکننده» بروید، فایل را بارگذاری و «نصب» کنید.
- در «افزونهها ← افزونهها ← ماژولها»، ماژول «معتمد آسا» را نصب و سپس ویرایش کنید؛ زمانبند اپنکارت (کرون) هاست باید فعال باشد.
دانلود فایل افزونه اپنکارت ۴(۱۲۶ کیلوبایت)SHA-256:
692785d9dea9c3c675db265f440a8dbce95af009e39b7f931197c077b589ea4dپرستاشاپ
پرستاشاپ ۱٫۷٫۶ تا ۸٫۲
- پیشنیاز
- PHP ۷٫۲ به بالا با cURL
- تنظیمات
- «ماژولها ← مدیریت ماژول ← معتمد آسا ← پیکربندی»
راهنمای نصب
- در پیشخوان به «ماژولها ← مدیریت ماژول» بروید و «بارگذاری یک ماژول» را بزنید.
- فایل zip را رها کنید تا نصب شود، سپس «پیکربندی» را بزنید.
- خط زمانبند (کرون) را که در صفحه پیکربندی آمده، در کرونجاب هاست تعریف کنید.
دانلود فایل افزونه پرستاشاپ(۱۲۱ کیلوبایت)SHA-256:
108d3eb6260bb115601352817b194412db5117378c515ca60c5f786fa521b402مجنتو ۲
مجنتو اوپنسورس و ادوبی کامرس ۲٫۴٫۴ تا ۲٫۴٫۷
- پیشنیاز
- PHP ۸٫۱ تا ۸٫۳ و کرون مجنتو فعال
- تنظیمات
- «فروشگاهها ← پیکربندی ← فروش ← معتمد آسا»
راهنمای نصب
- فایل را در ریشه مجنتو باز کنید تا پوشه app/code/AsaTsp/Connector ساخته شود.
- دستورهای bin/magento module:enable AsaTsp_Connector، setup:upgrade، setup:di:compile و cache:flush را اجرا کنید.
دانلود فایل افزونه مجنتو ۲(۱۵۱ کیلوبایت)SHA-256:
aa4882f2fc2defc58cadcf7f7d1b489811795771b495d0c5d48d5cbfc5500b5bکتابخانه PHP
سایتها و فروشگاههای اختصاصی با PHP (لاراول، یی، کدایگنایتر یا PHP ساده)
- پیشنیاز
- PHP ۷٫۲ به بالا با cURL
- تنظیمات
- در کد شما، با کلاس Config
راهنمای نصب
- فایل را در پروژه باز کنید و src/autoload.php را require کنید (یا پوشه را بهعنوان مخزن محلی Composer اضافه کنید).
- راهنمای README و نمونههای پوشه examples صدور، استعلام، برگشت و ابطال را گامبهگام نشان میدهند.
دانلود فایل افزونه کتابخانه PHP(۸۱ کیلوبایت)SHA-256:
f2135eae3fe2832dd3434625613658735310438030447f37b3f8da895f7696ac
فهرست نسخهها و چکیده SHA-256 همه فایلها در download.asatsp.ir/Plugins/latest.json هم منتشر میشود.
صورتحساب در این روش چه مسیری را طی میکند؟
- سفارش در فروشگاه شماتکمیل سفارش یا دکمه «ارسال به سامانه مودیان»
- افزونه معتمد آساساخت صورتحساب از اقلام، تخفیف، ارسال و مالیات
- وبسرویس آساکنترل، امضا با کلید معتمد آسا و ارسال
- وضعیت کنار سفارششماره مالیاتی و نتیجه در صفحه سفارش
مراحل راهاندازی و استفاده
ثبتنام و تعریف کسبوکار
در پنل آسا کسبوکار را با شناسه یکتای حافظه مالیاتی تعریف کنید. برای آزمایش، شناسه حافظه مالیاتی محیط سندباکس را هم داشته باشید.
دریافت شناسه و رمز اتصال
در پنل، از «کسبوکارها» وارد تنظیمات کسبوکار شوید و در زبانه «اتصال API v2» اعتبارنامه صادر کنید. رمز اتصال (Client Secret) فقط همان لحظه نمایش داده میشود.
نصب افزونه
فایل افزونه فروشگاهساز خود را از بخش «دانلود» همین صفحه بگیرید و از بخش افزونهها یا ماژولهای فروشگاه نصب و فعال کنید.
تنظیم و آزمایش اتصال
شناسه و رمز اتصال را وارد کنید و «آزمایش اتصال» را بزنید. سپس روش مالیات بر ارزش افزوده، شناسه کالا/خدمت پیشفرض و، اگر هزینه ارسال میگیرید، شناسه خدمت هزینه ارسال را مشخص کنید. برای شروع میتوانید محیط سندباکس را انتخاب کنید.
شناسه کالای محصولات
در صفحه هر محصول، شناسه ۱۳ رقمی کالا/خدمت را وارد کنید؛ لینک جستوجوی شناسه در stuffid.asatsp.ir از همانجا باز میشود.
صدور خودکار و پیگیری
از این پس سفارشها در وضعیت انتخابی خودکار صادر میشوند و وضعیت هر صورتحساب هر چند دقیقه یکبار از سامانه مؤدیان بهروز میشود.
مزایا و معایب روش «افزونه فروشگاه اینترنتی»
مزایا
- رایگان و متنبازافزونه رایگان است و با مجوز GPL منتشر میشود؛ هزینه فقط همان تعرفه صورتحساب در معتمد آساست.
- بدون برنامهنویسینصب و تنظیم در چند دقیقه و از پیشخوان خود فروشگاه انجام میشود.
- صدور خودکار، دستی و گروهیصورتحساب با رسیدن سفارش به وضعیت انتخابی صادر میشود؛ هر سفارش یا گروهی از سفارشها را هم میتوانید دستی بفرستید.
- نوع ۱ و ۲ بدون دردسرنوع ۲ پیشفرض است و اگر خریدار شناسه وارد کند نوع ۱ صادر میشود؛ کد ملی و شناسه ملی همان هنگام خرید با رقم کنترلی بررسی میشوند.
- مبالغ درستتبدیل تومان به ریال، تخفیفها، هزینه ارسال و مالیات بر ارزش افزوده با یک هسته محاسبه مشترک و آزموده ساخته میشوند.
- بدون صورتحساب تکراریهر سفارش کد داخلی یکتا دارد. اگر ارتباط وسط کار قطع شود، افزونه پیش از ارسال دوباره، وضعیت را از آسا استعلام میکند.
- برگشت و ابطال با تأیید شماافزونه برای استرداد، «برگشت از فروش» یا «ابطال» را پیشنهاد میدهد و چیزی را بدون تأیید شما در سامانه مؤدیان ثبت نمیکند.
- محیط آزمایشیپیش از ارسال واقعی، همهچیز را در محیط سندباکس سازمان آزمایش کنید.
معایب و محدودیتها
- فقط فروشگاهسازهای نصبشدنیروی فروشگاهسازهای آمادهای که اجازه نصب افزونه نمیدهند کار نمیکند؛ برای آنها فایل اکسل یا وبسرویس مناسب است.
- شناسه کالای درست لازم استشناسه کالا/خدمت هر محصول باید درست باشد؛ شناسه نادرست یعنی رد صورتحساب در سامانه مؤدیان.
- استرداد فقط مبلغیکاهش مبلغ بدون برگشت کالا «صورتحساب اصلاحی» میخواهد که از پنل آسا صادر میشود؛ افزونه همین را به شما میگوید.
- زمانبند هاستدر اپنکارت، پرستاشاپ و مجنتو، برای صدور و بهروزرسانی خودکار، زمانبند (کرون) هاست باید فعال باشد؛ نشانی و دستور آن در تنظیمات افزونه آمده است. در وردپرس زمانبند خود ووکامرس کافی است.
امنیت روش «افزونه فروشگاه اینترنتی»
فقط ارتباط خروجی به آسا
افزونه فقط با HTTPS به api-v2.asatsp.ir وصل میشود و هیچ مسیر ورودی تازهای روی فروشگاه باز نمیکند، جز نشانی زمانبند با رمز اختصاصی در فروشگاهسازهایی که به آن نیاز دارند.
رمز اتصال دوباره نمایش داده نمیشود
Client Secret پس از ذخیره در صفحه تنظیمات نشان داده نمیشود و در گزارشها نوشته نمیشود.
توکن کوتاهمدت
درخواستها با توکنی ۶۰ دقیقهای انجام میشوند که خود افزونه میگیرد و تمدید میکند.
بدون کلید امضا روی سرور شما
صورتحساب با کلید معتمد آسا امضا میشود؛ هیچ کلید خصوصی یا گواهی روی سرور فروشگاه نگهداری نمیشود.
کمترین اطلاعات خریدار
در صورتحساب نوع ۲ هیچ شناسه هویتی از خریدار فرستاده نمیشود و فرستادن نام و شماره همراه او هم در تنظیمات قابل خاموش کردن است.
فقط مدیران و همهچیز ثبتشده
تنظیمات و دکمههای ارسال، برگشت و ابطال فقط برای مدیرانی است که دسترسی ویرایش سفارش دارند و هر اقدام در تاریخچه همان سفارش میماند.
آسا شرکت معتمد مالیاتی نوع اول با مجوز سازمان امور مالیاتی کشور است و از دادههای شما طبق ضوابط محرمانگی و حریم خصوصی محافظت میکند.
پیشنیازها
- یکی از فروشگاهسازهای بخش «دانلود» روی هاستی با 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)یکپارچهسازی کامل برای تیمهای فنی و سامانههای فروش
- اتصال نرمافزار حسابداریصورتحسابهای سپیدار، هلو، تدبیر و سیبا، مستقیم در پنل آسا
- پایگاه داده اختصاصیبا هر پایگاه دادهای؛ بدون تغییر در نرمافزار شما
- کارتخوانتراکنشهای کارتخوان را بدون ورود دستی به صورتحساب تبدیل کنید
برای شروع با این روش آمادهاید؟
ثبتنام در آسا رایگان است. اگر مطمئن نیستید این روش برای کسبوکار شما مناسب است، کارشناسان آسا راهنماییتان میکنند.
بدون هزینه ثبتنام، بدون گواهی امضا، بدون تعطیلی.