fastsit-shop

Showing 25 of 160 from the live probe.

• فهرستِ سفارش‌ها

  list orders — فهرستِ سفارش‌ها سفارش‌های فروشگاه، تازه‌ترین اول. با status می‌توانی فیلتر کنی: pending (در انتظار تأیید)، confirmed، shipped، delivered، cancelled، returned.

• جزئیاتِ یک سفارش

  get order — جزئیاتِ یک سفارش کلِ یک سفارش با اقلام، مشتری، نشانی و وضعیتِ پرداخت. با شماره‌ی سفارش صدا زده می‌شود.

• تغییرِ وضعیتِ سفارش

  set order status — تغییرِ وضعیتِ سفارش وضعیتِ یک سفارش را عوض می‌کند. مقادیرِ مجاز: pending، confirmed، shipped، delivered، cancelled، returned. ⚠️ این کار روی انبار اثر دارد: لغو، موجودیِ رزروشده را آزاد می‌کند و برگشت، کالا را به قفسه برمی‌گرداند. پیش از اجرا از کاربر تأیید بگیر.

• جست‌وجویِ کالا

  search products — جست‌وجویِ کالا کالاها را با نام یا کد پیدا می‌کند. query خالی یعنی تازه‌ترین کالاها.

• جزئیاتِ کالا

  get product — جزئیاتِ کالا همه‌ی مشخصاتِ یک کالا با شناسه‌اش.

• دسته‌بندی‌ها

  list categories — دسته‌بندی‌ها درختِ دسته‌ها و زیرمجموعه‌ها با شناسه، به‌همراهِ تعدادِ کالا و زیرمجموعه‌ی هرکدام. پیش از ساختِ کالا این را صدا بزن (کالا بدونِ زیرمجموعه ساخته نمی‌شود) و پیش از حذفِ دسته هم، تا ببینی چند کالا دارد.

• کالاهایِ رو به اتمام

  list low stock — کالاهایِ رو به اتمام کالاهایی که موجودیشان به آستانه‌ی خودشان رسیده یا کمتر است (همان چیزی که تبِ «هشدارها»ی انبار نشان می‌دهد). threshold را فقط اگر می‌خواهی یک عددِ ثابتِ سفارشی به‌جایِ آستانه‌ی خودِ کالاها استفاده کنی بفرست.

• خلاصه‌ی فروش

  sales summary — خلاصه‌ی فروش تعداد و مبلغِ سفارش‌ها در n روزِ گذشته، به تفکیکِ وضعیت.

• ساختِ کالا

  create product — ساختِ کالا کالایِ تازه می‌سازد. شناسه‌ی دسته و زیرمجموعه را از list_categories بگیر. قیمت به تومان. همه‌ی فیلدهایِ فرمِ پنل این‌جا هست جز عکس — عکس را با add_product_image اضافه کن.

• به‌روزرسانیِ موجودی

  update stock — به‌روزرسانیِ موجودی موجودیِ انبارِ یک کالا را می‌گذارد روی عددِ داده‌شده. اختلاف با مقدارِ فعلی به‌شکلِ یک اصلاح در دفترِ انبار ثبت می‌شود و پخشِ انبارها هم با آن می‌خواند، پس با stock_history قابلِ ردیابی است. اگر می‌دانی جنس واقعاً وارد شده، receive_stock درست‌تر است (نوعِ حرکتش «ورود» ثبت می‌شود، نه «اصلاح»).

• به‌روزرسانیِ قیمت

  update price — به‌روزرسانیِ قیمت قیمت و درصدِ تخفیفِ یک کالا را عوض می‌کند. قیمت به تومان.

• ویرایشِ کالا

  update product — ویرایشِ کالا هر فیلدی که پنل دارد، جز عکس: نام، توضیح، برند، دسته، کد، پارت‌نامبر، کشورِ سازنده، سالِ ساخت، مشخصاتِ فنی، نشان‌هایِ صفحه‌ی کالا (گارانتی/مهلتِ تست/ارسالِ سریع)، ویژه/جدید، حدِ هشدارِ موجودی، تاریخِ انقضا، ردیابیِ تک‌واحدی، نشانی و مختصاتِ مبدأِ ارسال، و ویدیو. هر فیلدی که نفرستی دست‌نخورده می‌ماند. برای قیمت از update_price و برای موجودی از update_stock و برای عکس از add_product_image استفاده کن.

• انتشارِ کالا

  publish product — انتشارِ کالا کالا را در ویترینِ عمومی نشان می‌دهد. کالای تازه‌ساخته پیش‌نویس است تا وقتی این را صدا بزنی. ⚠️ کالایِ بدونِ دسته و زیرمجموعه منتشر نمی‌شود (خطا می‌دهد) — چون در ویترین سرِ جایش نمی‌نشیند. از رویِ نامِ کالا خودت تشخیص بده کدام دسته و زیرمجموعه بهش می‌خورد؛ نبود، با create_category بسازش (مثلاً «شارژر گوشی سامسونگ» → دسته‌ی «شارژر» + زیرمجموعه‌ی «شارژر سامسونگ»). اگر سهمِ فروش صفر باشد منتشر می‌شود ولی «ناموجود» دیده می‌شود و در پاسخ هشدار می‌گیری — با set_allocatio

• بایگانیِ کالا

  unpublish product — بایگانیِ کالا کالا را از ویترینِ عمومی برمی‌دارد ولی پاکش نمی‌کند — همان «آرشیو». وقتی کالا موقتاً موجود نیست یا نمی‌خواهی دیده شود، این را به‌جای delete_product بزن؛ برگشت‌پذیر است.

• درخواستِ کدِ حذفِ کالا

  request product delete code — درخواستِ کدِ حذفِ کالا کدِ یک‌بارمصرف را به آنپی‌چتِ مالکِ فروشگاه می‌فرستد. کد در پاسخ برنمی‌گردد — باید از خودِ مالک بپرسی و با delete_product بفرستی. تا ۵ دقیقه معتبر است.

• حذفِ کالا

  delete product — حذفِ کالا کالا را به *سطلِ زباله* می‌فرستد: از ویترین و همه‌ی فهرست‌ها ناپدید می‌شود، ولی خودش و دفترِ انبار و موجودی و نظرهایش دست‌نخورده می‌مانند و مالک می‌تواند از پنل برش گرداند. پاک‌کردنِ نهایی فقط از پنل و به‌دستِ مالک انجام می‌شود — هیچ ابزارِ MCPی برایش نیست. اگر فقط می‌خواهی موقتاً از سایت برداشته شود، unpublish_product سبک‌تر است. هم confirm=true می‌خواهد هم کدی که با request_product_delete_code به آنپی‌چتِ مالک رفته.

• تغییرِ دسته‌جمعیِ قیمت/تخفیف

  bulk update prices — تغییرِ دسته‌جمعیِ قیمت/تخفیف روی همه‌ی کالاهای یک دسته یکجا کار می‌کند. op یکی از: discount (گذاشتنِ درصدِ تخفیف)، markup (گران‌کردنِ قیمت به درصد)، markdown (ارزان‌کردن به درصد). بدونِ confirm=true فقط می‌گوید چند کالا تحتِ تأثیر قرار می‌گیرند و تغییری نمی‌دهد.

• لینکِ آپلودِ عکس

  create image upload link — لینکِ آپلودِ عکس نشانیِ کوتاه‌عمری می‌سازد که کاربر با آن، عکس را از گوشی یا کامپیوترش مستقیم روی این کالا می‌گذارد — بدونِ ورود به پنل. ⚠️ این راهِ درست برای عکسی است که کاربر در گفت‌وگو آپلود کرده یا روی گوشی‌اش دارد: تو نمی‌توانی خودِ فایل را بفرستی، ولی می‌توانی این لینک را بدهی. لینک را به کاربر نشان بده تا روی گوشی بازش کند. تا ۳۰ دقیقه و برای چند عکس معتبر است.

• افزودنِ عکسِ کالا

  add product image — افزودنِ عکسِ کالا عکس را به کالا اضافه می‌کند. یکی از این دو را بفرست: image_url (نشانیِ عکس روی اینترنت — سرور خودش دانلود می‌کند) یا image_base64 (خودِ بایت‌های عکس در base64). ⚠️ اگر کاربر عکس را در گفت‌وگو آپلود کرده یا روی گوشی‌اش دارد، بایت‌هایش در اختیارِ تو نیست — در آن حالت به‌جای این ابزار از create_image_upload_link استفاده کن و لینک را به کاربر بده. عکس روی سرور فشرده و به فرمتِ استاندارد تبدیل می‌شود. سقف: ۱۵ مگابایت. فرمت‌ها: jpg، png، gif، webp.

• انتخابِ عکسِ شاخص

  set main image — انتخابِ عکسِ شاخص یکی از عکس‌های موجودِ کالا را عکسِ شاخص می‌کند. نشانیِ عکس را از get_product یا list_product_images بگیر.

• عکس‌های کالا

  list product images — عکس‌های کالا نشانیِ عکسِ شاخص و همه‌ی عکس‌های گالریِ یک کالا.

• حذفِ عکسِ کالا

  delete product image — حذفِ عکسِ کالا یک عکس را از کالا و از روی دیسک پاک می‌کند. اگر عکسِ شاخص باشد، اولین عکسِ گالری جایش می‌نشیند. بدونِ confirm=true کاری نمی‌کند.

• کم/زیادِ موجودی

  stock adjust — کم/زیادِ موجودی موجودی را نسبت به مقدارِ فعلی کم یا زیاد می‌کند — برخلافِ update_stock که عددِ مطلق می‌گذارد. delta مثبت یعنی کالا رسیده، منفی یعنی از انبار رفته (ضایعات، مرجوعی به فروشنده، شمارشِ اصلاحی). در دفترِ انبار ثبت می‌شود، پس بعداً با stock_history قابلِ ردیابی است. پخشِ انبارها خودکار با آن می‌خواند؛ اگر می‌دانی مالِ کدام انبار است warehouse_id را بده.

• تخصیصِ سهمِ فروش از یک انبار

  set allocation — تخصیصِ سهمِ فروش از یک انبار سهمِ فروش از یک انبارِ مشخص را رویِ عددِ داده‌شده می‌گذارد (مطلق، نه دلتا). مثلاً از ۱۰۰ گوشیِ انبارِ تهران فقط ۱۰ تا برایِ فروش: ویترین ۱۰ تا نشان می‌دهد و ۹۰ تایِ دیگر دست‌نخورده در همان انبار می‌مانند. جنس جابه‌جا نمی‌شود و از انبار کم نمی‌شود — فقط مالکیتش به فروش می‌رود؛ کم‌شدنِ واقعی لحظه‌ی ارسال است و همان‌جا سهم هم یکی کم می‌شود. صفر یعنی هیچی از این انبار فروخته نشود. برایِ گردشِ کارِ درخواست/تأیید (وقتی انباردار و فروشنده دو نفرند) request_

• پس‌دادنِ سهمِ فروش به انبار

  release allocation — پس‌دادنِ سهمِ فروش به انبار سهمِ نفروخته را به انبار برمی‌گرداند — عکسِ set_allocation. موجودیِ فیزیکی دست نمی‌خورد، فقط مالکیت از فروش به انبار برمی‌گردد و ویترین کمتر می‌بیند.