Schema کاتالوگ
نمونه قابل کپی taryva.catalog.v1
در این راهنما
ریشه باید object باشد و schema_version دقیقاً taryva.catalog.v1 باشد.
{
"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 را همراه با مشخصبودن منبع آن نمایش میدهد. قیمت ریالی در کارت خرید به تومان تبدیل میشود؛ عدد و واحد اصلی داده تغییر نمیکند. اگر قیمت تنوعها متفاوت باشد، تا پیش از انتخاب دقیق رنگ و سایز، بازهٔ قیمت نمایش داده میشود.
برای نمایش تخفیف، قیمت عادی و قیمت فروش را برای همان تنوع اضافه کنید:
{
"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 بهتنهایی موجودی فعلی را تأیید نمیکند. نمایش موجودی و امکان خرید به پاسخ زندهٔ فروشگاه نیاز دارد.