=== همگام‌سازی جت انبار ===
Contributors: jetanbar
Tags: woocommerce, inventory, sync, stock, jetanbar, انبار
Requires at least: 6.0
Tested up to: 6.6
Requires PHP: 7.4
WC requires at least: 7.0
WC tested up to: 9.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

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

== Description ==

جت انبار یک سامانه چندفروشگاهی مدیریت انبار و فروشگاه (POS) است. این افزونه به صاحب فروشگاه اجازه می‌دهد وب‌سایت شخصی ووکامرس خود را به انبار جت انبار متصل کند تا وب‌سایت همیشه موجودی و قیمت زنده‌ی انبار را نشان دهد و هر فروش در وب‌سایت به‌صورت خودکار موجودی جت انبار را کاهش دهد.

**نحوه‌ی کار**

۱. کلید API فروشگاه خود در جت انبار (با `sk_live_` شروع می‌شود) را در صفحه‌ی *ووکامرس → همگام‌سازی جت انبار* وارد کنید.
۲. در صفحه‌ی هر محصول ووکامرس، از بخش «همگام‌سازی جت انبار» محصول را جست‌وجو کرده و به یک محصول جت انبار (`PRD-XXXXXX`) پیوند بزنید.
۳. برای هر محصول، «همگام‌سازی قیمت فروش» و/یا «همگام‌سازی تعداد (موجودی)» را فعال کنید.
۴. هر یک دقیقه (قابل تنظیم)، افزونه محصولات پیوندخورده را در یک درخواست دسته‌ای از جت انبار دریافت کرده و قیمت/موجودی ووکامرس را به‌روز می‌کند.
۵. هنگامی که یک سفارش به وضعیت انتخاب‌شده (مثلاً *تکمیل شده*) برسد، افزونه برای هر محصول پیوندخورده‌ی فروخته‌شده یک تراکنش خروجی (`/transactions/out`) در جت انبار ثبت می‌کند.

**واحد پول**

قیمت‌ها در جت انبار همواره به **تومان** هستند. کافی است واحد پول وب‌سایت خود را انتخاب کنید:

* **تومان**
* **ریال** (تبدیل به‌صورت خودکار: تومان × ۱۰ = ریال)

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

**نکات و محدودیت‌ها**

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

== Installation ==

۱. پوشه‌ی `jetanbar-woocommerce` را در `/wp-content/plugins/` آپلود کنید (یا فایل ZIP را از *افزونه‌ها → افزودن → بارگذاری افزونه* وارد کنید).
۲. **همگام‌سازی جت انبار** را از منوی *افزونه‌ها* فعال کنید.
۳. مطمئن شوید ووکامرس فعال است.
۴. به *ووکامرس → همگام‌سازی جت انبار* بروید و کلید API (از جت انبار → تنظیمات) را وارد کنید.
۵. واحد پول وب‌سایت (تومان یا ریال) را انتخاب کرده و وضعیت‌های سفارشی که باید ثبت فروش را شروع کنند، مشخص کنید.
۶. یک محصول ووکامرس را باز کرده و آن را از بخش «همگام‌سازی جت انبار» به یک محصول جت انبار پیوند بزنید.

== Frequently Asked Questions ==

= کلید API را از کجا بیاورم؟ =

در داشبورد جت انبار، به تنظیمات فروشگاه بروید و کلید API را (دوباره) بسازید. این کلید چیزی شبیه `sk_live_...` است و آن را در تنظیمات افزونه وارد می‌کنید.

= همگام‌سازی هر چند وقت یک‌بار اجرا می‌شود؟ =

پیش‌فرض هر ۱ دقیقه است. می‌توانید آن را به ۲، ۵ یا ۱۰ دقیقه تغییر دهید. همچنین با دکمه‌ی «همگام‌سازی اکنون» می‌توانید یک‌بار به‌صورت دستی اجرا کنید.

= وقتی موجودی ۰ یا منفی باشد چه اتفاقی می‌افتد؟ =

افزونه تعداد موجودی ووکامرس را ۰ قرار داده و محصول را «ناموجود» نشان می‌دهد.

= آیا ذخیره‌ی مجدد سفارش، تراکنش تکراری می‌سازد؟ =

خیر. هر آیتمی که ارسال شده، در سفارش ثبت می‌شود و ذخیره‌ی مجدد یا تغییر وضعیت، آن را دوباره ارسال نمی‌کند.

= آیا با متغیرهای محصول کار می‌کند؟ =

پیوند در حال حاضر در سطح محصول (اصلی) انجام می‌شود. پیوند در سطح متغیر برای نسخه‌های بعدی برنامه‌ریزی شده است.

== Changelog ==

= 1.0.0 =
* انتشار اولیه.
* صفحه‌ی تنظیمات شامل کلید API، آدرس سرور، واحد پول (تومان/ریال)، بازه‌ی همگام‌سازی و وضعیت‌های سفارش.
* متاباکس هر محصول با جست‌وجوی AJAX برای پیوند محصول ووکامرس به محصول جت انبار.
* فعال/غیرفعال کردن همگام‌سازی قیمت و موجودی برای هر محصول.
* همگام‌سازی دسته‌ای با WP-Cron هر ۱ دقیقه (قابل تنظیم).
* ارسال فروش به `transactions/out` جت انبار با جلوگیری از ثبت تکراری و یادداشت فارسی سفارش.
* نمایش گزارش رویدادها.
