واجهة REST بصيغة JSON ومُدارة بالإصدارات، محمية بمصادقة لكل مفتاح. اشترك في خطافات الويب لـ 12 حدثًا تشمل المهام والفواتير والمدفوعات وعروض الأسعار والعملاء. متاحة في باقة Scale.
curl https://api.servicesynchq.com/api/v1/jobs \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"customerId": 12345,
"scheduledDate": "2026-08-20T14:00:00Z",
"title": "HVAC repair"
}'{ "id": 84213, "customerId": 12345, "status": "scheduled", "scheduledDate": "2026-08-20T14:00:00Z", "title": "HVAC repair", "createdAt": "2026-07-24T08:14:22Z"}لمحة عن نطاق الواجهة. العملاء والمهام والفواتير وعروض الأسعار والمدفوعات والمخزون والجدولة والإشعارات — جميعها تتيح عمليات CRUD كاملة عبر JSON.
عمليات CRUD كاملة عبر JSON، مؤمَّنة بواسطة X-API-Key.
سجّل نقطة نهاية وتفاعل في الوقت الفعلي.
طريقتان للتكامل — REST للقراءة والكتابة، وwebhooks للدفع الفوري في الوقت الفعلي.
/api/v1/customers
عرض قائمة بجميع العملاء.
ترقيم صفحات بالمؤشر (cursor)/api/v1/customers
أنشئ عميلًا جديدًا.
يدعم idempotency-key/api/v1/jobs
اعرض المهام مُرشَّحة حسب الحالة أو التاريخ.
قابل للفرز والتصفية/api/v1/jobs
جدولة مهمة جديدة. تُطلق job.created خطاف الويب.
/api/v1/invoices
عرض الفواتير مع الترقيم الصفحي.
مُدرِك للاختصاص الضريبي/api/v1/invoices/:id/send
أرسل الفاتورة عبر البريد الإلكتروني أو SMS. يُنشَأ IRN تلقائيًا للهند.
مدعوم بطابور إعادة المحاولةعيّنة تمثيلية تشمل العملاء · المهام · عروض الأسعار · الفواتير · المدفوعات · المخزون · المشتريات · الجدولة · الإشعارات. كل استدعاء ذي صلاحية يُسجَّل في سجل التدقيق. اطّلع على المرجع الكامل ←
مرّر رمز الدولة لتحصل على الحسابات الضريبية الصحيحة، وتخطيط المستند الصحيح، وحمولة الفاتورة الإلكترونية الصحيحة. نفس نقاط النهاية، وسلوك يراعي النطاق الضريبي — دون أي تفرُّعات خاصة بكل دولة في كود التكامل الخاص بك.
مرّر النية فقط — ونحن نحسب التفصيل الضريبي الصحيح. تغييرات الولاية، وتغييرات التسجيل، ومفاتيح النطاق الضريبي كلها بيانات وليست كودًا. عزل بمستوى مصرفي: بيانات كل عميل تعيش في خزينتها المنطقية الخاصة — وقاعدة البيانات نفسها ترفض خلط البيانات بين الخزائن، وليس كود التطبيق فقط.
هل ولاية المورّد نفسها ولاية العميل؟ CGST + SGST. مختلفة؟ IGST. تُحتسب من company.state مقابل customer.state.
يُنشئ IRN + رمز QR موقَّعًا عند POST. 24h cancellation window متاح عبر نقطة نهاية مخصّصة. أكواد HSN عبر البحث.
يُخصم تلقائيًا 20% / 30% / 0% بناءً على حالة تسجيل المقاول، لكل مقاول من الباطن.
فاتورة ثنائية اللغة للمرحلة الأولى + ترميز TLV QR لجميع 5 mandatory tags. يتم التحقق منها لدى ZATCA قبل العرض.
يتم توثيق كل طلب بمفتاح API يُرسَل في
X-API-Key الترويسة. تُنشئ المفاتيح بواسطة مسؤولي مستأجرك،
ويمكن إبطالها في أي وقت، ويُسجَّل كل استدعاء ذي صلاحية في سجل التدقيق.
تظهر المفاتيح مرة واحدة عند الإنشاء وتُخزَّن على شكل تجزئة (hash) فقط — ولا تُحفظ أبدًا كنص صريح.
X-API-Key الترويسة في كل طلب.
curl https://api.servicesynchq.com/api/v1/customers \
-H "X-API-Key: YOUR_API_KEY"
# 200 OK — returns your customers as JSON.
# Manage keys under Settings → API keys (admin only).اشترك في أحداث دورة الحياة عبر CRM والإرسال والفوترة والمدفوعات والمشتريات والتدقيق. كل خطاف ويب موقَّع تشفيريًا، ويُعاد إرساله بتراجع أُسّي، ومدعوم بطابور إعادة محاولة دائم.
job.created
تم إنشاء مهمة جديدة.
job.completed
تم وضع علامة اكتمال على المهمة.
job.status_changed
انتقلت مهمة إلى حالة جديدة.
invoice.created
تم إنشاء فاتورة جديدة.
invoice.paid
تم استلام دفعة الفاتورة.
invoice.overdue
تجاوزت الفاتورة تاريخ استحقاقها دون سداد.
payment.received
تم تسجيل دفعة من العميل.
customer.created
تمت إضافة عميل جديد.
estimate.sent
أُرسل عرض السعر إلى العميل.
estimate.accepted
قبِل العميل عرض السعر.
estimate.rejected
رفض العميل عرض السعر.
estimate.converted_to_job
تحوّل عرض السعر المقبول إلى مهمة.
حِزم SDK الرسمية قيد التطوير. وإلى حين إطلاقها، فإن واجهة REST API موثَّقة بالكامل أعلاه وتعمل مع أي عميل HTTP.
يُقيَّد كل طلب تلقائيًا ضمن نطاق مساحة عملك على مستوى طبقة قاعدة البيانات — وليس في كود التطبيق فحسب. لا يمكن حرفياً لاستعلام من مساحة عمل أن يقرأ بيانات مساحة عمل أخرى — قاعدة البيانات نفسها تفرض ذلك.
حدود استخدام عادلة مع سعة اندفاعية. يُعاد إرسال حدّك الحالي وحصتك المتبقية
مع كل استجابة في X-RateLimit-Limit / X-RateLimit-Remaining /
X-RateLimit-Reset الترويسات (مسودة معيار IETF). لن تحتاج أبدًا إلى التخمين بشأن المسموح به.
مساحة كافية للتكاملات الاعتيادية · الترويسات تُطلعك على ذلك في الوقت الفعلي
لمزامنة عالية الإنتاجية، والتصدير المجمَّع، وأعباء عمل ETL
تواصل مع المبيعات لتحديد الحجم المناسب
429 Too Many Requests مع Retry-After رأسًا في غضون ثوانٍ.
تتعامل حزم SDK الخاصة بنا مع هذا تلقائيًا عبر التراجع الأُسّي.
وإذا كنت بحاجة بانتظام إلى سقوف أعلى، تحدّث إلينا
— فالأرقام المنشورة هي حدود دنيا، لا حدود قصوى.
نحمي مفاتيحك تمامًا كما نحبّ أن تُحمى مفاتيحنا. إليك ما يمكنك الاعتماد عليه.
وثائق مرجعية، وسجل تغييرات، وشخص حقيقي على الطرف الآخر حين تتعثّر.
الوصول إلى API مُضمَّن في باقة Scale. اقرأ الوثائق أولاً، واحصل على مفاتيحك عندما تكون جاهزاً.