ضبط إعدادات فاتورة (المُصدر والافتراضيات والتوقيع)

حقول صفحة الإعدادات بالتفصيل: البيئة، Client ID/Secret، الرقم الضريبي وعنوان المُصدر، بادئة الترقيم، افتراضيات المستلم، رابط التوقيع، اختبار الدخول، وتدوير المفتاح.

إعدادات فاتورةالرقم الضريبي كود النشاطاختبار دخول المصلحةفاتورة settingsبادئة رقم الفاتورة

كل ما يلي موجود في `/t/{slug}/settings`. الحفظ متاح لـ المالك والمسؤول فقط. المحاسب يمكنه إنشاء/إرسال الفواتير بعد اكتمال الإعدادات.

لوحة الاتصال

في الأعلى تظهر البيئة، وما إذا كانت الاعتمادات مضبوطة، ومعاينة Client ID، ورابط الهوية وقاعدة الـ API. استخدم اختبار دخول المصلحة بعد الحفظ — يشغّل OAuth2 `client_credentials` بنطاق `InvoicingAPI` دون إرسال فواتير.

حقول ملف المُصدر

• `etaEnvironment` — `preprod` أو `prod`
• `etaClientId`
• `etaClientSecret` — بعد الحفظ الأول: اتركه فارغاً للإبقاء
• `issuerTin` — الرقم الضريبي
• `issuerName` — الاسم القانوني كما تتوقعه المصلحة
• `activityCode` — كود النشاط
• `branchId` — غالباً `0`
• `issuerGovernate` و`issuerRegionCity` و`issuerStreet` و`issuerBuildingNumber`

تُفحص هذه الحقول عند جاهز للتوقيع. نقص الرقم أو الاسم أو كود النشاط أو العنوان يوقف الخطوة.

الافتراضيات

• العملة الافتراضية (غالباً EGP)
• نوع الصنف (EGS أو GS1)
• كود الصنف الافتراضي
• بادئة الترقيم — يظهر الرقم التالي `{prefix}-{YYYY}-{####}`

افتراضيات عنوان المستلم

تُستخدم عندما لا يملك العميل عنواناً خاصاً: الدولة، المحافظة، المنطقة/المدينة، الشارع، المبنى.

قسم التوقيع المحلي

• رابط التوقيع الافتراضي `http://localhost:7733`
• مفتاح التوقيع للعرض فقط — انسخه إلى تطبيق سطح المكتب
• تدوير المفتاح — يلغي المفتاح القديم فوراً؛ حدّث كل أجهزة التوقيع

ترتيب حفظ ناجح

• عبّئ المُصدر والاعتمادات
• حفظ الإعدادات
• اختبار دخول المصلحة حتى OK
• انسخ مفتاح التوقيع للتطبيق المحلي
• جرّب فاتورة صغيرة على Preprod قبل Prod