سكربت Python يحوّل تصديرات جهات الاتصال لديك إلى ملف CSV نظيف جاهز للاستيراد في خدمة القوائم البريدية

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

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

عن هذه الخدمة

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

ما المشمول

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

كيف يعمل

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

ما نحتاجه منك

العناوين و10-20 صفًا من كل تصدير بأسماء وعناوين بريد مختلقة لكن بالتنسيق نفسه، وأي عمود يوضح الموافقة وأيها يوضح إلغاء الاشتراك، وخدمة القوائم البريدية التي تستخدمها وقالب الاستيراد الخاص بها أو رابط إلى صفحة المساعدة في الاستيراد، وكيف تُضبط الوسوم أو الشرائح. كيف جُمعت جهات الاتصال (متجرك، نموذج تسجيل، فعاليات). لا ترسل القائمة الحقيقية أبدًا.

سنسألك:

• من أين تأتي جهات الاتصال؟
• إلى أي خدمة قوائم بريدية ستستورد؟
• كيف تُسجَّل الموافقة؟
• هل تحتاج إلى وسوم أو شرائح؟

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

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

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