REST API للربط مع أنظمة المحاسبة

المصادقة

أرسل مفتاح المؤسسة في ترويسة Authorization. تُنشئ المفاتيح وتُلغى من الإعدادات، وكل استخدام يُسجَّل.

Authorization: Bearer zk_live_...

نقاط النهاية

• GET /api/v1/entities

  قائمة كيانات المؤسسة

  curl https://zakatos.vercel.app/api/v1/entities \
    -H "Authorization: Bearer zk_live_YOUR_KEY"

• POST /api/v1/trial-balances

  دفع ميزان مراجعة (وإنشاء الكيان اختياريًا) — يعيد الاحتساب فورًا

• GET /api/v1/entities/{id}/calculation

  الاحتساب الكامل لكيان

  curl https://zakatos.vercel.app/api/v1/entities/ENTITY_ID/calculation \
    -H "Authorization: Bearer zk_live_YOUR_KEY"

مثال كامل — دفع ميزان من نظامك

curl -X POST https://zakatos.vercel.app/api/v1/trial-balances \
  -H "Authorization: Bearer zk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entity": { "nameAr": "شركة المثال التجارية", "crNumber": "1010123456", "sector": "trading" },
    "fileName": "qoyod-tb-2025.csv",
    "rows": [
      { "code": "1110", "name": "نقد في الصندوق", "debit": 50000, "credit": 0 },
      { "code": "3100", "name": "رأس المال", "debit": 0, "credit": 1000000 },
      { "code": "1610", "name": "مباني تشغيلية", "debit": 400000, "credit": 0 }
    ]
  }'

التصدير من الأنظمة الشائعة

• قيود / Zoho / Xero: صدّر «ميزان المراجعة» CSV بأعمدة code, account_name, debit, credit ثم ادفع الصفوف كما هي.
• QuickBooks / Odoo / SAP: التصدير الهرمي (عمود Account موحّد + أرصدة ختامية مدين/دائن) مدعوم في معالج الرفع داخل المنصة؛ عبر الـ API أرسل الصفوف التفصيلية فقط.
• الحسابات غير الواضحة تُعلَّم «تحتاج مراجعة» ويمكن تصنيفها يدويًا أو باقتراحات الذكاء الاصطناعي من صفحة الحاسبة.