البداية

النطاقات

لا يفعل المفتاح إلا ما تسمح به نطاقاته، ضمن خطة الشركة.

النطاق تطبيق ومستوى. والمستوى الأعلى يشمل الأدنى: sales:approve يكتب ويقرأ أيضًا. وتذكر كل عملية في المرجع الصلاحية التي تحتاجها والنطاقات التي تمنحها.

النطاق	يسمح بـ
`sales:read`	عروض الأسعار وأوامر البيع والفواتير والإشعارات الدائنة والفواتير الإلكترونية؛ وجهات الاتصال والمنتجات.
`sales:write`	وأيضًا إنشاء المسودات وتعديلها، والتأكيد، وفوترة الأوامر، والإلغاء، وإصدار فاتورة معتمدة مسبقًا؛ وإنشاء جهات الاتصال والمنتجات.
`sales:approve`	وأيضًا اعتماد الفواتير والإشعارات الدائنة، وإصدار المسودة بخطوة واحدة. ويحتاجه `POST /einvoices`.
`purchase:read`	طلبات عروض الأسعار وأوامر الشراء وفواتير المورّدين والاستردادات؛ وجهات الاتصال والمنتجات.
`purchase:write`	وأيضًا إنشاؤها وتعديلها، والتأكيد، وفوترة الأوامر، والإلغاء؛ وإنشاء جهات الاتصال والمنتجات.
`purchase:approve`	وأيضًا ترحيل الفواتير والاستردادات إلى الحسابات.
`contacts:read` · `contacts:write`	دفتر جهات الاتصال وحده، دون المبيعات أو المشتريات.
`reports:read`	إقرار ضريبة القيمة المضافة 201 (مع `sales:read` أو `purchase:read`) وأعمار الذمم المدينة (مع `sales:read`).
`accounting:read`	أعمار الذمم الدائنة وميزان المراجعة. متاح فقط ما دامت المحاسبة ضمن خطة الشركة.

حدود كل مفتاح

لا يتجاوز المفتاح أبدًا صلاحيات من ينشئه: يُرفض النطاق الأعلى من صلاحياته (API_SCOPE_ABOVE_YOURS)، وكذلك التطبيق خارج الخطة (API_SCOPE_NOT_IN_PLAN).
لا يدير المفتاح أبدًا المستخدمين أو المفاتيح أو الفوترة أو إعدادات الشركة، أيًّا كانت نطاقاته.
التطبيق الذي لا تشمله خطة الشركة يُرفض حتى لمفتاح يذكره (APP_LOCKED).
يجيب GET /me بما يحق للمفتاح الآن — استخدمه بدل تتبّع النطاقات بنفسك.

امنح كل مفتاح أقل ما يحتاجه. المتجر الذي يرسل الفواتير فقط يحتاج sales:approve؛ وأداة التقارير تحتاج reports:read وsales:read.