تخطَّ إلى المحتوى

واجهة ميزان البرمجية

ابنِ فوق دفاترك

واجهة REST عامة تصل إلى نفس البيانات التي تراها في الواجهة: العملاء والمنتجات والفواتير والقيود. مع توثيق OpenAPI، ومكتبة تطوير، وWebhooks تُخبر نظامك بما حدث فور حدوثه.

  • REST + JSON
  • OpenAPI
  • Webhooks

ما الذي تحصل عليه

  • REST API عامة

    قراءة وإنشاء وتحديث على موارد ميزان الأساسية.

  • توثيق OpenAPI

    وصف رسمي للواجهة يصلح لتوليد العميل الذي تحتاجه.

  • Webhooks

    أحداث تصل إلى نظامك بدل أن تستعلم أنت كل دقيقة.

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

    المفتاح يعمل ضمن صلاحيات المنشأة، لا فوقها.

  • إنشاء جماعي

    نقاط نهاية للإنشاء الجماعي للترحيل والاستيراد الأولي.

المضيف

https://apiv2.mezan.sa

النمط
REST
الصيغة
JSON
الوصف
OpenAPI
الأحداث
Webhooks

واجهة JSON عبر HTTPS، بمصادقة على مستوى المنشأة.

الموارد المتاحة

نفس الموارد التي تعمل عليها الواجهة، بنفس القواعد المحاسبية. الفاتورة المُنشأة عبر الواجهة تُنشئ قيدها وتتبع مسار الفوترة الإلكترونية تماماً كالفاتورة المُنشأة يدوياً.

المبيعات

  • العملاء
  • عروض الأسعار
  • فواتير المبيعات
  • سندات القبض
  • الإشعارات الدائنة

المشتريات

  • الموردون
  • أوامر الشراء
  • فواتير المشتريات
  • سندات الصرف
  • الإشعارات المدينة

المنتجات والمخزون

  • المنتجات والتصنيفات
  • المستودعات
  • الكميات والحركات
  • وحدات القياس
  • الأرقام التسلسلية

المحاسبة

  • دليل الحسابات
  • القيود اليدوية
  • الأبعاد المحاسبية
  • الأرصدة
  • أنواع الضرائب

من صفر إلى أول طلب

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

  1. 1

    فعّل الواجهة

    الوصول إلى الواجهة والWebhooks متاح ضمن الباقات المتقدمة. راجع صفحة الأسعار لمعرفة ما تشمله باقتك.

  2. 2

    أنشئ مفتاحاً

    المفتاح يُنشأ من داخل المنشأة ويعمل ضمن صلاحياتها. لا يمنح المفتاح ما لا يملكه صاحبه.

  3. 3

    اقرأ الوصف

    وثيقة OpenAPI تصف الموارد والحقول، وتصلح لتوليد عميل بلغتك بدل كتابته يدوياً.

  4. 4

    استقبل الأحداث

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

Webhooks

لا تستعلم كل دقيقة

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

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

استخدامات شائعة

  • مزامنة المخزون

    مع منصة بيع أو مستودع خارجي.

  • لوحات تحكم

    تغذية لوحاتك الداخلية بأرقام حيّة.

  • أنظمة داخلية

    ربط ميزان بنظام تشغيلك الخاص.

تبحث عن ربط متجرك في سلة أو زد؟ ذلك جاهز ولا يحتاج برمجة — انظر صفحة التكاملات.

صفحة التكاملات

أسئلة متكررة

هل الواجهة متاحة في كل الباقات؟

الوصول إلى الواجهة والWebhooks متاح ضمن الباقات المتقدمة، وحدود الاستخدام المرتفعة ضمن باقة المنشآت الكبيرة. التفاصيل في صفحة الأسعار.

هل تتجاوز الواجهة القواعد المحاسبية؟

لا. المستند المُنشأ عبر الواجهة يمرّ بنفس القواعد: القيد يُسجَّل، والمخزون يتحرّك، ومسار الفوترة الإلكترونية يُطبَّق كما لو أُنشئ من الواجهة الرسومية.

ما نموذج المصادقة؟

مفتاح يُنشأ على مستوى المنشأة ويعمل ضمن صلاحياتها، فلا يمنح المفتاح صلاحية لا يملكها من أنشأه.

هل هناك مكتبة تطوير جاهزة؟

نعم، إضافة إلى وثيقة OpenAPI التي يمكن توليد عميل منها بلغتك مباشرة.

احجز عرضًا توضيحيًا

سجّل بياناتك، وسنتصل بك خلال يوم عمل واحد لتنسيق جلسة تناسب احتياجات منشأتك.

نستخدم بياناتك فقط للتواصل معك بشأن جلستك مع ميزان.