# Error BR-KSA-17 in Standard credit note

**URL:** <https://zatca1.discourse.group/t/error-br-ksa-17-in-standard-credit-note/4151>\
**Category:** General\
**Created:** [November 12, 2024, 7:26am UTC](https://zatca1.discourse.group/t/error-br-ksa-17-in-standard-credit-note/4151 "2024-11-12T07:26:12Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![ashraf\_gebril](https://avatars.discourse-cdn.com/v4/letter/a/47e85d/32.png) [@ashraf\_gebril](https://zatca1.discourse.group/u/ashraf_gebril)\
**Post date:** [November 12, 2024, 7:26am UTC](https://zatca1.discourse.group/t/error-br-ksa-17-in-standard-credit-note/4151/1 "2024-11-12T07:26:12Z")

</div>

[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 .

```auto
    <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>

```

---

<div class="post-metadata">

**Author:** ![Ankit.K.Tiwari](https://avatars.discourse-cdn.com/v4/letter/a/9d8465/32.png) [@Ankit.K.Tiwari](https://zatca1.discourse.group/u/Ankit.K.Tiwari)\
**Post date:** [November 12, 2024, 7:27am UTC](https://zatca1.discourse.group/t/error-br-ksa-17-in-standard-credit-note/4151/2 "2024-11-12T07:27:52Z")

</div>

@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 (عند التعديل على بيانات المورد أو المشتري)

---

<div class="post-metadata">

**Author:** ![omab](https://avatars.discourse-cdn.com/v4/letter/o/7c8e57/32.png) [@omab](https://zatca1.discourse.group/u/omab)\
**Post date:** [December 11, 2024, 10:56am UTC](https://zatca1.discourse.group/t/error-br-ksa-17-in-standard-credit-note/4151/3 "2024-12-11T10:56:36Z")

</div>

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

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

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

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

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

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

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

```

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

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

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

```