🏪 قیمت‌هات رو یه‌جا برای «تهش چنده؟» بفرست

برای فروشگاه‌های اینترنتی و پیج‌های اینستاگرامی. به‌جای اینکه ما سایتت رو بگردیم، خودت قیمت‌ها رو یکجا می‌فرستی؛ ما هر کالا رو با کاتالوگ‌مون تطبیق می‌دیم، تو تطبیق رو تأیید می‌کنی و بعد از بررسی ادمین، پیشنهادت به خریدارهای کانال و ربات نشون داده می‌شه.

درخواست همکاری در ربات

چطور شروع کنم؟

  1. تو ربات @taheshchande_bot دستور /shop رو بزن و «🌐 سایت» یا «📸 پیج اینستاگرام» رو انتخاب کن.
  2. اطلاعات هویتی رو کامل کن (نام فروشگاه، نام صاحب، کد ملی، کارت برای تطبیق هویت، موبایل — با کد پیامکی تأیید می‌شه). اطلاعات رمزنگاری‌شده نگه داشته می‌شه و شماره‌ی کامل کارت ذخیره نمی‌شه.
  3. بعد از تأیید، تو ربات یه کلید API می‌گیری (فقط یک بار نشون داده می‌شه). بدون برنامه‌نویسی: یه فایل اکسل/CSV تو ربات بفرست (/sheet)، یا از /offer و صفحه‌ی /myshop استفاده کن.
  4. قیمت‌ها رو بفرست، تطبیق با کاتالوگ رو تأیید کن، و منتظر بررسی ادمین بمون.

API — فرستادن همه‌ی قیمت‌ها در یک درخواست

آدرس: https://api.taheshchande.ir/v1/partner/items
احراز هویت: هدر Authorization: Bearer pk_…
محدودیت: تا ۱٬۰۰۰ کالا در هر درخواست؛ ۱۲۰ درخواست در دقیقه؛ برای هر فروشگاه در هر ساعت ۶۰ بار فرستادن فهرست و روی‌هم ۱۰٬۰۰۰ کالا (بیشتر از این 429 با retry-after). فقط https.

curl -X POST https://api.taheshchande.ir/v1/partner/items \
  -H "Authorization: Bearer pk_XXXXXXXX" -H "Content-Type: application/json" \
  -d '{
  "items": [
    { "sku": "A56-256",
      "title": "گوشی سامسونگ Galaxy A56 ۲۵۶ گیگ",
      "url": "https://myshop.ir/p/a56",
      "price_toman": 18500000,
      "in_stock": true,
      "valid_until": "2026-11-30T23:59:00+03:30",
      "ref_url": "https://www.digikala.com/product/dkp-13579246/" }
  ]
}'
فیلدتوضیح
skuشناسه‌ی کالا تو سیستم خودت (ثابت بمونه)
titleاسم کالا
urlصفحه‌ی خرید همین کالا تو سایت یا پست اینستاگرامت
price_tomanقیمت فروش امروز به تومان (عدد صحیح)
in_stockموجوده؟ (پیش‌فرض true) — کالای ناموجود نمایش داده نمی‌شه و قیمت زنده‌ش همون لحظه برداشته می‌شه
valid_until (اختیاری)تا کی این قیمت رو تضمین می‌کنی (ISO 8601 با منطقه‌ی زمانی). بعدش نمایش داده نمی‌شه؛ حداکثر ۳۰ روز. نفرستی یعنی «تا قیمت بعدی». فرستادنِ دوباره‌ی همون قیمت، نمایشش رو تمدید می‌کنه.
ref_url (پیشنهادی)لینک همین کالا تو دیجی‌کالا یا ترب — دقیق‌ترین راه تطبیق
dkp، image_urlاختیاری
{ "accepted": 1, "unchanged": 0, "deferred": 0,
  "items": [ { "sku": "A56-256", "match_status": "suggested",
               "suggestions": [ { "dkp": 13579246, "title": "گوشی سامسونگ Galaxy A56 ۲۵۶ گیگ", "score": 1 } ],
               "waiting_review": true } ] }

بدون برنامه‌نویسی: فایل اکسل یا CSV

قالب رو بگیر و پرش کن: قالب اکسل (.xlsx) · CSV. بعد همون فایل رو تو ربات بفرست (یا تو صفحه‌ی /myshop بارگذاری کن). قبل از ثبت، چیزی که از فایل فهمیدیم رو نشونت می‌دیم و تأیید می‌کنی.

ستونتوضیح
نام کالا · قیمت (تومان)لازم. قیمت ریالی هم قبوله اگه تو اسم ستون «ریال» بنویسی (یا موقع ثبت بگی).
لینک کالا یا پستصفحه‌ای که خریدار ازش می‌خره. پیج اینستاگرامی خالی بذاره، لینک پیجش رو می‌ذاریم.
لینک همین کالا در دیجی‌کالا / ترب / ایمالزدقیق‌ترین راه تطبیق با کاتالوگ.
موجودی«موجود» / «ناموجود» یا تعداد (۰ = ناموجود). خالی = موجود.
قیمت معتبر تامثلاً 1405/09/10 یا 1405/09/10 18:00 (شمسی یا میلادی). خالی = تا قیمت بعدی.
کد کالا · لینک عکساختیاری.

برای برنامه‌نویس‌ها همون فایل با API هم قبوله:

POST /v1/partner/sheet
{ "filename": "prices.xlsx", "data_b64": "<base64 فایل>", "unit": "toman", "confirm": false, "full_list": false }

confirm: false فقط پیش‌نمایش برمی‌گردونه (چیزی ذخیره نمی‌شه)؛ confirm: true ثبت می‌کنه. با full_list: true یعنی «این فهرست کامله»: کالاهای موجودی که تو فایل نیستن ناموجود می‌شن و قیمتشون از نمایش برداشته می‌شه (missing_in_stock تو پیش‌نمایش تعدادشون رو می‌گه). هر خوندن فایل یه «فرستادن» از سهم ساعتی حساب می‌شه.

تطبیق با کاتالوگ

برای هر کالا تا ۳ پیشنهاد تطبیق برمی‌گردونیم. تطبیق درست رو تأیید کن (یا null اگه هیچ‌کدوم نبود):

POST /v1/partner/items/A56-256/match
{ "dkp": 13579246 }

GET /v1/partner/items فهرست همه‌ی کالاها، وضعیت تطبیق، اینکه کدوم قیمت الان نمایش داده می‌شه (live) و کدوم منتظر بررسیه (waiting_review) رو برمی‌گردونه.

قانون‌ها

سؤال داری؟ تو ربات «💬 پشتیبانی» رو بزن.