الأكواد المرجعية
نوع المستند — InvoiceTypeCode
| الكود | المستند | النقطة |
|---|
388 | فاتورة | POST /v1/invoices |
381 | إشعار دائن (مرتجع) | POST /v1/credit-notes |
السمة name — ثلاث خانات
تُبنى تلقائيًا من طريقة الدفع في الطلب ونوع التكليف في إعدادات حسابك:
name = "0" + طريقة الدفع + نوع التكليف
طريقة الدفع: 1 = نقدي (cash) 2 = ذمم (receivable)
نوع التكليف: 1 = دخل 2 = مبيعات 3 = مبيعات خاصة
name | الوصف | payment_method | نوع التكليف |
|---|
011 | فاتورة دخل — نقدي | cash | income |
021 | فاتورة دخل — ذمم | receivable | income |
012 | فاتورة مبيعات — نقدي | cash | sales |
022 | فاتورة مبيعات — ذمم | receivable | sales |
013 | مبيعات خاصة — نقدي | cash | special_sales |
023 | مبيعات خاصة — ذمم | receivable | special_sales |
يجب أن يطابق نوع التكليف ما هو مسجّل لمنشأتك فعليًا لدى دائرة ضريبة الدخل والمبيعات.
إرسال كود لا يوافق تسجيلك يؤدّي إلى رفض الفاتورة من البوابة.
تصنيف الضريبة — tax_category
| الكود | المعنى | النسبة المتوقّعة | يُستنتج تلقائيًا عندما |
|---|
S | خاضع للضريبة بالنسبة العامة | > 0 (16 عادةً) | tax_percent > 0 |
Z | نسبة صفرية (Zero rated) | 0 | tax_percent = 0 |
E | معفى (Exempt) | 0 | يجب تحديده صريحًا |
O | خارج نطاق الضريبة | 0 | يجب تحديده صريحًا |
نوع هوية المشتري — identity_type
| القيمة في طلبك | schemeID في UBL | الاستخدام |
|---|
tax | TN | المشتري منشأة مكلّفة — الرقم الضريبي. |
national | NIN | المشتري فرد أردني — الرقم الوطني. |
passport | PN | المشتري غير أردني — رقم جواز السفر. |
أكواد الوحدات — unit_code
وفق UN/ECE Recommendation 20. الشائعة في السوق المحلي:
| الكود | الوحدة | الكود | الوحدة |
|---|
PCE | قطعة (الافتراضي) | KGM | كيلوغرام |
LTR | لتر | MTR | متر |
MTK | متر مربع | MTQ | متر مكعب |
HUR | ساعة | DAY | يوم |
MON | شهر | ANN | سنة |
BX | صندوق | PK | عبوة |
TNE | طن متري | SET | طقم |
الصلاحيات — scopes
| الصلاحية | الوصف |
|---|
invoices:write | إنشاء وإرسال الفواتير |
invoices:read | قراءة الفواتير وسجلّها |
webhooks:write | إدارة نقاط الـ Webhook |
account:read | قراءة بيانات الحساب والاستهلاك |
قيم status و jofotara.status
| حقل | القيم |
|---|
status (لدينا) | pending · accepted · rejected · error |
jofotara.status (من البوابة) | SUBMITTED · قيم أخرى تُمرَّر كما وردت · SANDBOX_SUBMITTED و SANDBOX_REJECTED في بيئة الاختبار |
mode | live · test |
document_type | invoice · credit_note |