سكربت Google Apps Script يحوّل صفوف جدول بيانات Google لديك إلى فواتير PDF على قالبك بزر واحد

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

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

عن هذه الخدمة

إن كنت تحتفظ بالطلبات أو ساعات العمل في جدول بيانات Google، فإن إعداد كل فاتورة يدويًا يعني نسخ العميل والبنود والمجاميع إلى مستند وحفظ ملف PDF. يضيف سكربت Google Apps Script هذا زرًا إلى جدولك: يملأ قالب فاتورتك الخاص في مستندات Google أو جداول بيانات Google ببيانات الصف، ويحفظ ملف PDF بالاسم الذي تريده في مجلد على Drive، ويعيد الرابط إلى الصف. بدءًا من الباقة القياسية يتعامل مع عدة أسطر بنود والترقيم؛ وفي الباقة المميزة يمكنه إرسال كل ملف PDF من Gmail الخاص بك إلى عميلك. المجاميع والضرائب والصياغة تأتي من جدولك وقالبك: يُجري السكربت الحسابات التي تصفها ولا يقدم نصائح ضريبية أو محاسبية، لذا تحقق من الفواتير الأولى. تثبّته وتشغّله في حسابك على Google.

ما المشمول

• ما الذي تحصل عليهأرشيف ZIP يضم كود Apps Script وملف README يوضح كيفية إضافته إلى جدولك وقالبك؛ ويُعرض الكود أيضًا في صفحة الطلب.
• قالبك الخاصتخطيطك وشعارك وصياغتك في مستندات Google أو جداول بيانات Google
• PDF إلى Driveمسمّى بالرقم والعميل والتاريخ، في المجلد الذي تحدده
• رابط في الصفترى الصفوف التي لديها فاتورة بالفعل
• الترقيمبدءًا من الباقة القياسية، يُؤخذ الرقم التالي من جدولك
• كود مقروءمع تعليقات، ليسهل تغيير أي حقل لاحقًا

كيف يعمل

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

ما نحتاجه منك

أسماء أعمدة جدولك مع صفين أو ثلاثة ببيانات مختلقة، وقالب فاتورتك (مستند أو جدول من Google، أو ملف PDF لفاتورة ترسلها حاليًا) مع أماكن كل قيمة، وطريقة حساب المجاميع: نسبة الضريبة والخصومات والعملة والتقريب، كما يخبرك محاسبك. طريقة ترقيم الفواتير وتسميتها، ومجلد Drive لملفات PDF، ونص الرسالة إلى العميل للباقة المميزة.

سنسألك:

• عمّ تصدر الفواتير؟
• ما أعمدة الجدول؟
• كيف تبدو فاتورتك؟
• كيف تُحسب المجاميع؟

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

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

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