کاتالوگ پایدار
ورود 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