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