S&R CoreSync
S&R CoreSync Sovereign Business Platform — API Docs v3.1
OpenAPI 3.1 · OAuth2 · REST + Webhooks

📡 توثيق API السيادي الموحّد

الوصول الكامل لجميع نقاط نهاية منظومة S&R CoreSync — المحاسبة، الضرائب، التدقيق، المستشار الذكي — بـ 29 لغة عالمية مع SDK جاهز للتكامل الفوري.

47+Endpoints
29لغة عالمية
OAuth2Authentication
99.9%Uptime SLA

🔐 المصادقة — OAuth2 & JWT

الحصول على رمز الوصول للوصول لجميع نقاط النهاية

POST /v3/auth/token الحصول على JWT Token

أرسل بيانات اعتمادك للحصول على رمز وصول صالح لمدة 24 ساعة.

POST https://api.sr-coresync.com/v3/auth/token Content-Type: application/json { "client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET", "grant_type": "client_credentials", "scope": "advisor:read tax:write audit:full" } // Response { "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...", "token_type": "Bearer", "expires_in": 86400, "scope": "advisor:read tax:write audit:full" }
POST /v3/auth/refresh تجديد رمز الوصول
POST https://api.sr-coresync.com/v3/auth/refresh Authorization: Bearer {refresh_token} // Response: نفس بنية /token مع رمز جديد

🧠 API المستشار الذكي

تحليل ضريبي، توصيات استراتيجية، حساب KIA وZelfstandigenaftrek

POST /v3/advisor/analyze تحليل ضريبي واستراتيجي شامل
POST https://api.sr-coresync.com/v3/advisor/analyze Authorization: Bearer {token} Content-Type: application/json { "revenue": 120000, "sector": "tech", "legal_entity": "eenmanszaak", "year": 2026, "language": "ar" } // Response { "tax_analysis": { "zelfstandigenaftrek": 2460, "kia_rate": 0.28, "kia_amount": 33600, "mkb_vrijstelling": 0.1331, "net_taxable": 83940, "estimated_tax": 32400 }, "recommendations": [ { "priority": "high", "title": "تحويل إلى BV عند €85k ربح", "saving": 8200 }, { "priority": "medium", "title": "تعظيم KIA بشراء أصول", "saving": 4100 } ], "audit_risk_score": 23, "bv_breakeven": 85000 }
GET /v3/advisor/report/{session_id} استرجاع تقرير محفوظ
GET https://api.sr-coresync.com/v3/advisor/report/sess_abc123 Authorization: Bearer {token} // يُعيد تقرير JSON كامل مع توصيات للتصدير أو الربط مع التدقيق

🔍 API التدقيق الضريبي

مطابقة الفواتير، IFRS، AAOIFI، تصدير حزمة Big-4

POST /v3/audit/run تشغيل مطابقة ضريبية كاملة
POST https://api.sr-coresync.com/v3/audit/run Authorization: Bearer {token} { "records": [ { "invoice_id": "INV-2601", "net": 10000, "vat": 2100, "standard": "IFRS" } ], "export_format": "json", "link_advisor_session": "sess_abc123" } // Response: نتائج مطابقة + ربط تلقائي بتقرير المستشار الذكي { "audit_id": "AUD-2026-001", "findings": 2, "balanced": 18, "advisor_link": "/v3/advisor/report/sess_abc123", "export_url": "https://api.sr-coresync.com/v3/audit/export/AUD-2026-001" }
GET /v3/audit/export/{audit_id} تصدير حزمة تدقيق Big-4
GET https://api.sr-coresync.com/v3/audit/export/AUD-2026-001?format=pdf Authorization: Bearer {token} // يُنزّل ملف PDF/JSON/CSV جاهز للمراجعة بمعايير Big-4

🌍 بوابات API الـ 29 لغة

كل بوابة تدعم لغتها الكاملة مع Base URL منفصل

📦 SDK متعدد اللغات البرمجية

مكتبات جاهزة للتكامل الفوري مع منظومتك

// npm install @sr-coresync/sdk import { CoreSyncClient } from '@sr-coresync/sdk'; const client = new CoreSyncClient({ clientId: process.env.CORESYNC_CLIENT_ID, clientSecret: process.env.CORESYNC_CLIENT_SECRET, language: 'ar' // أو أي من الـ 29 لغة }); // تحليل ضريبي const result = await client.advisor.analyze({ revenue: 120000, sector: 'tech', year: 2026 }); // ربط مع التدقيق تلقائياً const audit = await client.audit.run({ records: myInvoices, linkAdvisorSession: result.session_id }); console.log(audit.findings); // 2 استثناءات للمراجعة
# pip install sr-coresync from sr_coresync import CoreSyncClient client = CoreSyncClient( client_id=os.getenv("CORESYNC_CLIENT_ID"), client_secret=os.getenv("CORESYNC_CLIENT_SECRET"), language="ar" ) # تحليل ضريبي result = client.advisor.analyze( revenue=120000, sector="tech", year=2026 ) # ربط التدقيق بالمستشار audit = client.audit.run( records=my_invoices, link_advisor_session=result["session_id"] ) print(f"استثناءات: {audit['findings']}")
getenv('CORESYNC_CLIENT_ID'), 'client_secret' => getenv('CORESYNC_CLIENT_SECRET'), 'language' => 'ar' ]); $result = $client->advisor->analyze([ 'revenue' => 120000, 'sector' => 'tech', 'year' => 2026 ]); $audit = $client->audit->run([ 'records' => $myInvoices, 'link_advisor_session' => $result['session_id'] ]); ?>
# الحصول على Token curl -X POST https://api.sr-coresync.com/v3/auth/token \ -H "Content-Type: application/json" \ -d '{"client_id":"YOUR_ID","client_secret":"YOUR_SECRET","grant_type":"client_credentials"}' # تحليل ضريبي curl -X POST https://api.sr-coresync.com/v3/advisor/analyze \ -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ -d '{"revenue":120000,"sector":"tech","year":2026,"language":"ar"}'

⚡ Webhooks — الإشعارات الفورية

استقبل إشعارات فورية عند اكتمال التدقيق أو التحليل

POST /v3/webhooks/register تسجيل Webhook جديد
{ "url": "https://your-system.com/webhook", "events": ["audit.completed", "advisor.analyzed", "invoice.flagged"], "secret": "YOUR_WEBHOOK_SECRET" } // Payload المُرسَل عند الحدث: { "event": "audit.completed", "audit_id": "AUD-2026-001", "findings": 2, "advisor_session": "sess_abc123", "timestamp": "2026-11-06T03:38:00Z" }