سكربت Python يحوّل ملف منتجات المورّد أو متجرك القديم إلى ملف CSV جاهز للاستيراد في Shopify

مثال على النتيجة

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  المجلد: sales/2026-10، عُثر على 9 ملفات
2026-11-02 09:14:03 INFO  shop-01.csv: 1,284 صفًا
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 صفًا
2026-11-02 09:14:04 WARN  shop-07.csv: تُخطّيت 3 صفوف بلا سعر (الأسطر 88، 412، 913)
2026-11-02 09:14:05 INFO  تم: 10,412 صفًا -> report-2026-10.xlsx (الورقتان «المبيعات» و«الإجماليات»)

[columns]
date = التاريخ, تاريخ البيع, اليوم
product = المنتج, الصنف, الاسم
quantity = الكمية, العدد, قطع
price = السعر, سعر الوحدة

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """يقرأ ملف متجر واحد ويمنح أعمدته أسماء أعمدة التقرير."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: لا يوجد عمود لـ «{name}» (جرى البحث عن: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

عن هذه الخدمة

يستورد Shopify المنتجات من ملف CSV، لكن بتنسيقه الخاص فقط: Handle واحد للمنتج وكل متغيراته، وأسماء الخيارات وقيمها في أعمدة محددة، والصور كروابط عامة. يحوّل سكربت Python هذا الملف الذي لديك، سواء كان قائمة أسعار مورّد أو تصديرًا من متجرك القديم أو ملف Excel الخاص بك، إلى ذلك التنسيق. يربط أعمدتك بأعمدة Shopify، وبدءًا من الباقة القياسية يحوّل المقاسات والألوان إلى متغيرات، وينظف الأسعار والمخزون ويضيف الوسوم. يتبع قالب CSV الحالي للمنتجات في Shopify، الذي يمكنك تنزيله من لوحة الإدارة. يجب أن تكون الصور على روابط يستطيع Shopify فتحها. تستورد الملف في Shopify بنفسك؛ ولا نسجّل الدخول إلى متجرك أبدًا. جرّب بضعة منتجات أولًا: النتيجة لا تكون أكمل من بياناتك.

ما المشمول

• ما الذي تحصل عليهأرشيف ZIP يضم سكربت Python وملف README بتعليمات خطوة بخطوة، ومن الباقة القياسية ملف إعدادات بخريطة الأعمدة؛ ويُعرض الكود أيضًا في صفحة الطلب.
• تنسيق Shopifyوفق قالب CSV الحالي للمنتجات في Shopify
• متغيرات مجمّعةبدءًا من الباقة القياسية، المقاسات والألوان تحت منتج واحد
• أسعار ومخزون نظيفةأرقام يقبلها Shopify، بلا رموز عملات ولا مسافات
• سرد المشكلاتيُبلَّغ عن الصفوف التي بلا سعر أو SKU أو صورة
• كود مقروءمع تعليقات، ليسهل إضافة عمود لاحقًا

كيف يعمل

1. 1
   الملفاتترسل عينة من ملف منتجاتك وتوضح ما يذهب إلى أين
2. 2
   الكودنكتب السكربت ودليل تشغيله
3. 3
   جرّبهتستورد بضعة منتجات إلى Shopify وتتحقق منها
4. 4
   التعديلاتتطلب التعديلات ضمن باقتك وترسل أي رسالة خطأ

ما نحتاجه منك

20-30 صفًا من الملف الذي لديك (قائمة أسعار المورّد، أو تصدير المتجر القديم، أو جدولك الخاص)، وكيف تُكتب المتغيرات فيه (صف لكل مقاس، أو المقاسات في خلية واحدة)، وأين الصور (روابط، أو ملفات سترفعها إلى Shopify أولًا)، وكيف تُحدد الأسعار. وإن كان لديك، تصدير لبضعة منتجات من متجرك على Shopify، لتتطابق الأعمدة تمامًا. نظامك: Windows أو macOS أو Linux.

سنسألك:

• ما الملف الذي لديك الآن؟
• كيف تُكتب المتغيرات فيه؟
• أين توجد الصور؟
• كيف يجب تحديد الأسعار؟

قارن بين الباقات

الأسئلة والأجوبة

لم تجد إجابتك؟ اسألنا