# BR-CL-20 Kodlanmış ek ücret nedeni UNCL7161’den olmalıdır

Bir ek ücret nedeni kodlandığında (belge düzeyinde BT-105, satır düzeyinde BT-145), kod UNCL7161 kod listesine ait olmalıdır.

## Sorun açıklaması

> **HATA**: EN 16931 kod listesi kuralı (BR-CL)

## Bağlam ve önem

Ek ücretler çoğunlukla harf kodlarından oluşan UNCL7161’i, indirimler ise sayısal UNCL5189 kodlarını kullanır (BR-CL-19). 95 gibi bir indirim kodu bir ek ücrette gönderildiğinde, bir indirim ek ücret olarak işaretlendiğinde (ChargeIndicator true) veya kod alanında "FREIGHT" gibi bir metin bulunduğunda kural başarısız olur. Örnek: Belge düzeyinde eklenen nakliye masrafları "Navlun" nedeniyle FC kodunu kullanır.

## Çözüm

Ek ücret nedeni kodunu bir UNCL7161 değerine ayarlayın; örn. FC (navlun hizmeti), PC (paketleme), ABL (ek ambalaj) veya SAA (sevkiyat ve elleçleme); diğer nedenleri serbest metin olarak verin (BT-104 veya BT-144). UBL’de kod, cbc:ChargeIndicator değeri true olan bir cac:AllowanceCharge içindeki cbc:AllowanceChargeReasonCode’dur; CII’de bir ram:SpecifiedTradeAllowanceCharge içindeki ram:ReasonCode’dur.

- [XML doğrula](/tr/xrechnung-validator?source=resource&rule=BR-CL-20)
- [Faturayı dönüştür](/tr/pdf-to-xrechnung?source=resource&rule=BR-CL-20)

## Geçerli örnekler

- BT-105 = FC — navlun hizmeti
- BT-145 = ABL — satır düzeyinde ek ambalaj

## Geçersiz örnekler

- BT-105 = 95 — ek ücrette indirim kodu (UNCL5189)
- BT-105 = FREIGHT — kod yerine serbest metin

## Kod örnekleri

### Geçerli XML
```
<cac:AllowanceCharge>
  <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  <cbc:AllowanceChargeReasonCode>FC</cbc:AllowanceChargeReasonCode>
</cac:AllowanceCharge>
```

### Geçersiz XML
```
<cac:AllowanceCharge>
  <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  <cbc:AllowanceChargeReasonCode>95</cbc:AllowanceChargeReasonCode>
</cac:AllowanceCharge>
```

## Etkilenen alanlar

- [BT-105 Belge düzeyi ek ücret neden kodu](/resources/xrechnung/bt-105-document-level-charge-reason-code)
- [BT-145 Satır düzeyi ek ücret neden kodu](/resources/xrechnung/bt-145-invoice-line-charge-reason-code)

## İlgili kurallar

- [BR-CL-19](/resources/kosit-validator-errors/br-cl-19-uncl5189-allowance-reason)

## Doğrulama araçları

- [Resmi KoSIT doğrulayıcı](https://github.com/itplr-kosit/validator): EN 16931 ve XRechnung kurallarını denetlemek için resmi KoSIT doğrulayıcısını XRechnung yapılandırmasıyla çalıştırın.
- [PDF’yi XRechnung’e dönüştür](/pdf-to-xrechnung): Dönüştürme sırasında doğrulama hatalarını bulun ve her düzeltmeyi inceleyin.

## İlgili kaynaklar

- [Resmi spesifikasyon](https://docs.peppol.eu/poacc/billing/3.0/rules/ubl-tc434/)
- [Test paketi](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Tüm doğrulama hataları](/resources/kosit-validator-errors): Burada açıklanan EN 16931, XRechnung ve Peppol doğrulama kurallarına genel bakış.