پاسخ کوتاه: برای اتصال سایت به سامانه مودیان سه راه دارید: ارسال مستقیم با کلید خودتان، ارسال از طریق شرکت معتمد ارائهدهنده خدمات مالیاتی، یا استفاده از افزونه یا نرمافزار حسابداریای که این کار را انجام میدهد. برای فروشگاه کوچک ووکامرسی معمولاً یک افزونه معتبر یا شرکت معتمد کافی است. برای سایت اختصاصی، فروش چندکاناله یا مشتریهای شرکتی که فاکتور رسمی میخواهند، اتصال اختصاصی با صف ارسال، پیگیری وضعیت و مدیریت مرجوعی کار را خیلی کمدردسرتر میکند. اصل کار هم ارسال نیست؛ این است که هر سفارش، هر مرجوعی و هر تغییر قیمت به صورتحساب درست تبدیل شود. برآورد ما برای مهر ۱۴۰۵: افزونه آماده حدود ۵ تا ۶ میلیون تومان بهعلاوه تنظیم، اتصال اختصاصی به API شرکت معتمد حدود ۲۵ تا ۶۰ میلیون و ارسال مستقیم با پنل کامل حدود ۶۰ تا ۱۵۰ میلیون تومان.
از وقتی ارسال صورتحساب الکترونیکی برای بخش بزرگی از کسبوکارها الزامی شده، سؤال تکراری صاحبان فروشگاه اینترنتی این است: «سایت ما باید به سامانه مودیان وصل شود؟ از کجا شروع کنیم و چقدر خرج دارد؟» در این راهنما پیشنیازها را مرتب میکنیم، سه روش ارسال را کنار هم میگذاریم، میگوییم هر فیلد صورتحساب از کجای سایت میآید، مرجوعی و لغو سفارش را چطور باید ثبت کرد و هزینه هر راه در ۱۴۰۵ حدوداً چقدر است.
بهروزرسانی ۲۶ مهر ۱۴۰۵. این راهنما را با نتایج تازه گوگل، متن قانون و اطلاعیههای سازمان امور مالیاتی دوباره بررسی کردیم. بخشهای تازه: جدول واقعیتهای ۱۴۰۵ (مهلت ۱۲ روزه، تمدیدهای موقت امسال، مهلت ۳۰ روزه واکنش خریدار، اعتبار خرید، جریمه و تعرفه شرکت معتمد)، شناسه کالا و خدمت، سرور خارج از ایران، کسبوکارهای خاص مثل طلا و مارکتپلیس، مثال فرضی پخش تخفیف سبد، خطاهای رایج ارسال، مثال فرضی مرجوعی جزئی، نقشها و دسترسیها، سؤالهای قبل از خرید افزونه، برآورد هزینه با عاملهای قیمت، تستهای بیشتر، عددهای هفتگی، اشتباههای رایج و سؤالهای تازه.
اگر الان «اتصال سایت به سامانه مودیان» را در گوگل جستجو کنید، بیشتر نتایج اول یا رونوشت همان دستورالعمل فنی سازماناند که برای برنامهنویس نوشته شده، یا صفحه فروش یک افزونه و نرمافزار، یا مقایسه کلی روش مستقیم و شرکت معتمد. تقریباً هیچکدام نمیگویند تخفیف سبد خرید چطور روی اقلام پخش شود، مرجوعی یک قلم در پنل چه صورتحسابی بسازد، سرور سایت اگر بیرون از ایران باشد چه میشود، یا قبل از روشن کردن ارسال واقعی چه چیزهایی را تست کنید. این نسخه همینها را با جدول و مثال فرضی اضافه کرده است. از اول روشن بگوییم: هیچکس نمیتواند رتبه مشخصی در گوگل یا نتیجه مالیاتی خاصی را برای شما تضمین کند و ما هم چنین ادعایی نداریم.
این مقاله راهنمای فنی و اجرایی است، نه مشاوره مالیاتی. مشمول بودن، نرخ مالیات هر کالا و نحوه ثبت هزینه ارسال را با حسابدارتان و آخرین اطلاعیههای سازمان امور مالیاتی چک کنید؛ این قواعد هر از گاهی تغییر میکنند.

اتصال سایت به سامانه مودیان دقیقاً یعنی چه؟
سامانه مودیان جایی است که فروشنده باید صورتحسابهای الکترونیکی فروشش را در آن ثبت کند. وقتی میگوییم سایت را به این سامانه وصل کنیم، یعنی به جای اینکه حسابدار هر چند روز یکبار سفارشها را دستی در کارپوشه وارد کند، سایت خودش این کارها را انجام دهد:
- سفارش پرداختشده را به یک صورتحساب با ساختار استاندارد تبدیل کند.
- صورتحساب را با کلید خصوصی امضا کند، یا آن را به شرکت معتمد بدهد تا او امضا و ارسال کند.
- صورتحساب را بفرستد و شماره پیگیری بگیرد.
- چند دقیقه بعد وضعیت را استعلام کند و نتیجه (موفق یا خطا) را در پنل نشان دهد.
- برای مرجوعی، لغو یا تغییر قیمت، صورتحساب ارجاعی درست (اصلاحی، ابطالی یا برگشت از فروش) صادر کند.
بیشتر دردسرهای واقعی در مرحله اول و پنجم است: اطلاعات ناقص خریدار، کالایی که شناسه ندارد و مرجوعیای که اشتباه ثبت شده.
واقعیتهای ۱۴۰۵ که روی طراحی اتصال اثر دارند
قبل از اینکه سراغ روش و کد برویم، این چند قاعده را بدانید. همه از متن قانون پایانههای فروشگاهی و سامانه مودیان، بخشنامهها و اطلاعیههای سازمان امور مالیاتی آمدهاند و ستون آخر میگوید هر کدام برای سایت شما چه معنایی دارد. این قواعد ممکن است دوباره تغییر کنند؛ قبل از هر تصمیم، آخرین اطلاعیه را با حسابدارتان چک کنید.
| قاعده | منبع | یعنی سایت باید |
|---|---|---|
| حداکثر فاصله تاریخ صدور تا ثبت صورتحساب در سامانه ۱۲ روز است (از ۱۵ آبان ۱۴۰۳، قبلاً ۲۱ روز بود) | اطلاعیه سازمان امور مالیاتی | صف ارسال و هشدار مهلت داشته باشد و عدد مهلت قابل تغییر باشد |
| در ۱۴۰۵ چند بار مهلت ثبت موقتاً تمدید شد؛ مثلاً صورتحسابهای اسفند ۱۴۰۴ تا پایان فروردین و صورتحسابهای ۱ فروردین تا ۱۵ اردیبهشت ۱۴۰۵ تا ۳۰ اردیبهشت | اطلاعیههای تمدید فروردین ۱۴۰۵ | روی تمدید حساب باز نکند؛ تمدیدها فقط برای همان بازهاند |
| خریدار مودی ۳۰ روز از درج صورتحساب در کارپوشه فرصت دارد آن را تأیید یا رد کند؛ اگر واکنشی نشان ندهد، صورتحساب سیستمی تأیید میشود | تبصره بند ب ماده ۵ قانون و بخشنامه ۲۶۸/۵۲۲۶۰ | وضعیت «رد شده توسط خریدار» را بگیرد و به مسئول خبر بدهد |
| از ۱ دی ۱۴۰۴ اعتبار مالیات خرید فقط برای صورتحسابهایی پذیرفته میشود که در سامانه مودیان ثبت شدهاند | اطلاعیههای سازمان امور مالیاتی | برای خریدار شرکتی، صورتحساب نوع اول درست و بهموقع صادر کند؛ این برای او مستقیماً پول است |
| جریمه عدم صدور صورتحساب الکترونیکی: ۱۰ درصد مبلغ فروش بدون صورتحساب یا ۲۰ میلیون ریال، هر کدام بیشتر باشد؛ مبلغ ثابت هر سال با تورم بهروز میشود | بند الف ماده ۲۲ و تبصره ۱ همان ماده | هیچ سفارش پرداختشدهای بدون صورتحساب نماند و گزارش «سفارش بدون صورتحساب» داشته باشد |
| تعرفه خدمات شرکت معتمد برای صدور صورتحساب الکترونیکی را سازمان طبق تعرفه شورای اقتصاد از محل مالیات بر ارزش افزوده میپردازد | تبصره ماده ۲۶ قانون | در مقایسه هزینه، خدمت پایه را از خدمات جانبی مثل API و اتصال اختصاصی جدا کنید |
نتیجه عملی این جدول ساده است: اتصال سایت فقط «ارسال» نیست. باید مهلت را بپاید، واکنش خریدار را دنبال کند و اجازه ندهد سفارشی بیصورتحساب بماند. اگر به شرکتها و همکاران میفروشید، صورتحساب درست برای آنها مستقیماً اعتبار مالیاتی است و خطای سایت شما میتواند مشتری عمده را ناراضی کند؛ برای همین در سامانه سفارشگیری عمده و پیشفاکتور آنلاین B2B هم این موضوع را از اول در طراحی فرم و پنل در نظر میگیریم.
پیشنیازها؛ قبل از اینکه حتی یک خط کد نوشته شود
این موارد را خود شما یا حسابدارتان آماده میکنید، نه برنامهنویس؛ بدون آنها پروژه فنی متوقف میماند:
- پرونده مالیاتی و دسترسی به کارپوشه: کارپوشه همان پنل شما در سامانه مودیان است که همه تنظیمات از آنجا انجام میشود.
- شناسه یکتای حافظه مالیاتی: برای ارسال صورتحساب لازم است و در کارپوشه دریافت میشود. برای هر شناسه باید روش ارسال را مشخص کنید.
- کلید و گواهی امضا: اگر خودتان مستقیم ارسال میکنید، باید کلید عمومی RSA با طول ۲۰۴۸ بیت را در کارپوشه ثبت کنید و کلید خصوصی را امن نگه دارید. اگر شرکت معتمد با کلید خودش ارسال کند، این مرحله با اوست.
- شناسه ۱۳ رقمی کالا و خدمت: هر محصولی که در سایت میفروشید باید شناسه کالا یا خدمت و نرخ مالیات مشخص داشته باشد. این مرحله در فروشگاههای پرمحصول، از خود اتصال وقتگیرتر است.
- اطلاعات هویتی فروشنده: شماره اقتصادی و شناسه ملی یا کد ملی، دقیقاً مطابق پرونده.
- تصمیم درباره نوع صورتحساب: برای کدام خریدارها نوع اول صادر میشود و برای کدام نوع دوم. پایینتر توضیح دادهایم.
شناسه کالا و خدمت؛ کاری که به برنامهنویس ربطی ندارد ولی پروژه را عقب میاندازد
هر ردیف صورتحساب یک شناسه ۱۳ رقمی کالا یا خدمت لازم دارد. فهرست شناسهها، نرخ و وضعیت مشمول یا معاف بودن را میتوانید در سامانه رسمی شناسه کالا و خدمات (stuffid.tax.gov.ir) استعلام کنید. شناسه دو نوع دارد:
| نوع شناسه | از کجا | کی مناسب است | نکته |
|---|---|---|---|
| شناسه عمومی | فهرست رسمی شناسهها، برای گروه کالا یا خدمت | شروع کار، کالاهای متنوع کمتعداد، تا وقتی شناسه اختصاصی ندارید | دقیقترین گروه را انتخاب کنید؛ گروه اشتباه یعنی نرخ اشتباه |
| شناسه اختصاصی کالا | سامانه جامع تجارت | تولیدکننده، واردکننده یا برندی که کالای مشخص و تکرارشونده دارد | شناسه اختصاصی شرکت دیگر را برای کالای خودتان استفاده نکنید |
| شناسه اختصاصی خدمت | درگاه GS1 ایران | شرکت خدماتی، نرمافزاری یا آموزشی با خدمات مشخص | شرح خدمت را طوری بنویسید که با فاکتور سایت یکی باشد |
مثال فرضی: فروشگاهی ۱٬۲۰۰ محصول فعال در ۴۰ دسته دارد. به جای اینکه برنامهنویس محصولبهمحصول شناسه وارد کند، حسابدار برای هر دسته یک شناسه عمومی پیشنهاد میدهد، فایل اکسل دستهها و شناسهها تأیید میشود و سایت با یک ورود گروهی، شناسه را روی همه محصولات آن دسته مینشاند. بعد فقط استثناها (مثلاً کالای معاف یا کالایی که شناسه اختصاصی دارد) دستی اصلاح میشوند. روش پاکسازی و ورود گروهی داده را در انتقال داده از اکسل به نرمافزار نوشتهایم. قاعدهای که در پنل میگذاریم: محصولی که شناسه ندارد یا قابل انتشار نیست، یا دستکم صورتحسابش در صف متوقف میماند و هشدار میدهد.
سه روش ارسال صورتحساب از سایت
در کارپوشه، برای هر شناسه یکتای حافظه مالیاتی یکی از روشهای ارسال را انتخاب میکنید: مستقیم توسط خودتان یا غیرمستقیم از طریق شرکت معتمد. افزونهها و نرمافزارهای حسابداری هم در عمل یکی از همین دو مسیر را استفاده میکنند. این جدول تفاوتها را نشان میدهد:
| روش | امضای صورتحساب با | زیرساخت فنی با | مزیت | محدودیت |
|---|---|---|---|---|
| ارسال مستقیم (اتصال مستقیم سایت) | کلید خصوصی خود شما | خود شما یا برنامهنویس شما | واسطه و هزینه ماهانه واسط ندارد، کنترل کامل دست شماست | پیادهسازی، نگهداری و امنیت کلید با شماست |
| شرکت معتمد | کلید شما یا کلید شرکت معتمد، بسته به قرارداد | شرکت معتمد؛ سایت فقط به API او وصل میشود | پیادهسازی سادهتر، پشتیبانی و پنل آماده | وابستگی به یک سرویس، هزینه خدمات جانبی و پلنها |
| افزونه آماده یا نرمافزار حسابداری | طبق تنظیم افزونه؛ مستقیم یا از طریق شرکت معتمد | سازنده افزونه یا نرمافزار | سریعترین شروع برای سایتهای وردپرسی | فقط برای همان پلتفرم؛ موارد خاص مثل مرجوعی جزئی یا چند انبار را همیشه پوشش نمیدهد |
نکته مهم: نمیشود برای یک شناسه حافظه مالیاتی همزمان دو روش ارسال داشت، ولی میشود چند شناسه داشت و برای هر کدام روش متفاوتی گذاشت. مثلاً فروش سایت مستقیم ارسال شود و فروش حضوری فروشگاه از طریق شرکت معتمد. این را قبل از شروع پروژه با حسابدار تصمیم بگیرید.
سرور سایت کجاست؟ اگر بیرون از ایران باشد
یکی از دردسرهایی که در راهنماها کمتر دیده میشود، محل سرور است. دسترسی به سرویسهای سامانه از بعضی سرورهای خارج از ایران ممکن است رد شود یا ناپایدار باشد. برای همین بعضی افزونههای ووکامرس برای سایتهایی که سرور خارجی دارند، قابلیت «ارسال از طریق پروکسی» را جداگانه میفروشند. سه راه معمول داریم:
| راه | کی مناسب است | نکته |
|---|---|---|
| انتقال کل سایت به هاست یا سرور داخل ایران | بیشتر مشتریها داخل ایراناند و درگاه و پیامک هم داخلی است | سرعت سایت از داخل را هم بهتر میکند؛ ولی بکاپ و امنیت را جدی بگیرید |
| یک سرویس کوچک صدور صورتحساب روی سرور داخلی | سایت اصلی باید بیرون بماند | کلید خصوصی فقط روی همین سرویس میماند؛ ارتباط سایت و سرویس باید امن و احراز هویتشده باشد |
| ارسال از طریق API شرکت معتمد | نمیخواهید زیرساخت ارسال را خودتان نگه دارید | قبل از قرارداد، دسترسی از سرور فعلی را با یک صورتحساب آزمایشی امتحان کنید |
انتخاب هاست را در هاست و CDN برای سایت کسبوکار در ایران مفصلتر توضیح دادهایم و برای امن نگه داشتن سرور سرویس صورتحساب، چکلیست امنیت سایت را ببینید.
کدام راه برای سایت شما مناسبتر است؟
به جای اینکه بپرسید کدام روش بهتر است، بپرسید کدام روش با سایت، حجم فروش و تیم شما جور است:
| وضعیت شما | راه پیشنهادی | چرا |
|---|---|---|
| فروشگاه ووکامرسی کوچک، چند ده سفارش در روز | افزونه معتبر یا پنل شرکت معتمد | هزینه اولیه کم است و نیاز خاصی ندارید |
| سایت اختصاصی (مثلاً Next.js یا جنگو) | اتصال اختصاصی به API شرکت معتمد یا ارسال مستقیم | افزونه آماده برای این سایتها وجود ندارد |
| فروش همزمان در سایت، فروشگاه حضوری و بازارگاهها | یک لایه مرکزی صدور صورتحساب با چند شناسه حافظه | جلوی ارسال تکراری یا جاافتادن فروشها را میگیرد |
| فروش به شرکتها و همکاران (B2B) | اتصال اختصاصی با فرم کامل اطلاعات خریدار | بیشتر خریدارها صورتحساب نوع اول میخواهند و تأیید یا رد خریدار مهم است |
| فروش خدمات یا اشتراک نرمافزار (SaaS) | اتصال اختصاصی به سیستم صورتحساب و تمدید | هر تمدید یک فروش جداست و باید خودکار صادر شود |
اگر هنوز بین ووکامرس و فروشگاه اختصاصی تصمیم نگرفتهاید، مقاله ووکامرس یا فروشگاه اختصاصی کمک میکند این هزینه را هم در حسابتان بیاورید.
کسبوکارهای خاص؛ جاهایی که اتصال ساده جواب نمیدهد
بعضی مدلهای فروش، جزئیاتی دارند که اگر از اول دیده نشوند، بعداً کل اتصال را باید دوباره نوشت. جزئیات مالیاتی هر ردیف را حسابدار تعیین میکند؛ کار ما این است که سایت آن تصمیم را درست اجرا کند:
| مدل فروش | نکتهای که باید روشن شود | کاری که سایت میکند |
|---|---|---|
| مارکتپلیس چندفروشنده | صورتحساب کالا را فروشنده صادر میکند یا پلتفرم؟ کمیسیون پلتفرم چطور صورتحساب میشود؟ | سهم فروشنده و کمیسیون را جدا نگه میدارد و برای هر طرف خروجی جدا میدهد؛ جزئیات در طراحی مارکتپلیس چندفروشنده |
| طلا و جواهر | الگوی صورتحساب طلا جداست و اصل طلا، اجرت، سود فروشنده و حقالعمل جدا ثبت میشوند | این چهار جزء را از همان محاسبه قیمت سایت جدا ذخیره میکند؛ ببینید طراحی سایت طلا فروشی و نرم افزار طلافروشی |
| فروش اقساطی و اعتباری | روش تسویه و زمان صدور صورتحساب با حسابدار مشخص شود | نوع پرداخت را در صورتحساب درست ثبت میکند؛ ببینید فروش اقساطی در سایت |
| فروش دوره و فایل | شناسه خدمت یا کالای دیجیتال درست انتخاب شود | برای هر محصول دیجیتال هم شناسه میگذارد؛ ببینید فروش دوره آنلاین در سایت |
| اشتراک نرمافزار و تمدید خودکار | هر تمدید یک فروش جداست | با هر پرداخت تمدید، صورتحساب جدید میسازد؛ ببینید طراحی SaaS در ایران و قیمتگذاری نرمافزار اشتراکی |
| خدمات در محل با مبلغ نهایی متغیر | بیعانه و مبلغ نهایی هر کدام کی صورتحساب میشوند | بعد از بسته شدن سفارش، مبلغ نهایی را مبنا میگیرد و اختلاف را درست ثبت میکند؛ ببینید سامانه سفارش خدمات در محل |
| فروش عمده با پیشفاکتور | پیشفاکتور فروش نیست | فقط بعد از قطعی شدن سفارش صورتحساب میسازد، نه با صدور پیشفاکتور |
نوع اول یا نوع دوم؛ فرم تسویه حساب را درست کنید
صورتحساب نوع اول اطلاعات کامل خریدار را دارد و معمولاً برای خریدارهایی است که فعال اقتصادیاند و میخواهند از اعتبار مالیاتی استفاده کنند. نوع دوم برای فروش به مصرفکننده نهایی است و اطلاعات کامل خریدار در آن لازم نیست. در فروشگاه اینترنتی، بیشتر سفارشها نوع دوماند، ولی اگر حتی چند درصد مشتریهای شما شرکت یا همکار باشند، فرم سایت باید آماده باشد.
کاری که در عمل جواب میدهد این است:
- در صفحه تسویه حساب یک گزینه ساده بگذارید: «فاکتور رسمی میخواهم».
- با زدن این گزینه، فیلدهای لازم باز شوند: نوع خریدار (حقیقی یا حقوقی)، کد ملی یا شناسه ملی، شماره اقتصادی و کد پستی.
- فرمت این فیلدها را همان لحظه بررسی کنید؛ مثلاً تعداد رقم کد ملی و شناسه ملی. اطلاعات خریدار بعداً با صورتحساب اصلاحی قابل تغییر نیست.
- در پنل مشتری، اطلاعات خریدار شرکتی ذخیره شود تا در خرید بعدی دوباره پرسیده نشود.
- بعد از پرداخت، تغییر اطلاعات فاکتور رسمی را فقط از طریق پنل مدیر و با ثبت دلیل ممکن کنید.
وقتی خریدار شرکتی صورتحساب را رد میکند
صورتحساب نوع اول بعد از ثبت، در کارپوشه خریدار مینشیند و او ۳۰ روز فرصت دارد تأیید یا ردش کند. اگر رد کند، تا وقتی شما آن را ابطال نکردهاید، از نظر سیستم همچنان فروش شما حساب میشود و خریدار هم از آن اعتباری نمیگیرد. پس سایت یا پنل شما باید اینها را داشته باشد:
- استعلام دورهای وضعیت صورتحسابهای نوع اول و نمایش «تأیید شده»، «رد شده» یا «در انتظار واکنش».
- پیامک یا اعلان داخلی به حسابدار وقتی صورتحسابی رد میشود، همراه شماره سفارش و نام خریدار.
- نمایش شماره منحصربهفرد مالیاتی و وضعیت صورتحساب در حساب کاربری مشتری شرکتی، تا لازم نباشد برای هر فاکتور تماس بگیرد. این بخش را معمولاً در پورتال مشتریان میگذاریم.
- یادداشت داخلی روی سفارش برای اینکه چرا رد شده و چه صورتحسابی جایگزین شد.
هر فیلد صورتحساب از کجای سایت میآید؟
بخش زیادی از کار اتصال، همین نگاشت داده است. اگر از اول روشن باشد، خطاهای ارسال خیلی کم میشود:
| فیلد صورتحساب | منبع در سایت | نکته اجرایی |
|---|---|---|
| تاریخ صدور | زمان تأیید پرداخت یا زمان ارسال کالا | با حسابدار یکی را انتخاب و در همه سفارشها یکسان اجرا کنید |
| شناسه کالا یا خدمت | فیلد اختصاصی در صفحه هر محصول | محصول بدون شناسه نباید قابل فروش یا دستکم قابل ارسال باشد |
| تعداد و قیمت واحد | اقلام سبد خرید | واحد مبلغ (ریال یا تومان) را در تبدیل یکسان کنید |
| تخفیف | کد تخفیف، حراج یا تخفیف سبد | تخفیف سبد را به نسبت روی اقلام پخش کنید و گرد کردن را تست کنید |
| نرخ مالیات | تنظیم هر محصول یا دسته | کالاهای معاف را جدا علامت بزنید |
| هزینه ارسال | روش ارسال سفارش | اینکه ردیف جدا باشد یا نه را حسابدار تعیین کند |
| اطلاعات خریدار | فرم فاکتور رسمی | فقط برای نوع اول؛ قبل از ارسال اعتبارسنجی شود |
| روش تسویه | نوع پرداخت (آنلاین، کیف پول، اعتباری) | فروش اقساطی و اعتباری را جدا بررسی کنید |
| شماره داخلی | شماره سفارش | هر صورتحساب به یک سفارش وصل باشد تا ارسال تکراری رخ ندهد |
مثال فرضی: یک سفارش با تخفیف روی کل سبد
بیشتر خطاهای «جمع مبالغ» از همینجا میآید. مشتری سه کالا خریده و کد تخفیف ۱۵۰ هزار تومانی روی کل سبد زده است. اگر سایت تخفیف را فقط روی جمع کل کم کند، صورتحساب با اقلام نمیخواند. راه درست این است که تخفیف به نسبت مبلغ هر قلم پخش شود (اعداد فرضیاند و مالیات هر ردیف طبق نرخ همان کالا حساب میشود):
| قلم | مبلغ قبل از تخفیف | سهم از جمع | تخفیف این قلم | مبلغ بعد از تخفیف |
|---|---|---|---|---|
| کالای الف | ۱٬۲۰۰٬۰۰۰ تومان | ۶۰٪ | ۹۰٬۰۰۰ تومان | ۱٬۱۱۰٬۰۰۰ تومان |
| کالای ب | ۶۰۰٬۰۰۰ تومان | ۳۰٪ | ۴۵٬۰۰۰ تومان | ۵۵۵٬۰۰۰ تومان |
| کالای ج | ۲۰۰٬۰۰۰ تومان | ۱۰٪ | ۱۵٬۰۰۰ تومان | ۱۸۵٬۰۰۰ تومان |
| جمع | ۲٬۰۰۰٬۰۰۰ تومان | ۱۰۰٪ | ۱۵۰٬۰۰۰ تومان | ۱٬۸۵۰٬۰۰۰ تومان |
سه نکته اجرایی: مبالغ را در صورتحساب به ریال تبدیل کنید و گرد کردن را در یک جا و یک قاعده انجام دهید؛ اگر بعد از پخش، یکی دو ریال اختلاف ماند، آن را روی بزرگترین قلم بگذارید؛ و هزینه ارسال را طبق نظر حسابدار یا ردیف جدا کنید یا نکنید، ولی در همه سفارشها یکسان. اگر در سایت کیف پول یا باشگاه مشتریان دارید، از قبل با حسابدار روشن کنید که پرداخت با امتیاز یا اعتبار کیف پول، تخفیف حساب میشود یا روش تسویه.
اگر سایتتان به نرمافزار حسابداری هم وصل است، تصمیم بگیرید صورتحساب را کدام سیستم صادر کند. دو سیستم که هر دو برای یک سفارش صورتحساب بفرستند، دردسر بزرگی میسازند. جزئیات اتصال به حسابداری را در مقاله اتصال سایت به نرمافزار حسابداری نوشتهایم.

ارسال غیرهمگام، صف و پیگیری وضعیت
ارسال صورتحساب به سامانه مودیان غیرهمگام است؛ یعنی وقتی صورتحساب را میفرستید، همان لحظه نتیجه نهایی را نمیگیرید. یک شماره پیگیری دریافت میکنید و بعد باید وضعیت را استعلام کنید. اگر سایت این را درست مدیریت نکند، صورتحسابهایی خطا میخورند و هیچکس متوجه نمیشود.
طراحی درست معمولاً اینطور است:
- صف ارسال: صورتحسابها در صف قرار میگیرند و ارسالشان روی سرعت صفحه پرداخت اثری ندارد.
- تلاش دوباره با فاصله: اگر سرویس در دسترس نبود، ارسال چند بار با فاصله تکرار شود، نه بیوقفه.
- جلوگیری از ارسال تکراری: هر سفارش فقط یک صورتحساب اصلی داشته باشد، حتی اگر دکمه ارسال دو بار زده شود.
- هشدار مهلت: طبق اطلاعیهای که از ۱۵ آبان ۱۴۰۳ اجرا شد، فاصله صدور تا ثبت صورتحساب در سامانه حداکثر ۱۲ روز است. بعضی شرکتهای معتمد برای صورتحسابهایی که از طریق آنها ثبت میشود مهلت کمی بیشتری اعلام میکنند؛ این را از شرکت خودتان و حسابدار بپرسید و به آن تکیه نکنید. سایت باید چند روز قبل از مهلت برای صورتحسابهای ثبتنشده هشدار بدهد. این عدد ممکن است دوباره تغییر کند؛ آن را در تنظیمات قابل تغییر بگذارید.
- ساعت سرور: امضا و توکن به زمان حساساند. ساعت سرور را با سرویس زمان همگام نگه دارید؛ ساعت عقب یا جلو یکی از دلیلهای رایج خطاهای عجیب ارسال است.
- گزارش کامل: متن درخواست، پاسخ و شماره پیگیری هر ارسال (بدون کلید و اطلاعات حساس) ذخیره شود تا اختلافها قابل پیگیری باشند.
در پنل مدیر، هر صورتحساب یکی از این وضعیتها را دارد:
| وضعیت | معنی | اقدام لازم |
|---|---|---|
| آماده ارسال | صورتحساب ساخته شده ولی هنوز در صف است | کاری لازم نیست مگر بیش از چند ساعت بماند |
| ارسال شده | شماره پیگیری گرفته شده، نتیجه نهایی نیامده | استعلام خودکار انجام میشود |
| موفق | در سامانه ثبت شده | شماره منحصربهفرد مالیاتی روی فاکتور مشتری نمایش داده شود |
| خطا | سامانه صورتحساب را نپذیرفته | متن خطا در پنل نمایش داده شود و مسئول رسیدگی مشخص باشد |
| رد شده توسط خریدار | خریدار نوع اول آن را در کارپوشه رد کرده | با حسابدار بررسی و صورتحساب ارجاعی مناسب صادر شود |
خطاهای رایج ارسال و کاری که سایت باید بکند
متن و کد دقیق خطاها را از مستندات فنی سامانه یا شرکت معتمدتان بگیرید؛ اینجا گروههای رایج را آوردهایم که تقریباً در هر پروژهای دیده میشوند:
| گروه خطا | معمولاً از کجا میآید | کاری که سایت یا پنل میکند |
|---|---|---|
| شناسه کالا نامعتبر یا ناموجود | شناسه اشتباه، قدیمی یا مربوط به گروه دیگر | ارسال آن صورتحساب متوقف شود و محصول در فهرست «نیازمند اصلاح» بیاید |
| اطلاعات خریدار نامعتبر | کد ملی، شناسه ملی یا شماره اقتصادی اشتباه در فرم فاکتور رسمی | اعتبارسنجی فرمت در همان فرم؛ اصلاح فقط با ابطال و صدور دوباره |
| اختلاف جمع مبالغ | گرد کردن، تخفیف سبد یا واحد پول | یک تابع واحد برای محاسبه و گرد کردن؛ تست با سفارشهای پرقلم |
| تاریخ خارج از بازه مجاز | صورتحسابی که روزها در صف مانده یا تاریخ دستی | هشدار مهلت؛ هیچوقت تاریخ صدور را برای جا دادن در مهلت دستکاری نکنید |
| صورتحساب تکراری | دو بار زدن دکمه یا تلاش دوباره بدون کنترل | هر سفارش یک شناسه داخلی ثابت داشته باشد و قبل از ارسال دوباره، وضعیت قبلی استعلام شود |
| خطای امضا، توکن یا دسترسی | کلید اشتباه، ساعت سرور، سرور خارج از ایران | هشدار فوری به مسئول فنی؛ صف متوقف شود ولی سفارشها گم نشوند |
قاعده کلی ما: هیچ خطایی نباید فقط در لاگ سرور بماند. هر صورتحساب خطادار یک صاحب در پنل دارد و تا حل نشود در فهرست کارهای باز میماند. اگر پنل پشتیبانی یا تیکت دارید، میشود خطاهای ماندگار را به صورت خودکار تیکت کرد؛ ببینید نرمافزار تیکتینگ پشتیبانی.
مرجوعی، لغو و تغییر قیمت؛ هر اتفاق کدام صورتحساب را لازم دارد؟
اینجا جایی است که بیشتر افزونهها و راهنماها ساکتاند. قاعده کلی این است که بعضی اطلاعات صورتحساب با صورتحساب اصلاحی قابل تغییرند و بعضی فقط با ابطال و صدور صورتحساب جدید. جدول زیر خلاصه رایجترین حالتها در فروشگاه اینترنتی است؛ اجرای نهایی را با حسابدار تأیید کنید:
| اتفاق در سایت | صورتحساب لازم | کاری که سایت باید بکند |
|---|---|---|
| لغو سفارش قبل از ارسال صورتحساب | هیچ؛ صورتحسابی ارسال نشده | صورتحساب از صف حذف شود |
| مرجوعی بخشی از اقلام | برگشت از فروش | اقلام باقیمانده با ارجاع به صورتحساب اصلی ثبت شود |
| لغو کامل معامله بعد از ثبت | ابطالی | دلیل و مدرک لغو در پنل ذخیره شود |
| تغییر مبلغ، تخفیف یا تعداد | اصلاحی | صورتحساب جدید با ارجاع به صورتحساب مرجع صادر شود |
| اشتباه در اطلاعات خریدار یا شناسه کالا | ابطالی و صدور صورتحساب جدید | این دو اطلاعات با اصلاحی قابل تغییر نیستند |
| اضافه شدن قلم جدید به همان سفارش | ابطالی و صدور صورتحساب جدید | یا قلم جدید را سفارش جداگانه کنید |
دو نکته اجرایی: هر صورتحساب فقط یک بار میتواند مرجع ابطال باشد، و تاریخ صورتحساب ارجاعی باید بعد از صورتحساب اصلی باشد. پس در پنل، دکمههای «مرجوعی» و «لغو» نباید فقط وضعیت سفارش را عوض کنند؛ باید صورتحساب ارجاعی درست را هم بسازند.
مثال فرضی: مرجوعی یک قلم از سه قلم
همان سفارش مثال تخفیف را در نظر بگیرید. صورتحساب اصلی ثبت و موفق شده و چند روز بعد مشتری «کالای ب» را پس میفرستد. روال درست در پنل اینطور است:
| مرحله | چه کسی | اتفاق در پنل |
|---|---|---|
| ۱. ثبت درخواست مرجوعی | مشتری یا پشتیبانی | قلم «کالای ب» با دلیل مرجوعی انتخاب میشود؛ هنوز صورتحسابی ساخته نمیشود |
| ۲. دریافت و بررسی کالا | انبار | تأیید سالم بودن و برگشت به موجودی؛ ببینید نرمافزار انبارداری |
| ۳. تأیید مالی | حسابدار | مبلغ برگشتی همان ۵۵۵ هزار تومان بعد از تخفیف است، نه قیمت اصلی |
| ۴. صدور صورتحساب برگشت از فروش | سیستم | با ارجاع به صورتحساب اصلی و تاریخ بعد از آن، وارد صف ارسال میشود |
| ۵. بازپرداخت و اطلاع به مشتری | مالی و سیستم | بعد از وضعیت موفق، بازپرداخت انجام و پیامک ارسال میشود |
اگر کل سفارش برگشته بود، به جای برگشت از فروش، صورتحساب ابطالی لازم بود. دکمهها را در پنل جدا بگذارید تا کاربر مجبور نباشد بین این دو حدس بزند. قواعد مرجوعی و ارسال برگشتی را در اتصال فروشگاه به پست و تیپاکس هم آوردهایم.
امنیت کلید خصوصی و دسترسیها در پنل
اگر روش مستقیم را انتخاب کنید، کلید خصوصی یعنی امضای مالیاتی شما. هر کسی آن را داشته باشد، میتواند به نام شما صورتحساب بفرستد. حداقلهایی که باید رعایت شود:
- کلید خصوصی هیچوقت داخل مخزن کد یا فایل پشتیبان عمومی قرار نگیرد و فقط روی سرور، در محل امن نگهداری شود.
- فقط سرویس صدور صورتحساب به آن دسترسی داشته باشد، نه همه بخشهای سایت.
- ابطال و صدور صورتحساب اصلاحی فقط برای نقشهای مشخص (مثلاً حسابدار و مدیر) فعال باشد.
- هر ارسال، ابطال و اصلاح با نام کاربر و زمان در گزارش ثبت شود.
- اگر برنامهنویس یا شرکت همکار عوض شد، کلید را تعویض و کلید عمومی جدید را در کارپوشه ثبت کنید.
چه کسی در پنل چه کاری میکند؟
| نقش | دیدن صورتحسابها | ارسال دوباره | اصلاحی و برگشت از فروش | ابطال | دسترسی به کلید |
|---|---|---|---|---|---|
| پشتیبانی | فقط وضعیت | خیر | فقط ثبت درخواست | خیر | خیر |
| مدیر فروش | بله | خیر | درخواست و پیگیری | خیر | خیر |
| حسابدار | بله | بله | بله | بله، با ثبت دلیل | خیر |
| مدیر کل | بله | بله | بله | بله | فقط تعویض کلید، نه دیدن آن |
| برنامهنویس یا شرکت پشتیبان | گزارش خطاها | خیر، مگر در محیط آزمایشی | خیر | خیر | فقط روی سرور، بدون نسخه شخصی |
طراحی نقشها و دسترسیها را در طراحی پنل مدیریت اختصاصی مفصلتر نوشتهایم. یک نکته قراردادی هم مهم است: سورس کد اتصال و دسترسیهای سرور باید به نام خود شما باشد؛ چراییاش را در مالکیت سورس کد سایت و قرارداد برنامهنویسی پروژهای ببینید.
اتصال به حسابداری، انبار و کانالهای دیگر فروش
سامانه مودیان معمولاً تنها سیستمی نیست که سایت شما به آن وصل است. قاعده طلایی: برای هر فروش فقط یک سیستم صورتحساب صادر کند و بقیه از آن پیروی کنند.
| سیستم کنار سایت | سؤالی که باید جواب بدهید | پیشنهاد معمول ما |
|---|---|---|
| نرمافزار حسابداری | صورتحساب را سایت صادر میکند یا حسابداری؟ | اگر حسابداری خودش به سامانه وصل است، سایت فقط سفارش را بفرستد؛ ببینید اتصال سایت به نرمافزار حسابداری |
| انبار | مرجوعی کی به موجودی برمیگردد؟ | صورتحساب برگشت از فروش بعد از تأیید انبار ساخته شود |
| فروشگاه حضوری و کارتخوان | یک شناسه حافظه یا چند شناسه؟ | برای هر کانال شناسه جدا تا گزارشها قاطی نشوند |
| بازارگاهها مثل دیجیکالا | صورتحساب فروش آنجا را چه کسی و از کجا صادر میکند؟ | سفارشهای بازارگاه را جدا علامت بزنید تا دو بار صورتحساب نخورند؛ ببینید اتصال فروشگاه به دیجی کالا |
| فروش تلفنی یا اینستاگرامی | این سفارشها وارد سایت میشوند؟ | ثبت در پنل سایت تا همه از یک مسیر صورتحساب بگیرند؛ ببینید سایت برای پیج اینستاگرام |
| داشبورد مدیریتی | جمع فروش سایت با جمع صورتحسابهای ثبتشده میخواند؟ | یک گزارش مقایسه روزانه؛ ببینید ساخت داشبورد مدیریتی |
برای کسبوکارهایی که پخش مویرگی یا ویزیتور دارند، صورتحساب معمولاً باید از نرمافزار پخش صادر شود نه از سایت؛ این را در نرم افزار پخش مویرگی توضیح دادهایم. اگر هنوز روی اکسل کار میکنید و نمیدانید وقت نرمافزار اختصاصی رسیده یا نه، نرم افزار اختصاصی به جای اکسل را بخوانید.
افزونه آماده یا اتصال اختصاصی؟
| معیار | افزونه آماده | اتصال اختصاصی |
|---|---|---|
| شروع کار | چند روز، بعد از آماده بودن کلید و شناسهها | معمولاً چند هفته |
| پلتفرم | معمولاً فقط ووکامرس | هر سایت یا نرمافزاری |
| مرجوعی جزئی و اصلاحی | بسته به افزونه؛ قبل از خرید تست کنید | طبق روال واقعی فروشگاه طراحی میشود |
| چند کانال فروش | معمولاً نه | بله، با یک لایه مرکزی |
| وابستگی | به بهروزرسانی سازنده افزونه | به کد خودتان که مالکش هستید |
| هزینه اولیه | کم | بیشتر |
قبل از خرید افزونه این هشت سؤال را بپرسید
این سؤالها را از پرسش و پاسخهای واقعی صفحه افزونهها و پروژههایی که بعداً به ما رسیده جمع کردهایم. جواب هر کدام را کتبی بگیرید:
| سؤال | چرا مهم است |
|---|---|
| ارسال خودکار است یا برای هر سفارش باید دکمه بزنیم؟ | در بعضی افزونهها ارسال دستی است؛ با دهها سفارش در روز یعنی یک نفر تماموقت |
| نوع اول و دوم را خودش تشخیص میدهد؟ اطلاعات خریدار را کجا میگیرد؟ | فرم تسویه حساب باید با منطق افزونه بخواند |
| برگشت از فروش برای یک قلم و صورتحساب اصلاحی را پشتیبانی میکند؟ | خیلی از افزونهها فقط ابطال کامل را دارند |
| لایسنس برای چند فروشگاه یا چند شرکت است؟ | بعضی فقط تککاربرهاند و برای حسابداری که چند مشتری دارد کار نمیکنند |
| بدون ووکامرس یا از طریق API هم کار میکند؟ | معمولاً نه، یا کدنویسی اختصاصی با هزینه جدا لازم دارد |
| سایت ما سرور خارج دارد؛ ارسال کار میکند؟ | ممکن است قابلیت پروکسی جداگانه فروخته شود |
| آخرین بهروزرسانی کی بوده و با تغییرات مستندات فنی هماهنگ میشود؟ | افزونهای که ماهها بهروز نشده، با تغییر سامانه از کار میافتد |
| دادهها و گزارش ارسالها خروجی دارند؟ | اگر روزی افزونه را عوض کردید، سابقه صورتحسابها نباید گم شود |
اگر سایتتان وردپرسی است و نمیدانید برای بقیه امکانات هم با افزونه ادامه بدهید یا نه، سایت اختصاصی یا وردپرس و قالب آماده یا طراحی اختصاصی کمک میکنند.
هزینه اتصال سایت به سامانه مودیان در ۱۴۰۵
هزینه به روش ارسال، نوع سایت و تعداد حالتهای خاص (مرجوعی، چند انبار، فروش شرکتی، چند کانال) بستگی دارد. اول ببینید در بازار چه قیمتهایی اعلام شده، بعد برآورد ما را برای پروژه اختصاصی.
قیمتهایی که در بازار دیده میشود (مهر ۱۴۰۵)
- افزونه آماده ووکامرس: در بازارهای افزونه ایرانی حدود ۵٫۵ تا ۶٫۱ میلیون تومان، یکباره. نصب، تنظیم و بعضی قابلیتها مثل پروکسی جداگانه حساب میشوند.
- نرمافزار واسط یا حسابداری متصل: از خرید دائمی حدود ۵ میلیون تومان با پشتیبانی سالانه جدا، تا اشتراک ماهانه ابری. در جدول مقایسه یکی از فروشندگان، پلنهای پایه ابری حدود ۵۰ تا ۱۵۰ هزار تومان در ماه و نسخههای دسکتاپ یکباره حدود ۳ تا ۱۳ میلیون تومان آمده است.
- شرکت معتمد: طبق تبصره ماده ۲۶، تعرفه صدور صورتحساب الکترونیکی را سازمان میپردازد. ولی خدمات جانبی مثل API، اتصال اختصاصی، مشاوره یا پلنهای ویژه ممکن است هزینه جدا داشته باشند. قبل از قرارداد، کتبی بپرسید چه چیزی رایگان است و چه چیزی نه.
برآورد ما برای مهر ۱۴۰۵ (پروژه اختصاصی)
این بازهها برای برنامهریزی است، نه قیمت قطعی؛ قیمت نهایی بعد از دیدن سایت و روال فروش شما مشخص میشود:
| سطح کار | چه چیزی شامل است | بازه برآورد | زمان معمول |
|---|---|---|---|
| نصب و تنظیم افزونه آماده | نصب، فرم فاکتور رسمی، نگاشت شناسه کالا، تست با حسابدار | قیمت افزونه بهعلاوه حدود ۳ تا ۱۰ میلیون تومان | چند روز بعد از آماده بودن کلید و شناسهها |
| اتصال سایت اختصاصی به API شرکت معتمد | نگاشت داده، صف، استعلام وضعیت، مرجوعی ساده، پنل وضعیت | حدود ۲۵ تا ۶۰ میلیون تومان | حدود ۲ تا ۴ هفته |
| ارسال مستقیم با امضا و پنل کامل | امضا، صف، تلاش دوباره، هشدار مهلت، اصلاحی و برگشت از فروش، نقشها، گزارش | حدود ۶۰ تا ۱۵۰ میلیون تومان | حدود ۴ تا ۸ هفته |
| لایه مرکزی چندکاناله | چند شناسه حافظه، سایت و حضوری و بازارگاه، اتصال حسابداری و انبار، داشبورد | از حدود ۱۵۰ میلیون تومان به بالا | بسته به تعداد سیستمها |
این بازهها مشاوره مالیاتی، تعریف یا دریافت شناسه کالاها، گواهی امضا و هزینه هاست را شامل نمیشوند. هزینه نگهداری را هم در نظر بگیرید؛ مستندات فنی سامانه گاهی بهروز میشود و اتصال باید با آن هماهنگ بماند. بودجه سالانه نگهداری را در هزینه نگهداری سایت و پشتیبانی ماهانه سایت توضیح دادهایم.
چه چیزهایی قیمت را بالا و پایین میبرد؟
| عامل | اثر روی هزینه |
|---|---|
| روش ارسال (مستقیم یا شرکت معتمد) | مستقیم کار امضا، امنیت کلید و نگهداری بیشتری دارد |
| تعداد حالتهای مرجوعی و اصلاح | هر نوع رویداد (مرجوعی جزئی، تغییر قیمت، افزودن قلم) منطق و تست جدا میخواهد |
| تعداد کانال فروش و شناسه حافظه | هر کانال تازه یعنی نگاشت و جلوگیری از ارسال تکراری بیشتر |
| وضعیت داده محصولات | اگر شناسه کالا، واحد و نرخ مرتب نباشد، پاکسازی داده زمان میبرد |
| سهم فروش شرکتی | فرم کامل خریدار، پیگیری رد و تأیید و پورتال مشتری |
| اتصال به حسابداری یا انبار | هر اتصال تازه، API و تست جدا دارد؛ ببینید یکپارچه سازی API |
مثال فرضی: اجرای مرحلهای برای یک فروشگاه اختصاصی
| مرحله | کار | نتیجه |
|---|---|---|
| مرحله ۱ | اتصال به API شرکت معتمد، صورتحساب نوع دوم، صف و پنل وضعیت | ورود دستی حذف میشود و هیچ سفارشی بیصورتحساب نمیماند |
| مرحله ۲ | فرم فاکتور رسمی، نوع اول، پیگیری رد و تأیید خریدار، برگشت از فروش جزئی | مشتری شرکتی و مرجوعیها مرتب میشوند |
| مرحله ۳ | اتصال حسابداری و انبار، گزارش مغایرت روزانه و داشبورد | جمع فروش و صورتحسابها هر روز با هم مقایسه میشوند |
برای اینکه پیشنهاد چند تیم را درست مقایسه کنید، استعلام قیمت طراحی سایت و هزینههای پنهان طراحی سایت ارزان را ببینید. برای کل بودجه یک فروشگاه، هزینه طراحی فروشگاه اینترنتی ۱۴۰۵ و هزینه طراحی سایت ۱۴۰۵ را بخوانید، هزینه API را در هزینه طراحی API و هزینه پنل را در هزینه ساخت پنل مدیریت آوردهایم و برای عوامل قیمت پروژههای پونوکد به صفحه قیمتگذاری سر بزنید.

تست قبل از روشن کردن ارسال واقعی
قبل از روشن کردن ارسال خودکار، این سناریوها را با سفارش آزمایشی و هماهنگ با حسابدار امتحان کنید. تا همه ردیفها رد نشدهاند، پرداخت آخر پروژه را نگه دارید:
| سناریو | نتیجه درست |
|---|---|
| سفارش عادی با یک کالا | صورتحساب نوع دوم با وضعیت موفق و شماره مالیاتی روی فاکتور |
| سفارش با فاکتور رسمی | صورتحساب نوع اول با اطلاعات کامل خریدار |
| فاکتور رسمی با شماره اقتصادی اشتباه | فرم همان لحظه خطا میدهد و سفارش با اطلاعات غلط ثبت نمیشود |
| سفارش با کد تخفیف روی کل سبد | جمع اقلام و تخفیف دقیقاً با مبلغ پرداختی یکی است |
| سفارش پرقلم با مبالغ کسری | گرد کردن در یک جا انجام میشود و اختلاف جمع ندارد |
| دو بار زدن دکمه ارسال | فقط یک صورتحساب اصلی ثبت میشود |
| مرجوعی یک قلم از سه قلم | برگشت از فروش با ارجاع درست و مبلغ بعد از تخفیف |
| لغو کامل بعد از ثبت | ابطالی و وضعیت بهروز در پنل |
| تغییر تعداد بعد از ثبت صورتحساب | صورتحساب اصلاحی با ارجاع به صورتحساب مرجع |
| رد صورتحساب توسط خریدار شرکتی (در محیط آزمایشی یا با شبیهسازی) | وضعیت «رد شده» و اعلان به حسابدار |
| قطع عمدی ارتباط با سرویس | صورتحساب در صف میماند و بعد از وصل شدن ارسال میشود |
| صورتحسابی که نزدیک مهلت هنوز ثبت نشده | هشدار مهلت به مسئول میرسد |
| محصول بدون شناسه کالا | ارسال متوقف و هشدار در پنل نمایش داده میشود |
| کالای معاف کنار کالای مشمول در یک سبد | هر ردیف با نرخ درست خودش ثبت میشود |
| ورود کاربر پشتیبانی به بخش ابطال | دسترسی ندارد و تلاشش در گزارش ثبت میشود |
فهرست کامل تستهای تحویل سایت را در چک لیست طراحی سایت آوردهایم و اگر سایت را تازه تحویل گرفتهاید، سئو فنی بعد از تحویل سایت را هم ببینید.
بعد از راهاندازی؛ عددهایی که هر هفته ببینید
| عدد | چرا مهم است | وضعیت سالم |
|---|---|---|
| صورتحسابهای خطادار باز | هر کدام ممکن است از مهلت جا بماند | صفر یا در دست رسیدگی با مسئول مشخص |
| صورتحسابهایی که بیش از چند ساعت در صف ماندهاند | نشانه قطعی سرویس یا خطای فنی | صفر |
| صورتحسابهای نزدیک مهلت | هشدار زودهنگام | صفر |
| صورتحسابهای رد شده توسط خریدار | رضایت مشتری شرکتی و درستی اطلاعات | کم و همه با دلیل ثبتشده |
| سفارش پرداختشده بدون صورتحساب | ریسک جریمه بند الف ماده ۲۲ | صفر |
| مغایرت جمع فروش سایت با جمع صورتحسابهای ثبتشده | جا افتادن یا تکرار | صفر یا با توضیح (مثلاً مرجوعی در راه) |
این عددها را میشود در یک صفحه کنار بقیه شاخصهای فروش گذاشت؛ نمونهاش را در داشبورد فروش و ساخت داشبورد مدیریتی اختصاصی ببینید.
اشتباههای رایج در اتصال سایت به سامانه مودیان
- شروع برنامهنویسی قبل از آماده شدن کارپوشه، شناسه حافظه و شناسه کالاها.
- کم کردن تخفیف سبد از جمع کل به جای پخش آن روی اقلام.
- دکمه «لغو» و «مرجوعی» که فقط وضعیت سفارش را عوض میکند و صورتحساب ارجاعی نمیسازد.
- دو سیستم (سایت و حسابداری) که هر دو برای یک سفارش صورتحساب میفرستند.
- ارسال صورتحساب در همان لحظه پرداخت و بدون صف، طوری که اگر سامانه کند باشد، صفحه پرداخت مشتری هم معطل بماند.
- نگه داشتن کلید خصوصی در مخزن کد، ایمیل یا لپتاپ برنامهنویس.
- تکیه بر تمدید مهلت به جای هشدار مهلت.
- دستکاری تاریخ صدور برای جا دادن صورتحساب در مهلت.
- نادیده گرفتن صورتحسابهایی که خریدار رد کرده است.
- خرید افزونه بدون پرسیدن درباره ارسال خودکار، برگشت از فروش جزئی و سرور خارج.
- ثبت نکردن متن خطاها و پاسخها، طوری که بعداً معلوم نیست چه اتفاقی افتاد.
- روشن کردن ارسال واقعی بدون اجرای سناریوهای تست با حسابدار.
چکلیست اتصال سایت به سامانه مودیان
- دسترسی به کارپوشه و شناسه یکتای حافظه مالیاتی آماده است.
- روش ارسال برای هر شناسه حافظه با حسابدار مشخص شده است.
- کلید عمومی در کارپوشه ثبت شده و کلید خصوصی فقط روی سرور سرویس صورتحساب است (برای روش مستقیم).
- همه محصولات فعال شناسه ۱۳ رقمی و نرخ مالیات دارند و محصول بدون شناسه ارسال نمیشود.
- دسترسی سرور سایت یا سرویس صورتحساب به سامانه یا API شرکت معتمد با صورتحساب آزمایشی امتحان شده است.
- زمان صدور صورتحساب (پرداخت یا ارسال کالا) تعیین شده است.
- فرم تسویه حساب گزینه فاکتور رسمی و اعتبارسنجی فیلدها را دارد.
- تخفیف سبد روی اقلام پخش میشود و گرد کردن در یک جا انجام میشود.
- هزینه ارسال طبق نظر حسابدار در صورتحساب ثبت میشود.
- ارسال در صف انجام میشود و وضعیت خودکار استعلام میشود.
- جلوی ارسال تکراری برای یک سفارش گرفته شده است.
- هشدار مهلت فعال است و عدد مهلت در تنظیمات قابل تغییر است.
- ساعت سرور همگام است.
- دکمههای مرجوعی و لغو صورتحساب ارجاعی درست میسازند و جدا از هماند.
- وضعیت رد یا تأیید خریدار شرکتی پیگیری و اعلان میشود.
- دسترسی ابطال و اصلاح فقط برای نقشهای مشخص فعال است.
- متن درخواست، پاسخ و خطای هر ارسال در گزارش ذخیره میشود.
- فقط یک سیستم برای هر فروش صورتحساب صادر میکند.
- گزارش هفتگی صورتحسابهای خطادار، نزدیک مهلت و سفارش بدون صورتحساب آماده است.
- سناریوهای تست بالا قبل از روشن کردن ارسال واقعی اجرا شدهاند.
اگر سایت اختصاصی دارید یا میخواهید بسازید
در پونوکد اتصال سایت به سرویسهای بیرونی را از نگاشت داده و روال واقعی فروشگاه شروع میکنیم، نه از کد. اگر سایت اختصاصی دارید یا قرار است بسازید، اتصال به سامانه مودیان را میشود از همان ابتدا در طراحی پنل سفارش و حسابداری در نظر گرفت تا بعداً وصلهپینه نشود. برای آشنایی با روش کار ما در اتصالها، مقاله یکپارچه سازی API را بخوانید و صفحه خدمات پونوکد و طراحی سایت را ببینید. برای دیدن عوامل قیمت به قیمتگذاری سر بزنید یا شرایطتان را از فرم تماس بفرستید.
اگر هنوز مطمئن نیستید سایت میخواهید یا نرمافزار اختصاصی، یا پروژه قبلیتان نیمهکاره مانده، این دو مطلب کمک میکنند: سایت میخواهید یا نرمافزار اختصاصی و پروژه نیمهکاره نرمافزار. اگر قبل از شروع، یک جلسه مشاوره فنی برای نگاشت داده و انتخاب روش لازم دارید، مشاوره فنی قبل از ساخت نرمافزار را بخوانید.
مطالب مرتبط
- اتصال سایت به نرمافزار حسابداری
- یکپارچه سازی API
- هزینه طراحی API
- هزینه طراحی فروشگاه اینترنتی ۱۴۰۵
- ووکامرس یا فروشگاه اختصاصی
- قیمت طراحی سایت فروشگاهی اختصاصی
- طراحی سایت فروشگاهی
- فروش اقساطی در سایت
- اتصال فروشگاه به پست و تیپاکس
- سامانه گارانتی آنلاین
- پرداخت ناموفق در فروشگاه اینترنتی
- اتصال سایت به ترب
- اتصال فروشگاه به دیجی کالا
- پورتال مشتریان اختصاصی
- سامانه سفارشگیری عمده B2B
- نرم افزار انبارداری اختصاصی
- نرم افزار فروشگاه پوشاک
- نرم افزار طلافروشی
- طراحی سایت موسسه حسابداری
- هاست و CDN در ایران
- چکلیست امنیت سایت
- سایت هک شده چه کنیم
- هزینه نگهداری سایت
- مالکیت سورس کد سایت
جمعبندی
اتصال سایت به سامانه مودیان سه بخش دارد: کار مالیاتی (پرونده، شناسه حافظه، شناسه کالا)، کار داده (تبدیل درست سفارش و مرجوعی به صورتحساب) و کار فنی (امضا، ارسال، صف و پیگیری). فروشگاه کوچک ووکامرسی معمولاً با افزونه معتبر یا شرکت معتمد راه میافتد؛ سایت اختصاصی و فروش چندکاناله یا شرکتی، اتصال اختصاصی میخواهد. در هر حال، قبل از ارسال واقعی، مرجوعی و خطا را تست کنید.
اگر فقط سه کار از این راهنما بردارید: شناسه کالاها را قبل از هر چیز مرتب کنید، برای مهلت ۱۲ روزه هشدار خودکار بگذارید و دکمههای مرجوعی و لغو را طوری بسازید که صورتحساب ارجاعی درست تولید کنند. بقیه کار، جزئیات اجرایی است که با یک تیم فنی دقیق و حسابدار همراه، قابل انجام است. باز هم یادآوری میکنیم: این مطلب مشاوره مالیاتی نیست و تصمیمهای مالیاتی با حسابدار شماست.
سؤالهای رایج
فروشگاه اینترنتی من حتماً باید به سامانه مودیان وصل شود؟
اینکه مشمول ارسال صورتحساب الکترونیکی هستید یا نه و از چه تاریخی، به وضعیت مالیاتی شما بستگی دارد و باید با حسابدار و کارپوشهتان چک شود. اگر مشمول هستید، الزام قانونی «ثبت صورتحساب» است؛ اتصال خودکار سایت فقط راهی است که این کار بدون ورود دستی انجام شود.
میشود صورتحسابها را دستی در کارپوشه ثبت کرد؟
بله، برای تعداد کم سفارش. ولی با چند ده سفارش در روز، ورود دستی وقتگیر است و احتمال اشتباه و جا ماندن از مهلت را بالا میبرد.
ارسال مستقیم بهتر است یا شرکت معتمد؟
هیچکدام برای همه بهتر نیست. ارسال مستقیم هزینه ماهانه واسط ندارد ولی پیادهسازی و امنیت کلید با شماست. شرکت معتمد شروع سادهتری دارد ولی به یک سرویس بیرونی وابسته میشوید. اگر تیم فنی یا همکار قابل اتکا ندارید، شرکت معتمد کمریسکتر است.
برای سایت غیر وردپرسی افزونه آماده وجود دارد؟
برای سایتهای اختصاصی معمولاً نه. این سایتها یا به API شرکت معتمد وصل میشوند یا ارسال مستقیم برایشان پیادهسازی میشود. اگر سایتتان روی پلتفرم دیگری است، از سازنده آن بپرسید چه امکانی دارد.
اگر مشتری کالا را مرجوع کند چه میشود؟
اگر بخشی از اقلام برگردد، معمولاً صورتحساب برگشت از فروش صادر میشود و اگر کل معامله لغو شود، صورتحساب ابطالی. سایت باید این صورتحسابها را از همان دکمه مرجوعی در پنل بسازد تا چیزی جا نماند.
اتصال به سامانه مودیان چقدر طول میکشد؟
با افزونه آماده، بعد از آماده بودن کلید و شناسه کالاها، معمولاً چند روز. اتصال اختصاصی معمولاً چند هفته، که بخشی از آن صرف تست با حسابدار میشود.
مهلت ثبت صورتحساب در سامانه مودیان چند روز است؟
طبق اطلاعیه سازمان امور مالیاتی، از ۱۵ آبان ۱۴۰۳ حداکثر فاصله تاریخ صدور تا ثبت صورتحساب ۱۲ روز است. در ۱۴۰۵ چند بار مهلت برای بازههای مشخص موقتاً تمدید شد، ولی این تمدیدها فقط برای همان بازهها بود. سایت را با قاعده عادی و هشدار مهلت طراحی کنید و آخرین اطلاعیه را از حسابدار بپرسید.
اگر خریدار شرکتی صورتحساب را رد کند چه میشود؟
خریدار ۳۰ روز از درج صورتحساب در کارپوشه فرصت دارد آن را تأیید یا رد کند و اگر واکنشی نشان ندهد، صورتحساب سیستمی تأیید میشود. اگر رد کند، تا وقتی شما آن را ابطال نکردهاید از نظر سیستم فروش شما حساب میشود و خریدار اعتباری نمیگیرد. بهتر است پنل، صورتحسابهای رد شده را نشان بدهد تا حسابدار با خریدار هماهنگ کند و صورتحساب درست را صادر کند.
سایت ما روی سرور خارج از ایران است؛ اتصال ممکن است؟
ممکن است دسترسی از سرور خارجی رد شود یا ناپایدار باشد. راههای معمول، انتقال سایت به سرور داخلی، یک سرویس کوچک صدور صورتحساب روی سرور داخل ایران یا ارسال از طریق API شرکت معتمد است. قبل از هر خریدی، دسترسی را با یک صورتحساب آزمایشی امتحان کنید.
شرکت معتمد بابت هر صورتحساب از ما پول میگیرد؟
طبق تبصره ماده ۲۶ قانون پایانههای فروشگاهی و سامانه مودیان، تعرفه صدور صورتحساب الکترونیکی شرکتهای معتمد را سازمان امور مالیاتی میپردازد. ولی خدمات جانبی مثل API، اتصال اختصاصی یا پلنهای ویژه ممکن است هزینه جدا داشته باشند. فهرست خدمات رایگان و پولی را قبل از قرارداد کتبی بگیرید.
مشاوره اتصال سایت به سامانه مودیان با پونوکد
اگر میخواهید بدانید برای سایت شما کدام راه مناسبتر است، شرایط فروشتان را برایمان بفرستید (نوع سایت، تعداد سفارش روزانه، سهم مشتری شرکتی، نرمافزار حسابداری و محل سرور) تا راه پیشنهادی و برآورد اولیه را بگوییم: ۰۹۹۱۵۶۱۵۹۴۶، تلگرام t.me/resonea یا فرم تماس.
اگر به وبلاگهای حوزه تکنولوژی روز دنیا علاقهمندید، میتوانید به وبسایت شخصی من هم سر بزنید: ramineslami.ir/blogs



