فرض کنید از یک کفش در انبار فقط یک جفت باقی مانده است. فروشنده آن را حضوری میفروشد، اما چون موجودی سایت جداگانه بهروز میشود، چند دقیقه بعد یک مشتری همان کفش را آنلاین میخرد. حالا تیم فروش باید با مشتری تماس بگیرد، سفارش را لغو کند و وجه را برگرداند. اگر قیمتها، سفارشها و اطلاعات مشتریان هم جداگانه نگهداری شوند، این دوبارهکاری در بخشهای دیگر فروشگاه تکرار میشود. ماژول وب سرویس و API آیمیس برای حذف همین دوبارهکاری طراحی شده است؛ در ادامه میبینیم این اتصال چطور کار میکند.
وب سرویس فروشگاه اینترنتی راهی برای تبادل خودکار داده بین سایت و نرمافزار حسابداری یا انبار است. در یک الگوی رایج، اطلاعات پایه کالا، موجودی و قیمت از سیستم مرکزی به سایت میرسد؛ سفارش و دادههای لازم مشتری از سایت به حسابداری ارسال میشود؛ و شماره فاکتور یا نتیجه پردازش، در صورت پشتیبانی اتصال، به سایت برمیگردد. نکته مهم این است که برای هر داده مشخص کنید کدام سیستم مرجع است و اگر انتقال انجام نشد چه اتفاقی میافتد.
وب سرویس فروشگاه اینترنتی چیست و چه فرقی با API دارد؟
وب سرویس واسطی است که دو نرمافزار از طریق شبکه با هم ارتباط برقرار میکنند. برای مثال، سایت میتواند موجودی یک کالا را از سیستم انبار بخواند یا پس از تأیید پرداخت، اطلاعات سفارش را برای حسابداری بفرستد. روز کاری کاربر همان است: مشتری از سایت خرید میکند و تیم مالی در نرمافزار حسابداری کار میکند. چیزی که تغییر میکند، مسیر انتقال اطلاعات بین این دو محیط است. اگر میخواهید مرز دقیق این دو مفهوم را بدانید، مقایسه وب سرویس و API را بخوانید.
وقتی از API فروشگاه اینترنتی حرف میزنیم، منظور رابطی است که مشخص میکند نرمافزار دیگر چه اطلاعاتی را با چه قالبی میتواند بخواند یا ثبت کند. وب سرویس حسابداری هم میتواند امکان خواندن کالا و قیمت یا ثبت مشتری و سند فروش را فراهم کند. وجود API بهتنهایی به معنی یکپارچگی نیست. اتصال باید بداند کد کالای سایت معادل کدام شناسه در حسابداری است، در چه زمانی سفارش را بفرستد و پاسخ ناموفق را چطور پیگیری کند. این کار معمولاً بر عهده افزونه، کانکتور یا یک سرویس واسط است.
چه دادههایی بین سایت و حسابداری جابهجا میشوند؟
جدول زیر یک الگوی رایج را نشان میدهد، نه قاعدهای که برای همه فروشگاهها یکسان باشد. اگر از چند انبار یا چند کانال فروش استفاده میکنید، ممکن است سامانه انبار یا مدیریت سفارش، مرجع موجودی باشد و حسابداری فقط نتیجه مالی را دریافت کند.
| داده | مسیر رایج | تصمیمی که باید بگیرید |
|---|---|---|
| اطلاعات پایه کالا | سیستم مرکزی ← منبع داده؛ سایت ← دریافتکننده | هر کالا و هر تنوع با چه شناسهای تطبیق داده میشود؟ |
| موجودی قابل فروش | انبار یا سیستم مرکزی به سایت | کدام انبارها در فروش آنلاین مشارکت دارند؟ |
| قیمت فروش | مرجع قیمت به سایت | قیمت پایه و تخفیفهای کمپین کجا تعیین میشوند؟ |
| سفارش و اطلاعات لازم مشتری | سایت به حسابداری یا سامانه مدیریت سفارش | انتقال پس از ثبت، پرداخت یا تأیید انجام میشود؟ |
| نتیجه پردازش و شماره فاکتور | حسابداری به سایت، در صورت پشتیبانی | چه اطلاعاتی باید به کارشناس یا مشتری نمایش داده شود؟ |
اصل مفید این است که هر فیلد یک مرجع مشخص داشته باشد. لازم نیست کل اطلاعات کالا از یک سیستم بیاید. میتوان کد و واحد کالا را در حسابداری نگه داشت، اما عنوان نمایشی، تصاویر و توضیحات محصول را در سایت مدیریت کرد. اگر همگامسازی بدون توجه به این تفکیک پیاده شود، یک بهروزرسانی عادی ممکن است توضیحاتی را که تیم محتوا نوشته بازنویسی کند.
اطلاعات کالا چطور به سایت میرسد؟
قبل از همگامسازی، باید مشخص شود هر محصول سایت به کدام قلم در سیستم مرکزی وصل است. این تطبیق معمولاً با کد کالا، SKU یا شناسه ثبتشده در رابط انجام میشود. نام کالا معیار مطمئنی نیست؛ ممکن است در حسابداری کوتاه شده باشد، در سایت تغییر کند یا برای دو کالای مشابه یکسان باشد. در راهاندازی اولیه، بهتر است ابتدا اقلام موجود تطبیق داده شوند و فقط کالاهایی که معادل ندارند با یک قاعده مشخص اضافه شوند؛ در غیر این صورت، محصول تکراری در سایت یا حسابداری شکل میگیرد.
برای کالای دارای تنوع، مثلاً پیراهن آبی سایز متوسط و پیراهن آبی سایز بزرگ، اگر موجودی این دو مستقل است، هر تنوع باید جداگانه قابل شناسایی باشد. واحد شمارش هم مهم است. اگر انبار کالا را بهصورت «عدد» نگه میدارد ولی سایت آن را در بسته ششتایی میفروشد، هفت عدد موجودی معادل یک بسته قابل فروش است، نه هفت بسته. همچنین باید مشخص شود کالای غیرفعال دیگر قابل خرید نباشد یا صفحه آن بهکلی پنهان شود. این تصمیم با حذف سابقه سفارشهای قبلی فرق دارد.
بهروزرسانی خودکار موجودی و قیمت چطور انجام میشود؟

موجودی فیزیکی با موجودی قابل فروش فرق دارد
فرض کنید از یک کالا ۱۲ عدد در انبار دارید، سه عدد برای سفارشهای قطعی رزرو شده و دو عدد هم بهعنوان حاشیه اطمینان کنار گذاشتهاید. در این مثال، موجودی قابل فروش سایت هفت عدد است، نه ۱۲. اگر فروشگاه چند شعبه دارد، ممکن است موجودی شعبهای که امکان ارسال سفارش آنلاین ندارد اصلاً وارد این محاسبه نشود. بنابراین قبل از اتصال، تعیین کنید چه موجودیای باید به مشتری نمایش داده شود، نه اینکه صرفاً عدد موجودی حسابداری را به سایت منتقل کنید.
موجودی میتواند با هر تغییر به سایت اعلام شود یا در بازههای زمانی مشخص خوانده شود. روش اول به پشتیبانی سیستم از اعلان تغییر وابسته است؛ روش دوم معمولاً پیادهسازی سادهتری دارد، اما بین دو بهروزرسانی فاصله میافتد. حتی اتصال سریع هم تضمین نمیکند دو مشتری نتوانند همزمان برای خرید آخرین واحد اقدام کنند. برای کالای کمیاب باید قواعد کنترل یا رزرو موجودی در زمان سفارش و آزادسازی آن در پرداخت ناموفق روشن باشد.
قیمت پایه را از تخفیف سایت جدا کنید
گاهی قیمت پایه در حسابداری تعریف میشود و تخفیف، کد تخفیف یا قیمت ویژه یک کمپین در سایت. در این حالت، بهروزرسانی خودکار موجودی و قیمت نباید با هر تغییر قیمت پایه، تخفیف فعال سایت را حذف کند. اگر قیمت نهایی از یک سیستم مرکزی محاسبه میشود، بهتر است سایت همان مبلغ را طبق قاعده توافقشده نمایش دهد تا تخفیف دوباره اعمال نشود.
در زمان انتقال سفارش، مبلغ همان معامله باید ثبت شود، نه قیمت لحظهای کالا در زمان پردازش. ممکن است مشتری ساعت ده خرید کند و ساعت یازده قیمت تغییر کند؛ اگر سفارش با تأخیر به حسابداری برسد، نباید با قیمت تازه فاکتور شود. یکسان بودن واحد پول، نحوه گرد کردن مبلغ، مالیات و روش ثبت هزینه ارسال را هم قبل از راهاندازی بررسی کنید. تبدیل ریال و تومان نمونهای از جزئیات سادهای است که اگر در طراحی نادیده بماند، اختلاف مبلغ بزرگی ایجاد میکند.
سفارش و اطلاعات مشتری چطور به حسابداری میرسد؟

سفارش در مرحله مناسب ارسال میشود
ثبت سفارش، تأیید پرداخت و صدور فاکتور یک رویداد نیستند. برای پرداخت اینترنتی، معیار انتقال ممکن است تأیید پرداخت توسط درگاه باشد. در پرداخت در محل، شاید تأیید کارشناس فروش یا آمادهسازی سفارش نقطه شروع مناسبتری باشد. اگر فروشگاه ابتدا رزرو یا پیشفاکتور ایجاد میکند، باید مشخص شود چه زمانی سند نهایی ثبت میشود. این انتخاب را با فرایند مالی هماهنگ کنید تا سفارشهای رهاشده یا پرداختنشده ناخواسته به فروش قطعی تبدیل نشوند.
دادههای سفارش معمولاً شامل شناسه یکتای سفارش، اقلام، تعداد، قیمت واحد، تخفیف، مالیات در صورت اعمال، هزینه ارسال و مبلغ نهایی است. ممکن است روش پرداخت و شناسه پیگیری تراکنش هم لازم باشد. وقتی حسابداری درخواست را پذیرفت، کانکتور میتواند شماره سند یا فاکتور را ذخیره کند. اگر پاسخ دریافت نشد، اتصال نباید فرض کند عملیات قطعاً ناموفق بوده است؛ ممکن است سند ثبت شده باشد و فقط پاسخ به سایت نرسیده باشد. ارسال دوباره باید با همان شناسه انجام شود و پیش از ثبت دوباره، وجود سند بررسی شود.
مشتری تطبیق داده میشود، نه اینکه همیشه دوباره ساخته شود
متناسب با تنظیمات، سفارش میتواند به پرونده مشتری موجود متصل شود یا باعث ایجاد پرونده جدید شود. بهتر است برای مشتریان تکراری، رابطه میان شناسه مشتری در سایت و حسابداری ذخیره شود. شماره موبایل یا ایمیل میتواند سرنخ تطبیق باشد، اما شماره ممکن است تغییر کند و چند نفر هم ممکن است از یک شماره استفاده کنند. اگر تطبیق قطعی نیست، بر اساس سیاست فروشگاه بررسی انسانی یا ثبت با شناسهای تازه، از ادغام اشتباه سوابق مطمئنتر است.
همه اطلاعات حساب کاربری لازم نیست به حسابداری منتقل شود. اطلاعات لازم برای صدور سند و انجام سفارش کافی است؛ گذرواژه، دادههای غیرمرتبط حساب و اطلاعات کامل کارت بانکی نباید بخشی از این تبادل باشند. برای کنترل دسترسی، حساب اتصال فقط باید مجوز عملیات ضروری را داشته باشد. همچنین در گزارش خطا بهتر است شناسه سفارش و دلیل خطا نمایش داده شود، نه همه جزئیات شخصی مشتری. اگر میخواهید اطلاعات مشتریان سایت در CRM هم ثبت و پیگیری شود، راهنمای همگامسازی سایت با CRM را ببینید.
صدور خودکار فاکتور فروش در یک مثال واقعینما

تصور کنید مشتری دو عدد از یک محصول را به قیمت واحد ۸۰۰ هزار تومان میخرد، ۱۰۰ هزار تومان تخفیف میگیرد و ۶۰ هزار تومان هزینه ارسال میپردازد. با فرض اینکه مالیات جداگانهای به این مثال اضافه نمیشود، مبلغ پرداختی ۱ میلیون و ۵۶۰ هزار تومان است. مسیر پردازش میتواند به این شکل باشد:
- سایت پرداخت را تأیید میکند و سفارش را با شناسه یکتا در صف ارسال قرار میدهد.
- کانکتور محصول و مشتری را با شناسههای متناظر حسابداری تطبیق میدهد و مبلغ ثبتشده سفارش را میفرستد.
- حسابداری طبق تنظیمات، فاکتور فروش را ثبت میکند و شماره سند را برمیگرداند.
- سایت شماره سند را کنار سفارش نگه میدارد؛ اگر پردازش ناموفق باشد، کارشناس سفارش را در گزارش خطا میبیند و پس از رفع علت، همان سفارش را دوباره ارسال میکند.
صدور خودکار فاکتور فروش به معنی خودکار شدن همه وظایف مالیاتی نیست. صدور سند در نرمافزار حسابداری، نمایش رسید در سایت و ارسال صورتحساب الکترونیکی به سامانههای قانونی میتوانند مسیرهای جداگانهای داشته باشند. قبل از راهاندازی، مشخص کنید خروجی اتصال دقیقاً کدام سند است. همینطور برای لغو سفارش، مرجوعی جزئی و استرداد وجه از قبل تعیین کنید که چه سندی صادر شود و چه زمانی موجودی به فروش برگردد. استرداد پول بهتنهایی به این معنی نیست که کالا به انبار برگشته و دوباره قابل فروش است.
هنگام انتخاب نرم افزار حسابداری با قابلیت اتصال به سایت چه بپرسیم؟
بهجای اینکه فقط بپرسید «آیا به فروشگاه اینترنتی وصل میشود؟»، از ارائهدهنده بخواهید مسیر یک سفارش را با نسخه و امکاناتی که واقعاً در اختیار دارید نشان دهد. وب سرویس فروشگاه اینترنتی سپیدار میتواند یکی از گزینههای بررسی برای کسبوکاری باشد که حسابداریاش را در سپیدار انجام میدهد، اما دامنه اتصال به نسخه، نوع رابط و امکانات کانکتور بستگی دارد. برای مقایسه این گزینه با هلو، راهنمای وب سرویس سپیدار و وب سرویس هلو نقطه شروع مناسبتری است. در این مرحله، معیار اصلی این است که اتصال انتخابی بتواند فرایند واقعی فروشگاه شما را پوشش دهد.
جدول زیر معیارهایی را جمعبندی میکند که هنگام مقایسه گزینهها ارزش بررسی دارند.
| ویژگی کلیدی | چرا اهمیت دارد؟ |
|---|---|
| دامنه اتصال و همگامسازی دوطرفه | علاوه بر ارسال قیمت و موجودی به سایت، بررسی کنید سفارش، مشتری، شماره فاکتور و وضعیت ارسال هم قابل تبادل هستند یا فقط سفارش منتقل میشود. |
| کالای دارای تنوع و چند انبار | اگر کالاهایی با تنوع رنگ و سایز یا چند انبار دارید، اتصال باید انتخاب انبار قابل فروش، کد مستقل برای هر تنوع و تبدیل واحد کالا را پشتیبانی کند. |
| استثناهای مالی | تکلیف تخفیف، پرداخت در محل، تغییر سفارش پس از پرداخت و مرجوعی جزئی باید از قبل روشن باشد. |
| مدیریت خطا و صف ارسال (Queue & Log) | اگر اینترنت فروشگاه یا سرور حسابداری موقتاً قطع شود، سفارش نباید گم شود؛ درخواست باید در صف بماند و دوباره ارسال شود و ارسال دوباره نباید فاکتور تکراری ثبت کند. |
| امنیت و احراز هویت | تبادل اطلاعات مالی به ارتباط رمزنگاریشده (HTTPS) و کلیدهای امنیتی (Token یا API Key) با سطح دسترسی مشخص نیاز دارد. |
| مستندات فنی و سازگاری با فروشگاهساز | مستندات روشن و رابطی با استانداردهای رایج مثل RESTful API و JSON، کار تیم فنی سایت را سادهتر میکند. وجود افزونه یا کانکتور آماده برای ووکامرس و فروشگاهسازهای رایج، در کنار امکان اتصال به سایتهای اختصاصی، میتواند راهاندازی را سریعتر کند. |
هزینه و پشتیبانی را هم جداگانه بپرسید: هزینه مجوز، کانکتور، راهاندازی و نگهداری چقدر است و در زمان خطا چه تیمی مسئول پاسخگویی است؟
مراحل راهاندازی وب سرویس فروشگاه اینترنتی

- یکسانسازی کد کالاها (SKU Mapping): پیش از هر اتصال فنی، مطمئن شوید هر کالای سایت کد یکتایی دارد که با کد همان کالا در نرمافزار حسابداری مطابق است. نبود نظم در کدگذاری کالا یکی از دلایل رایج خطا در همگامسازی موجودی است.
- تعریف قواعد مالی و انبارداری: مشخص کنید سفارشهای آنلاین از کدام انبار کسر شوند، حساب درگاه بانکی در کدام سرفصل حسابداری قرار بگیرد، مالیات بر ارزش افزوده و هزینه ارسال در چه ردیفهایی ثبت شوند و تخفیفها در سطر هر کالا محاسبه شوند یا در جمع فاکتور.
- پیکربندی کلیدهای امنیتی و نقاط اتصال: دسترسی API را در سیستم حسابداری ایجاد کنید و آن را در افزونه یا کد ارتباطی سایت وارد کنید. برای تبادل داده از پروتکل امن HTTPS استفاده کنید.
- تست در محیط آزمایشی (Staging): قبل از فعالسازی روی سایت اصلی، چند سفارش آزمایشی با دادههای نمونه ثبت کنید: خرید موفق، خرید ناموفق، سفارش با کد تخفیف، کالای دارای تنوع و یک سفارش مرجوعی. سپس قطع موقت ارتباط و ارسال دوباره همان سفارش را هم امتحان کنید. نتیجه را کنار هم بگذارید: آیا تعداد اقلام، جمع مبالغ، موجودی و شماره سند در دو سیستم مطابق انتظارند؟ اگر پاسخ منفی است، پیش از اضافه کردن همه کالاها یا فعال کردن صدور فاکتور خودکار، قاعده یا تنظیم مربوط را اصلاح کنید.
- پایش لاگها پس از راهاندازی: در هفتههای اول، گزارش خطای وب سرویس را روزانه بررسی کنید تا مغایرتها، مثلاً کالای جدیدی که در سایت بدون کد تعریف شده، زودتر شناسایی و رفع شود.
وب سرویس فروشگاه اینترنتی آیمیس
اگر میخواهید این اتصال را با یک ابزار مشخص راه بیندازید، ماژول وب سرویس و API آیمیس برای همین کار طراحی شده است. این وب سرویس کالا، قیمت، موجودی، سفارش و اطلاعات مشتری را بین فروشگاه اینترنتی و نرمافزار حسابداری جابهجا میکند. برای حسابداریهای هلو، سپیدار، محک و حسابفا اتصال آماده دارد و با نرمافزارهای دیگری که از وب سرویس پشتیبانی کنند هم اتصال قابل بررسی است. فرقی نمیکند فروشگاه شما روی ووکامرس باشد، سایت اختصاصی داشته باشید یا آن را با فروشگاهساز آیمیس ساخته باشید. اگر هنوز بین اتصال مستقیم و استفاده از یک سامانه یکپارچه فروشگاهی تصمیم نگرفتهاید، مقایسه نرمافزارهای جدا و سیستم یکپارچه تفاوت این رویکردها را توضیح میدهد.
تصمیمهایی که در این مقاله مرور کردیم، در روند راهاندازی آیمیس هم دیده میشوند: ابتدا مشخص میشود چه دادههایی و در چه جهتی منتقل شوند، سپس کد کالا در حسابداری با شناسه محصول در سایت تطبیق داده میشود و پیش از راهاندازی، چند سفارش آزمایشی در هر دو سیستم بررسی میشود. درخواستها از بستر HTTPS و با احراز هویت توکنمحور انجام میشوند و هر درخواست در لاگ سیستم ثبت میشود. اتصال به روشهای پرداختی مثل اسنپ پی و تارا و سامانه ارسال تاپین هم از همین لایه انجام میشود.
برای اینکه بدانید فروشگاه و حسابداری شما چطور به هم وصل میشوند، فرم مشاوره رایگان را در صفحه وب سرویس آیمیس پر کنید یا با شماره ۰۲۱-۹۱۳۰۰۸۰۹ تماس بگیرید تا کارشناسان آیمیس نیاز شما را بررسی کنند و دموی اختصاصی ارائه دهند.
پرسشهای متداول
آیا وب سرویس فروشگاه اینترنتی همیشه در لحظه کار میکند؟
خیر. بعضی اتصالها تغییرات را با اعلان دریافت میکنند و بعضی در بازههای مشخص داده را میخوانند. حتی در حالت اول، قطعی شبکه یا صف پردازش میتواند انتقال را عقب بیندازد. اگر سرعت فروش بالاست، از ارائهدهنده بپرسید فاصله معمول ثبت تغییر تا نمایش در سایت چقدر است و برای آخرین واحد موجودی چه کنترلی دارد.
اگر ارتباط سایت و حسابداری قطع شود، سفارش از دست میرود؟
در یک اتصال درست، سفارش باید در سایت باقی بماند و انتقال ناموفق بهصورت جداگانه در صف یا گزارش خطا ثبت شود. بعد از وصل شدن ارتباط، سفارش با همان شناسه پیگیری و ارسال میشود. سیاست فروش در زمان قطعی هم مهم است: برای کالایی که موجودی آن نامطمئن است، میتوان فروش را محدود کرد تا احتمال سفارش بیش از موجودی پایین بیاید.
آیا برای شروع باید همه اطلاعات را دوطرفه همگام کرد؟
نه. میتوان از ارسال سفارشهای قطعی به حسابداری یا انتشار موجودی قابل فروش در سایت شروع کرد و پس از کنترل نتیجه، قیمت، مشتری و بازگشت شماره فاکتور را اضافه کرد. همگامسازی دوطرفه برای هر فیلد ضروری نیست؛ حتی ممکن است باعث بازنویسی مقدار درست شود. مسیر انتقال را بر اساس محل ثبت و مسئول نگهداری آن داده تعیین کنید.
آیا اتصال سایت به حسابداری سرعت سایت را کم میکند؟
معمولاً نه، به شرط اینکه تبادل داده در پسزمینه انجام شود. وقتی ارسال سفارش و دریافت موجودی در یک صف و جدا از بارگذاری صفحه پردازش شود، مشتری منتظر پاسخ حسابداری نمیماند و این اتصال نباید روی سرعت باز شدن صفحات اثر محسوسی بگذارد. اما اگر سایت برای نمایش صفحه یا تکمیل خرید مستقیماً منتظر پاسخ حسابداری بماند، کندی یا قطعی حسابداری میتواند به سایت هم منتقل شود. پیش از راهاندازی، از ارائهدهنده بپرسید همگامسازی بهصورت غیرهمزمان و در پسزمینه انجام میشود یا نه.
جمعبندی
ارزش وب سرویس فروشگاه اینترنتی فقط در حذف ورود دستی نیست؛ مهمتر این است که فروشگاه کالایی را نمایش دهد که واقعاً قابل فروش است و سند مالی نیز مطابق همان خرید ثبت شود. پیش از انتخاب ابزار، چهار مرجع را روی کاغذ مشخص کنید: مرجع کالا و قیمت، مرجع موجودی قابل فروش، زمان انتقال سفارش و محل صدور فاکتور. سپس یک سفارش را از ثبت تا صدور فاکتور، و یک سفارش دیگر را تا لغو یا مرجوعی آزمایش کنید. اگر هر مرحله قابل پیگیری و نتیجه آن قابل تطبیق باشد، اتصال برای استفاده روزمره آمادهتر است.
