🔐 المصادقة — 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"}'
🔗
ربط المستشار الذكي بمحرك التدقيق الضريبي
يمكنك إرسال نتائج تحليل المستشار الذكي مباشرةً إلى محرك التدقيق الضريبي، وسيُضمّن التقرير بياناتك الضريبية المحسوبة تلقائياً مع سجل الفواتير في حزمة واحدة جاهزة لـ Big-4.
⚡ 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"
}