# BR-05 Fatura para birimi kodu belirtilmelidir

Avrupa standardı EN 16931-1 ve XRechnung standardı uyarınca, her e-fatura ISO 4217 standardından geçerli 3 harfli bir alfabetik kod (EUR, USD, GBP, CHF) kullanarak ana fatura para birimi kodunu (BT-5 / DocumentCurrencyCode) açıkça belirtmelidir. Faturadaki tüm parasal tutarlar—satır net tutarları, masraf/indirim tutarları, vergi dökümleri ve ödenecek toplam tutar—bu para birimi cinsinden ifade edilir.

## Sorun açıklaması

Avrupa standardı EN 16931-1 ve XRechnung standardı uyarınca, her e-fatura ISO 4217 standardından geçerli 3 harfli bir alfabetik kod (EUR, USD, GBP, CHF) kullanarak ana fatura para birimi kodunu (BT-5 / DocumentCurrencyCode) açıkça belirtmelidir. Faturadaki tüm parasal tutarlar—satır net tutarları, masraf/indirim tutarları, vergi dökümleri ve ödenecek toplam tutar—bu para birimi cinsinden ifade edilir.

> **HATA**: XRechnung 3.0

## Bağlam ve önem

Açık bir para birimi kodu olmadan muhasebe sistemleri kalemlerin değerini veya vergi yükümlülüğünü hesaplayamaz ve BR-05 hatası oluşur.

## Çözüm

ERP veya muhasebe yazılımınızda fatura başlığına belge para birimini tanımlayın. UBL 2.1 sözdiziminde kök <Invoice> öğesi altında <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode> alanını doldurun. CII sözdiziminde <ram:ApplicableHeaderTradeSettlement> altına <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode> ekleyin. Tüm tutar öğelerinin currencyID="EUR" niteliğini taşıdığından emin olun.

- validate
- convert

## Geçerli örnekler

- Fatura başlığı ISO 4217 kod listesinden BT-5 = "EUR" içeriyor
- Uluslararası faturalama için fatura başlığı BT-5 = "USD" içeriyor

## Geçersiz örnekler

- Fatura kök öğesi cbc:DocumentCurrencyCode / ram:InvoiceCurrencyCode alanını tamamen atlıyor
- Para birimi alanına 3 harfli ISO 4217 kodu yerine sembol ("€" veya "$") yazılmış

## Kod örnekleri

### Geçerli XML
```
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
```

### Geçersiz XML
```
<cbc:ID>INV-2026-001</cbc:ID>
<cbc:IssueDate>2026-02-15</cbc:IssueDate>
```

## Etkilenen alanlar

- [BT-5 Fatura para birimi kodu](/resources/xrechnung/bt-5-invoice-currency-code)

## İlgili kurallar

- [BR-CL-04](/resources/kosit-validator-errors/br-cl-04-iso-4217-invoice-currency)
- [BR-06](/resources/kosit-validator-errors/br-06-seller-name-required)

## Doğrulama araçları

- [Resmi KoSIT doğrulayıcı](https://erechnungsvalidator.service-bw.de/): XRechnung dosyalarınızı tüm BR-DE kurallarına göre doğrulayı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://xeinkauf.de/xrechnung/)
- [Test paketi](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Tüm doğrulama hataları](/resources/kosit-validator-errors): Tüm Alman XRechnung doğrulama kurallarına genel bakış.