اتصال حسابداری به سایت: راهنمای تصویری گام‌به‌گام

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

پنج گام دارد و اگر دستتان به پیشخوان وردپرس برسد، کمتر از ده دقیقه طول می‌کشد.

پیش از شروع، دو چیز را چک کنید

یک: سایتتان HTTPS باشد. ووکامرس روی HTTP کلید API نمی‌سازد، و اگر هم بسازد، فرستادن کلید روی اتصال رمزنگاری‌نشده کار درستی نیست.

دو: دسترسی مدیر داشته باشید. ساخت کلید فقط از حساب مدیر وردپرس ممکن است.

گام ۱: کلید را در ووکامرس بسازید

در پیشخوان وردپرس، این مسیر را بروید:

روی افزودن کلید بزنید و سه فیلد را پر کنید:

چرا «خواندن و نوشتن»؟ چون اتصال دوطرفه است. با «خواندن» سفارش‌ها می‌آیند ولی موجودی به سایت برنمی‌گردد، و همان چیزی می‌شود که نمی‌خواستید: کالایی که در مغازه فروخته‌اید، در سایت هنوز موجود است.

گام ۲: کلید را همان لحظه کپی کنید

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

این تصویر شوخی نیست: پرتکرارترین دلیلی که یک اتصال هیچ‌وقت کار نمی‌کند، همین است — نام کاربری و رمز ورود وردپرس به‌جای کلید API. حالا فرم اتصال جلوی این را می‌گیرد و می‌گوید چه چیزی غلط است، ولی بهتر است از اول درست وارد شود.

و یک نکتهٔ ریز که وقت زیادی می‌گیرد: موقع کپی، فاصلهٔ اضافه نگیرید. کلیدی که آخرش یک فاصله دارد، از ظاهرش هیچ فرقی ندارد و فروشگاه ردش می‌کند.

گام ۳: در حساب‌شاپ وارد کنید

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

اگر تست موفق بود، ذخیره کنید. اگر نه، حساب‌شاپ نمی‌گوید فقط «ناموفق»؛ می‌گوید دقیقاً چه چیزی غلط است و چه کنید: آدرس پیدا نمی‌شود، سایت کند است، گواهی SSL مشکل دارد، کلید رد شده، افزونهٔ امنیتی جلوی درخواست را گرفته، یا «پیوندهای یکتا» روی حالت ساده است. تا مشکل حل نشود فروشگاه ذخیره نمی‌شود، پس هیچ‌وقت با اتصالی که کار نمی‌کند شروع نمی‌کنید.

گام ۴: واحد پول را جدی بگیرید

این تنها گامی است که اشتباهش گران تمام می‌شود.

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

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

گام ۵: کالاها را وارد کنید، بعد سفارش‌ها را روشن کنید

اول کالاها. پیش از واردکردن، گزارشی می‌بینید که می‌گوید دقیقاً چه چیزی وارد خواهد شد. بخوانیدش.

بعد سفارش‌ها. تعیین کنید سفارش‌ها از چه تاریخی بیایند. اگر سایت شما سه سال سابقه دارد، وارد کردن همه‌شان نه لازم است نه مفید؛ از امروز یا از اول ماه شروع کنید.

از این به بعد هر پانزده دقیقه سفارش‌های تازه خوانده می‌شوند، و وب‌هوک سفارش را همان لحظه می‌فرستد. اگر سایت اجازهٔ ثبت وب‌هوک نداد (معمولاً به‌خاطر کلیدِ «فقط خواندن»)، در «پیام‌های فروشگاه» می‌بینید که سفارش‌ها با تأخیر می‌آیند و چه کنید.

هفت خطایی که بیشترین وقت را می‌گیرد

«سایت کلید API را نپذیرفت.» یا کلید نیست (نام کاربری وردپرس است)، یا فاصلهٔ اضافه دارد، یا در ووکامرس حذف شده. کلید تازه بسازید و در داشبورد سینک، بخش «کلیدهای اتصال»، جایگزین کنید؛ حساب‌شاپ پیش از ذخیره امتحانش می‌کند.

«افزونهٔ امنیتی سایت جلوی حساب‌شاپ را گرفته.» Wordfence، iThemes یا فایروال میزبان به‌جای جواب API صفحهٔ «دسترسی ممنوع» می‌فرستد. در تنظیمات افزونه، REST API را برای کاربران احرازشده باز کنید یا از میزبانی بخواهید مسیر /wp-json/ را باز بگذارد.

«مسیر ووکامرس در سایت پیدا نشد.» ووکامرس فعال نیست یا «پیوندهای یکتا» روی «ساده» است. در تنظیمات ← پیوندهای یکتا گزینهٔ دیگری انتخاب کنید و ذخیره کنید.

«گواهی امنیتی سایت مشکل دارد.» SSL منقضی شده یا برای این دامنه نیست؛ مرورگر هم هشدار «ناامن» می‌دهد. از میزبانی بخواهید تمدیدش کند.

«ورود کالاها ناتمام ماند.» سایت کند است یا موقتاً در دسترس نیست. دوباره بزنید؛ کالاهای قبلی دوباره ساخته نمی‌شوند.

مبلغ‌ها ده برابر کم یا زیاد. واحد پول. گام ۴ را دوباره بخوانید.

موجودی سایت با انبار نمی‌خواند. شش دلیل رایجش را جدا نوشته‌ایم؛ معمولاً فروش حضوری یا مرجوعی است که به سایت نرسیده.

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

بعدش چه؟

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

سؤال‌های پرتکرار

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

از خود وردپرس: ووکامرس ← تنظیمات ← پیشرفته ← REST API ← افزودن کلید. ما کلید نمی‌دهیم و نمی‌توانیم بدهیم؛ کلید مال سایت شماست.

چرا نام کاربری و رمز وردپرسم کار نمی‌کند؟

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

کلید را گم کردم، چه کنم؟

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

سطح دسترسی «فقط خواندن» بدهم امن‌تر نیست؟

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

چند فروشگاه را می‌شود وصل کرد؟

هر تعداد؛ هر فروشگاه کلید و تنظیمات خودش را دارد و سفارش‌ها با ذکر مبدأ ثبت می‌شوند.

اگر سایتم موقتاً پایین بیاید؟

کار در صف می‌ماند و دوباره تلاش می‌شود. سفارشی که یک بار ثبت شده با تلاش دوباره تکراری نمی‌شود، چون هر سفارش کلید یکتای خودش را دارد.

حتماً باید افزونه نصب کنم؟

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