راهنمای جامع استفاده از افزونه کارپوشا

۱- معرفی افزونه و مفاهیم پایه

کارپوشا یک سیستم مدیریت اسناد فروش برای ووکامرس است. برخلاف افزونه‌هایی که فقط سفارش را چاپ می‌کنند، اینجا هر فاکتور یک سند مستقل با شماره سریال، وضعیت پرداخت، تاریخ، محتوای قابل ویرایش و مسیر چاپ امن است.

۱-۱ زنجیره مفهومی

1. سفارش ووکامرس: منبع اولیه داده فروش آنلاین.
2. سند فاکتور: رکورد حسابداری مستقل در نوع نوشته karpoosha_document.
3. شماره سریال: شناسه قابل اتکای سند با قفل ضدتداخل.
4. اسنپ‌شات: تصویر لحظه صدور برای ثبات محتوای چاپ‌شده.
5. لینک امن: مشاهده عمومی با توکن، نه با حدس شناسه عددی.
6. مودیان (اختیاری): صف و وضعیت ارسال صورتحساب مالیاتی.

۱-۲ انواع سند رایج

۲- نقشه منوها و مسیرهای اصلی

همچنین در صفحه هر سفارش ووکامرس، متاباکس «کارپوشا» برای صدور سریع، مشاهده، چاپ و ایمیل در دسترس است.

۳- شروع سریع پیشنهادی

1. لایسنس را فعال کنید.
2. در فروشنده، اطلاعات هویتی و لوگو/مهر را کامل کنید.
3. در شماره‌گذاری، الگوی سریال فاکتور و پیش‌فاکتور را تنظیم کنید.
4. در ظاهر فاکتور، قالب رسمی یا HTML سفارشی را انتخاب کنید.
5. در خودکارسازی، وضعیت‌های صدور خودکار را مشخص کنید.
6. اگر مشمول مالیات هستید، منبع مالیات و در صورت نیاز مودیان را تنظیم کنید.
7. یک سفارش آزمایشی بسازید، فاکتور را صادر و چاپ کنید.

۴- پیکربندی — فروشنده و برند

مسیر: فاکتور ← پیکربندی ← فروشنده

۴-۱ اطلاعات فروشنده

این بخش هویت فروشگاه روی فاکتور را می‌سازد. اگر اینجا ناقص باشد، فاکتور رسمی و خروجی مودیان ضعیف یا رد می‌شود.

۴-۲ لوگو و مهر

۵- پیکربندی — ظاهر فاکتور

مسیر: پیکربندی ← ظاهر فاکتور

۵-۱ قالب

می‌توانید قالب رسمی داخلی را نگه دارید یا قالب HTML سفارشی بسازید. تغییر قالب، ظاهر چاپ و پیش‌نمایش اسناد جدید را عوض می‌کند.

• قالب رسمی: مناسب فاکتور استاندارد ایرانی با QR و بارکد.
• HTML سفارشی: کنترل کامل برند؛ برای پیش‌فاکتور می‌توانید HTML جدا تعریف کنید.
• اندازه کاغذ و حاشیه: روی خروجی چاپ مرورگر اثر می‌گذارد (مثلاً A4 افقی).
• نوار ابزار چاپ: دکمه‌های چاپ/بستن را در پیش‌نمایش نشان می‌دهد یا مخفی می‌کند.

۵-۲ رنگ و فونت

• رنگ اصلی: رنگ تأکید سند (پیش‌فرض آبی برند).
• فونت فاکتور: خوانایی چاپ فارسی را تعیین می‌کند.
• فونت سفارشی TTF: اگر برند فونت اختصاصی دارد.

۵-۳ بخش‌های قالب

با خاموش/روشن کردن لوگو، QR، بارکد، یادداشت و اطلاعات پرداخت مشخص می‌کنید کدام بلوک‌ها روی فاکتور دیده شوند. مثلاً فروشگاه B2B ممکن است QR را نگه دارد ولی واترمارک را برای پیش‌فاکتور جدا تنظیم کند.

۵-۴ واترمارک و کدها

۶- پیکربندی — شماره‌گذاری و انواع سند

مسیر: پیکربندی ← شماره‌گذاری و اسناد

۶-۱ سری‌ها و توکن‌ها

این مهم‌ترین بخش اعتماد حسابداری است. هر تغییر در قالب شماره، روی شماره‌های بعدی اثر می‌گذارد؛ شماره‌های صادرشده قفل می‌مانند.

۶-۲ انواع و وضعیت سند

• انواع فعال: مشخص می‌کند کدام نوع سند در سیستم قابل صدور باشد.
• برگه پستی: قابلیت چاپ لیبل ارسال را روشن می‌کند.
• همگام‌سازی وضعیت مالی از سفارش: وضعیت پرداخت سند را با سفارش هم‌راستا پیشنهاد می‌دهد.
• حالت مرجوعی خودکار: هنگام refund ووکامرس، سند برگشت ساخته شود یا نشود.

۷- پیکربندی — محتوا و فیلدها

مسیر: پیکربندی ← محتوا و فیلدها

۷-۱ نمایش محتوا

اینجا مشخص می‌کنید چه چیزهایی روی فاکتور چاپ شود. خاموش کردن یک گزینه، همان بلوک را از خروجی حذف می‌کند.

• اقلام: SKU، ویژگی‌ها، افزونه‌ها، متای سفارشی، لینک دانلود، تخفیف قلم
• مالیات: نمایش مالیات، شکست مالیاتی، مالیات تخفیف/کارمزد
• ارسال: هزینه ارسال، روش ارسال، آدرس ارسال، مالیات ارسال
• پرداخت و جمع‌ها: کارمزد، کوپن، وضعیت پرداخت، شماره تراکنش، مبلغ پرداخت‌شده و مانده
• مرجوعی و اشتراک: جزئیات refund، اطلاعات اشتراک/عضویت
• سایر: شماره سفارش، شماره صفحه، یادداشت مشتری

۷-۲ متن و برچسب

عنوان‌ها و برچسب‌های فارسی سند را عوض می‌کند؛ مثلاً «مشخصات فروشنده»، «جمع کل»، «چاپ». اگر فیلدی خالی بماند، متن پیش‌فرض افزونه استفاده می‌شود. یادداشت پاورقی برای پیام ثابت مثل شرایط مرجوعی مناسب است.

۷-۳ پرداخت روی فاکتور

برای هر درگاه ووکامرس مشخص می‌کنید پرداخت «نقدی» است یا «غیرنقدی». این برچسب روی فاکتور رسمی اثر دارد و برای گزارش و ظاهر سند مهم است.

۷-۴ فیلدهای خریدار و حقیقی/حقوقی

۷-۵ فیلدهای داخلی و سفارشی

در بخش حقیقی/حقوقی می‌توانید نمایش، اجباری بودن و منبع پر شدن فیلدهای داخلی را کنترل کنید. در فیلد سفارشی، فیلدهای متنی/عددی/ایمیل خودتان را اضافه می‌کنید تا روی حساب کاربری، سفارش یا فاکتور ظاهر شوند. دکمه پیشنهادهای ایران برای سناریوهای B2B مفید است.

۷-۶ تاریخ و زبان

• تقویم نمایش: شمسی، میلادی یا هر دو
• قالب تاریخ: شکل چاپ تاریخ
• منبع تاریخ فاکتور: تاریخ سفارش یا زمان صدور سند
• ارقام: فارسی / عربی / انگلیسی
• جهت سند: خودکار، RTL یا LTR

۸- پیکربندی — مالیات و سامانه مودیان

مسیر: پیکربندی ← مالیات

۸-۱ منبع مالیات

• استفاده از تنظیمات ووکامرس: همان مالیات هسته ووکامرس روی فاکتور می‌آید.
• مالیات اختصاصی ایران: VAT فروشگاه را خود افزونه مدیریت می‌کند.

۸-۲ مالیات ایران (در حالت اختصاصی)

۸-۳ اتصال به مودیان

این بخش فقط وقتی معنا دارد که فروشگاه مشمول سامانه مودیان باشد و گواهی/شناسه حافظه آماده باشد.

در سطح محصول هم می‌توانید شناسه کالا/خدمت مودیان و معافیت مالیاتی را برای هر کالا یا متغیر تنظیم کنید. شناسه اقتصادی/ملی فروشنده از تب فروشنده خوانده می‌شود.

۹- پیکربندی — خودکارسازی، دسترسی، ایمیل و پیامک

مسیر: پیکربندی ← خودکارسازی و ابزارها

۹-۱ صدور خودکار

۹-۲ دسترسی مشتری

• مشاهده در حساب کاربری: دکمه فاکتور در حساب من
• دکمه صفحه تشکر: دسترسی سریع بعد از خرید
• پیش‌فاکتور در سبد: پیشنهاد قیمت قبل از تسویه
• وضعیت‌های مجاز مشاهده: مشتری فقط در وضعیت‌های انتخابی فاکتور را می‌بیند
• درگاه پیش‌فاکتور: ثبت سفارش با پرداخت بعدی
• مهلت اعتبار پیش‌فاکتور و TTL لینک امن: کنترل انقضا

۹-۳ ایمیل و پیامک

برای فاکتور و پیش‌فاکتور جداگانه می‌توانید قالب ایمیل ووکامرس یا سفارشی، موضوع، درج لینک، و ارسال روی وضعیت‌های سفارش را تنظیم کنید. پیامک نیازمند افزونه پیامک حرفه‌ای ووکامرس است و با قالب و وضعیت‌های مشخص ارسال می‌شود.

۹-۴ برچسب پستی

اندازه لیبل، موبایل فرستنده، حالت فشرده، نمایش یادداشت و بارکد را تنظیم می‌کند. مناسب ارسال فیزیکی بعد از صدور فاکتور.

۱۰- ابزارها، پشتیبان و اتصال نرم‌افزارها

۱۰-۱ ابزارها و حریم خصوصی

• خروجی JSON تنظیمات: بک‌آپ پیکربندی قبل از تغییرات بزرگ
• ورود JSON: بازگردانی تنظیمات روی سایت دیگر یا بعد از حادثه
• بازنشانی پیش‌فرض: برگرداندن تنظیمات به حالت اولیه (گواهی مودیان حفظ می‌شود؛ اسناد صادرشده پاک نمی‌شوند)
• حذف داده هنگام uninstall: فقط اگر آگاهانه می‌خواهید با حذف افزونه داده پاک شود

۱۰-۲ اتصال نرم‌افزارها

مسیر: پیکربندی ← اتصال نرم‌افزارها

• راهنما: آدرس API، هدر کلید، سطح دسترسی
• کلیدهای API: ساخت کلید با محدوده read/write/moadian، IP مجاز، نرخ و انقضا
• مستندات عملگرها: نمونه فراخوانی برای یکپارچگی خارجی
• رویدادهای امنیتی: ردگیری تلاش‌ها و رخدادهای حساس اتصال

۱۱- فهرست اسناد و متاباکس سفارش

۱۱-۱ فهرست اسناد فاکتور

همه اسناد در یک جدول دیده می‌شوند: شماره، نوع، وضعیت پرداخت، سفارش مرتبط، تاریخ. از اینجا می‌توانید سند را باز کنید، به استودیو بروید، چاپ کنید یا ارسال گروهی به مودیان انجام دهید.

۱۱-۲ متاباکس سفارش ووکامرس

در صفحه سفارش می‌توانید فاکتور/پیش‌فاکتور صادر کنید، لینک مشاهده و چاپ بگیرید، برچسب پستی بسازید، ایمیل بفرستید یا انتخاب نوع خریدار را ریست کنید. این مسیر برای اپراتور فروش روزمره سریع‌ترین راه است.

۱۲- صدور سند دستی (بدون سفارش)

مسیر: صدور سند

برای فروش حضوری، تلفنی یا اصلاحات می‌توانید بدون سفارش ووکامرس سند بسازید؛ یا سند را به یک سفارش موجود وصل کنید.

1. نوع سند را انتخاب کنید (پیش‌فاکتور، فروش، اصلاحی، برگشت، ابطالی).
2. کانال فروش را مشخص کنید (آنلاین، حضوری، تلفنی، سایر).
3. مشتری و اقلام را وارد کنید.
4. صادر کنید؛ سیستم شما را به استودیو سند می‌برد.

۱۳- استودیوی ویرایش سند

استودیو محل کنترل نهایی محتوای یک سند است. تب‌ها:

• سربرگ سند: شماره، عنوان، وضعیت، تاریخ
• خریدار / صورتحساب: اطلاعات طرف حساب
• آدرس ارسال: نشانی تحویل
• پرداخت: وضعیت و جزئیات پرداخت
• مبالغ: جمع‌ها و مالیات
• اقلام: نام، تعداد، تخفیف، مالیات، SSTID و ...
• فروشنده: بازنویسی اطلاعات فروشنده روی همین سند
• یادداشت: توضیحات چاپی

دکمه‌های عملیاتی مثل ذخیره، چاپ، باز کردن فاکتور، خواندن از سفارش، و عملگرهای مودیان (اصلاحی/برگشت/ابطال) هم اینجاست. اگر سند قفل قانونی شده باشد، ویرایش محدود می‌شود.

۱۴- مشاهده عمومی، چاپ و PDF

• مشاهده امن: مسیر /invoice/view/{TOKEN}/
• صحت‌سنجی: مسیر /invoice/verify/{CODE}/ بدون افشای اطلاعات حساس
• چاپ: از دکمه چاپ سند یا حالت چاپ
• PDF: در مرورگر گزینه Save as PDF؛ تولید PDF سمت سرور در این نسخه عمداً غیرفعال است

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

۱۵- گزارش‌ها و مانیتور مودیان

مسیر: فاکتور ← گزارش‌ها

۱۵-۱ گزارش مالی

با فیلتر سال شمسی و ماه، فروش دوره، VAT، تفکیک حقیقی/حقوقی، وضعیت ارسال مودیان و لیست اسناد ارسال‌نشده را می‌بینید. خروجی CSV برای حسابدار در دسترس است.

۱۵-۲ لاگ ممیزی

رویدادهایی مثل صدور، ابطال، ارسال و اصلاح مودیان را با فیلتر سند و جستجو نشان می‌دهد. برای پاسخ به اختلافات و ممیزی داخلی حیاتی است.

۱۵-۳ مودیان

• گزارش وضعیت: وضعیت ارسال اسناد
• مانیتور مهلت: اسناد نزدیک به ددلاین قبل از بحران

۱۶- سناریوهای کامل کسب‌وکار

۱۶-۱ فروشگاه اینترنتی استاندارد

1. فروشنده و ظاهر را کامل کنید.
2. صدور خودکار روی وضعیت پرداخت‌شده/تکمیل‌شده.
3. دکمه فاکتور در حساب کاربری و صفحه تشکر را روشن کنید.
4. ایمیل لینک فاکتور را فعال کنید.

۱۶-۲ فروش B2B با پیش‌فاکتور

1. سری جدا برای پیش‌فاکتور بسازید.
2. پیش‌فاکتور سبد یا درگاه پیش‌فاکتور را فعال کنید.
3. مهلت اعتبار تعیین کنید.
4. پس از توافق، سند را به فاکتور فروش ارتقا دهید.

۱۶-۳ فروش حضوری و تلفنی

1. از «صدور سند» حالت بدون سفارش استفاده کنید.
2. کانال حضوری/تلفنی را ثبت کنید.
3. چاپ بگیرید یا لینک امن بفرستید.

۱۶-۴ فروشگاه مشمول مودیان

1. ابتدا محیط آزمایشی و تست اتصال.
2. SSTID کالاها را تکمیل کنید.
3. ارسال خودکار + مانیتور مهلت را روشن کنید.
4. پس از SUCCESS از قفل قانونی بهره ببرید.

۱۷- عیب‌یابی و چک‌لیست نهایی

چک‌لیست قبل از بهره‌برداری

• لایسنس فعال است
• اطلاعات فروشنده و مهر کامل است
• شماره‌گذاری با حسابدار هماهنگ شده
• حداقل یک فاکتور آزمایشی چاپ شده
• دسترسی مشتری و ایمیل تست شده
• اگر مودیان لازم است، تست اتصال موفق بوده
• خروجی JSON تنظیمات گرفته شده
• مسیرهای فاکتور از کش صفحه‌ای مستثنی شده‌اند

با این ترتیب، کارپوشا از یک دکمه چاپ ساده به سامانه کامل اسناد فروش فروشگاه شما تبدیل می‌شود: از پیشنهاد قیمت تا فاکتور رسمی، از فروش حضوری تا مودیان، از گزارش مالی تا آرشیو قابل اتکا.