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

Schema کاتالوگ

نمونه قابل کپی taryva.catalog.v1

در این راهنما

ریشه باید object باشد و schema_version دقیقاً taryva.catalog.v1 باشد.

json
{
  "schema_version": "taryva.catalog.v1",
  "catalog_id": "apparel-main",
  "currency": "IRR",
  "generated_at": "2026-08-21T12:00:00Z",
  "knowledge_documents": [
    {
      "id": "size-guide",
      "title": "راهنمای سایز",
      "type": "size_guide",
      "content": "اندازه‌گیری دور سینه، کمر و باسن.",
      "url": "https://shop.example.com/size-guide",
      "tags": ["سایز"]
    }
  ],
  "products": [
    {
      "id": "product-1001",
      "title": "کت زنانه مشکی",
      "status": "active",
      "type": "variable",
      "url": "https://shop.example.com/product/product-1001",
      "images": [{"url": "https://shop.example.com/media/1001.webp", "alt": "کت مشکی"}],
      "variants": [
        {
          "id": "product-1001-40",
          "title": "مشکی / 40",
          "attributes": {"رنگ": "مشکی", "سایز": "40"},
          "price_snapshot": {"amount_minor": 34900000, "currency": "IRR", "observed_at": "2026-08-21T12:00:00Z"},
          "stock_snapshot": {"state": "in_stock", "observed_at": "2026-08-21T12:00:00Z"}
        }
      ]
    }
  ]
}

شناسه محصول باید یکتا باشد. ویژگی‌های نوسانی مثل قیمت داخل attributes مجاز نیست.

قیمت و تخفیف

تاریوا قیمت ثبت‌شده در price_snapshot را همراه با مشخص‌بودن منبع آن نمایش می‌دهد. قیمت ریالی در کارت خرید به تومان تبدیل می‌شود؛ عدد و واحد اصلی داده تغییر نمی‌کند. اگر قیمت تنوع‌ها متفاوت باشد، تا پیش از انتخاب دقیق رنگ و سایز، بازهٔ قیمت نمایش داده می‌شود.

برای نمایش تخفیف، قیمت عادی و قیمت فروش را برای همان تنوع اضافه کنید:

json
{
  "amount_minor": 8000000,
  "currency": "IRR",
  "observed_at": "2026-09-11T08:00:00Z",
  "regular_amount_minor": 10000000,
  "sale_amount_minor": 8000000,
  "sale_starts_at": "2026-09-10T00:00:00Z",
  "sale_ends_at": "2026-09-20T00:00:00Z"
}

مبلغ‌ها باید عدد صحیح نامنفی در کوچک‌ترین واحد ارز باشند. قیمت فروش باید برابر amount_minor و کمتر از قیمت عادی باشد. تاریخ مشاهده باید معتبر باشد و در آینده نباشد. تاریخ شروع و پایان تخفیف اختیاری است؛ اگر ارائه شود، باید تاریخ و منطقهٔ زمانی معتبر داشته باشد. تخفیف آینده یا پایان‌یافته نمایش داده نمی‌شود.

این فیلدها اختیاری‌اند و فایل‌های قبلی همچنان قابل استفاده‌اند. اگر قیمت عادی یا تخفیف در داده وجود نداشته باشد، تاریوا آن را حدس نمی‌زند. به‌روزرسانی داده از مسیر معمول ساخت پیش‌نویس و انتشار انجام می‌شود.

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