ورود و خروج گروهی محصولات با CSV؛ پیش‌نمایش، اصلاح و ایمنی اطلاعات

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

گردش واقعی ورود فایل در پنل

وقتی فایل انتخاب می‌شود، ابتدا درخواست dry_run=true به API /products/import/ ارسال می‌شود. در پاسخ، تعداد ردیف‌ها، محصولات بررسی‌شده، محصولات جدید، محصولات به‌روزشده و تنوع‌های جدید/به‌روزشده نمایش داده می‌شود. پس از تأیید کاربر، همان فایل با dry_run=false ارسال می‌شود. متن خود پنل تصریح می‌کند که موجودی تغییر نمی‌کند. پس از واردسازی، باید موجودی اولیه یا تغییر انبار را جداگانه ثبت کنید.

قبل از آماده‌سازی فایل

ابتدا از فهرست فعلی با گزینه «دریافت فایل» خروجی بگیرید و ساختار ستون‌های پذیرفته‌شده را با همان نسخه API تطبیق دهید. بدون بررسی قرارداد واقعی واردساز، صرفاً از روی نام چند ستون حدس نزنید. فایل‌های CSV ممکن است در Excel با جداکننده، UTF-8 یا اعداد فارسی به مشکل بخورند؛ بعد از ذخیره، چند خط نمونه را در ویرایشگر متن باز کنید تا داده‌ها جابه‌جا نشده باشند.

کدام داده‌ها بیشترین ریسک را دارند؟

شناسه محصول و تنوع: کدهای تکراری یا نام‌گذاری ناسازگار می‌توانند رکورد نامناسب را به‌روزرسانی کنند یا خطای تطبیق بدهند.

دسته و ویژگی: ورود کالا زیر دسته نادرست باعث نمایش فیلدهای اشتباه می‌شود. اگر دسته ویژگی اجباری دارد، قبل از واردسازی داده را آماده کنید.

قیمت: واحد پول و عدد بدون جداکننده غیرمجاز را کنترل کنید. عدد ۱۰۰۰۰۰ ریال و ۱۰۰۰۰۰ تومان یک قیمت نیستند.

وضعیت و انتشار: ایجاد دسته بزرگی از محصولات فعال پیش از آماده‌بودن تصاویر و موجودی می‌تواند ویترین را پر از کالای ناقص کند. تا حد امکان ابتدا در حالت پیش‌نویس وارد کنید.

تنوع: هر ترکیب رنگ/سایز باید مستقل و معتبر باشد؛ ترکیب‌های تکراری یا ناقص خطرناک‌اند.

روش واردسازی مطمئن در شش قدم

۱. از وضعیت فعلی خروجی و نسخه پشتیبان منطقی بگیرید. ۲. نام و دسته‌ها را استاندارد کنید. ۳. فایل را ابتدا فقط برای سه تا پنج محصول نماینده آماده کنید: ساده، چندتنوعی، ناموجود، دارای مشخصات. ۴. پیش‌نمایش خشک را اجرا کنید و تعداد ایجاد/به‌روزرسانی را با انتظار تطبیق دهید. ۵. بعد از تأیید، اطلاعات همان چند محصول را در پنل و ویترین بررسی کنید. ۶. سپس فایل بزرگ را در دسته‌های قابل کنترل وارد کنید و تعداد نهایی را با گزارش تطبیق دهید.

مثال کاربردی

قرار است ۲۵۰ مدل لوازم تحریر از سیستم قدیمی منتقل شود. قبل از فایل کامل، پنج قلم از نوع‌های متفاوت انتخاب کنید: مداد ساده، دفتر چندرنگ، ماژیک بسته‌بندی‌شده، کالای ناموجود و کالای دارای برند. نام و کد تنوع را یکسان کنید. پیش‌نمایش نشان می‌دهد پنج محصول و چند تنوع قرار است ایجاد شوند. اگر خروجی ناگهان ۲۵۰ «محصول به‌روزشده» نشان داد ولی قصدتان ساخت محصول جدید بوده، اجرا را متوقف کنید و کلیدهای تطبیق را بررسی کنید.

خروجی گرفتن چه کاربردی دارد؟

فایل دریافت‌شده برای ممیزی دسته‌ها، قیمت‌ها، SKUها و آماده‌سازی اصلاحات گروهی مفید است. اما خروجی CSV گزارش قطعی موجودی ارزش‌گذاری‌شده یا دفترکل حسابداری نیست. برای گزارش مقدار موجودی و بهای تمام‌شده از زیرسیستم انبار و حسابداری استفاده کنید. فایل کاتالوگ را در محیط امن نگه دارید؛ ممکن است قیمت‌های حساس یا شناسه‌های داخلی داشته باشد.

اقدامات گروهی از خود فهرست

در فهرست می‌توان چند محصول را انتخاب و عملیات گروهی را از /products/bulk/ اجرا کرد. قبل از عملیات، تعداد انتخاب‌شده، فیلترهای فعال، دامنه صفحه‌بندی و اثر احتمالی بر وضعیت انتشار را بررسی کنید. انتخاب همه در صفحه جاری را با انتخاب کل مخزن اشتباه نگیرید. اقدامات تغییر قیمت درصدی، وضعیت، گروه‌بندی یا برچسب باید با نمونه کوچک و تأیید نتیجه آغاز شوند.

عیب‌یابی

CSV پذیرفته نمی‌شود: قالب فایل، ستون‌ها، کدگذاری، مقادیر اجباری و نام‌های معتبر را بررسی کنید. فایل را با اکسل دوباره ذخیره کرده‌اید؟ مطمئن شوید صفرهای ابتدایی SKU یا GTIN از بین نرفته‌اند.

شمار محصولات بیشتر از انتظار است: فایل را متوقف کنید؛ احتمال تکرار رکورد، کلیدهای ناسازگار یا تفکیک اشتباه رنگ‌ها وجود دارد.

قیمت صحیح است ولی موجودی صفر است: طبق قرارداد رابط، واردسازی موجودی را تغییر نمی‌دهد؛ باید مسیر انبار را جدا طی کنید.

برخی کالاها در ویترین نیستند: انتشار، تصویر، وضعیت تنوع و فیلتر قالب را بررسی کنید. موفقیت آپلود CSV به‌تنهایی به معنی انتشار نیست.

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

آزمون جلوگیری از خراب‌شدن داده با فایل نامعتبر

برای تیمی که هر هفته قیمت‌ها را گروهی وارد می‌کند، پیش از فایل اصلی سه آزمون با فایل نمونه انجام دهید: کدهای صفر ابتدایی (مثل 00120)، محصول دارای تنوع و فیلد فارسی با ویرگول یا نیم‌فاصله. اگر ابزار spreadsheet کد 00120 را به ۱۲۰ تبدیل کند، ممکن است ارتباط شناسه از بین برود. اگر ویرگول داخل عنوان بدون کوتیشن مناسب ذخیره شود، ستون‌ها جابه‌جا می‌شوند. پس فایل را هم در ابزار صفحه‌گسترده و هم به‌عنوان متن خام کنترل کنید.

تفاوت واردسازی «اصلاح قیمت» با «تعویض کاتالوگ»

وقتی قصد فقط اصلاح قیمت دارید، نباید بدون بررسی، تمام فیلدهای محصول را با مقادیر قدیمی یک فایل بازنویسی کنید. ابتدا قرارداد API واردساز و رفتار به‌روزرسانی را بررسی کنید: آیا فیلد خالی معنی «بدون تغییر» می‌دهد یا «پاک‌کردن مقدار»؟ آیا شناسایی رکورد با ID، SKU یا کلید دیگری انجام می‌شود؟ پاسخ دقیق به نسخه واردساز وابسته است؛ نتیجه dry_run باید با تعداد محصولات هدف برابر باشد. اگر این قرارداد روشن نیست، از عملیات گروهی اختصاصی یا ویرایش محدود امن‌تر استفاده کنید.

کنترل امنیت و مسئولیت

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

جمع‌بندی قابل اجرا برای مدیر فروش

اگر در پیش‌نمایش تعدادها مطابق انتظار نیستند، ادامه ندهید. اگر واردسازی موفق بود اما کالاها ناموجودند، به جای بارگذاری دوباره CSV سراغ موجودی بروید. اگر محصولی در ویترین نمایش داده نمی‌شود، وضعیت انتشار را بررسی کنید. اگر قیمت مؤثر از مقدار فایل متفاوت است، منبع قیمت‌گذاری و تنوع را بررسی کنید. هر مسئله در زیرسیستم مربوط باید اصلاح شود، نه اینکه با ارسال چندباره یک فایل حل شود.