اتصال سایت فروشگاهی (ووکامرس یا هر سایت دیگر) به حسابداری

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

پیش از شروع

• کد کالا = SKU: کد هر کالا در کاسبار باید همان «شناسه محصول (SKU)» آن در سایت باشد (یا بارکد کالا). کالایی که پیدا نشود ثبت نمی‌شود و سفارش برای بررسی می‌ماند. اگر محصولات را با آوردن محصولات سایت آورده‌اید، SKU خودش کد کالا شده است.
• کالای هزینه‌ی ارسال: یک کالای خدماتی مثل «هزینه ارسال» بسازید؛ هزینه‌ی ارسال و هزینه‌های دیگر سفارش با آن در فاکتور می‌آید.
• حساب دریافت: حساب بانکی یا درگاهی که پول سایت به آن واریز می‌شود در صندوق و بانک تعریف شده باشد.
• برای کم شدن موجودی، تنظیمات انبار انجام شده باشد.

ساختن اتصال

1. ۱از منوی «فروش» به اتصال سایت فروشگاهی بروید و «اتصال تازه» را بزنید.
2. ۲نام، نوع سایت (ووکامرس یا سایت دیگر) و نشانی سایت را بنویسید.
3. ۳«دریافت پول در» را حساب بانک یا درگاه بگذارید (اگر خالی بماند، فاکتور نسیه می‌ماند و مشتری بدهکار می‌شود). انبار را انتخاب کنید یا انبار پیش‌فرض بماند، و «کالای هزینه‌ی ارسال» را انتخاب کنید.
4. ۴«قیمت‌های سایت به» را روی «از روی واحد پول سفارش» بگذارید (تومان و ریال خودش تشخیص داده می‌شود) یا مشخصاً تومان یا ریال را انتخاب کنید.
5. ۵اگر قیمت‌های سایت همان مبلغی است که مشتری می‌پردازد (با مالیات بر ارزش افزوده)، «قیمت‌های سایت با مالیات است» را روشن بگذارید؛ مالیات از داخل قیمت جدا می‌شود و جمع فاکتور همان مبلغ پرداختی است. اگر سایت قیمت بدون مالیات نشان می‌دهد، خاموشش کنید.
6. ۶«ساختن اتصال» را بزنید. کاسبار یک نشانی دریافت سفارش و یک کلید مخفی می‌دهد که هر دو دکمه‌ی کپی دارند.

وصل کردن ووکامرس (بدون افزونه)

1. ۱در پیشخوان وردپرس به «ووکامرس ← پیکربندی ← پیشرفته ← وب‌هوک‌ها» بروید و «افزودن وب‌هوک» را بزنید.
2. ۲نام: کاسبار — وضعیت: فعال — موضوع: «سفارش به‌روزرسانی شد» (Order updated).
3. ۳«نشانی تحویل» را نشانی دریافت سفارش کاسبار و «راز» را کلید مخفی بگذارید. نسخه‌ی API: WP REST API Integration v3. ذخیره کنید.
4. ۴اگر خواستید، یک وب‌هوک دیگر با موضوع «سفارش ایجاد شد» هم بسازید؛ سفارش تکراری دو بار ثبت نمی‌شود.

وصل کردن سایت‌های دیگر (هر زبانی)

برنامه‌نویس سایت بعد از پرداخت موفق، سفارش را به نشانی دریافت سفارش با روش POST و قالب JSON می‌فرستد: شناسه‌ی سفارش (id)، وضعیت (status: paid، pending یا cancelled)، واحد پول (IRR یا IRT)، تاریخ، مشتری (name، mobile، address، postalCode)، ردیف‌ها (sku، name، quantity، price و discount)، هزینه‌ی ارسال (shipping) و جمع (total). سرآیند X-Kasbar-Signature امضای HMAC-SHA256 همان متن با کلید مخفی به صورت hex است. نمونه‌ی کامل JSON و کد PHP در «راهنمای اتصال» همان کارت اتصال هست.

بعد از هر سفارش چه می‌شود

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

سفارش‌هایی که نیاز به بررسی دارند

در سفارش‌های سایت برگه‌ی «نیاز به بررسی» سفارش‌هایی را نشان می‌دهد که ثبت نشدند، با دلیلش: کالایی با آن SKU در کاسبار نیست، هزینه‌ی ارسال هست ولی کالای ارسال انتخاب نشده، موجودی کافی نیست، دوره‌ی مالی بسته است و مانند این‌ها. مشکل را درست کنید (مثلاً کالا را بسازید یا کدش را با SKU یکی کنید) و «دوباره ثبت کن» را بزنید. سفارشی را که نباید ثبت شود (مثلاً سفارش آزمایشی) با «کنار بگذار» ببندید.

موجودی کاسبار روی ووکامرس

1. ۱در وردپرس به «ووکامرس ← پیکربندی ← پیشرفته ← REST API» بروید، «افزودن کلید» را بزنید و دسترسی را «خواندن/نوشتن» بگذارید.
2. ۲در کاسبار «تنظیمات» همان اتصال را باز کنید، «موجودی کاسبار روی سایت هم اعمال شود» را روشن کنید و دو کلید (Consumer key که با ck_ شروع می‌شود و Consumer secret که با cs_ شروع می‌شود) را بنویسید و ذخیره کنید. نشانی سایت باید با https شروع شود.
3. ۳از آن به بعد موجودی هر کالا بعد از هر تغییر (خرید، فروش حضوری، سند انبار) حداکثر تا دو دقیقه روی سایت به‌روز می‌شود. دکمه‌ی «ارسال موجودی الان» روی کارت اتصال هم همین کار را فوراً انجام می‌دهد.

چه چیزهایی جابه‌جا نمی‌شود

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