رفتن به محتوای اصلی
تاریوا برای فروشگاهم می‌خواهم
کاتالوگ

کاتالوگ پایدار

ورود Excel، CSV، JSON یا Feed؛ بررسی محصول و تصویر پیش از انتشار.

در این راهنما

کاتالوگ برای کشف محصول، مقایسه، راهنمای سایز و دانش فروشگاه است.

ورودی‌ها

  • فایل Excel (XLSX) یا CSV با قالب قابل دریافت از «محصولات ← افزودن منبع».
  • فایل JSON با schema_version: taryva.catalog.v1.
  • نشانی Feed روی HTTPS مطابق مستندات؛ این نشانی باید خروجی JSON بدهد و لینک صفحهٔ محصول نیست.

فایل Excel و تصاویر

برگهٔ محصولات را Products نگه دارید. برای هر سایز یا رنگ، یک ردیف با شناسهٔ تنوع جدا بنویسید؛ شناسهٔ اصلی محصول در ردیف‌های آن محصول یکسان می‌ماند. شناسه و SKU را به صورت Text ذخیره کنید تا صفر ابتدایی از بین نرود.

در image_url نشانی مستقیم تصویر اصلی و در gallery_urls نشانی‌های گالری را با جداکنندهٔ | بگذارید. حداکثر ۱۲ تصویر برای هر محصول وارد کنید. تصویر داخل سلول Excel، لینک پوشه، Base64 و فایل ZIP تصاویر در این مسیر پشتیبانی نمی‌شوند. اگر عکس‌ها روی CDN هستند، ابتدا دامنهٔ رسانه را در تنظیمات اتصال تأیید کنید.

واحد قیمت را صریح بنویسید: IRT برای تومان و IRR برای ریال. زمان ثبت قیمت و موجودی در observed_at باید متن ISO باشد. مقدار خالی به معنی اطلاعات نامعلوم است و با صفر تفاوت دارد.

قالب معمول تا ۵ MiB و ۵۰۰۰ محصول می‌پذیرد؛ ظرفیت پلن نیز جداگانه اعمال می‌شود. برای کاتالوگ بزرگ از Feed صفحه‌بندی‌شده استفاده کنید. فایل باید خروجی کامل باشد؛ تغییرات و موارد غایب قبل از ساخت و انتشار مرور می‌شوند.

ویژگی‌های تکمیلی و جدول سایز قالب JSON مستند دارند؛ می‌توانید جدول سایز را پس از ورود محصولات، در ویرایشگر خود محصول تکمیل کنید. عکس مشتری جای جدول اندازهٔ معتبر محصول را نمی‌گیرد.

قوانین

  • بدون اعتبار پایگاه‌داده فروشنده
  • آدرس محصول و تصویر پایدار
  • تصویر فقط از دامنه فروشگاه یا Asset Origin تأییدشده
  • price_snapshot و stock_snapshot تشخیصی‌اند، نه حقیقت زنده

انتشار

پس از اعتبارسنجی یک پیش‌نویس ساخته می‌شود. بعد از بررسی می‌توانید publish کنید و تاریخچه/rollback دارید.

مثال Schema: catalog/schema

تصاویر: catalog/images