بهروزرسانی ۸ آبان ۱۴۰۵: خلاصه پاسخ به ابتدای صفحه آمد، راهنماهای تازه مرتبط و سؤالهای جدید اضافه شد و راه گرفتن مشاوره کوتاهتر شد.
ترب برای خیلی از خریدارهای ایرانی نقطه شروع خرید است. اسم کالا را جستوجو میکنند، قیمت فروشگاهها را کنار هم میبینند و روی ارزانترین یا معتبرترین کلیک میکنند. اگر فروشگاه شما آنجا نباشد، یا قیمت و موجودیاش در ترب با سایت یکی نباشد، این خریدار را دست رقیب دادهاید.
در این راهنما توضیح میدهیم اتصال سایت به ترب در عمل یعنی چه، چه شرایطی برای ثبت فروشگاه لازم است، فروشگاهساز و ووکامرس و فروشگاه اختصاصی هر کدام چه راهی دارند، نسخه سوم API ترب چه چیزی از سایت میخواهد، هزینه واقعی این کار (هم هزینه کلیک خود ترب و هم هزینه فنی) چقدر است و چه اشتباههایی باعث میشود محصولات درست نمایش داده نشوند. بخش فنی را طوری نوشتهایم که مدیر فروشگاه هم بفهمد و بتواند آن را دقیق به برنامهنویسش بدهد.
بهروزرسانی ۲۴ مهر ۱۴۰۵: بازه هزینه فنی بدون نام فروشنده، هزینههای پنهان اختلاف قیمت و موجودی، راهنمای خواندن پیشنهاد اتصال به ترب، پرداخت مرحلهای با آزمون پذیرش، جدول علت «ناموجود»، زمانبندی اتصال، عددهای روز نود و مطالب مرتبط اضافه شد.
پاسخ کوتاه:
- برای حضور در بخش خرید اینترنتی ترب، سایت فروشگاهی با دامنه مستقل، امکان سفارش آنلاین و اینماد معتبر لازم است.
- ترب برای فروش کمیسیون نمیگیرد، ولی ورودیهایی که از ترب به سایت شما میآید طبق تعرفه پنل فروشندگان از حساب شارژشده کم میشود.
- ووکامرس افزونه رسمی و رایگان ترب را دارد. بیشتر فروشگاهسازهای ایرانی هم اتصال آماده دارند.
- فروشگاه اختصاصی باید API محصولات را طبق مستند رسمی ترب (Product API v3) پیاده کند: درخواست POST، توکن JWT، قیمت به تومان و صفحههای ۱۰۰تایی.
- هزینه فنی بیشتر به تمیزی داده محصول بستگی دارد تا خود کد. مهمترین نکته بعد از اتصال، یکسان ماندن قیمت و موجودی ترب با سایت است.
- در بازار ۱۴۰۵، ووکامرس با افزونه رسمی اغلب حدود ۱ تا ۱۵ میلیون تومان کار فنی میبرد؛ فروشگاه اختصاصی با داده تمیز معمولاً حدود ۱۰ تا ۷۵ میلیون و با داده نامرتب حدود ۲۰ تا ۱۵۰ میلیون تومان دیده میشود — اینها قیمت پونوکد نیستند و هزینه کلیک خود ترب جداست.
- قسط آخر اتصال را به آزمون پذیرش وصل کنید: چند محصول نمونه در ترب با سایت یکی باشد، شناسه ثابت بماند، خطای توکن و بدنه درست باشد، و لاگ درخواستهای ترب قابل بررسی باشد.
آخرین بازبینی: ۲۴ مهر ۱۴۰۵. منابع: صفحه ثبت فروشگاه و مجله فروشندگان ترب، مستند Product API v3 در مخزن رسمی Torob-Sync در گیتهاب، صفحه افزونه رسمی ترب در مخزن وردپرس.
اتصال سایت به ترب یعنی چه؟
ترب موتور جستوجو و مقایسه قیمت کالاست. برای اینکه محصولات شما را نشان بدهد، باید اطلاعات آنها را از سایت شما بخواند. این کار دو راه دارد:
- خواندن صفحههای سایت: ربات ترب صفحه محصول را باز میکند و قیمت و موجودی را از آن درمیآورد. اگر ساختار صفحه استاندارد نباشد، اطلاعات ممکن است اشتباه یا دیر بهروز شود.
- API محصولات: سایت شما یک آدرس مشخص دارد که ترب از آن فهرست مرتب محصولات را میگیرد. این روش دقیقتر و سریعتر است و بخش اصلی این مقاله درباره آن است.
بعضی راهنماها از «فید XML» هم حرف میزنند. ملاک شما همان چیزی است که پنل فروشندگان ترب و مستند رسمی فعلی از شما میخواهد؛ مستندی که الان در گیتهاب ترب منتشر شده، API نسخه سوم با خروجی JSON است.
قبل از هر کار فنی: شرایط ثبت فروشگاه در ترب
خیلی از فروشگاهها اول برنامهنویس میگیرند و بعد میفهمند ثبتنامشان در ترب رد شده است. ترتیب درست برعکس است. طبق صفحه ثبت فروشگاه ترب و راهنمای مجله فروشندگان، برای بخش خرید اینترنتی اینها لازم است:
| شرط | توضیح | اگر ندارید |
|---|---|---|
| سایت با دامنه مستقل | فروشگاه روی دامنه خودتان باشد، نه صفحه شبکه اجتماعی | اول سایت فروشگاهی لازم دارید |
| اینماد معتبر | اطلاعات سایت باید با اطلاعات ثبتشده در اینماد بخواند | بدون اینماد، بخش خرید اینترنتی فعال نمیشود |
| سفارش آنلاین واقعی | دکمه خرید کار کند و پرداخت تا بازگشت موفق از درگاه انجام شود | درگاه و فرایند خرید را قبل از ثبتنام تست کنید |
| قیمت روشن برای کالای موجود | کالای «موجود» قیمت عددی و بهروز داشته باشد | کالاهای «تماس بگیرید» را از فهرست ترب بیرون نگه دارید |
| رعایت قوانین | کالای غیرمجاز یا مغایر با قوانین ترب و تجارت الکترونیک عرضه نشود | این بخش را با شرایط همکاری ترب چک کنید |
بررسی درخواست در ترب طبق اعلام خودش معمولاً تا حدود ۴۸ ساعت طول میکشد و نتیجه پیامک میشود. بعد از تأیید، اطلاعات پنل، لوگو و شرایط ارسال و مرجوعی را کامل میکنید و حساب را شارژ میکنید. فروشگاههای حضوری بدون سایت هم بخش جداگانهای دارند که فقط قیمت را روی کالای موجود در ترب ثبت میکنند؛ آن مسیر به برنامهنویس نیاز ندارد و موضوع این مقاله نیست.
اگر درگاه شما هنوز پرداختهای ناموفق زیادی دارد، قبل از ترب آن را درست کنید؛ خریدار ترب حوصله تکرار پرداخت ندارد. نکتههای این بخش را در پرداخت ناموفق در فروشگاه اینترنتی نوشتهایم.
فروشگاه شما روی چه بستری است؟
| بستر فروشگاه | راه معمول اتصال | کار فنی | ریسک اصلی |
|---|---|---|---|
| فروشگاهسازهای ایرانی | اتصال آماده در تنظیمات یا از طریق پشتیبانی همان فروشگاهساز | معمولاً فقط تنظیم و بررسی داده | داده نامرتب محصولات و تنوعها |
| ووکامرس (وردپرس) | افزونه رسمی و رایگان ترب | نصب، تنظیم، تست با قالب و افزونههای قیمت | تداخل با افزونههای تخفیف، تنوع و چندقیمتی |
| فروشگاه اختصاصی | پیادهسازی API طبق مستند رسمی ترب | ساخت آدرس API، بررسی توکن، صفحهبندی، تست | نبود شناسه ثابت، قیمت از چند منبع، کوئری سنگین |
| انبار یا ERP بدون سایت فروش | اول باید صفحه محصول عمومی و سفارش آنلاین داشته باشید | ساخت فروشگاه یا اتصال انبار به سایت | ترب به آدرس صفحه محصول و خرید آنلاین نیاز دارد |
اگر هنوز بین ووکامرس و فروشگاه اختصاصی مردد هستید، همین تفاوت یکی از معیارهاست؛ مقایسه کامل را در ووکامرس یا فروشگاه اختصاصی؟ آوردهایم.

ووکامرس: افزونه رسمی ترب و نکتههایش
ترب برای ووکامرس افزونه رسمی منتشر کرده که در مخزن وردپرس با نام Products Extractor for WooCommerce هست و رایگان است. طبق صفحه خود افزونه، وردپرس ۵.۹ به بالا و ووکامرس ۶.۹ به بالا لازم دارد و پیوندهای یکتا نباید روی حالت «ساده» باشند. افزونه یک مسیر API در سایت میسازد که ترب از آن محصولات را میخواند و بخشی هم برای وضعیت سفارشها دارد که در تنظیمات افزونه قابل مدیریت است.
رایگان بودن افزونه به معنی بیدردسر بودن کار نیست. چیزهایی که در عمل باید بررسی شود:
- نسخهها: اگر وردپرس یا ووکامرس قدیمی است، اول بهروزرسانی و تست سایت لازم است، نه نصب مستقیم افزونه روی سایت اصلی.
- افزونههای قیمت: افزونههای تخفیف پلکانی، قیمت همکار یا تبدیل ارز ممکن است قیمتی که در صفحه میبینید با قیمتی که در خروجی ترب میرود فرق داشته باشد.
- مالیات: طبق تغییرات اعلامشده افزونه، قیمت خروجی با تنظیمات نمایش مالیات ووکامرس هماهنگ میشود؛ پس این تنظیم را قبل از فعالسازی درست کنید.
- واحد پول: اگر فروشگاه به ریال تنظیم شده، بعد از فعالسازی چند محصول را در ترب با سایت مقایسه کنید.
- کش: افزونههای کش صفحه و کش سرور نباید مسیر API ترب را کش کنند.
- محصولات متغیر: رنگ و سایزهایی که قیمت یا موجودی جدا دارند، باید تنوع واقعی ووکامرس باشند.
همه اینها را اول روی نسخه آزمایشی سایت تست کنید. اگر سایت کند است، ورود خریدار ترب هم هزینه کلیک دارد و هم احتمالاً بینتیجه میماند؛ راههای تشخیص را در سایت کند است نوشتهایم.
فروشگاه اختصاصی: API نسخه سوم ترب چه میخواهد؟
ترب مستند فنی API محصولات (Product API v3) را در مخزن عمومی Torob-Sync در گیتهاب منتشر کرده است. خلاصه آن به زبان ساده:
درخواست
- ترب به آدرسی که شما تعیین میکنید (مثلاً
/torob_api/v3/products) درخواست POST با بدنه JSON میفرستد. - همراه هر درخواست، یک توکن JWT در سرآیند
X-Torob-Tokenو نسخه توکن درX-Torob-Token-Versionمیآید. سایت شما باید امضای توکن را با کلید عمومی ترب بررسی کند و اگر نامعتبر بود، خطای 401 بدهد. - بدنه درخواست یکی از این چهار حالت است: فهرست صفحهبندیشده (
pageوsort)، فهرست با نشانگر (cursor)، چند محصول با آدرس صفحه (page_urls) یا چند محصول با شناسه یکتا (page_uniques). - مرتبسازی بر اساس تاریخ افزودن برای همه فروشگاهها لازم است؛ مرتبسازی بر اساس تاریخ بهروزرسانی برای فروشگاههای بزرگ و فروشگاهسازها.
- مستند تأکید میکند برای پارامترها مقدار پیشفرض نگذارید؛ اگر بدنه خالی یا نامعتبر بود، خطای 400 برگردانید.
پاسخ
| فیلد | معنی | نکته مهم |
|---|---|---|
| page_unique | شناسه یکتای محصول | هرگز نباید عوض شود |
| page_url | آدرس صفحه محصول | حتماً آدرس کامل (مطلق)، نه نسبی |
| title | عنوان محصول | همان عنوان صفحه محصول |
| current_price | قیمت فروش به تومان | عدد صحیح؛ هرگز خالی نباشد؛ برای ناموجود ۰ |
| old_price | قیمت قبل از تخفیف | اختیاری |
| availability | موجود بودن | درست یا نادرست |
| image_links | فهرست تصویرها | اولی تصویر اصلی؛ حداقل ۹۰۰ در ۹۰۰ پیکسل توصیه شده؛ زیر ۶۰۰ نمایش داده نمیشود |
| spec | مشخصات بهصورت کلید و مقدار | اگر مشخصاتی ندارید، شیء خالی بفرستید |
| product_group_id | گروه تنوعها | رنگها و سایزهای یک کالا شناسه گروه یکسان و شناسه یکتای جدا دارند |
| date_added | تاریخ افزودن | با منطقه زمانی، مثلاً +03:30 |
هر صفحه پاسخ، به جز آخری، باید دقیقاً ۱۰۰ محصول داشته باشد و پاسخ شامل api_version با مقدار torob_api_v3، تعداد کل و تعداد صفحهها باشد. محصولی که حذف شده یا نباید در ترب باشد، از فهرست کنار گذاشته میشود. فیلدهای اختیاری دیگری مثل گارانتی، توضیح کوتاه و نام دسته هم وجود دارد. قبل از شروع، نسخه فعلی مستند را از گیتهاب ترب بخوانید؛ این خلاصه جای مستند رسمی را نمیگیرد.
نکتههای پیادهسازی که در مستند کمتر دیده میشود
- کوئری سبک: ترب ممکن است صفحهها را پشت سر هم بخواهد. پاسخ هر صفحه باید با یک کوئری بهینه و ایندکس روی تاریخ افزودن و تاریخ بهروزرسانی ساخته شود، نه با بارگذاری کل محصولات در حافظه.
- قیمت از همان منطق صفحه محصول: قیمت API را با کد جداگانه حساب نکنید. همان تابعی که قیمت نهایی صفحه محصول را میسازد (با تخفیف و مالیات) باید خروجی ترب را هم بسازد.
- کلید عمومی ترب: کلید را در تنظیمات سرور نگه دارید تا اگر نسخه توکن عوض شد، بدون انتشار دوباره کد قابل تغییر باشد.
- لاگ درخواستها: زمان، نوع درخواست، تعداد محصول و کد پاسخ را ثبت کنید. وقتی ترب میگوید «خروجی شما خطا دارد»، همین لاگ زمان رفع مشکل را از چند روز به چند ساعت میرساند.
- محدودیت دسترسی: مسیر API را از فایروال یا محدودیت نرخ عمومی سایت جدا تنظیم کنید که درخواستهای معتبر ترب پشت آن گیر نکند.
اگر میخواهید بدانید اتصالهای API معمولاً چطور قیمتگذاری و تحویل گرفته میشوند، هزینه طراحی API در ۱۴۰۵ را ببینید.

هزینه اتصال به ترب: دو هزینه جدا
وقتی میپرسند «اتصال به ترب چقدر خرج دارد»، معمولاً دو چیز قاطی میشود: هزینهای که به خود ترب میدهید و هزینه فنی آماده کردن سایت. این دو را جدا حساب کنید.
۱. هزینه ورودیها در خود ترب
ترب در صفحه رسمیاش میگوید برای فروش کمیسیون نمیگیرد. در عوض، هر ورودی (سشن) که از ترب به سایت شما میآید طبق تعرفه پنل فروشندگان از حساب شارژشده کم میشود. تعرفه پلهای است و با بیشتر شدن تعداد ورودی روزانه، قیمت هر ورودی بالاتر میرود. ورودی به محصولات ناموجود هم تعرفه جداگانه و کمتری دارد.
جدولی که چند منبع عمومی بازار از تعرفه پنل ترب منتشر کردهاند، از ابتدای آبان ۱۴۰۴ اینطور بوده است. این جدول از منابع منتشرشده است، نه از پونوکد؛ تعرفه روز و نحوه دقیق محاسبه پلهها را حتماً از پنل فروشندگان ترب ببینید.
| تعداد ورودی روزانه (طبق جدول منتشرشده) | هزینه هر ورودی (تومان) |
|---|---|
| ورودی به محصول ناموجود | ۲۵۰ |
| ۱ تا ۵۰ | ۴۵۰ |
| ۵۱ تا ۱۰۰ | ۶۵۰ |
| ۱۰۱ تا ۵۰۰ | ۸۵۰ |
| ۵۰۱ تا ۱٬۰۰۰ | ۱٬۰۵۰ |
| ۱٬۰۰۱ تا ۵٬۰۰۰ | ۱٬۲۵۰ تا ۱٬۵۰۰ |
| ۵٬۰۰۱ به بالا | ۱٬۷۰۰ تا ۲٬۳۰۰ |
یک حساب ساده و فرضی: اگر فروشگاهی روزی ۴۰ ورودی از ترب بگیرد و همه در پله اول حساب شوند، هزینه روزانه حدود ۴۰ ضرب در ۴۵۰ یعنی ۱۸ هزار تومان و ماهانه حدود ۵۴۰ هزار تومان میشود. این عدد فقط برای فهم ترتیب هزینه است. چیزی که اهمیت دارد این است که چند درصد از این ورودیها خرید میکنند؛ ورودی به کالای ناموجود یا صفحه کند، پول را بینتیجه خرج میکند.
۲. هزینه فنی آمادهسازی و اتصال
این هزینه به بستر فروشگاه و وضعیت داده بستگی دارد. جدول زیر بر اساس ساعت کار و نرخهای عمومی بازار ۱۴۰۵ (حدود ۵۰۰ هزار تا ۱٫۸۵ میلیون تومان برای هر ساعت، از فریلنسر باتجربه تا شرکت) محاسبه شده و تخمین تقریبی است، نه قیمت پونوکد:
| وضعیت فروشگاه | ساعت کار تقریبی | محدوده هزینه تقریبی | چه چیزی هزینه را بالا میبرد |
|---|---|---|---|
| فروشگاهساز با اتصال آماده | ۰ تا ۴ ساعت | معمولاً بدون هزینه برنامهنویسی؛ فقط وقت تیم فروشگاه | عنوان و عکس و تنوع نامرتب |
| ووکامرس سالم با افزونه رسمی | ۲ تا ۸ ساعت | حدود ۱ تا ۱۵ میلیون تومان | نسخه قدیمی، افزونههای قیمت و تنوع، کش |
| فروشگاه اختصاصی با داده تمیز | ۲۰ تا ۴۰ ساعت | حدود ۱۰ تا ۷۵ میلیون تومان | نبود ایندکس، نبود شناسه ثابت |
| فروشگاه اختصاصی با داده نامرتب یا قیمت از چند منبع | ۴۰ تا ۸۰ ساعت | حدود ۲۰ تا ۱۵۰ میلیون تومان | تنوعهای تعریفنشده، اتصال انبار یا حسابداری |
این محدودهها با برآوردهای عمومی بازار برای یک اتصال ساده به سرویس بیرونی (حدود ۴۰ تا ۸۰ نفر-ساعت) همخوانی دارد. در پیشنهاد قیمت حتماً بپرسید پاکسازی داده جزو کار هست یا نه، تست بعد از فعالسازی با کیست و اگر ترب مستند را تغییر داد، بهروزرسانی چطور حساب میشود.
هزینههای جانبی را هم فراموش نکنید: اینماد و درگاه اگر هنوز ندارید، عکاسی یا اصلاح عکس محصولات، و نگهداری ماهانه سایت. برای دید کامل هزینه فروشگاه، هزینه فروشگاه اینترنتی در ۱۴۰۵ را بخوانید.
برای مقایسه، نرخنامه رسمی خدمات نرمافزاری (فاوا) برای ۱۴۰۵ پایه ساعتی را برای شرکتها حدود ۵۷۶ هزار تومان و برای افراد حدود ۲۷۱ هزار تومان پیش از ضریبها آورده است. یک اتصال اختصاصی تمیز معمولاً چند ده ساعت کار پیادهسازی، پاکسازی داده و آزمون میخواهد. اگر پیشنهادی خیلی زیر این حساب است، بپرسید پاکسازی داده، تست چند محصول در ترب، لاگ و بهروزرسانی بعد از تغییر مستند در آن هست یا نه.
چرا محصول موجود در ترب «ناموجود» دیده میشود؟
این پرتکرارترین شکایت بعد از اتصال است. قبل از اینکه کل API را بازنویسی کنید، این علتهای رایج را چک کنید:
| علت محتمل | نشانه | کار عملی |
|---|---|---|
| کلمه «ناموجود» در بخش محصولات مرتبط همان صفحه | خود کالا موجود است ولی پایین صفحه برچسب ناموجود دارد | در نوار مرتبط فقط کالاهای موجود را نشان دهید |
| فیلد موجودی اشتباه در خروجی API | همیشه صفر یا خالی برمیگردد | همان منطقی که صفحه محصول برای «موجود» استفاده میکند را به API وصل کنید |
| صفحه فقط با جاوااسکریپت ساخته میشود | ربات HTML خالی یا ناقص میبیند | قیمت و موجودی را در HTML اولیه یا API بگذارید |
| آدرس محصول عوض شده یا فارسی مشکلساز | لینک ترب به خطای ۴۰۴ میرسد | آدرس پایدار انگلیسی و ریدایرکت درست |
| کش طولانی روی مسیر API یا صفحه | موجودی سایت عوض شده، ترب هنوز قدیمی است | مسیر ترب را از کش عمومی خارج کنید |
| تنوع (رنگ/سایز) بدون شناسه درست | یکی موجود و یکی ناموجود قاطی میشود | هر تنوع شناسه ثابت و موجودی جدا داشته باشد |
زمانبندی واقعی از ثبت تا نمایش پایدار
برای کمپین یا فصل فروش، اتصال را دیر شروع نکنید. یک زمانبندی رایج بر اساس اعلام رسمی ترب و تجربه بازار:
| مرحله | معمولاً چقدر طول میکشد | نکته |
|---|---|---|
| اینماد و دامنه مستقل | از چند روز تا چند هفته | موازی با آمادهسازی داده شروع کنید |
| ثبت و بررسی درخواست در ترب | تا حدود ۴۸ ساعت (طبق صفحه رسمی) | نتیجه معمولاً پیامک میشود |
| شارژ حساب و شروع خواندن محصولات | بعد از تأیید و شارژ | بدون شارژ، خواندن شروع نمیشود |
| دستهبندی و ادغام محتوا توسط ترب | بسته به تعداد کالا، تا حدود یک هفته | کالای زیاد = صبر بیشتر |
| پیادهسازی یا نصب افزونه + پاکسازی داده | از چند ساعت تا چند هفته | داده نامرتب معمولاً از کد بیشتر طول میکشد |
| آزمون پذیرش و رفع اختلاف قیمت/موجودی | ۲ تا ۷ روز بعد از نمایش اول | بدون این مرحله، ورودی بینتیجه میخرید |
اگر برای مناسبت خاص برنامه دارید، حداقل دو هفته جلوتر شروع کنید؛ جزئیات ساخت فروشگاه آماده فروش را در ووکامرس یا فروشگاه اختصاصی هم ببینید.
شش اشتباه رایج در اتصال به ترب
- قیمت ریال بهجای تومان: قیمت ده برابر نمایش داده میشود و خریدار رد میشود. مستند صریحاً تومان خواسته است.
- شناسه یکتای متغیر: اگر با هر ویرایش محصول شناسه عوض شود، ترب آن را محصول جدید میبیند.
- آدرس نسبی تصویر یا صفحه: آدرسهایی مثل
/product/12پذیرفته نمیشوند. - تصویر بندانگشتی: استفاده از تصویر کوچک فهرست بهجای تصویر اصلی محصول.
- تنوعها بدون گروه: رنگهای مختلف یک کالا بهعنوان کالاهای جدا و نامرتبط نمایش داده میشوند.
- کش طولانی: سایت قیمت دیروز را به ترب میدهد، در حالی که صفحه محصول قیمت امروز را نشان میدهد.
جدول تست قبل و بعد از فعالسازی
این تستها را برنامهنویس قبل از معرفی آدرس به ترب و یک بار هم بعد از فعالسازی انجام بدهد. نتیجه هر کدام را مکتوب بخواهید:
| تست | نتیجه درست |
|---|---|
| درخواست بدون توکن یا با توکن جعلی | خطای 401 |
| درخواست با بدنه خالی یا پارامتر نامعتبر | خطای 400، نه فهرست پیشفرض |
| صفحه اول با مرتبسازی تاریخ افزودن | دقیقاً ۱۰۰ محصول، با تعداد کل و تعداد صفحه درست |
| صفحه آخر | باقیمانده محصولات، بدون تکرار محصول صفحههای قبل |
| درخواست با چند آدرس صفحه یا شناسه | فقط همان محصولات، با قیمت لحظهای |
| محصول ناموجود | موجودی نادرست و قیمت صفر |
| محصول حذفشده یا پیشنویس | در خروجی نیست |
| محصول با سه رنگ | سه شناسه یکتای جدا با یک شناسه گروه |
| تغییر قیمت در پنل | همان لحظه در خروجی API دیده شود |
| زمان پاسخ صفحهها | سریع و بدون کند شدن بقیه سایت |
هماهنگی قیمت و موجودی؛ مهمتر از خود اتصال
اتصال فنی یک بار انجام میشود، ولی هماهنگی داده هر روز. اگر قیمتها را در اکسل یا نرمافزار حسابداری عوض میکنید و بعد دستی در سایت میزنید، احتمال اختلاف زیاد است. چند راه برای کم کردن این خطا:
- قیمت و موجودی فقط از یک منبع بیاید و سایت و API ترب هر دو از همان بخوانند.
- اگر انبار یا حسابداری دارید، اتصال خودکار آن به سایت را در نظر بگیرید؛ توضیح کامل را در اتصال سایت به نرمافزار حسابداری و یکپارچه سازی API نوشتهایم.
- محصولات ناموجود را با موجودی «نادرست» بفرستید و قیمت را صفر کنید، نه اینکه با قیمت قدیمی موجود نشان بدهید.
- بعد از هر تغییر قیمت گروهی، چند محصول را در ترب جستوجو و با سایت مقایسه کنید.
- اگر همزمان در دیجیکالا یا بازارگاههای دیگر هم میفروشید، موجودی مشترک را از یک جا مدیریت کنید؛ این بخش را در اتصال فروشگاه به دیجیکالا و بازارگاهها باز کردهایم.
چون ترب قیمت رقبا را کنار قیمت شما نشان میدهد، خیلی از فروشگاهها میخواهند تغییر قیمت رقبا را هم دنبال کنند. اگر این کار برایتان زمان زیادی میبرد، ربات پایش قیمت رقبا را ببینید.
داده محصول را قبل از اتصال آماده کنید
بیشتر زمان پروژههای اتصال به ترب، نه صرف نوشتن API، بلکه صرف مرتب کردن داده محصولات میشود. این کارها را میشود قبل از شروع کار برنامهنویس، با تیم فروشگاه انجام داد:
- عنوانها را یکدست کنید: عنوانی که خریدار در ترب جستوجو میکند معمولاً برند، مدل و یک ویژگی اصلی را دارد. عنوانهایی مثل «محصول جدید شماره ۱۲» در مقایسه قیمت گم میشوند.
- عکس اصلی هر محصول را بررسی کنید: زمینه ساده، اندازه کافی و بدون نوشتههای بزرگ تبلیغاتی روی تصویر.
- مشخصات را ساختاریافته کنید: بهجای یک پاراگراف توضیح، ویژگیهایی مثل جنس، ابعاد، ظرفیت و رنگ را جداگانه ثبت کنید.
- تنوعها را درست تعریف کنید: هر رنگ یا سایز که قیمت یا موجودی جدا دارد، باید تنوع جدا باشد، نه یک خط در توضیحات. فروشگاههای پوشاک بیشتر از همه با این مشکل روبهرو میشوند؛ مثالها را در طراحی سایت پوشاک آوردهایم.
- دستهبندی را منطقی کنید: نام دسته در خروجی ترب اختیاری است، ولی دستهبندی تمیز به همه کانالهای فروش کمک میکند.
این کارها فقط برای ترب نیست؛ همین داده تمیز، سئوی صفحه محصول و اتصال به بازارگاههای دیگر را هم سادهتر میکند.
یک مثال: فروشگاه لوازم آشپزخانه با ۲۵۰۰ کالا
یک فروشگاه اختصاصی فرضی با حدود ۲۵۰۰ کالا و تنوع رنگ را در نظر بگیرید. محدوده کار منطقی برای اتصال به ترب این است:
- ساخت آدرس API و بررسی توکن ترب طبق راهنمای توکن.
- پیادهسازی فهرست صفحهبندیشده با مرتبسازی تاریخ افزودن و تاریخ بهروزرسانی (۲۵ صفحه ۱۰۰تایی).
- پاسخ به درخواست تکمحصول با آدرس یا شناسه، برای وقتی که ترب میخواهد یک کالا را سریع بهروز کند.
- گروهبندی تنوع رنگها با شناسه گروه.
- تبدیل مشخصات فنی محصول به کلید و مقدار.
- تست با جدول بالا و بررسی ده محصول نمونه در ترب بعد از فعالسازی.
اگر داده محصولات تمیز باشد، این کار برای برنامهنویسی که با کد فروشگاه آشناست پروژه کوچکی است و در ردیف «داده تمیز» جدول هزینه قرار میگیرد. اگر عکسها کوچکاند، مشخصات بهصورت متن آزاد نوشته شده یا قیمت از چند جا میآید، بیشتر زمان صرف مرتب کردن داده میشود و پروژه به ردیف آخر جدول نزدیکتر میشود.

بعد از اتصال: هر هفته چه چیزی را چک کنیم؟
اتصال که فعال شد، کار تمام نشده است. یک نفر در تیم باید هر هفته این چند مورد را ببیند:
- گزارش ورودیها و هزینه در پنل ترب: کدام محصولات بیشترین ورودی را دارند و کدام فروش ندارند.
- ورودی به کالاهای ناموجود: اگر زیاد است، یا موجودی را زودتر بهروز کنید یا کالا را موقتاً از فهرست بیرون بگذارید.
- مقایسه قیمت ده محصول پرفروش در ترب با سایت.
- لاگ خطاهای مسیر API ترب در سرور.
- نرخ تبدیل خریدارهایی که از ترب آمدهاند در گزارش آمار سایت.
اگر نگهداری سایت را به تیم بیرونی سپردهاید، بررسی خروجی ترب را صریحاً در قرارداد پشتیبانی بنویسید؛ نمونه موارد را در پشتیبانی و نگهداری ماهانه سایت آوردهایم.
ترب، سئو و فروش مستقیم
ترب کانال فروش خوبی است، ولی جای سایت قوی را نمیگیرد. خریداری که از ترب میآید روی صفحه محصول شما فرود میآید؛ اگر صفحه کند باشد، اطلاعات کافی نداشته باشد یا پرداخت دردسر داشته باشد، هم کلیک هدر رفته و هم پولش را دادهاید. صفحه محصول سریع، عکس خوب، هزینه ارسال روشن و درگاه مطمئن، نرخ تبدیل ورودی ترب را بالا میبرد.
یک نکته دیگر: ترب خریدار را با قیمت جذب میکند. اگر همیشه ارزانترین نیستید، در صفحه محصول دلیل خرید از شما را روشن بگویید؛ مثلاً ارسال سریع در شهر خودتان، گارانتی معتبر، امکان مرجوعی یا مشاوره قبل از خرید. همین جزئیات است که خریدار مقایسهگر را به مشتری تکراری تبدیل میکند.
اصول ساخت فروشگاه را در طراحی سایت فروشگاهی آوردهایم.
چکلیست قبل و بعد از اتصال به ترب
- سایت دامنه مستقل، سفارش آنلاین کارکرده و اینماد معتبر دارد.
- فروشگاه در ترب ثبت و تأیید و حساب شارژ شده است.
- هر محصول شناسه ثابت و صفحه عمومی با آدرس کامل دارد.
- قیمتها به تومان و عدد صحیحاند و از همان منطق صفحه محصول میآیند.
- تصویر اصلی هر محصول حداقل ۹۰۰ در ۹۰۰ پیکسل است.
- تنوع رنگ و سایز با شناسه گروه مشخص شده است.
- محصولات حذفشده و پیشنویس از فهرست بیرون میروند.
- درخواست بدون توکن معتبر خطای 401 میگیرد و بدنه نامعتبر خطای 400.
- مسیر API ترب کش نمیشود و پشت فایروال یا محدودیت نرخ عمومی گیر نمیکند.
- لاگ درخواستهای ترب ثبت میشود.
- بعد از فعالسازی، چند محصول در ترب با سایت مقایسه شده است.
- مسئول بررسی هفتگی اختلاف قیمت و هزینه ورودیها مشخص است.
- علتهای رایج «ناموجود» (محصولات مرتبط، فیلد موجودی، کش، آدرس) چک شده است.
- هزینه فنی و بودجه کلیک ترب جدا در بودجه آمده و با بازه بازار مقایسه شده است.
- قسط آخر به آزمون پذیرش (نمونه کالا، توکن، لاگ، همگامی) وصل شده است.
- پایش ماهانه اختلاف قیمت/موجودی در برنامه پشتیبانی گذاشته شده است.
پیشنهاد اتصال به ترب را چطور بخوانید
چند جمله در پیشنهادها زیاد تکرار میشود. معنی عملیشان این است:
| جمله در پیشنهاد | معنی عملی | چه بپرسید |
|---|---|---|
| «فقط افزونه نصب میکنیم» | اگر داده و افزونههای قیمت خراب باشند، کافی نیست | پاکسازی عنوان، عکس، تنوع و تست چند کالا در ترب هست؟ |
| «API را در دو روز میزنیم» | بدون ایندکس و شناسه ثابت، بعداً اختلاف قیمت میماند | شناسه ثابت، صفحهبندی پایدار و لاگ در این زمان هست؟ |
| «تضمین نمایش همه کالاها در ترب» | نمایش نهایی دست تیم محتوا و قوانین ترب هم هست | چه چیزی در کنترل شماست و چه چیزی نه؟ |
| «هزینه ثابت بدون بررسی داده» | احتمال زیاد پاکسازی داده جدا فاکتور میشود | نمونه خروجی API و وضعیت انبار الان دیده شده؟ |
| «پشتیبانی نامحدود بعد از اتصال» | گاهی فقط پاسخ تیکت، نه پایش اختلاف قیمت | بررسی هفتگی قیمت/موجودی و هزینه ورودی در بسته است؟ |
| «مثل دیجیکالا وصل میکنیم» | ترب کانال ورودی است، نه بازارگاه؛ مدل فرق دارد | مسیر ترب جدا از اتصال به دیجیکالا تعریف شده؟ |
| «قسط آخر موقع تحویل کد» | بدون آزمون روی خود ترب، اختلافها دیر دیده میشوند | جدول پذیرش (نمونه کالا، توکن، لاگ) قبل از قسط آخر هست؟ |
هزینههای پنهان اتصال بد به ترب
قیمت پیادهسازی، معمولاً همه هزینه نیست. وقتی قیمت و موجودی یکی نباشد، اینها جدا حساب میشوند:
| مورد | چرا گران تمام میشود | نکته |
|---|---|---|
| ورودی به کالای ناموجود یا قیمت اشتباه | از اعتبار ترب کم میشود بدون فروش | اول همگامی را درست کنید، بعد بودجه کلیک را بالا ببرید |
| صفحه کند بعد از کلیک از ترب | خریدار مقایسه کرده و منتظر نمیماند | سرعت موبایل را در سایت کند است بسنجید |
| پرداخت ناموفق روی ورودی گران | کلیک را خریدهاید، سفارش قطع شده | وضعیت درگاه را در پرداخت ناموفق فروشگاه چک کنید |
| پاکسازی دیرهنگام داده | بعد از go-live چند برابر زمان میبرد | قبل از اتصال، عنوان/عکس/تنوع را مرتب کنید |
| دوبارهکاری بعد از تغییر مستند ترب | API بدون نسخه و تست میشکند | بند بهروزرسانی مستند را در قرارداد بنویسید |
| انبار و حسابداری جدا از سایت | موجودی ترب با واقعیت انبار یکی نیست | مسیر همگام را در اتصال سایت به حسابداری ببینید |
| پشتیبانی اضطراری آخر هفته | کمپین روشن است و قیمتها بههم ریخته | پشتیبانی ماهانه با پایش اختلاف، این نرخ را کم میکند |
| بازنویسی فروشگاه وسط فصل | اتصال روی بستر ضعیف دوام نمیآورد | اگر بستر مشکل دارد، اول هزینه بازطراحی را مقایسه کنید |
پرداخت مرحلهای و آزمون پذیرش برای اتصال به ترب
برای پروژه اتصال، پرداخت را به خروجی قابل اندازهگیری وصل کنید، نه فقط به گذشت روزها. یک تقسیم رایج:
| مرحله | سهم تقریبی | شرط پرداخت |
|---|---|---|
| بررسی بستر و داده محصولات | ۱۵ تا ۲۰ درصد | گزارش وضعیت اینماد، افزونه/API، کیفیت عنوان/عکس/تنوع |
| نصب افزونه یا پیادهسازی API | ۲۵ تا ۳۰ درصد | خروجی نمونه با شناسه ثابت، قیمت تومان، صفحهبندی درست |
| پاکسازی داده و اتصال انبار (در صورت نیاز) | ۲۰ تا ۲۵ درصد | نمونه کالاها در خروجی با صفحه محصول یکی است |
| آزمون پذیرش روی ترب | ۱۵ درصد | چند محصول در ترب با سایت مقایسه شده؛ توکن و خطای ۴۰۰/۴۰۱ درست |
| مستند نگهداری و لاگ | ۱۰ درصد | نحوه پایش هفتگی، محل لاگ، مسئول اختلاف قیمت مشخص است |
| قسط آخر | ۱۰ تا ۱۵ درصد | تأیید کتبی همگامی نمونه و سلامت مسیر بعد از شارژ حساب |
بندهای مربوط را در قرارداد برنامهنویسی پروژهای و روش تحویل گرفتن کار را در تحویل گرفتن پروژه نرمافزاری نوشتهایم. مالکیت سورس و دسترسیها را هم در مالکیت سورس کد سایت ببینید.
عددهایی که بعد از ۹۰ روز باید ببینید
اتصال وقتی موفق است که این عددها پایدار بمانند، نه فقط اینکه محصولات یکبار در ترب دیده شدهاند. قبل از شروع، همینها را یک بار ثبت کنید:
| شاخص | از کجا بخوانید | نشانه خوب |
|---|---|---|
| نسبت ورودی ترب به سفارش | آمار سایت / پنل ترب | بهبود یا حداقل افت نکردن نسبت به ماه اول |
| هزینه هر ورودی و هر سفارش از ترب | شارژ پنل + آمار فروش | بدون جهش ناگهانی بهخاطر ناموجود یا قیمت اشتباه |
| تعداد اختلاف قیمت/موجودی هفتگی | نمونه دستی یا گزارش همگام | روند کاهشی؛ نزدیک صفر برای کالاهای پرفروش |
| نرخ پرش صفحه محصول از ورودی ترب | آمار سایت | کم شدن نسبت به دوره قبل از رفع سرعت/اعتماد |
| خطاهای API (۴۰۰/۴۰۱/۵۰۰) از طرف ترب | لاگ سرور | نادر و قابل توضیح |
| سفارشهای لغوشده بهخاطر قیمت متفاوت | پشتیبانی فروش | نباید بعد از اتصال زیاد شود |
| تماس اضطراری «ترب قیمت اشتباه نشان میدهد» | تیکتها | کم شدن ماهبهماه |
اگر بعد از سه ماه هنوز اختلاف قیمت زیاد است، یا مسئول پایش مشخص نبوده یا منبع قیمت (انبار، حسابداری، افزونه تخفیف) یکی نیست. برای نگهداری مداوم، پشتیبانی ماهانه سایت را ببینید.
راهنماهای تازه مرتبط؛ آبان ۱۴۰۵
- جایگزین شاپیفای در ایران ۱۴۰۵؛ اگر هنوز بستر فروشگاه را انتخاب نکردهاید، فروشگاهساز ایرانی، ووکامرس و اختصاصی را از نظر اتصال آماده به ترب هم مقایسه کنید.
- اتصال کارتخوان به نرم افزار ۱۴۰۵؛ وقتی فروش حضوری و آنلاین از یک انبار است، اتصال کارتخوان به نرمافزار فروش کمک میکند موجودی سایت و ترب عقب نماند.
- خرید اسکریپت آماده یا برنامه نویسی اختصاصی؛ افزونه یا اسکریپت آماده اتصال بخرید یا اختصاصی بنویسید؟ هزینه دوساله و ریسک هر کدام را ببینید.
- استعلام قیمت ساخت نرم افزار ۱۴۰۵؛ برای گرفتن قیمت قابل مقایسه اتصال به ترب، تعداد کالا، بستر فروشگاه و نیاز به وبهوک را در سند استعلام بنویسید.
- بهترین شرکت طراحی سایت فروشگاهی ۱۴۰۵؛ اتصال به ترب و مقایسهگرها را جزو ملاکهای انتخاب مجری فروشگاه اینترنتی بگذارید.
نکتههای تازه ۱۴۰۵ از مستندهای رسمی ترب
- طبق مخزن رسمی Torob-Sync در گیتهاب، این APIها برای فروشگاههای بزرگ و فروشگاهسازهاست؛ فروشگاه کوچک بعد از ثبت در ترب خودکار اضافه میشود و لازم نیست API را پیاده کند. در همان مستند، نسخه ۱ و ۲ API محصولات «منسوخ» علامت خوردهاند و برای اتصال تازه فقط نسخه ۳ توصیه میشود.
- ترب یک وبهوک محصول هم دارد (آدرس api.torob.com/update/webhook/v1): فروشگاه بعد از افزودن یا ویرایش کالا، تا ۱۰۰ لینک محصول را در هر درخواست میفرستد و ترب بدون منتظر ماندن برای خزش دورهای، همانها را دوباره میخواند. توکن این وبهوک را باید از پشتیبانی ترب گرفت.
- برای سنجیدن فروش واقعی از ترب، مستند «Order Tracking API» ترب روشی رسمی دارد: کاربری که از ترب میآید پارامتر torob_clid در آدرس دارد، سایت آن را در کوکی نگه میدارد و کنار سفارش ذخیره میکند تا ترب سفارشهای ارجاعی را بخواند.
- مستند «Shop API» ترب به فروشگاه اجازه میدهد از داخل کد، وضعیت محصولات در ترب را بخواند، محصول را روشن یا خاموش کند، آمار کلیک را ببیند و به گزارشهای قیمت جواب بدهد.
- افزونه رسمی ترب برای ووکامرس در مخزن وردپرس بیش از ۴۰ هزار نصب فعال دارد (بازبینی ۸ آبان ۱۴۰۵)؛ یعنی برای فروشگاه ووکامرسی، شروع با افزونه رسمی راه جاافتادهای است.
مشاوره پیش از تصمیم: اگر میخواهید همین موضوع را روی پروژه خودتان بسنجید، بازه هزینه را در صفحه قیمتها ببینید و برای یک گفتوگوی کوتاه با ۰۹۹۱۵۶۱۵۹۴۶ تماس بگیرید، در تلگرام پیام بدهید یا فرم تماس را پر کنید.
سؤالهای رایج
اتصال سایت به ترب چقدر هزینه دارد؟
دو هزینه جدا دارد. اول، هزینه ورودیها در خود ترب که طبق تعرفه پلهای پنل فروشندگان از حساب شارژشده کم میشود. دوم، هزینه فنی: برای ووکامرس با افزونه رسمی معمولاً چند ساعت کار است و برای فروشگاه اختصاصی، بسته به تمیزی داده، از حدود دهها میلیون تا بیشتر. جدول هزینه بالا محدودهها را نشان میدهد.
بدون اینماد میشود در ترب بود؟
برای بخش خرید اینترنتی نه؛ ترب اینماد را لازم میداند. فروشگاههای حضوری بخش جداگانهای دارند که به سایت نیاز ندارد.
بدون API هم محصولاتم در ترب نمایش داده میشود؟
ترب میتواند صفحهها را بخواند، ولی API داده دقیقتر و بهروزتر میدهد. برای فروشگاه با کالای زیاد یا قیمت متغیر، API توصیه میشود.
چقدر طول میکشد تا تغییر قیمت در ترب دیده شود؟
این به زمانبندی خود ترب بستگی دارد. کاری که از دست شما برمیآید این است که API قیمت لحظهای بدهد، مرتبسازی تاریخ بهروزرسانی را پیاده کند و کش طولانی نداشته باشد.
محصولات عمده یا «تماس بگیرید» را هم میشود در ترب گذاشت؟
ترب برای مقایسه قیمت است و هر محصول موجود قیمت عددی میخواهد. محصولاتی که قیمت ثابت ندارند، جای مناسبی در ترب ندارند؛ برای فروش عمده، استعلام قیمت و پیشفاکتور آنلاین راه بهتری است.
اتصال ترب روی سرعت سایت اثر دارد؟
اگر درست پیاده شود، نه. درخواستهای ترب صفحهبندیشدهاند و باید با کوئری بهینه جواب داده شوند. پیادهسازی بد با کالای زیاد میتواند سرور را در لحظه درخواست ترب کند کند.
فقط اتصال ترب را سفارش بدهم یا کل فروشگاه را بازطراحی کنم؟
اگر فروشگاه سالم و سریع است، فقط اتصال کافی است. اگر داده محصولات نامرتب است یا صفحه محصول ضعیف است، اول همان را درست کنید؛ اتصال به ترب مشکل صفحه محصول را حل نمیکند و فقط برای ورودیهای بینتیجه پول میدهید.
نرخ ساعتی فاوا چه کمکی به مقایسه پیشنهاد اتصال میکند؟
پایه ساعتی رسمی فاوا برای ۱۴۰۵ حدود ۵۷۶ هزار تومان برای شرکت و حدود ۲۷۱ هزار تومان برای فرد (پیش از ضریبها) است. اگر پیشنهاد اتصال کامل برای فروشگاه اختصاصی با چند هزار کالا خیلی زیر چند ده ساعت با این نرخ است، احتمال دارد پاکسازی داده، تست روی خود ترب یا لاگ در آن نباشد. از طرف بخواهید با جدول پذیرش همین مقاله نشان بدهد کدام مرحلهها پوشش داده شده است.
پیشنهاد خیلی ارزان برای اتصال به ترب قابل اعتماد است؟
لزوماً نه. پیشنهادهای خیلی ارزان اغلب فقط نصب افزونه یا یک اسکریپت خاماند و داده، کش، تنوع و پایش اختلاف را لمس نمیکنند. اگر نمونه خروجی، شرایط تست و مسئول پایش هفتگی مکتوب نباشد، معمولاً ورودیهای بینتیجه میخرید و بعداً دوباره هزینه میدهید.
بعد از تغییر قیمت در سایت، چطور ترب را زودتر باخبر کنم؟
اگر فروشگاه اختصاصی دارید، علاوه بر API محصولات، وبهوک محصول ترب را پیاده کنید. سایت بعد از هر ویرایش، لینک و شناسه همان کالاها را برای ترب میفرستد و ترب آنها را زودتر از خزش معمولی دوباره میخواند. توکن وبهوک را از پشتیبانی ترب بگیرید و در کد صفحه نگذارید.
از کجا بفهمم چند سفارش واقعاً از ترب آمده است؟
دو راه دارید: پارامترهای UTM در گوگل آنالیتیکس، و روش رسمی ترب با پارامتر torob_clid که در کوکی ذخیره و کنار سفارش ثبت میشود. راه دوم سفارشها را دقیقتر به کلیک ترب وصل میکند و برای حساب کردن هزینه هر فروش از ترب بهدردبخورتر است.
مطالب مرتبط
- ووکامرس یا فروشگاه اختصاصی
- هزینه فروشگاه اینترنتی ۱۴۰۵
- اتصال فروشگاه به دیجیکالا
- اتصال سایت به حسابداری
- پرداخت ناموفق فروشگاه
- اتصال پیامک و OTP
- سایت کند است؟ علت و هزینه رفع
- چکلیست امنیت سایت
- هزینه طراحی API ۱۴۰۵
- قرارداد برنامهنویسی پروژهای
- تحویل گرفتن پروژه نرمافزاری
- مالکیت سورس کد سایت
اتصال فروشگاه شما به ترب
پونوکد اتصال فروشگاههای اختصاصی به ترب و سرویسهای دیگر را طبق مستندات رسمی پیاده میکند و قبل از شروع، وضعیت داده محصولات را بررسی میکند تا هزینه واقعی روشن باشد. جزئیات خدمات اتصال در صفحه API و یکپارچهسازی، بقیه خدمات در صفحه خدمات و ساخت فروشگاه در طراحی سایت آمده است؛ عوامل قیمت را هم در صفحه قیمت ببینید. برای بررسی وضعیت فروشگاهتان با ۰۹۹۱۵۶۱۵۹۴۶ تماس بگیرید، در تلگرام پیام بدهید (t.me/resonea) یا فرم تماس را پر کنید.



