ARCH_NCاستودیو معماری دیجیتال
فروشگاه اینترنتی

اتصال سایت به نرم‌افزار هلو با وب‌سرویس: راهنمای سایت اختصاصی

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

وب‌سرویس چیست؟

وب‌سرویس راهی است که دو نرم‌افزار بدون دخالت آدم با هم حرف بزنند. یک طرف درخواست می‌فرستد («موجودی کالای ۱۰۲۴ چند است؟») و طرف دیگر جواب ساختاریافته برمی‌گرداند. این گفت‌وگو معمولاً روی اینترنت و با پروتکل HTTPS انجام می‌شود و داده در قالبی مثل JSON یا XML جابه‌جا می‌شود.

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

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

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

  • موجودی یکی می‌شود: کالایی که در مغازه فروخته شد، روی سایت هم کم می‌شود و سفارش کالای تمام‌شده ثبت نمی‌شود.
  • قیمت یک جا عوض می‌شود: قیمت را در هلو تغییر می‌دهید و سایت به‌روز می‌شود.
  • فاکتور دستی حذف می‌شود: سفارش آنلاین با نام و موبایل مشتری مستقیم در هلو ثبت می‌شود.
  • خطای انسانی کم می‌شود: کد کالا و مبلغ دوباره تایپ نمی‌شود.

اتصال سایت اختصاصی به هلو چطور کار می‌کند؟

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

  1. رابط در بک‌اند: یک ماژول در سرور Node.js سایت که با وب‌سرویس هلو حرف می‌زند. رمز و کلید اتصال فقط روی سرور می‌ماند و هیچ‌وقت به مرورگر نمی‌رسد.
  2. همگام‌سازی زمان‌بندی‌شده: هر چند دقیقه کالا، قیمت و موجودی از هلو خوانده و در پایگاه‌داده‌ی سایت ذخیره می‌شود. سایت از داده‌ی خودش خوانده می‌شود، پس اگر هلو لحظه‌ای در دسترس نباشد، سایت نمی‌خوابد.
  3. بررسی دوباره در لحظه‌ی خرید: پیش از نهایی شدن سفارش، موجودی و قیمت یک بار دیگر بررسی می‌شود تا کالای تمام‌شده فروخته نشود.
  4. ارسال فاکتور با صف: سفارش پرداخت‌شده در صف قرار می‌گیرد و به هلو فرستاده می‌شود. اگر ارتباط قطع بود، دوباره تلاش می‌کند و برای هر سفارش فقط یک فاکتور ساخته می‌شود.
  5. گزارش و هشدار: هر خطای اتصال ثبت می‌شود و در صورت نیاز به تلگرام یا بله خبر می‌دهد.
جهتدادهزمان
هلو ← سایتنام کالا، کد، قیمت، موجودی، گروه کالازمان‌بندی‌شده و پیش از پرداخت
سایت ← هلومشتری (نام و موبایل)، سفارش و فاکتور فروشبعد از پرداخت موفق

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

افزونه‌ی آماده یا اتصال اختصاصی؟

برای سایت‌های وردپرسی (ووکامرس) افزونه‌های آماده‌ای مثل «نیلا» هست که سایت را به هلو APEX وصل می‌کنند. اگر فروشگاه شما ووکامرس است و قانون خاصی ندارید، افزونه‌ی آماده راه سریع‌تری است. سایت اختصاصی افزونه‌ی وردپرس را نمی‌پذیرد و رابطش در کد خود سایت نوشته می‌شود؛ در عوض این آزادی را دارد:

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

تفاوت کلی سایت اختصاصی و فروشگاه‌ساز را در سایت اختصاصی چیست و درباره‌ی بک‌اند در بک‌اند Node.js نوشته‌ایم.

پیش‌نیازهای اتصال به هلو

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

اشتباه‌های رایج

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

شروع کار

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

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

پرسش‌های رایج

وب‌سرویس هلو را چه کسی تهیه می‌کند؟

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

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

بسته به تعداد کالا و محدودیت وب‌سرویس، معمولاً هر چند دقیقه، به‌علاوه‌ی یک بررسی دوباره در لحظه‌ی خرید.

اگر اتصال هلو قطع شود سایت از کار می‌افتد؟

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

عکس و توضیح کالا هم از هلو می‌آید؟

معمولاً نه. قیمت و موجودی از هلو می‌آید و عکس و توضیح در پنل مدیریت سایت وارد می‌شود.

سایت وردپرسی را هم وصل می‌کنید؟

برای ووکامرس افزونه‌های آماده هست و معمولاً کافی است. تمرکز ما سایت‌های اختصاصی با بک‌اند Node.js است.

خدمت مرتبط: طراحی سایت فروشگاهی اختصاصی