افزونهٔ ووکامرس
نصب و راه‌اندازی افزونهٔ «حسابداری نمو» برای ووکامرس؛ بدون برنامه‌نویسی، در چند دقیقه.
دریافت افزونه (nemo-accounting.zip)
نسخهٔ ۱.۰.۰ — وردپرس ۶٫۲ به بالا، ووکامرس ۷ به بالا (آزموده تا ۱۱٫۱)، PHP ۷٫۴ به بالا. با «ذخیره‌سازی سفارش با کارایی بالا» (HPOS) سازگار است.
نصب
- در پیشخوان وردپرس به افزونه‌ها ← افزودن ← بارگذاری افزونه بروید، فایل
nemo-accounting.zipرا انتخاب و نصب کنید و سپس فعال‌سازی را بزنید. - در پنل حسابداری نمو، تنظیمات ← اتصال فروشگاه ← کلید جدید را بزنید، دسترسی «ثبت سفارش، پرداخت و برگشت» را بدهید و کلید را کپی کنید.
- در وردپرس به ووکامرس ← حسابداری نمو بروید، کلید را در «کلید API» بچسبانید و ذخیرهٔ تنظیمات را بزنید.
- دکمهٔ آزمایش اتصال را بزنید. باید پیام «وصل است» همراه نام سازمان شما نمایش داده شود.
همین. از این به بعد هر سفارش تازه خودکار به نمو فرستاده می‌شود.
تنظیمات افزونه
| تنظیم | توضیح |
|---|---|
| کلید API | کلیدی که در پنل نمو ساختید. پس از ذخیره دیگر نمایش داده نمی‌شود؛ برای تغییر، کلید تازه را بنویسید. |
| ارسال سفارش در وضعیت | سفارش در کدام وضعیت‌ها فرستاده شود. پیش‌فرض: «در حال انجام» و «تکمیل‌شده». پرداخت آنلاین موفق همیشه فرستاده می‌شود. |
| برگشت سفارش | روشن باشد، سفارشی که «مسترد شده» شود در نمو برگشت از فروش می‌شود. |
| واحد پول | خودکار تشخیص داده می‌شود (ریال، تومان، هزار ریال، هزار تومان). فقط اگر اشتباه است، بنویسید هر واحد پول فروشگاه چند ریال است — مثلاً تومان = ۱۰. |
| نشانی API | به آن دست نزنید؛ پیش‌فرض https://panel.nemosystem.ir/api/v1 است. |
چه چیزی کجا ثبت می‌شود
- پرداخت آنلاین (درگاه): همان لحظهٔ پرداخت موفق، فاکتور فروش و دریافت وجه با هم ثبت می‌شوند. شمارهٔ پیگیری درگاه روی رسید دریافت می‌نشیند.
- پرداخت در محل: وقتی سفارش به وضعیت ارسال برسد فاکتور ثبت می‌شود؛ دریافت وجه تا وقتی سفارش «تکمیل‌شده» نشود ثبت نمی‌شود — یعنی وقتی پیک پول را تحویل داد.
- کوپن تخفیف: به‌عنوان تخفیف روی همان اقلام فاکتور می‌نشیند.
- هزینهٔ ارسال و کارمزدها: یک ردیف «هزینهٔ ارسال» در فاکتور.
- مشتری: با شمارهٔ موبایل صورت‌حساب پیدا می‌شود؛ خریدار تازه با همان شماره به‌عنوان کد، مشتری می‌شود.
- استرداد: برگشت از فروش کامل. پس دادن پول به خریدار را در خزانهٔ نمو ثبت کنید؛ ممکن است از راهی جز راه دریافت برگردد.
مالیات
افزونه قیمت اقلام را بدون مالیات ووکامرس می‌فرستد و نمو نرخ مالیاتی را که در «تنظیمات اتصال» انتخاب کرده‌اید روی آن می‌گذارد.
- اگر ووکامرس شما مالیات حساب نمی‌کند ولی قیمت‌های سایت مالیات را در خود دارند، در پنل نمو «قیمت‌های سایت شامل مالیات است» را روشن کنید تا مالیات از قیمت جدا شود و جمع فاکتور با جمع سفارش یکی بماند.
- اگر ووکامرس مالیات را خودش جداگانه حساب می‌کند، این گزینه را خاموش بگذارید و همان نرخ را در نمو انتخاب کنید.
وضعیت هر سفارش
در ووکامرس ← سفارش‌ها ستونی به نام «نمو» اضافه می‌شود:
| برچسب | یعنی |
|---|---|
| فاکتور شد #123 | فاکتور ثبت شد (شمارهٔ فاکتور در نمو کنارش است)؛ دریافت وجه هنوز نه. |
| پرداخت‌شده | فاکتور و دریافت وجه هر دو ثبت شدند. |
| نیازمند بررسی | سفارش رسید اما حسابدار باید کاری بکند (مثلاً موجودی کالا). علت در یادداشت سفارش هست. |
| برگشت شد | برگشت از فروش ثبت شد. |
| خطا | ارسال ناموفق بود — علت را در یادداشت سفارش ببینید. |
پیام هر ارسال، موفق یا ناموفق، در یادداشت‌های سفارش هم ثبت می‌شود.
ارسال دوباره
- اگر نمو در دسترس نباشد یا اینترنت قطع شود، افزونه خودش تا ۶ بار با فاصلهٔ رو به افزایش (۱، ۵، ۲۵ دقیقه، …) دوباره می‌فرستد.
- خطایی که با تکرار رفع نمی‌شود — مثلاً کالایی که SKUاش در نمو نیست — دوباره فرستاده نمی‌شود. بعد از رفع (مثلاً تعریف کالا با همان کد)، سفارش را در فهرست سفارش‌ها انتخاب کنید و از «کارهای دسته‌جمعی» ارسال به حسابداری نمو را بزنید. روی صفحهٔ هر سفارش هم گزینهٔ «ارسال دوباره به حسابداری نمو» در «اقدامات سفارش» هست.
- فرستادن دوباره هیچ‌وقت فاکتور تکراری نمی‌سازد.
سفارش‌هایی که در نمو بررسی می‌شوند
وقتی سفارشی در نمو «نیاز به بررسی» می‌گیرد و حسابدار مشکل را رفع می‌کند و در صفحهٔ اتصال فروشگاه تلاش دوباره را می‌زند، نمو خودش به سایت خبر می‌دهد و ستون «نمو» و یادداشت سفارش به‌روز می‌شوند. این کار با وب‌هوک انجام می‌شود که افزونه هنگام ذخیرهٔ تنظیمات خودش ثبت می‌کند — کاری لازم نیست.
اگر بالای صفحهٔ تنظیمات افزونه پیام «ثبت وب‌هوک در نمو ناموفق بود» دیدید، سفارش‌ها همچنان فرستاده می‌شوند؛ فقط خبرهای سمت نمو نمی‌رسند. معمولاً علت این است که سایت روی https نیست.
پیش از راه‌اندازی، یک بار بررسی کنید
- SKU همهٔ محصولات سایت پر است و با کد کالا در نمو یکی است. (در نمو، کالاها و خدمات ← کد کالا.)
- در «تنظیمات اتصال» نمو، حساب دریافت وجه انتخاب شده است.
- یک سفارش آزمایشی بدهید و در پنل نمو، صفحهٔ «اتصال فروشگاه»، بخش «سفارش‌های رسیده» آن را ببینید.
برای فروشگاه پرفروش، اجرای منظم «Action Scheduler» ووکامرس را با یک cron واقعی مطمئن کنید؛ افزونه ارسال‌ها را با آن در پس‌زمینه انجام می‌دهد تا تکمیل خرید مشتری هیچ‌وقت منتظر نمو نماند.
حذف افزونه
با غیرفعال کردن، ارسال‌ها متوقف می‌شوند. با حذف، تنظیمات افزونه (از جمله کلید) از وردپرس پاک می‌شود. کلید را در پنل نمو هم باطل کنید.