الرياض، المملكة العربية السعودية

أهلًا بك

نمزج الاستراتيجية والتصميم والهندسة لنبني أنظمة ذكية تساعد المنشآت في السعودية والخليج على النمو والتميّز.

عُروة

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

  • منتج من شفرة
  • التكامل والواجهات البرمجية
  • منصات SaaS
  • لمحة

القطاع

التكامل والواجهات البرمجية

المنصات

Web · REST API · SDKs · Webhooks

الوحدات

8

التكاملات

8

الشاشات

4

المدة الإجمالية

22 أسبوعًا

يربط «عُروة» أي نظام، من تخطيط الموارد ونقاط البيع والمتاجر الإلكترونية إلى أنظمة المستشفيات والجهات الحكومية، بموصلات جاهزة عبر واجهة REST واحدة: الفوترة الإلكترونية مع هيئة الزكاة والضريبة والجمارك، وواتساب للأعمال، وسلة وزد وفودكس، والمدفوعات، والرسائل النصية، والنفاذ الوطني، والعنوان الوطني. وتتولى المنصة التوقيع وإعادة المحاولة والمراقبة وقياس الاستخدام، فيكتب الفريق التقني التكامل مرة واحدة ويطلقه بثقة.

عُروة: الشاشة 1
لوحة التشغيل: الطلبات في الدقيقة ومعدل الأخطاء وزمن الاستجابة وصحة كل موصل في شاشة واحدة.
  • التحدي

  1. 01

    كل نظام يبني ربطه مع منصة فاتورة من الصفر: الشهادات والتوقيع وسلسلة التجزئة ورمز QR، ثم يتعطل مع أول تحديث للمواصفات.

  2. 02

    الربط مع واتساب والمتاجر وبوابات الدفع يُعاد بناؤه في كل مشروع، بمفاتيح مبعثرة وصيغ بيانات مختلفة وبلا توثيق موحّد.

  3. 03

    الإشعارات الراجعة تضيع إذا تعطّل النظام المستقبِل، فلا إعادة محاولة ولا سجل يثبت ما أُرسل ومتى.

  4. 04

    عند تعطّل جهة خارجية لا يعرف الفريق موضع الخلل: في نظامه أم في الربط أم عند المزوّد، فيمتد التشخيص لساعات.

لمن صُمّم

  • مدير التقنية

    تكاملات موثوقة بضوابط أمنية واضحة دون فريق مستقل لكل جهة

  • مطوّر التكامل

    توثيق واضح وبيئة تجريبية ومفاتيح اختبار ليبدأ من الساعة الأولى

  • مهندس التشغيل

    سجل وتتبع لكل طلب، وتنبيه قبل أن يلاحظ العميل

  • مسؤول الامتثال الضريبي

    حالة كل فاتورة لدى الهيئة وسبب أي رفض في مكان واحد

  • مزوّد البرمجيات

    يقدّم الربط لعملائه باسمه، مع فصل كامل بين المستأجرين وفوترة حسب الاستخدام

  • الوحدات

ما الذي يقدّمه النظام

وحدات مترابطة تعمل على بيانات واحدة.

  • 01

    موصلات جاهزة

    فاتورة وواتساب وسلة وزد وفودكس والدفع والرسائل النصية والنفاذ والعنوان الوطني بمخطط بيانات موحّد

  • 02

    محرّك الفوترة الإلكترونية

    إنشاء UBL 2.1 والتجزئة والختم والعدّاد ورمز QR، والاعتماد أو الإبلاغ، وإصدار شهادات CSID وتجديدها

  • 03

    الواجهة الموحّدة وحزم التطوير

    واجهة REST موصوفة بـ OpenAPI 3.1، وحزم Node.js وPython وJava و‎.NET وPHP، ومفاتيح لمنع التكرار

  • 04

    الإشعارات الراجعة

    توقيع HMAC وإعادة محاولة بتراجع أسّي وطابور للرسائل المتعثرة مع إعادة إرسال يدوية

  • 05

    المفاتيح والوصول

    مفاتيح API وعملاء OAuth 2.0 بنطاقات محددة، وحدود طلبات وحصص لكل مستأجر

  • 06

    المراقبة والتتبع

    سجل لكل طلب وتتبع موزّع بمعيار OpenTelemetry، ومعدل الأخطاء وزمن الاستجابة لكل موصل

  • 07

    بوابة المطوّرين

    توثيق تفاعلي وبيئة تجريبية وبيانات اعتماد اختبارية ومحاكاة لأخطاء المزوّدين

  • 08

    قياس الاستخدام والفوترة

    عدّ الطلبات والفواتير والرسائل لكل مستأجر، وخطط أسعار، وفاتورة شهرية

أين يعمل الذكاء الاصطناعي

  • AI · 01

    مساعد لغوي خاص (داخل المملكة) يشرح رسائل التحقق من الهيئة، مثل BR-CO-15 وBR-KSA-37، بلغة واضحة ويحدد الحقل الذي يحتاج تصحيحًا.

  • AI · 02

    كشف للشذوذ على مقاييس كل موصل، من معدل الأخطاء وزمن الاستجابة إلى حجم الطلبات، ينبّه عند انحراف غير معتاد قبل بلوغ الحد الثابت.

  • AI · 03

    مساعد لربط الحقول يقترح المطابقة بين حقول نظام العميل والمخطط الموحّد، اعتمادًا على أسماء الحقول وعينات من البيانات.

  • AI · 04

    مساعد في بوابة المطوّرين يجيب من التوثيق، ويولّد أمثلة برمجية باللغة التي يستخدمها المطوّر.

  • الشاشات

شاشات النظام كما يستخدمها فريق العميل وعملاؤه.

عُروة: الشاشة 2
سجل الفواتير الإلكترونية: حالة كل فاتورة لدى الهيئة، وسبب الحجز أو الرفض، ومسار الطلب، واقتراح التصحيح.
عُروة: الشاشة 3
بوابة المطوّرين: مفاتيح تجريبية، ومثال جاهز بحزمة التطوير، وسجل الطلبات التجريبية، من التسجيل حتى أول فاتورة.
عُروة: الشاشة 4
الإشعارات الراجعة: كل تسليم موقّع، وإعادة محاولة بتراجع أسّي، وطابور للمتعثرة يُعاد إرساله بضغطة.
  • البنية التقنية

خدمات مستقلة، بيانات داخل المملكة، وتكاملات عبر واجهات موثّقة.

القنوات

  • Customer systems: تخطيط موارد ونقاط بيع ومتاجر
  • SDKs: Node و Python و Java و ‎.NET
  • Console & portal: لوحة التشغيل وبوابة المطوّرين

البوابة

  • API gateway: TLS وحدود الطلبات لكل مستأجر
  • Auth server: مفاتيح API وOAuth 2.0

الخدمات

  • Connector runtime: تحويل الصيغ واستدعاء المزوّد
  • E-invoicing engine: UBL والختم والاعتماد
  • Webhook dispatcher: التوقيع وإعادة المحاولة
  • Metering & billing: الاستخدام والفواتير الشهرية

الذكاء الاصطناعي

  • Anomaly detection: انحراف الأخطاء والزمن
  • Fix assistant: شرح الرفض واقتراح التصحيح
  • Mapping assistant: مطابقة الحقول

البيانات

  • PostgreSQL: المستأجرون والإعدادات والفواتير
  • Kafka: الأحداث وطوابير التسليم
  • ClickHouse: سجلات الطلبات والتتبع
  • Vault · HSM: الشهادات والمفاتيح الخاصة

التكاملات

  • ZATCA Fatoora: الاعتماد والإبلاغ
  • WhatsApp Cloud API: الرسائل والقوالب
  • Salla · Zid · Foodics: الطلبات والمنتجات
  • Payments · SMS: مزوّد الدفع وبوابات الرسائل
  • Nafath · SPL: الهوية والعنوان الوطني

الاتصالات

  • من Customer systems إلى API gateway: REST
  • من SDKs إلى API gateway: HTTPS
  • من Console & portal إلى API gateway
  • من SDKs إلى Auth server: OAuth
  • من Console & portal إلى Auth server
  • من API gateway إلى Connector runtime
  • من API gateway إلى E-invoicing engine
  • من API gateway إلى Metering & billing: usage
  • من Connector runtime إلى Kafka: events
  • من Connector runtime إلى ClickHouse: logs
  • من E-invoicing engine إلى Vault · HSM: sign
  • من E-invoicing engine إلى PostgreSQL
  • من E-invoicing engine إلى Fix assistant
  • من Connector runtime إلى Anomaly detection
  • من Connector runtime إلى Mapping assistant
  • من Webhook dispatcher إلى Kafka: consume
  • من Metering & billing إلى ClickHouse
  • من Anomaly detection إلى ClickHouse
  • من E-invoicing engine إلى ZATCA Fatoora: REST
  • من Connector runtime إلى WhatsApp Cloud API
  • من Connector runtime إلى Salla · Zid · Foodics
  • من Connector runtime إلى Payments · SMS
  • من Connector runtime إلى Nafath · SPL

التقنيات

  • Go
  • NestJS
  • Next.js
  • PostgreSQL
  • Redis
  • Kafka
  • ClickHouse
  • OpenTelemetry
  • Kubernetes
  • Vault · HSM
  • سير العمل

رحلة الفاتورة الإلكترونية عبر عُروة

  1. 01

    النظام يرسل الفاتورة بالمخطط الموحّد

    نظام العميلREST API · SDK

  2. 02

    التحقق من المفتاح والنطاق وحد الطلبات

    آليAPI gateway

  3. 03

    التحويل إلى UBL 2.1 والتحقق المسبق من القواعد

    آليE-invoicing engine

  4. 04

    التجزئة والعدّاد وسلسلة الفواتير، وختم الفاتورة المبسطة

    آليVault · HSM

  5. 05

    الاعتماد للفاتورة الضريبية أو الإبلاغ للمبسطة

    آليZATCA Fatoora

  6. 06

    حفظ الفاتورة المعتمدة ورمز QR

    آليPostgreSQL · Object storage

  7. 07

    إشعار موقّع إلى النظام مع إعادة المحاولة

    آليWebhook dispatcher

  8. 08

    مراجعة المحجوز والمرفوض وتصحيحه وإعادة إرساله

    مسؤول الامتثالConsole · Fix assistant

  9. 09

    احتساب الاستخدام في فاتورة الشهر

    آليMetering

  • البيانات والواجهات

الكيانات الأساسية وعلاقاتها، ومثال حي من الواجهة البرمجية.

Tenant

  • iduuidPK
  • nametext
  • planenum
  • parent_iduuidFK
  • rate_limit_rpmint
  • statusenum
  • created_attimestamptz

ApiCredential

  • iduuidPK
  • tenant_iduuidFK
  • kindenum(api_key,oauth_client)
  • prefixtext
  • secret_hashtext
  • scopestext[]
  • envenum(sandbox,live)
  • last_used_attimestamptz
  • revoked_attimestamptz

Connection

  • iduuidPK
  • tenant_iduuidFK
  • connectorenum
  • configjsonb
  • secret_reftext
  • statusenum
  • health_checked_attimestamptz

EgsUnit

  • iduuidPK
  • connection_iduuidFK
  • serialtext
  • csid_reftext
  • csid_expires_attimestamptz
  • icvbigint
  • last_hashtext

EInvoice

  • iduuidPK
  • egs_unit_iduuidFK
  • uuiduuidunique
  • numbertext
  • typeenum(standard,simplified,credit,debit)
  • icvbigint
  • hashtext
  • statusenum
  • zatca_messagesjsonb

RequestLog

  • idtextPK
  • tenant_iduuid
  • connection_iduuid
  • methodtext
  • pathtext
  • statussmallint
  • latency_msint
  • trace_idtext
  • attimestamptz

WebhookEndpoint

  • iduuidPK
  • tenant_iduuidFK
  • urltext
  • eventstext[]
  • secret_reftext
  • activebool

WebhookDelivery

  • idtextPK
  • endpoint_iduuidFK
  • eventtext
  • payload_reftext
  • attemptsmallint
  • response_codesmallint
  • next_retry_attimestamptz
  • statusenum(delivered,retrying,dead)
  • Tenant 1—∞ ApiCredential
  • Tenant 1—∞ Connection
  • Connection 1—∞ EgsUnit
  • EgsUnit 1—∞ EInvoice
  • Connection 1—∞ RequestLog
  • Tenant 1—∞ WebhookEndpoint
  • WebhookEndpoint 1—∞ WebhookDelivery
POST /v1/einvoices إصدار فاتورة إلكترونية واعتمادها أو الإبلاغ عنها

الطلب

{
  "type": "standard",
  "egs_unit": "EGS-RYD-03",
  "number": "INV-26-118402",
  "issue_date": "2026-11-08",
  "issue_time": "11:02:40",
  "buyer": {
    "vat_number": "310122393500003",
    "national_address": {
      "building_no": "7421",
      "additional_no": "3184",
      "street": "King Fahd Rd",
      "district": "Al Olaya",
      "city": "Riyadh",
      "postal_code": "12214"
    }
  },
  "lines": [
    { "sku": "SRV-0042", "qty": 12, "unit_price": 3500.00, "vat_category": "S" }
  ]
}

الاستجابة

{
  "id": "einv_01M6Q8JX2T",
  "number": "INV-26-118402",
  "status": "cleared",
  "icv": 118402,
  "uuid": "6f4c1e2a-8b3d-4c7e-9a51-2d0f7b3e9c14",
  "hash": "q0Yb3Jp8…Z1k=",
  "totals": { "net": 42000.00, "vat": 6300.00, "gross": 48300.00 },
  "zatca": { "clearance_status": "CLEARED", "warnings": [] },
  "qr": "AQ1TYW1wbGUgU2VsbGVy…",
  "cleared_xml_url": "/files/einv/01M6Q8JX2T.xml"
}

حدث Webhook · einvoice.cleared

{
  "event": "einvoice.cleared",
  "id": "evt_01M6Q8K2V7",
  "einvoice": "INV-26-118402",
  "egs_unit": "EGS-RYD-03",
  "clearance_status": "CLEARED",
  "gross": 48300.00,
  "currency": "SAR",
  "at": "2026-11-08T11:02:42+03:00"
}
  • التكاملات

  • منصة فاتورة

    الاعتماد والإبلاغ في مرحلة الربط والتكامل، وإصدار شهادات CSID

  • واتساب للأعمال (Cloud API)

    رسائل القوالب والمحادثات وحالات التسليم والقراءة

  • سلة · زد

    الطلبات والمنتجات والمخزون من المتاجر الإلكترونية

  • فودكس

    طلبات نقاط البيع والقوائم والفروع للمطاعم

  • مزوّد الدفع

    مدى وApple Pay وSTC Pay عبر مزوّد دفع مرخّص من البنك المركزي السعودي

  • بوابات الرسائل النصية

    رموز التحقق والإشعارات بأسماء مرسلين مسجّلة لدى هيئة الاتصالات والفضاء والتقنية

  • نفاذ

    تسجيل الدخول والتحقق من الهوية عبر النفاذ الوطني الموحّد

  • العنوان الوطني

    التحقق من العنوان الوطني وتوحيده للشحن والفواتير

  • الأمان والامتثال

  • استضافة البيانات والسجلات والنسخ الاحتياطية داخل المملكة.
  • ضوابط الهيئة الوطنية للأمن السيبراني: الضوابط الأساسية (ECC) وضوابط الحوسبة السحابية (CCC).
  • المفاتيح الخاصة وشهادات الختم (CSID) محفوظة في HSM أو Vault ولا تغادره، مع تدوير مُجدول.
  • فصل كامل بين المستأجرين في البيانات والمفاتيح وحدود الطلبات.
  • توقيع كل إشعار راجع بـ HMAC-SHA256 مع طابع زمني يمنع إعادة الإرسال الخبيثة.
  • التوافق مع نظام حماية البيانات الشخصية (PDPL)، وإخفاء أرقام الهوية والجوال في السجلات.
  • مفاتيح API محفوظة بقيمة مُجزّأة فقط، وسجل تدقيق غير قابل للتعديل لكل تغيير في الإعدادات.
  • خطة التنفيذ

مراحل واضحة بمخرجات قابلة للقياس.

  1. 01

    الاكتشاف وحصر التكاملات

    • حصر الأنظمة والجهات وأحجام الطلبات
    • تحديد المخطط الموحّد ومتطلبات الأمن
    أسبوعان
  2. 02

    البنية وتصميم الواجهة

    • مواصفة OpenAPI ونموذج الأخطاء
    • تصميم تعدد المستأجرين والمفاتيح
    3 أسابيع
  3. 03

    النواة والفوترة الإلكترونية

    • البوابة والهوية والإشعارات الراجعة
    • محرّك الفوترة واجتياز فحوص الامتثال في البيئة التجريبية للهيئة
    7 أسابيع
  4. 04

    الموصلات

    • واتساب وسلة وزد وفودكس والدفع والرسائل النصية
    • النفاذ الوطني والعنوان الوطني
    5 أسابيع
  5. 05

    المراقبة وبوابة المطوّرين

    • السجلات والتتبع والتنبيهات
    • التوثيق والبيئة التجريبية وحزم التطوير
    3 أسابيع
  6. 06

    اختبار الحمل والإطلاق

    • اختبار حمل واختبار اختراق
    • نقل الأنظمة إلى المنصة تدريجيًا
    أسبوعان
المدة الإجمالية
22 أسبوعًا
الفريق
مدير مشروع، مهندس حلول، 3 مطوّرين للخلفية، مطوّر واجهات، مهندس موثوقية وDevOps، مختبر جودة وأمن.

مؤشرات الأداء

  • 99.95% إتاحة الواجهة البرمجية
  • أقل من 80 ملّي ثانية الزمن الذي تضيفه المنصة (p95) دون زمن المزوّد
  • 99.99% إشعارات راجعة تُسلَّم بعد إعادة المحاولة
  • أقل من 15 دقيقة من التسجيل إلى أول طلب تجريبي ناجح

عندك مشروع مشابه؟

ابدأ مشروعًا
تواصل معنا