کانکتور ترب و اودو
فید خودکار محصولات به بزرگترین موتور مقایسهقیمت ایران
کاتالوگ اودو (Odoo) شما را بدون فید دستی یا اکسل روی ترب نمایش دهید: قیمت، موجودی و تصویر همیشه بهروز، امن با JWT. سازگار با اودو ۱۴ تا ۱۹.
چرا محصولات اودو را به ترب وصل کنیم؟
ترب روزانه میلیونها ایرانی را هنگام خرید به فروشگاهها هدایت میکند. اما اگر کاتالوگ شما در اودو مدیریت میشود، بهروز نگهداشتن دستی قیمت و موجودی روی ترب فرسایشی و پرخطاست: قیمت عوض میشود ولی روی ترب قدیمی میماند، محصول ناموجود همچنان «موجود» نمایش داده میشود.
کانکتور ابرک این شکاف را میبندد. ترب بهصورت دورهای و امن، فید محصولات را مستقیم از اودوی شما میخواند؛ هر تغییر قیمت یا موجودی خودکار روی ترب بازتاب مییابد. یک منبع حقیقت، نمایش همیشهدرست. پیادهسازی این کانکتور را با فید زندهی محصولات واقعی روی نصب Odoo 19 خودمان آزمایش و تأیید کردهایم.
چه چیزهایی به ترب فرستاده میشوند؟
- عنوان و مشخصات: نام محصول، دستهبندی و مشخصات فنی از ویژگیهای محصول اودو.
- قیمت به تومان: قیمت فروش از لیستقیمت انتخابی؛ قیمت ریالی اودو خودکار به تومان تبدیل میشود.
- موجودی: وضعیت موجود/ناموجود بر اساس موجودی انبار یا قابلیت فروش، قابلتنظیم.
- تصاویر: تصویر اصلی و گالری محصول با نشانی مطلق و عمومی.
- شناسهی پایدار: هر محصول (و هر متغیر رنگ/سایز) یک شناسهی یکتای ثابت دارد.
راهاندازی در ۴ گام
- فعالسازی اپ روی اودو: اپ «کانکتور ترب» را از فروشگاه اپ ابرک فعال کنید؛ منوی ترب در نوار اصلی ظاهر میشود.
- ساخت اتصال: در منوی «ترب ▸ اتصالها» یک رکورد بسازید: نام میزبان API، لیستقیمت، منبع موجودی و انبار را تنظیم کنید. با دکمهی «تست فید» مطمئن شوید محصولات درست آماده میشوند.
- ثبت نقطهی اتصال نزد ترب: نشانی
https://<میزبان>/torob_api/v3/productsرا در پنل فروشندگان ترب یا از طریق پشتیبانی ترب ثبت کنید تا فید شما را بخزد. - اعلان لحظهای و ردیابی سفارش (اختیاری): برای بهروزرسانی سریعتر از خزش دورهای، توکن وبهوک ترب را وارد کنید. برای گزارش فروشهای واردشده از ترب، «ردیابی سفارش» را فعال کنید.
آموزش تصویری — قدمبهقدم
سمت اودو (Odoo)
ثبت نزد ترب
بعد از تست موفق فید، کافی است نشانی endpoint خود را (طبق فرمت https://<میزبان>/torob_api/v3/products) به پنل فروشندگان ترب یا پشتیبانی ترب بدهید. ترب پس از تأیید، فید را بهصورت دورهای میخزد و محصولات شما را نمایش میدهد.
چه چیزی ابرک را از فیدهای دستی متمایز میکند؟
- یک کدپایه برای نسخههای ۱۴ تا ۱۹: با یک ترنسپایلر داخلی، افزونه روی همهی نسخههای اودو نصب میشود.
- احراز هویت امن با JWT: هر درخواست ورودی ترب پیش از هر دسترسی به داده با کلید عمومی رمزنگاریشدهی ترب (ed25519) اعتبارسنجی میشود.
- اعلان لحظهای (Webhook): با افزودن یا تغییر محصول، بلافاصله به ترب اطلاع داده میشود؛ صف تلاشمجدد داخلی، بدون ابزار جانبی.
- ردیابی فروش و کمیسیون: شناسهی کلیک ترب روی سفارش ذخیره میشود تا فروشهای آمده از ترب بهدرستی نسبت داده شوند.
امنیت و پایداری
ارتباط ورودی از ترب با امضای دیجیتال ed25519 محافظت میشود و پیش از هر عملیاتی روی داده اعتبارسنجی میگردد. توکنها و اسرار هرگز در لاگ یا رابط کاربری فاش نمیشوند و همهی داده روی سرور داخل ایران میماند. اگر فروشگاه ووکامرس هم دارید، آموزش کانکتور ووکامرس را ببینید.
راهنماهای مرتبط
اگر کاتالوگ فروشگاه شما در اودو مدیریت میشود، بهروز نگهداشتن دستی قیمت و موجودی روی ترب دیر یا زود خطا میسازد. کانکتور ترب ابرک این فید را خودکار و همیشهدرست میکند.
اگر همزمان فروشگاه ووکامرس و نرمافزار اودو دارید، ورود دستی سفارش و بهروزرسانی دستی موجودی دیر یا زود خطا میسازد. کانکتور ووکامرس ابرک این دو سیستم را زنده و دوطرفه به هم وصل میکند.
اتصال ووکامرس به اودو با کانکتور ابرک بیش از چند دقیقه طول نمیکشد. این راهنما هر گام را از ساخت کلید API تا اولین همگامسازی کامل توضیح میدهد.
پرسشهای پرتکرار دربارهی کانکتور ترب
کانکتور ترب ابرک دقیقاً چهکار میکند؟
کاتالوگ محصولات اودوی شما را بهصورت خودکار در اختیار ترب (torob.com) میگذارد. قیمت، موجودی، تصویر، دستهبندی و مشخصات هر محصول مستقیم از اودو خوانده و به فرمت رسمی ترب تبدیل میشود؛ دیگر نیازی به فید دستی یا اکسل نیست.
آیا ترب مثل ووکامرس یک API دوطرفه دارد؟
خیر. ترب فقط داده را از سایت شما میخواند — یک فید یکطرفه. افزونهی ابرک نقطهی اتصال رسمی و امضاشدهای روی خود اودو میسازد که ترب بهصورت دورهای آن را میخزد. اگر ردیابی سفارش فعال باشد، سفارشهایی که از ترب آمدهاند هم قابلگزارشگیری هستند.
آیا با همهی نسخههای اودو کار میکند؟
بله. کانکتور با یک کدپایهی واحد از اودو ۱۴ تا ۱۹ پشتیبانی میکند — برخلاف رقبا که برای هر نسخه یک بیلد جداگانه و پولی میفروشند.
قیمت روی ترب به چه واحدی نمایش داده میشود؟
ترب همیشه قیمت را به تومان میخواهد. اگر لیستقیمت اودوی شما ریالی است، افزونه بهصورت خودکار قیمت را به تومان تبدیل میکند — نیازی به تنظیم دستی نیست.
امنیت درخواستهای ورودی ترب چطور تأمین میشود؟
هر درخواست ورودی ترب پیش از هر دسترسی به داده، با امضای دیجیتال رمزنگاریشده (الگوریتم ed25519، همان کلید عمومی رسمی ترب) اعتبارسنجی میشود. درخواست بدون امضای معتبر یا با مقصد اشتباه رد میشود.
اگر محصولی ناموجود شود، ترب چطور متوجه میشود؟
وضعیت موجودی هر محصول در لحظهی هر درخواست ترب از اودو خوانده میشود؛ محصول ناموجود با قیمت صفر و وضعیت «ناموجود» فرستاده میشود. با فعالکردن اعلان لحظهای (وبهوک)، تغییرات سریعتر از خزش دورهای هم به ترب اطلاع داده میشود.
قیمت این افزونه چقدر است؟
کانکتور ترب بهصورت اپ مستقل با اشتراک ماهانه ارائه میشود؛ قیمت بهروز در صفحهی قیمتگذاری آمده است.