مرجع تمام فیلدهای سفارش دستی
معنای مشتری، تنوع، مقدار، قیمت، تحویل، روش پرداخت و اثر هر فیلد
مرجع کامل تمام فیلدهای سفارش دستی؛ هر ورودی چه می‌کند و چه خطایی ممکن است بسازد؟
فرم «سفارش جدید» در /panel/orders از مسیر ثبت سفارش فروشنده استفاده می‌کند؛ یعنی مشتری و کالا را انتخاب می‌کنید، سرور تعداد و وضعیت تنوع را کنترل می‌کند و برای اقلامی که مدیریت موجودی دارند رزرو ثبت می‌کند. این فرم معادل فاکتور آزاد دفترکل یا دریافت کالا به انبار نیست. هر ورودی باید با واقعیتی که قرار است ثبت شود هماهنگ باشد.
بخش مشتری
| فیلد | چرا لازم است؟ | اثر ثبت و پیشنهاد |
|---|---|---|
| مشتری موجود | مالک سفارش و مخاطب پیگیری را مشخص می‌کند | فقط حساب مشتری فعال و در محدوده دسترسی قابل انتخاب است؛ شماره مشتری اشتباه یعنی تاریخچه سفارش به فرد دیگری متصل می‌شود |
| گزینه «مشتری جدید» | ایجاد سریع مشتری هنگام فروش تلفنی/حضوری | فقط برای کاربر دارای مجوز ایجاد مشتری فعال است؛ در سفارش در حال ویرایش، روال دیگری لازم است |
| نام مشتری جدید | برچسب نمایشی در پنل و مدارک پیگیری | نام خوانا و واقعی ثبت کنید؛ نام شهر یا توضیح خرید را اینجا ننویسید |
| موبایل مشتری جدید | شناسه ارتباط و بررسی تکراری‌نبودن مشتری | اگر شماره پیش‌تر وجود داشته، همان مشتری را انتخاب کنید؛ سفارش دوم برای حل تکرار شماره نسازید |
«مشتری جدید» با «طرف حساب دفترکل» یک مفهوم نیست؛ اگر فروش اعتباری رسمی، سازمانی یا صورتحساب حقوقی نیاز دارید، حساب اشخاص و سفارش اعتباری را جداگانه بررسی کنید.
بخش اقلام سفارش
| فیلد یا نشانه | معنی عملی | اثر بر قیمت و انبار |
|---|---|---|
| کالا / تنوع | انتخاب variant، نه صرف عنوان کلی محصول | رنگ، اندازه، بسته‌بندی یا SKU اشتباه می‌تواند موجودی انبار دیگری را رزرو کند |
| SKU در زیر فیلد | شناسه ردیف قابل پیگیری | برای برچسب بسته و تحویل از همین شناسه استفاده کنید |
| «قابل فروش» | موجودی آزادِ تنوع در انبارهای فعالِ قابل استفاده برای وب | همیشه به آن به‌عنوان موجودی فیزیکی کل یا موجودی تمام انبارها نگاه نکنید |
| مقدار | تعداد یا کمیت نمایشی تنوع | سمت سرور به واحد داخلی تبدیل می‌شود؛ حداقل و گام سفارش باید رعایت شود |
| قیمت واحد (تومان) | قیمت هر واحد نمایشی این سفارش | مقدار پیشنهادی از قیمت‌گذاری برمی‌گردد، ولی قابل تغییر است؛ قیمت فروش با بهای خرید فرق دارد |
| افزودن یا حذف ردیف | تغییر اقلام پیش از ثبت | یک تنوع را دوبار اضافه نکنید؛ تعداد همان ردیف را اصلاح کنید |
| جمع اقلام | جمع هر مقدار × قیمت واحد | محاسبه سمت فرم پیش‌نمایش است و ملاک نهایی، نتیجه پذیرفته‌شده سرور است |
واحد وزن: اگر محصول با کیلوگرم فروخته می‌شود، مقدار 1.5 یعنی یک‌ونیم واحد نمایشی، نه لزوماً یک‌ونیم «واحد داخلی». سیستم از quantity_scale استفاده می‌کند. همیشه مقدار، گام و موجودی همان تنوع را قبل از ثبت کنترل کنید. برای مثال فروش ۳۰۰ کیلو از محصولی که واحد نمایش آن «تن» است باید 0.3 باشد، نه 300؛ راهنمای وزنی را بخوانید.
بخش تحویل
| فیلد | در چه وضعیتی دیده می‌شود؟ | اهمیت |
|---|---|---|
روش تحویل pickup یا shipping | همیشه | تعیین می‌کند سفارش حضوری است یا نیازمند نشانی و ارسال |
| نام گیرنده | هنگام ارسال | گیرنده ممکن است با خریدار تفاوت داشته باشد؛ نام را دقیق وارد کنید |
| موبایل گیرنده | هنگام ارسال | برای هماهنگی حامل ضروری است؛ بدون اجازه مشتری در کانال ناامن منتشر نکنید |
| استان و شهر | هنگام ارسال | برای نرخ حمل و تعیین محدوده خدمت استفاده می‌شود |
| نشانی | هنگام ارسال | نشانی ناقص باعث برگشت مرسوله و اختلاف می‌شود؛ توضیح قابل تحویل بنویسید |
| کدپستی | اختیاری طبق فرم، در صورت واردکردن ده‌رقمی | داده ساختگی وارد نکنید؛ برخی حامل‌ها ممکن است کد معتبر بخواهند |
| روش ارسال | هنگام ارسال، بسته به تنظیمات | تنها روش فعال و در دسترس همان Tenant را انتخاب کنید |
| هزینه ارسال | هنگام ارسال | به مبلغ نهایی اضافه می‌شود؛ در تحویل حضوری باید صفر باشد |
مهم: داده تحویل در سفارش به شکل snapshot نگهداری می‌شود. اگر بعدها نشانی حساب مشتری تغییر کند، سند قبلی را نباید بدون ردپا بازنویسی کرد. در زمان ایجاد سفارش حضوری، هزینه ارسال غیرصفر از طرف بک‌اند رد می‌شود.
بخش تخفیف، روش پرداخت و توضیحات
- تخفیف کل سفارش (
discount_amount) مبلغ کاهنده جمع اقلام است؛ درصد تخفیف نیست. قبل از اعمال، سقف مجاز و سیاست داخلی فروشگاه را کنترل کنید؛ تخفیف بیشتر از مبلغ کالا نباید مانده منفی بسازد. - مبلغ نهایی برابر جمع اقلام منهای تخفیف به اضافه هزینه ارسال است؛ اعداد فرم پیش‌نمایش‌اند. قیمت نهاییِ پذیرفته‌شده از پاسخ سرور معتبرتر است.
- روش پرداخت در فرم دستی فعلی دو انتخاب
manual_followup(هماهنگی پرداخت) وbank_transfer(واریز بانکی/کارت‌به‌کارت) دارد. انتخاب واریز بانکی به این معنی نیست که پول واقعاً به بانک رسیده است؛ تأیید دریافت مرحله جداگانه است. - شخصیت حسابداری (
legal_entity_id) در صورت نمایش/وجود باید با فروشنده و حساب‌های مالی مربوط سازگار باشد؛ تغییر دلخواه آن برای دورزدن خطای مالی صحیح نیست. - یادداشت سفارش برای توضیح کوتاه و غیرحساس است: «تحویل بعد از ساعت ۱۶» مفید است؛ شماره کارت کامل، رمز و اطلاعات شناسایی حساس را وارد نکنید.
- کلید جلوگیری از تکرار (
idempotency_key) توسط فرم تولید می‌شود، کاربر آن را نمی‌بیند. اگر ارسال شبکه قطع شد، ایجاد سفارش تازه با محتوای مشابه بدون بررسی فهرست می‌تواند مشکل‌ساز شود؛ ابتدا نتیجه درخواست اول را جست‌وجو کنید. - زمان ویرایش مورد انتظار (
expected_updated_at) هنگام اصلاح سفارش برای تشخیص تغییر هم‌زمان استفاده می‌شود. اگر شخص دیگری سفارش را تغییر داده، جزئیات تازه را باز کنید و روی داده قدیمی بازنویسی نکنید.
کدام اطلاعات قابل ویرایش‌اند؟
در کد، اجازه ویرایش سفارش دستی محدود است: سفارش باید در انتظار پرداخت باشد، پرداخت نشده باشد، سابقه پرداخت یا رسید نداشته باشد و کاربر مجوز ویرایش داشته باشد. بنابراین برای سفارش پرداخت‌شده، «ویرایش اقلام» را جایگزین مرجوعی، تعویض یا سند اصلاحی نکنید. پرداخت‌شدن یک مرز داده‌ای است.
سه خطای رایجِ هنگام ذخیره
۱. «تنوع پیدا نشد» یا «کالای فعال انتخاب کنید»: وضعیت انتشار محصول، فعال‌بودن تنوع و دسترسی Tenant را بررسی کنید. صرف نمایش محصول در فهرست مدیریتی کافی نیست.
۲. «مقدار سفارش معتبر نیست»: گام، حداقل خرید، دقت و موجودی قابل‌فروش را دوباره بخوانید. برای فروش وزنی، ورود عدد صحیحِ بزرگ به جای مقدار اعشاریِ واحد دیگر یکی از علل معمول است.
۳. «مشتری یا نشانی نامعتبر است»: مشتری موجود باید فعال و در محدوده مجوز باشد؛ نشانی انتخابی متعلق به همان مشتری باشد؛ در ارسال، نشانی جدید باید کامل شود.
پیش از ذخیره، این کنترل را انجام دهید
مشتری درست است؟ SKU و تنوع هر ردیف صحیح است؟ مقدار و واحد آن واقعی است؟ آیا قیمت واحد و تخفیف مجازند؟ روش تحویل با هزینه حمل سازگار است؟ وجه واقعاً دریافت شده یا هنوز در انتظار است؟ شخصیت حسابداری صحیح است؟ با این کنترل، بخش عمده خطاهای بعدی پیش از ایجاد رزرو و پرونده سفارش جلوگیری می‌شود.
برای ثبت نمونه کامل سفارش دستی از صفر و برای اثر رزرو انبار سفارش را بخوانید.