پاسخ کوتاه: اتصال دیجی‌کالای ابرک با API رسمی فروشندگان موجودی، قیمت، وضعیت باکس خرید و سفارش‌ها را میان دیجی‌کالا و اودو همگام می‌کند. اتصال اسنپ‌فود ابرک در نسخهٔ فعلی اتصال حساب، نگاشت کالا، کلید خاموشی و اعتبار اسنپ‌ساپلای را دارد و ورود سفارش‌هایش هنوز اجرا نمی‌شود. هر دو روی هستهٔ بازارگاه ابرک ساخته شده‌اند.
بیشتر فروشنده‌هایی که دربارهٔ اتصال بازارگاه به نرم‌افزار حسابداری می‌پرسند، یک جواب ساده می‌خواهند: سفارش‌ها خودکار ثبت می‌شود یا نه؟ ما این مقاله را برای همین نوشته‌ایم. برای هر کانکتور می‌گوییم امروز چه کاری از آن برمی‌آید و چه کاری نه.
اتصال دیجی‌کالا به اودو چطور کار می‌کند؟
افزونهٔ abrak_digikala_connector یک اپ کامل با منوی «دیجی‌کالا» است و سه زیرمنو دارد: «تنوع‌ها»، «سفارش‌ها» و «اتصال‌ها». در هر اتصال یک حساب فروشندهٔ دیجی‌کالا با انبار، لیست قیمت و مشتری پیش‌فرض خودش تعریف می‌شود.
کار با دریافت تنوع‌ها شروع می‌شود. هر کالا در دیجی‌کالا یک کد کالا (DKP) دارد و هر تنوعش، مثلاً رنگ یا اندازه، یک کد تنوع (DKPC). کانکتور همهٔ تنوع‌های فروشگاه را با عنوان، وضعیت بررسی و موجودی می‌آورد و هر تنوعی را که «کد فروشنده»اش با کد داخلی یا بارکد یک محصول اودو برابر باشد، خودکار به آن وصل می‌کند.
از آن پس دو زمان‌بند کار را جلو می‌برند. زمان‌بند «دیجی‌کالا: همگام‌سازی تنوع، موجودی و قیمت» هر ۳۰ دقیقه اجرا می‌شود و زمان‌بند «دیجی‌کالا: دریافت سفارش‌ها» هر ده دقیقه.
موجودی
آنچه به دیجی‌کالا می‌رود موجودی آزاد انبار انتخابی منهای «موجودی احتیاطی» است و فقط وقتی تغییر کرده باشد ارسال می‌شود. در فهرست تنوع‌ها سه عدد کنار هم دیده می‌شوند: «موجودی نزد فروشنده»، «موجودی انبار دیجی‌کالا» و «رزروشده». اگر بخشی از کالا را در انبار دیجی‌کالا گذاشته‌اید، این تفکیک نشان می‌دهد چه مقدار دست خودتان است.
قیمت و کف قیمت
ارسال قیمت به‌طور پیش‌فرض خاموش است و این انتخاب عمدی است. وقتی روشنش کنید، قیمت اودو یا لیست قیمت دیجی‌کالا فقط برای تنوع‌هایی ارسال می‌شود که «کف قیمت (ریال)» دارند. هر قیمتی پایین‌تر از کف رد می‌شود. یعنی اگر کسی در لیست قیمت یک صفر را جا بیندازد، کالا در دیجی‌کالا ارزان نمی‌شود و «وضعیت ارسال» آن تنوع «خطا» می‌شود تا کسی آن را ببیند.
باکس خرید
در دیجی‌کالا چند فروشنده می‌توانند یک کالا را بفروشند و فقط یکی در باکس خرید صفحهٔ کالا می‌نشیند. کانکتور برای هر تنوع «برندهٔ باکس خرید»، «قیمت باکس خرید (ریال)» و «فاصله تا باکس خرید (ریال)» را ثبت می‌کند. روی فرم اتصال، شمارندهٔ «بیرون از باکس خرید» نشان می‌دهد چند تنوع از باکس بیرون افتاده‌اند. کانکتور قیمت را برای بردن باکس خودکار پایین نمی‌آورد؛ تصمیم قیمت با شماست و کف قیمت مرز آن است.
سفارش‌ها
سفارش‌های عادی و «ارسال توسط فروشنده» به سفارش فروش بومی اودو تبدیل می‌شوند و هر سفارش دیجی‌کالا فقط یک بار وارد می‌شود. اگر نشانی وب‌هوک را ثبت کنید، سفارش تازه بی انتظار برای نوبت ده دقیقه‌ای می‌رسد. وب‌هوک فقط دریافت را بیدار می‌کند و جزئیات سفارش همیشه از خود API خوانده می‌شود، پس پیام جعلی نمی‌تواند سفارش ساختگی بسازد. مالیات سطرها از تنظیم مالیات محصول در اودو می‌آید.
اگر دیجی‌کالا توکن API نداده باشد چه کنیم؟
فیلد «روش اتصال» دو گزینه دارد. «API رسمی (توکن)» پایدارتر است و وب‌هوک دارد. توکن را در پنل فروشندگان دیجی‌کالا، بخش API حساب کاربری می‌سازید.
اگر این بخش برای حساب شما باز نیست، «پنل فروشندگان (بدون API)» با کوکی نشست خودتان کار می‌کند. کالا، قیمت، موجودی و سفارش با همان منطق همگام می‌شوند، ولی وب‌هوک ندارد. این روش در آغاز فقط می‌خواند: کلید «اجازهٔ نوشتن از راه پنل» خاموش است تا خودتان آن را روشن کنید. هر زمان توکن گرفتید، روش اتصال را عوض می‌کنید و چیزی از نو ساخته نمی‌شود.
اتصال اسنپ‌فود به اودو امروز چه می‌کند؟
افزونهٔ abrak_snappfood_connector منوی «اسنپ‌فود» با دو زیرمنوی «اتصال‌ها» و «گزارش درخواست‌ها» دارد. فیلد «کانال» سه گزینه دارد: «اسنپ‌فود (رستوران)»، «اسنپ‌مارکت» و «دخل». نسخهٔ فعلی فاز صفر است و این کارها را انجام می‌دهد:
- اتصال حساب فروشنده با «شناسهٔ فروشگاه در اسنپ‌فود» و دکمهٔ «آزمون اتصال» که فهرست فروشگاه‌های حساب را می‌خواند.
- کلید «اتصال روشن» که وقتی خاموش باشد، هیچ درخواستی به اسنپ‌فود نمی‌رود.
- زبانهٔ «نگاشت کالاها» که هر کالای اسنپ‌فود را به یک محصول اودو وصل می‌کند.
- دکمهٔ «به‌روزرسانی اسنپ‌ساپلای» که «اعتبار اسنپ‌ساپلای (تومان)» و «کیف پول اسنپ‌فود در ساپلای (تومان)» را فقط‌خواندنی می‌آورد.
- ثبت هر درخواست در لاگ مشترک بازارگاه، بی نشانی کامل، بدنهٔ پیام یا توکن.
دریافت خودکار سفارش و ارسال خودکار موجودی و قیمت در این نسخه اجرا نمی‌شود. کلیدهای «ارسال موجودی» و «ارسال قیمت» در هر ردیف نگاشت برای آن مرحله آماده‌اند. پس اگر رستوران دارید، امروز می‌توانید منوی اسنپ‌فود را با محصولات اودو جفت کنید و اعتبار ساپلای را در یک جا ببینید، ولی سفارش‌ها هنوز در پنل اسنپ‌فود مدیریت می‌شوند.
یک مراقبت دیگر هم هست. کلاینت ابرک روی میزبان اسنپ‌ساپلای فقط درخواست خواندن می‌فرستد و هر درخواست خرید را رد می‌کند. اگر پایگاه داده برای آزمایش کپی شود، همهٔ توکن‌های اسنپ‌فود در نسخهٔ کپی پاک می‌شوند تا آزمایش هرگز به حساب واقعی نرسد.
دو کانکتور در یک نگاه
| قابلیت | اتصال دیجی‌کالا | اتصال اسنپ‌فود (نسخهٔ فعلی) |
|---|---|---|
| نگاشت کالا به محصول اودو | دارد، خودکار با کد داخلی و بارکد | دارد، در زبانهٔ «نگاشت کالاها» |
| ارسال موجودی | هر ۳۰ دقیقه | در این نسخه نه |
| ارسال قیمت | اختیاری، با کف قیمت | در این نسخه نه |
| ورود سفارش | هر ده دقیقه و با وب‌هوک | در این نسخه نه |
| داده‌های ویژه | باکس خرید و فاصلهٔ قیمت | اعتبار اسنپ‌ساپلای |
| کلید خاموشی | بایگانی اتصال | کلید «اتصال روشن» |
اگر هم در دیجی‌کالا می‌فروشیم و هم در اسنپ‌فود، از کدام شروع کنیم؟
از دیجی‌کالا. دلیلش ساده است: کانکتور دیجی‌کالا امروز موجودی و سفارش را کامل همگام می‌کند و بیشترین کار دستی را برمی‌دارد. هم‌زمان می‌توانید اتصال اسنپ‌فود را بسازید و نگاشت کالاها را کامل کنید. چون هر دو کانکتور روی یک هسته‌اند، هر محصولی که یک بار کد داخلی درست گرفته باشد، در هر دو نگاشت به کار می‌آید.
یک نکته برای فروشگاه‌هایی که یک کالا را در هر دو سکو دارند: اسنپ‌فود در نسخهٔ فعلی موجودی را خودکار کم یا زیاد نمی‌کند. پس فروش اسنپ‌مارکت هنوز باید با دست در اودو ثبت شود تا موجودی آزادی که به دیجی‌کالا می‌رود درست بماند. اگر این کار را نکنید، موجودی احتیاطی را برای آن کالاها بالاتر بگذارید.
امنیت کلیدها در هر دو کانکتور
توکن دیجی‌کالا و راز وب‌هوک را فقط گروه «مدیر دیجی‌کالا» می‌بیند. توکن‌های اسنپ‌فود و اسنپ‌ساپلای هم فقط برای گروه «مدیر اسنپ‌فود» باز است و با کپی رکورد کپی نمی‌شوند. هر دو کانکتور از کلاینت پایهٔ هستهٔ بازارگاه استفاده می‌کنند که فقط به https و میزبان ثابت درخواست می‌فرستد و ریدایرکت را دنبال نمی‌کند.
هزینهٔ اتصال دیجی‌کالا و اسنپ‌فود چقدر است؟
هر کانکتور ۲۵۰٬۰۰۰ تومان (۲٬۵۰۰٬۰۰۰ ریال) به ازای هر کاربر در ماه است و پلن سازمانی ۲٬۵۰۰٬۰۰۰ تومان (۲۵٬۰۰۰٬۰۰۰ ریال) به ازای هر کاربر. جزئیات در صفحهٔ قیمت آمده است.
برای راه‌اندازی، آموزش اتصال دیجی‌کالا و اسنپ‌فود به ابرک را دنبال کنید. منطق مشترک دو کانکتور در مقالهٔ فروش هم‌زمان در چند بازارگاه آمده است و صفحه‌های اتصال دیجی‌کالا و اتصال اسنپ‌فود خلاصهٔ هر کدام را دارند.
پرسش‌های پرتکرار
اتصال دیجی‌کالا قیمت را برای بردن باکس خرید خودکار تغییر می‌دهد؟
خیر. وضعیت و فاصله تا باکس خرید را نشان می‌دهد و تصمیم قیمت با شماست.
سفارش‌های اسنپ‌فود وارد اودو می‌شوند؟
در نسخهٔ فعلی نه. این نسخه اتصال، نگاشت کالا و اسنپ‌ساپلای را دارد.
بدون توکن API می‌توانم به دیجی‌کالا وصل شوم؟
بله، با روش «پنل فروشندگان (بدون API)» و کوکی نشست خودتان، بی وب‌هوک.
کالاهای انبار دیجی‌کالا موجودی مرا دو بار کم نمی‌کنند؟
اگر «تأیید خودکار سفارش» را برای آن اتصال خاموش بگذارید، نه.