Qoyod
منتجات قيود
نظام نقاط البيع
كاشير ZATCA متكامل لمحلاتك مع دفع مرن
قيود فليفرز
كاشير سحابي مصمَّم خصيصًا للمطاعم والكافيهات
قيود HR
الموظفون والرواتب والإجازات وفق نظام العمل السعودي
قيود CRM
من العميل المحتمل إلى الفاتورة في قيود
مساكن
إدارة جمعيات اتحاد الملاك
قيود للمؤسسات
نظام ERP للشركات من 200 إلى 1,000 موظف
الأسعار
Qoyod
الأسعار

 دليل المعرفة

مثال XML لإرجاع فاتورة بضريبة خاصة في نظام الفوترة مشروحًا

من يبني الربط بين برنامج محاسبي ونظام الفوترة الوطني يجد في الدليل التقني الصادر عن دائرة ضريبة الدخل والمبيعات قسمًا كاملًا لفاتورة إرجاع المبيعات الخاصة، يمتد من الصفحة 72 إلى الصفحة 84. يشرح هذا المقال مثال XML لإرجاع فاتورة بضريبة خاصة في نظام الفوترة الوطني كتلة كتلة، فيبيّن ما يوضع في كل عنصر، وأي قيمة ثابتة تُنقل كما هي، وأي قيمة تأتي من الفاتورة الأصلية، وأي قاعدة من الدليل تحكمها.

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

والمقال موجّه إلى المطوّر الذي يعرف بنية فاتورة الضريبة الخاصة الجديدة ويريد أن يعرف ما الذي يضيفه الإرجاع إليها وما الذي يبقى كما هو.

ما يعرضه مثال XML لإرجاع فاتورة بضريبة خاصة في نظام الفوترة

يعرّف الدليل التقني نوعين فقط من المستندات في عنصر نوع الفاتورة، هما القيمة 388 للفاتورة الجديدة والقيمة 381 لفاتورة الإرجاع. ولا تُعدَّل الفاتورة بعد إصدارها، فكل ما يُرد من فاتورة بيع يمر عبر فاتورة إرجاع مرتبطة بها، والإرجاع يكون على الكميات فقط.

وفاتورة الإرجاع في عائلة الضريبة الخاصة تحمل بنية فاتورة الضريبة الخاصة الجديدة نفسها في بنودها، أي كتلة للضريبة الخاصة بالمخطط OTH تليها كتلة للضريبة العامة بالمخطط VAT. ويضيف إليها الإرجاع ثلاثة أشياء، هي مرجع الفاتورة الأصلية، وسبب الإرجاع، وقيود على ما يُكتب في البنود حتى يطابق الأصل.

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

خريطة الملف من مقدمته إلى آخر بند

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

مرِّر الجدول أفقيًا لعرض بقية الأعمدة

الكتلة العنصر في الملف ما يوضع فيه القاعدة
مقدمة الملف Invoice وcbc:ProfileID سطر التعريف ووسم الجذر والقيمة reporting:1.0 وسم الفاتورة الافتتاحي في سطر واحد (ص102)
رأس الإرجاع cbc:ID وcbc:UUID وcbc:IssueDate رقم فاتورة الإرجاع ومعرّفها الفريد وتاريخها المعرّف يولّده نظامك، والتاريخ بالصيغة yyyy-mm-dd
نوع الفاتورة والعملة cbc:InvoiceTypeCode وcbc:DocumentCurrencyCode القيمة 381 مع رمز الفاتورة الأصلية في السمة name، وعملتها النوع والعملة حسب الفاتورة الأصلية (ص74)
مرجع الفاتورة الأصلية cac:BillingReference رقم الفاتورة الأصلية ومعرّفها وإجماليها الإجمالي إجمالي الفاتورة الأصلية لا إجمالي الإرجاع
عداد الفاتورة cac:AdditionalDocumentReference المعرّف ICV وقيمة العداد عداد تسلسلي ينشئه المكلف
البائع cac:AccountingSupplierParty الرقم الضريبي للبائع واسمه الاسم كما هو مسجل لدى الدائرة
المشتري cac:AccountingCustomerParty بيانات المشتري تتوافق مع بياناته في الفاتورة الأصلية (ص76)
تسلسل مصدر الدخل cac:SellerSupplierParty تسلسل مصدر الدخل قيمة إجبارية في كل إرسال
سبب الإرجاع cac:PaymentMeans الرمز 10 ونص السبب السبب إلزامي في فاتورة الإرجاع
مجاميع الفاتورة cac:AllowanceCharge وcac:TaxTotal وcac:LegalMonetaryTotal الخصم والضريبة والإجماليات تغطي الجزء المراد إرجاعه فقط
بنود الإرجاع cac:InvoiceLine البند وكتلة OTH ثم كتلة VAT رقم البند واسمه وسعره كما في الأصل، والكمية هي المرجعة

نلاحظ من الجدول أن معظم قيم ملف الإرجاع منقولة من سجل الفاتورة الأصلية، وأن ما يُكتب جديدًا قليل، وهو رقم فاتورة الإرجاع ومعرّفها وتاريخها وعدادها، وسبب الإرجاع، والكميات المرجعة وما يترتب عليها من مبالغ.

رأس الإرجاع ومرجع الفاتورة الأصلية

يبدأ القالب بالقسم A، وعنوانه في الدليل «معلومات الفاتورة الأساسية و معلومات الفاتورة المراد الارجاع منها». ويضم هذا القسم بيانات فاتورة الإرجاع نفسها، ثم كتلة المرجع التي تشير إلى الفاتورة الأصلية، ثم عداد الفاتورة.

قالب «A. معلومات الفاتورة الأساسية ومعلومات الفاتورة المراد الإرجاع منها» لإرجاع المبيعات الخاصة: رقم فاتورة الإرجاع وUUID وتاريخها وInvoiceTypeCode بالرقم 381 وخاصية name لطريقة الدفع، وJOD، وBillingReference برقم الأصلية ورقمها المتسلسل وإجماليها، وICV، والقيم عبارات وصفية، ولا طمس فيه
المصدر: دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، ص73

في رأس الإرجاع ثلاثة عناصر تخص فاتورة الإرجاع وحدها.

  • رقم فاتورة الإرجاع ومعرّفها. يحمل cbc:ID رقم فاتورة الإرجاع، ويحمل cbc:UUID معرّفها الفريد. والمفتاح الأساسي لأي فاتورة في نظام الفوترة الوطني هو الرقم والمعرّف معًا، والمعرّف يولّده نظام المكلف، فيُحفظ قبل أول إرسال ويُعاد استعماله في أي إعادة إرسال.
  • تاريخ فاتورة الإرجاع. يُكتب في cbc:IssueDate بالصيغة yyyy-mm-dd كما في جميع أمثلة XML في الدليل. وقد يظهر الوصف المنسوخ من ملف الدليل في صفحة 73 بترتيب مختلف لأجزاء التاريخ، فاعتمد الصيغة المستعملة في الأمثلة.
  • غياب عنصر الملاحظات. لا يحمل رأس إرجاع الضريبة الخاصة العنصر cbc:Note، وكذلك رأس إرجاع ضريبة المبيعات العامة، بخلاف رأس إرجاع فاتورة الدخل الذي يبقيه اختياريًا.

أما عنصر نوع الفاتورة فقيمته 381 دائمًا في الإرجاع، والسمة name تحمل الرمز الثلاثي للفاتورة الأصلية نفسه. والخانة الثالثة في هذا الرمز هي 3 لعائلة الضريبة الخاصة، والخانة الثانية 1 للنقدي و2 للذمم، والخانة الأولى لنوع التعامل. ويذكر الدليل مثالين لهذه العائلة هما 013 لإرجاع فاتورة محلية نقدية و023 لإرجاع فاتورة محلية ذمم.

وصف InvoiceTypeCode لإرجاع المبيعات الخاصة: الرقم 381 دال على فاتورة إرجاع، ومثالا 013 للإرجاع النقدي و023 للإرجاع الذمم، وقاعدة اختيار نوع فاتورة الإرجاع وعملتها حسب الفاتورة الأصلية، وصفوف رقم الأصلية ورقمها المتسلسل وإجماليها وICV، ولا طمس فيه
المصدر: دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، ص74

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

وتأتي بعد ذلك كتلة المرجع cac:BillingReference، وفيها ثلاثة عناصر، هي رقم الفاتورة الأصلية ومعرّفها الفريد وإجماليها في cbc:DocumentDescription. وتفصيل هذه الكتلة وما يساويه كل عنصر فيها في مقال مرجع الفاتورة الأصلية في نظام الفوترة الوطني. ويختم القسم بعداد الفاتورة، وهو في نص الدليل «عداد يتم إنشاؤه من قبل المكلف للفواتير الإلكترونية يبدأ بشكل تسلسلي من 1 الى ما لانهاية حسب التعريف العالمي».

وهذا مقطع مختصر يبيّن ترتيب عناصر الرأس، والتعليقات العربية فيه أوصاف لما يوضع مكان النقاط.

<cbc:ID>...</cbc:ID>  <!-- رقم فاتورة الإرجاع في نظامك -->
<cbc:UUID>...</cbc:UUID>  <!-- معرّف فريد جديد لفاتورة الإرجاع يحفظه نظامك -->
<cbc:IssueDate>...</cbc:IssueDate>  <!-- تاريخ الإرجاع بالصيغة yyyy-mm-dd -->
<cbc:InvoiceTypeCode name="...">381</cbc:InvoiceTypeCode>  <!-- رمز الفاتورة الأصلية مثل 013 أو 023 -->
<cbc:DocumentCurrencyCode>...</cbc:DocumentCurrencyCode>  <!-- عملة الفاتورة الأصلية -->
<cbc:TaxCurrencyCode>...</cbc:TaxCurrencyCode>  <!-- العملة نفسها -->
<cac:BillingReference>
  <cac:InvoiceDocumentReference>
    <cbc:ID>...</cbc:ID>  <!-- رقم الفاتورة الأصلية -->
    <cbc:UUID>...</cbc:UUID>  <!-- معرّف الفاتورة الأصلية -->
    <cbc:DocumentDescription>...</cbc:DocumentDescription>  <!-- إجمالي الفاتورة الأصلية -->
  </cac:InvoiceDocumentReference>
</cac:BillingReference>

البائع والمشتري وتسلسل مصدر الدخل وسبب الإرجاع

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

البائع. تحمل الكتلة cac:AccountingSupplierParty رمز الدولة JO، والرقم الضريبي للبائع في cbc:CompanyID، والمخطط VAT، واسم البائع في cbc:RegistrationName كما هو مسجل لدى الدائرة.

المشتري. عنوان هذا القسم في القالب يصفه بأنه «وصف ثابت دون تغيير او إضافة»، وتحته القاعدة التي تحكمه.

عنوان «C. البيانات الخاصة بالمشتري (وصف ثابت دون تغيير او إضافة)» في إرجاع المبيعات الخاصة وملاحظة «يجب أن تتوافق بيانات المشتري في فاتورة الإرجاع مع بياناته في فاتورة البيع الأصلية المرتبطة بها»، ولا طمس فيه
المصدر: دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، ص76

نص القاعدة «يجب أن تتوافق بيانات المشتري في فاتورة الإرجاع مع بياناته في فاتورة البيع الأصلية المرتبطة بها». وتشمل هذه البيانات نوع رقم التعريف في السمة schemeID، وقيمها NIN للرقم الوطني وPN للرقم الشخصي لغير الأردني وTN للرقم الضريبي، ثم الرمز البريدي ورمز المحافظة والهاتف والاسم. واسم المشتري إجباري في فاتورة الذمم، وفي الفاتورة النقدية إذا زادت قيمتها على 10 آلاف دينار أو ما يعادلها بالعملات الأجنبية. والطريق العملي أن يقرأ نظامك هذه الكتلة من سجل الفاتورة الأصلية، لا أن يعيد إدخالها.

تسلسل مصدر الدخل. تحمل الكتلة cac:SellerSupplierParty في cbc:ID تسلسل مصدر الدخل، وهو قيمة إجبارية في كل إرسال. ورقم المستخدم والمفتاح السري مرتبطان بتسلسل واحد، فإذا اختلف التسلسل عما يناسب الفاتورة فقد يُرفض الإرسال برسالة تفيد بأن المستخدم غير مصرح له بإرسال هذا النوع من الفواتير.

سبب الإرجاع. هذه الكتلة خاصة بفاتورة الإرجاع. فالعنصر cac:PaymentMeans يحمل الرمز PaymentMeansCode listID="UN/ECE 4461" بالقيمة 10، ويحمل cbc:InstructionNote نص سبب الإرجاع نصًا حرًا، والسبب إلزامي. واسم الكتلة يوحي بطريقة الدفع، لكن طريقة الدفع في نظام الفوترة الوطني هي الخانة الثانية من رمز نوع الفاتورة. والتفصيل في مقال سبب الإرجاع في نظام الفوترة الوطني.

مجاميع الإرجاع على مستوى الفاتورة

المبدأ الذي يحكم هذا القسم أن مجاميع فاتورة الإرجاع تغطي الجزء المراد إرجاعه فقط، لا الفاتورة الأصلية كلها. ويضع الدليل في قالب هذا القسم عبارة «المراد ارجاعها» بجانب الإجماليات، ويصف مجموع الضريبة في الرأس بأنه «مجموع قيمة الضريبة العامة» (ص78).

وفي هذا القسم ثلاث كتل.

  • الخصم على مستوى الفاتورة. الكتلة cac:AllowanceCharge تحمل ChargeIndicator بالقيمة false، وسبب الخصم discount، ومبلغًا يساوي مجموع خصومات البنود. ولا يقبل النظام خصمًا مستقلًا على الفاتورة كلها.
  • مجموع الضريبة في الرأس. الكتلة cac:TaxTotal تحمل في cbc:TaxAmount مجموع ضريبة البنود. وفي فاتورة الضريبة الخاصة الجديدة يحمل هذا العنصر الضريبة العامة وحدها، إذ يساوي في مثال الدليل مجموع الضريبة العامة في البندين.
  • الإجماليات. الكتلة cac:LegalMonetaryTotal تحمل TaxExclusiveAmount بمجموع الكمية مضروبة في سعر الوحدة، وAllowanceTotalAmount بمجموع خصومات البنود، وTaxInclusiveAmount وPayableAmount بمجموع إجماليات البنود في RoundingAmount.

ويصوغ الدليل إجمالي فاتورة الضريبة الخاصة بهذه الكلمات «اجمالي الفاتورة = (اجمالي الفاتورة قبل الخصم − مجموع قيمة الخصم + مجموع الضريبة الخاصة + مجموع قيمة الضريبة العامة)». وفي الإرجاع تُحسب هذه الأطراف كلها على البنود والكميات المرجعة. ويسمح الدليل بالتقريب لغاية ثلاث خانات عشرية وبحد أعلى تسع خانات، على ألا يزيد الفرق على 0.001.

وإذا رُفض الإرجاع برسالة تخص المجاميع، فابدأ من نص الرسالة في EINV_MESSAGE، ثم أعد حساب كل مجموع من بنود الإرجاع نفسها، لا من الفاتورة الأصلية.

بنود الإرجاع وكتلة OTH قبل كتلة VAT

القسم الأخير من القالب، وعنوانه «المدخلات الخاصة بتفاصيل سلع فاتورة الارجاع الخاصة»، هو أطول أقسامه، ويشرحه الدليل في الصفحات 80 إلى 84.

قالب «G. المدخلات الخاصة بتفاصيل سلع فاتورة الإرجاع الخاصة»: الرقم التسلسلي والكمية وLineExtensionAmount وTaxTotal، ثم TaxSubtotal بقيمة الضريبة الخاصة ومخطط OTH، ثم TaxSubtotal بقيمة الضريبة العامة والفئة S ونسبة الضريبة ومخطط VAT، ثم اسم السلعة وسعر الوحدة والخصم، ولا طمس فيه
المصدر: دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، ص80

يبدأ البند ببياناته الأساسية، ثم كتلة الضريبة، ثم السلعة وسعرها وخصمها.

  • رقم البند cbc:ID. يُكتب كما هو في الفاتورة الأصلية، فالإرجاع يُطابق البنود برقمها. لذلك يحفظ نظامك رقم كل بند من البيع الأصلي.
  • الكمية cbc:InvoicedQuantity. هي الكمية المرجعة، ويجوز أن تكون الكمية كاملة أو جزءًا منها، برقم صحيح أو بأجزاء عشرية، وأكبر من صفر. ولا تتجاوز الكمية المبيعة في الأصل، ويجوز إجراء أكثر من إرجاع جزئي على الفاتورة نفسها حتى تنفد كمياتها.
  • قيمة البند cbc:LineExtensionAmount. تساوي الكمية المرجعة مضروبة في سعر الوحدة، مطروحًا منها خصم البند.
  • ضريبة البند cac:TaxTotal. يحمل cbc:TaxAmount فيها الضريبة العامة وحدها، ويحمل cbc:RoundingAmount قيمة البند مضافًا إليها الضريبة الخاصة والضريبة العامة.
  • اسم السلعة وسعر الوحدة. يُكتب cbc:Name وcbc:PriceAmount كما هما في الفاتورة الأصلية، والسعر سعر الوحدة قبل الضريبة.

وداخل ضريبة البند كتلتان cac:TaxSubtotal بترتيب ثابت. الأولى للضريبة الخاصة بالمخطط OTH، والثانية للضريبة العامة بالمخطط VAT. وهذا مقطع مختصر للكتلة الأولى.

<cac:TaxSubtotal>
  <cbc:TaxableAmount currencyID="JO">...</cbc:TaxableAmount>  <!-- الكمية × سعر الوحدة − خصم البند -->
  <cbc:TaxAmount currencyID="JO">...</cbc:TaxAmount>  <!-- قيمة الضريبة الخاصة للسلعة، مبلغ يُدخل لا نسبة -->
  <cac:TaxCategory>
    <cbc:ID schemeAgencyID="6" schemeID="UN/ECE 5305">S</cbc:ID>
    <cac:TaxScheme>
      <cbc:ID schemeAgencyID="6" schemeID="UN/ECE 5153">OTH</cbc:ID>
    </cac:TaxScheme>
  </cac:TaxCategory>  <!-- لا يوجد عنصر cbc:Percent في هذه الكتلة -->
</cac:TaxSubtotal>

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

أما الكتلة الثانية فتحمل المبلغ الخاضع، وقيمة الضريبة العامة، والفئة، والنسبة في cbc:Percent، والمخطط VAT. والضريبة العامة تُحسب على قيمة البند مضافًا إليها الضريبة الخاصة. وتسرد صفحة الإرجاع في هذه العائلة النسب المقبولة في حقل النسبة على هذا النحو «1,2,3,4,5,7,8,10,16» (ص82)، وهي قائمة قيم تقبلها الواجهة البرمجية، لا جدول بنسب ضريبة المبيعات العامة التي يفرضها القانون.

ويختم البند بكتلة الخصم. وللخصم في الإرجاع قاعدة نصها «اذا كان الارجاع لكامل كمية السلعة او الخدمة فيجب وضع الخصم (إن وجد) كاملا، أما اذا كان الارجاع لجزء من الكمية فيجب ان يكون الخصم (إن وجد) جزء من الخصم الكلي للسلعة او الخدمة حسب الكمية المرجعة» (ص82). ولا يضع الدليل معادلة لهذا التوزيع، فالمفهوم من عبارة «حسب الكمية المرجعة» أن الخصم يتناسب مع الكمية، والحساب الدقيق قرار يتخذه نظامك ويوثقه.

ولا نذكر هنا قاعدة لتوزيع مبلغ الضريبة الخاصة على الكمية المرجعة في الإرجاع الجزئي، لأن الدليل يصف الضريبة الخاصة في هذا الموضع بأنها قيمة تُدخل دون عمليات حسابية، ولا نضيف إلى وصفه قاعدة لا يذكرها.

ملاحظتان على مثال الدليل قبل الاعتماد عليه

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

  • رأس المثال (ص74). يلاحظ في المثال أن رأسه يحمل بيانات رأس مثال إرجاع ضريبة المبيعات العامة نفسها عدا رمز النوع 013، ومنها مرجع الفاتورة الأصلية وإجماليها، فلا يطابق مثال فاتورة الضريبة الخاصة الذي يسبقه في الدليل. لذلك لا تعتمد أرقام هذا المرجع في اختبارك.
  • علامات الاقتباس (ص81 وص82). يلاحظ في صفحة 81 أن قيمة السمة currencyID تنتهي بعلامتي اقتباس، وفي صفحة 82 أن السمتين schemeAgencyID وschemeID كُتبتا بعلامات مضاعفة. وإذا نُسخ المثال كما هو فلن يكون ملف XML سليم البنية. والصيغة الصحيحة علامة واحدة على كل جانب من القيمة، كما في القالب.

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

والطريقة الآمنة أن تأخذ البنية والوصف الثابت من القالب، وأن تملأ المتغيرات من سجل الفاتورة الأصلية ومن الكميات المرجعة، وأن تستعمل المثال للمقارنة فقط.

ما ينفرد به هذا المثال عن مثالي الإرجاع الآخرين

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

مرِّر الجدول أفقيًا لعرض بقية الأعمدة

الجانب إرجاع فاتورة الدخل إرجاع ضريبة المبيعات العامة إرجاع الضريبة الخاصة
صفحات القسم ص22 إلى ص31 ص45 إلى ص56 ص72 إلى ص84
الخانة الثالثة في الرمز 1، وأمثلتها 011 و021 و111 و121 2، وأمثلتها 012 و022 و112 و122 و212 و222 3، ومثالاها 013 و023
ضريبة البند لا كتلة ضريبة في البند كتلة واحدة بالمخطط VAT كتلة OTH ثم كتلة VAT
عنصر الملاحظات في الرأس موجود واختياري غير موجود غير موجود

فالفرق الجوهري في هذا المثال هو كتلة OTH داخل كل بند، وما يترتب عليها من أساس الضريبة العامة وإجمالي البند ومجاميع الفاتورة. أما بقية الملف فتشبه إرجاع ضريبة المبيعات العامة. وشرح المثالين الآخرين في مقالي مثال XML لإرجاع فاتورة الدخل ومثال XML لإرجاع فاتورة ضريبة المبيعات العامة ضمن هذه السلسلة. ولمن يريد الجانب التشريعي والإجرائي لهذه العائلة، يعرض مقال فاتورة الضريبة الخاصة من يصدرها ورموزها وطريقة إرجاعها.

قائمة فحص لملف الإرجاع قبل الإرسال

هذه القائمة مستخلصة من القالب وقواعد الدليل المذكورة أعلاه، ويمكن تمريرها على أي ملف إرجاع في هذه العائلة قبل ترميزه وإرساله.

  1. الرأس. رقم ومعرّف جديدان لفاتورة الإرجاع، والتاريخ بالصيغة yyyy-mm-dd، ولا عنصر cbc:Note.
  2. النوع والعملة. القيمة 381، ورمز الفاتورة الأصلية في السمة name وخانته الثالثة 3، وعملة الفاتورة الأصلية في عنصري العملة.
  3. المرجع. رقم الفاتورة الأصلية ومعرّفها وإجماليها كما في سجلها.
  4. الأطراف. بيانات البائع كما في التسجيل، وبيانات المشتري مطابقة للفاتورة الأصلية، وتسلسل مصدر الدخل الصحيح.
  5. السبب. الرمز 10 ونص السبب في cbc:InstructionNote.
  6. البنود. رقم البند واسمه وسعره كما في الأصل، والكمية المرجعة أكبر من صفر ولا تتجاوز المتبقي من الكمية المبيعة.
  7. كتلتا الضريبة. كتلة OTH أولًا بلا عنصر نسبة، ثم كتلة VAT بالنسبة، والضريبة العامة محسوبة على قيمة البند مضافًا إليها الضريبة الخاصة.
  8. الخصم. كاملًا عند إرجاع الكمية كلها، وجزءًا منه حسب الكمية المرجعة عند الإرجاع الجزئي.
  9. المجاميع. محسوبة من بنود الإرجاع وحدها، ومطابقة لصيغة إجمالي فاتورة الضريبة الخاصة.
  10. سلامة الملف. وسم الفاتورة الافتتاحي في سطر واحد، وعلامة اقتباس واحدة على كل جانب من قيم السمات.

وبعد الإرسال يُحكم على النتيجة من قيمة EINV_STATUS لا من رمز الحالة وحده. فالحالة SUBMITTED تعني القبول ويعود معها رمز الاستجابة السريع، والحالة NOT_SUBMITTED تعني الرفض وتظهر تفاصيله في EINV_MESSAGE. وعند إعادة الإرسال يبقى رقم فاتورة الإرجاع ومعرّفها كما هما.

كيف يتعامل قيود مع ملف فاتورة الإرجاع

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

  • بناء الملف والإرسال. يبني قيود ملف الفاتورة بصيغة UBL 2.1 مع المعرّف الفريد، ويرسله إلى نظام الفوترة الوطني دون أي تدخل يدوي.
  • التنبيه قبل الإرسال. يفحص قيود الرقم الضريبي ونوع المستند وطريقة الدفع ونسبة ضريبة المبيعات العامة واكتمال البنود، وينبهك بأي خطأ قبل الإرسال لتقليل حالات الرفض.
  • حالة كل فاتورة أمامك. تعيد الدائرة حالة الفاتورة ورسالة الخطأ، ويعرضها قيود في لوحة الحالة.
  • إعادة الإرسال بالمعرّف نفسه. حين تعيد إرسال فاتورة من لوحة الحالة، تُرسل بالمعرّف UUID نفسه.

ولصورة أوسع عن النظام وطريقة ربط منشأتك به، اقرأ مقال نظام الفوترة الوطني الإلكتروني في الأردن، أو تعرّف على قيود مع نظام الفوترة الوطني.

قيود · نظام الفوترة الوطني

فوترة إلكترونية ومحاسبة متكاملة في نظام واحد

قيود متكامل مع نظام الفوترة الوطني (JoFotara). تُصدر فاتورتك بالدينار الأردني من قيود فتُقيَّد في دفاترك تلقائيًا وتُرسل إلى النظام، وبعد قبولها يعود عليها رمز QR من دائرة ضريبة الدخل والمبيعات.

الأسئلة الشائعة

ما الرمز الذي تحمله فاتورة إرجاع الضريبة الخاصة؟

تحمل القيمة 381 في عنصر نوع الفاتورة، ورمز الفاتورة الأصلية في السمة name. ويذكر الدليل التقني لهذه العائلة المثالين 013 لإرجاع الفاتورة المحلية النقدية و023 لإرجاع الفاتورة المحلية الذمم.

هل تبقى كتلة OTH في بنود فاتورة الإرجاع؟

تبقى في كل بند، وتأتي قبل كتلة الضريبة العامة VAT، وتحمل الفئة S دون عنصر نسبة. ويكرر الدليل في صفحات الإرجاع أن الضريبة الخاصة قيمة تُدخل دون عمليات حسابية.

هل أنسخ مثال إرجاع الضريبة الخاصة من الدليل التقني؟

لا تنسخه حرفيًا. فرأس المثال في صفحة 74 يحمل بيانات رأس مثال إرجاع ضريبة المبيعات العامة، وفي صفحتي 81 و82 علامات اقتباس مضاعفة تجعل الملف غير سليم البنية. خذ البنية من القالب واملأ القيم من سجل فاتورتك الأصلية.

ماذا أكتب في بيانات المشتري في فاتورة الإرجاع؟

تكتب بيانات المشتري كما وردت في الفاتورة الأصلية، لأن الدليل ينص على أنه «يجب أن تتوافق بيانات المشتري في فاتورة الإرجاع مع بياناته في فاتورة البيع الأصلية المرتبطة بها».

كيف أحسب الخصم في الإرجاع الجزئي؟

يوضع الخصم كاملًا إذا أُرجعت الكمية كلها، ويكون جزءًا من الخصم الكلي للبند حسب الكمية المرجعة إذا أُرجع جزء منها. ولا يضع الدليل معادلة لهذا التوزيع.

هل جرّبتم مقاطع XML المعروضة في هذا المقال على نظام الفوترة الوطني؟

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

المراجع

  • دائرة ضريبة الدخل والمبيعات، الدليل التقني للربط مع نظام الفوترة الوطني من خلال واجهة برمجة التطبيقات (API)، الإصدار 1.5، 2026، ص10 وص12 وص22 إلى ص31 وص45 إلى ص84 وص97 إلى ص102.
الأدلّة الإرشادية

تابع رحلة التعلّم

استكشف بقية أدلّة قيود الإرشادية، أو ابدأ بتطبيق ما تعلّمته.

ندوات مباشرة يقدمها فريق قيود لمساعدتك في استخدام البرنامج بسهولة والرد على أسئلتك.

تعرّف على أحدث تحديثات فيود والتحسينات المستمرة والخصائص الجديدة في مكان واحد.

فريقنا جاهز لمساعدتك وتقديم الدعم الفوري لأي مشكلة تواجهها على مدار الساعة