دليل استخدام JSON في نقل البيانات بين الأنظمة المحاسبية

ما هو JSON؟

JSON (JavaScript Object Notation) هو صيغة بسيطة جداً لتبادل البيانات بين الأنظمة المختلفة. تخيل أنه "لغة مشتركة" بين البرامج.

مثال بسيط

{
  "اسم_العميل": "شركة النور للتجارة", 
  "رقم_الفاتورة": "INV-2026-001",
  "المبلغ": 15000,
  "العملة": "EGP",
  "حالة_الدفع": "مدفوع"
}

كل سطر = معلومة واحدة. النظام المحاسبي يقرأها ويفهمها فوراً!

لماذا JSON مهم للأنظمة المحاسبية؟

السيناريو التقليدي (بدون JSON)

موظف يُدخل البيانات يدوياً من Excel إلى البرنامج المحاسبي
أخطاء إملائية ورقمية كثيرة
يستغرق ساعات يومياً
صعوبة المتابعة والتدقيق

مع JSON (الأتمتة)

نظام المبيعات يُرسل بيانات الفواتير تلقائياً عبر API بصيغة JSON
النظام المحاسبي يستقبلها ويسجلها تلقائياً
خطأ صفر، وقت صفر

💡 توفير: من 3 ساعات يومياً إلى ثواني!

تركيبة JSON الأساسية

1. Object (كائن)

يبدأ بـ { وينتهي بـ }

{
  "key": "value",
  "المفتاح": "القيمة"
}

2. Array (قائمة)

يبدأ بـ [ وينتهي بـ ]

{
  "الفواتير": [
    {"رقم": "INV-001", "المبلغ": 5000},
    {"رقم": "INV-002", "المبلغ": 7500},
    {"رقم": "INV-003", "المبلغ": 3000}
  ]
}

3. أنواع البيانات

String (نص): "اسم العميل"
Number (رقم): 15000
Boolean (صح/خطأ): true أو false
Null (فارغ): null

مثال عملي: فاتورة مبيعات

{
  "رقم_الفاتورة": "INV-2026-125",
  "التاريخ": "2026-02-15",
  "العميل": {
    "الاسم": "مصنع الأهرام للبلاستيك",
    "رقم_التسجيل_الضريبي": "123456789",
    "العنوان": "العاشر من رمضان، مصر"
  },
  "المنتجات": [
    {
      "الكود": "PROD-001",
      "الاسم": "علبة بلاستيك 500 مل",
      "الكمية": 1000,
      "السعر_للوحدة": 5,
      "الإجمالي": 5000
    },
    {
      "الكود": "PROD-002",
      "الاسم": "علبة بلاستيك 1000 مل",
      "الكمية": 500,
      "السعر_للوحدة": 8,
      "الإجمالي": 4000
    }
  ],
  "الإجمالي_قبل_الضريبة": 9000,
  "ضريبة_القيمة_المضافة": 1260,
  "الإجمالي_النهائي": 10260,
  "حالة_الدفع": "مدفوع جزئياً",
  "المدفوع": 5000,
  "المتبقي": 5260
}

هذا الـ JSON يحتوي على كل معلومات الفاتورة بشكل منظم!

كيف تستخدم JSON مع الأنظمة المحاسبية؟

السيناريو 1: ربط Shopify بـ QuickBooks

عميل يشتري من متجر Shopify
Shopify يُنشئ JSON للطلب
n8n أو Zapier ينقل الـ JSON إلى QuickBooks API
QuickBooks يُنشئ فاتورة تلقائياً

السيناريو 2: تصدير بيانات من Excel إلى نظام ERP

1. تحويل Excel إلى JSON (أداة: convertcsv.com/csv-to-json.htm)
2. رفع JSON إلى ERP API
3. ERP يستورد البيانات تلقائياً

السيناريو 3: ربط نقاط البيع (POS) بالمخازن

عند كل عملية بيع، POS يُرسل JSON بالمنتجات المُباعة
نظام المخزون يستقبل JSON ويُحدّث الكميات
عندما يصل المخزون لحد معين، يُرسل إشعار تلقائي

أمثلة كود للتعامل مع JSON

قراءة JSON في JavaScript

// استقبال JSON من API
const data = {
  "اسم_العميل": "شركة النور",
  "المبلغ": 15000
};

// الوصول للبيانات
console.log(data.اسم_العميل); // "شركة النور"
console.log(data.المبلغ); // 15000

إنشاء JSON في Python

import json

# إنشاء قاموس
invoice = {
    "رقم_الفاتورة": "INV-001",
    "العميل": "مصنع الأهرام",
    "المبلغ": 10000
}

# تحويله لـ JSON
json_string = json.dumps(invoice, ensure_ascii=False)
print(json_string)

إرسال JSON عبر API

// باستخدام JavaScript Fetch API
fetch('https://accounting-system.com/api/invoices', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "رقم_الفاتورة": "INV-001",
    "المبلغ": 15000
  })
})

الأسئلة الشائعة

❓ هل JSON آمن؟

نعم، لكن يجب تشفير الاتصال بـ HTTPS وعدم وضع معلومات حساسة (كلمات مرور) في JSON غير مُشفر.

❓ ما الفرق بين JSON و XML؟

JSON أخف وأسرع. XML أقدم وأكثر تعقيداً. معظم الأنظمة الحديثة تستخدم JSON.

❓ كيف أتحقق من صحة JSON؟

استخدم JSONLint.com أو أداة API Tester الخاصة بنا.

❓ هل يدعم JSON اللغة العربية؟

نعم تماماً! JSON يدعم Unicode، لذا يمكنك استخدام العربية بدون مشاكل.

نصائح ذهبية

✅ استخدم أسماء مفاتيح واضحة (تجنب: "x", "data1")
✅ حافظ على التنسيق منظماً (استخدم Tools للتنسيق التلقائي)
✅ لا تنسى الفواصل (،) بين العناصر
✅ استخدم null للقيم الفارغة، لا تترك المفتاح فارغاً
✅ اختبر JSON قبل الإرسال (JSONLint)

تحتاج مساعدة في ربط أنظمتك المحاسبية؟
تواصل معنا