Error BR-KSA-17 in Standard credit note

XML and business rules
1

[message] => Debit and credit note (invoice type code (BT-3) is equal to 383 or 381) must contain the reason (KSA-10) for this invoice type issuing.

How to solve this problem … even in a simple example to deal with the problem .

    <cbc:ProfileID>reporting:1.0</cbc:ProfileID>
    <cbc:ID>885</cbc:ID>
    <cbc:UUID>77d51807-f6dc-4c28-8755-684d33b32aef</cbc:UUID>
    <cbc:IssueDate>2024-11-10</cbc:IssueDate>
    <cbc:IssueTime>10:16:40</cbc:IssueTime>
    <cbc:InvoiceTypeCode name="0200000">381</cbc:InvoiceTypeCode>
    <cbc:DocumentCurrencyCode>SAR</cbc:DocumentCurrencyCode>
    <cbc:TaxCurrencyCode>SAR</cbc:TaxCurrencyCode>
    <cac:BillingReference>
        <cac:InvoiceDocumentReference>
            <cbc:ID>22007</cbc:ID>
        </cac:InvoiceDocumentReference>
    </cac:BillingReference>
    <cac:AdditionalDocumentReference>
        <cbc:ID>ICV</cbc:ID>
        <cbc:UUID>1</cbc:UUID>
    </cac:AdditionalDocumentReference>
    <cac:AdditionalDocumentReference>
        <cbc:ID>PIH</cbc:ID>
        <cac:Attachment>
            <cbc:EmbeddedDocumentBinaryObject mimeCode="text/plain">NWZlY2ViNjZmZmM4NmYzOGQ5NTI3ODZjNmQ2OTZjNzljMmRiYzIzOWRkNGU5MWI0NjcyOWQ3M2EyN2ZiNTdlOQ==</cbc:EmbeddedDocumentBinaryObject>
        </cac:Attachment>
    </cac:AdditionalDocumentReference>
2

@ashraf_gebril please refer any sample credit note or debit note from SDK and look for cac:PaymentMeans / cbc:InstructionNote. Credit Notes and Debit Notes must contain a reason.

Reasons for issuance of credit / debit note as per Article 40 (paragraph 1) and Article 54 (3) of KSA VAT regulations, a Credit and Debit Note is issued for these 5 instances:

  • Cancellation or suspension of the supplies after its occurrence either wholly or partially (تم إلغاء أو وقف التوريد بعد حدوثه أو اعتباره كلياً أو جزئياً)
  • In case of essential change or amendment in the supply, which leads to the change of the VAT due (وجود تغيير أو تعديل جوهري في طبيعة التوريد بحيث يؤدي الى تغيير الضريبة المستحقة)
  • Amendment of the supply value which is pre-agreed upon between the supplier and consumer (تم الاتفاق على تعديل قيمة التوريد مسبقاً)
  • In case of goods or services refund. (عند ترجيع السلع أو الخدمات)
  • In case of change in Seller’s or Buyer’s information (عند التعديل على بيانات المورد أو المشتري)
1 Like
3

أفضل شئ هو الشرح العملي المباشر … إن كنت مبرمج فيمكنك وضع قائمة منسدلة لأسباب عمل إشعار الدائن أو المدين

هذا مثال فقط ويمكنك عمله بالطرقة التي تريدها:

public enum RefundReason
{
    [Description("تغيير أو تعديل أساسي في التوريدات مما يؤدي إلى تغيير الضريبة على القيمة المضافة المستحقة")]
    PriceChange = 1,

    [Description("إلغاء أو تعليق التوريدات بعد حدوثها كلياً أو جزئياً")]
    Cancel = 2,

    [Description("تعديل قيمة التوريد التي تم الاتفاق عليها مسبقاً بين المورد والمشتري")]
    TotalChange = 3,

    [Description("إرجاع السلع أو الخدمات")]
    ReturnItems = 4,

    [Description("التعديل على بيانات المورد أو المشتري")]
    PartiesDataChange = 5,
}

والأسباب بأعلى مأخوذه من ملف الاكسيل على منصة الهيئة … قاموس شرح البيانات في الفاتورة
20230519_EInvoice_Data_Dictionary vF.xlsx

وهذا مثال لما ينبغي أن تضعه في ملف الفاتورة لهذه الجزئية حتى لا يرجع لك الخطأ الذي في سؤالك :

<cac:PaymentMeans repeat="PaymentMeans">
	<cbc:PaymentMeansCode>1</cbc:PaymentMeansCode>
	<cbc:InstructionNote>إرجاع السلع أو الخدمات</cbc:InstructionNote>
</cac:PaymentMeans>