Giden Fatura
Giden Fatura JSON → UBL Mapping
Giden fatura JSON alanlarının üretilen UBL Invoice XML içindeki karşılıkları.
Mapping Kapsamı
Kısa kural: Aşağıdaki tablo,
AddOutgoingInvoice isteğinin ortak alanlarıyla profile özgü alanlarının UBL Invoice belgesindeki karşılığını birlikte gösterir. Düz XML için AddOutgoingInvoiceByXml, hazır UBL belgesi için AddOutgoingInvoiceByUbl kullanılır. EARSIVFATURA bu rehberin kapsamı dışındadır. Referans Tablo
| JSON Alanı | UBL Invoice Karşılığı | Kural |
|---|---|---|
ProfileId | cbc:ProfileID | Tüm e-Fatura isteklerinde zorunludur. |
InvoiceTypeCode | cbc:InvoiceTypeCode | Seçilen profile ve güncel GİB kılavuzuna uygun olmalıdır. |
IssueDate | cbc:IssueDate + cbc:IssueTime | Tarih ve saat bileşenleri UBL belgesine ayrı yazılır. |
InvoicePeriod.StartDate / EndDate | cac:InvoicePeriod/cbc:StartDate + StartTime / EndDate + EndTime | ENERJI profilindeki SARJ ve SARJANLIK faturalarında tarih ve saat çiftleri birlikte zorunludur. |
DocumentCurrencyCode | cbc:DocumentCurrencyCode | Belge toplamları ve satır tutarları bu para birimiyle tutarlı olmalıdır. |
AccountingSupplierParty | cac:AccountingSupplierParty | Satıcı tarafının kimlik, unvan ve adres bilgilerini taşır. |
AccountingCustomerParty | cac:AccountingCustomerParty | Alıcı tarafının kimlik, unvan ve adres bilgilerini taşır. |
AccountingCustomerParty.Party.PartyIdentifications[]SchemeId=PLAKA | cac:AccountingCustomerParty/cac:Party/cac:PartyIdentification/cbc:IDschemeID="PLAKA" | ENERJI profilinde tam bir plaka kaydı bulunur. |
AdditionalDocumentReference[]SchemeId=ESURaporID | cac:AdditionalDocumentReference/cbc:ID + cbc:IssueDate | SARJ faturasında en az bir kayıt bulunur; her Id GUID biçiminde, her IssueDate 2000–2099 aralığında olmalıdır. |
InvoiceLine[].Item.ItemInstance[].SerialId | cac:InvoiceLine/cac:Item/cac:ItemInstance/cbc:SerialID | SARJANLIK faturasında her satır en az bir boş olmayan seri numarası taşır. |
BillingReference[].InvoiceDocumentReference | cac:BillingReference/cac:InvoiceDocumentReference | IADE, TEVKIFATIADE, YTBIADE ve YTBTEVKIFATIADE tiplerinde cbc:DocumentTypeCode=IADE, tam 16 karakterli cbc:ID ve kaynak belge tarihi taşır; KAMU iadesinde de aynı yapı kullanılır. |
Delivery[] | cac:Delivery | Teslim tarihi, adresi, taşıma bilgisi ve ihracat teslim koşullarını taşır. |
PaymentMeans[] | cac:PaymentMeans | Ödeme aracı, vade ve alacaklı hesap bilgilerini taşır; KAMU profilinde TR IBAN kontrolü uygulanır. |
AllowanceCharge[] | cac:AllowanceCharge | Belge seviyesindeki indirim ve artırımlar tutar, oran ve temel tutarla birlikte aktarılır. |
TaxTotal[] | cac:TaxTotal | Vergi toplamı ve alt vergi kırılımları birlikte aktarılır. |
TaxTotal[].TaxSubtotal[].TaxCategory.TaxExemptionReasonCode | cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:TaxExemptionReasonCode | 233 kamulaştırma istisnasıdır. 555 yalnız izin verilen profil/tiplerde ve sıfır olmayan 0015 KDV ile kullanılır. 308/339 yalnız yatırım teşvik bağlamındadır. |
LegalMonetaryTotal | cac:LegalMonetaryTotal | Vergi hariç, vergi dahil ve ödenecek toplamları taşır. |
InvoiceLine[] | cac:InvoiceLine | Her kalemin miktar, fiyat, vergi ve ürün bilgilerini taşır. ENERJI profilinde Item.Name, InvoicedQuantity.Value/UnitCode ve en az bir TaxTotal.TaxSubtotal zorunludur. |
InvoiceLine[].PriceInvoiceLine[].InvoicedQuantity.Value | cac:Price/cbc:PriceAmountcbc:InvoicedQuantity | ENERJI profilindeki SARJ/SARJANLIK faturalarında her iki değer de en fazla 8 ondalık basamak içerebilir. |
InvoiceLine[].TaxTotal.TaxAmountTaxSubtotal[].TaxableAmount / TaxAmount / Percent | cac:TaxTotal ve cac:TaxSubtotal altındaki tutar/oran alanları | ENERJI profilindeki SARJ/SARJANLIK faturalarında vergi matrahı ve tutarları en fazla 2, vergi oranı en fazla 3 ondalık basamak içerebilir. |
InvoiceLine[]. | cac:InvoiceLine/ | YATIRIMTESVIK profilinde zorunludur. JSON request alanı Value'dur; değer 01, 02, 03 veya 04 olmalıdır. |
ContractDocumentReference[]SchemeId=YTBNO | cac:ContractDocumentReference/+ cbc:IssueDate | YATIRIMTESVIK profilinde zorunludur. ID 6 haneli, IssueDate dolu olmalıdır. |
InvoiceLine[]. | cac:InvoiceLine/ | IHRACAT profilinde her kalemde zorunludur. GTİP değeri 12 haneli ve yalnızca rakam olmalıdır. |
InvoiceLine[].SchemeId=KUNYENO | cac:InvoiceLine/schemeID="KUNYENO" | HKS profilinde her kalemde zorunludur. Değer tam 19 karakter olmalıdır. |
InvoiceLine[].SchemeId=ILACSchemeId=TIBBICIHAZSchemeId=DIGER | cac:InvoiceLine/ | ILAC_TIBBICIHAZ profilinde her kalem bu üç şema değerinden birini taşımalıdır. |
InvoiceLine[].SchemeId=ETIKETNO | cac:InvoiceLine/schemeID="ETIKETNO" | IDIS profilinde her kalemde zorunludur. Değer 2 harf ve ardından 7 rakam içermelidir. |
IdisSevkiyatNo | cac:AccountingSupplierParty/schemeID="SEVKIYATNO" | IDIS profilinde zorunludur. Değer SE- veya ES- ön eki ve ardından tam 7 rakam içermelidir. Hazır UBL’de bu değer AccountingSupplierParty altındaki SEVKIYATNO kimliğinde taşınır. Hedef ortamda İDİS UBL giriş desteği teyit edilmediyse JSON veya platform XML’i kullanın. |
PricingCurrencyCode | cbc:PricingCurrencyCode | UBL Invoice içinde opsiyoneldir. AddOutgoingInvoice isteğinden üretilen UBL'ye aktarılmaz; AddOutgoingInvoiceByUbl ile verilen hazır UBL'de kullanılabilir. |
TaxCurrencyCode | cbc:TaxCurrencyCode | UBL Invoice içinde opsiyoneldir. AddOutgoingInvoice isteğinden üretilen UBL'ye aktarılmaz; AddOutgoingInvoiceByUbl ile verilen hazır UBL'de kullanılabilir. |
PaymentAlternativeCurrencyCode | cbc:PaymentAlternativeCurrencyCode | UBL Invoice içinde opsiyoneldir. AddOutgoingInvoice isteğinden üretilen UBL'ye aktarılmaz; AddOutgoingInvoiceByUbl ile verilen hazır UBL'de kullanılabilir. |
Ayrıntı ve güncelleme çevrimi: UBL'den üretilen ayrıntı yanıtında
AdditionalDocumentReference[] ve ContractDocumentReference[] kayıtlarının Id ile SchemeId alanları birlikte korunur. InvoiceLine[].Item.AdditionalItemIdentification[] değerleri düz metin dizisi değil, her biri SchemeId ve Value taşıyan nesneler olarak döner. SARJ ve SARJANLIK tiplerinde UBL'deki StartDate/StartTime ile EndDate/EndTime çiftleri ayrıntı ve güncelleme modellerindeki InvoicePeriod.StartDate/EndDate tarih-saat değerlerine yeniden birleştirilir; diğer fatura tiplerinin ortak dönem dönüşümü tarih bileşeniyle kalır. Bu alanları ayrıntı yanıtından güncelleme isteğine taşırken nesne yapısı ve SchemeId değerleri kaybedilmemelidir. Uygulama Notları
Yatırım Teşvik Fatura Tipi Kümeleri
ItemClassificationCode | İzin Verilen InvoiceTypeCode Değerleri | Ek Kural |
|---|---|---|
01 veya 02 | SATIS, ISTISNA veya IADE | Güncel GİB e-Fatura kılavuzundaki tip kümesi kullanılır. |
03 veya 04 | SATIS veya IADE | ISTISNA kullanılamaz; KDV oranı sıfır olamaz. |
İstisna kodu eşleşmesi:
YATIRIMTESVIK + ISTISNA bağlamında ItemClassificationCode=01 olan kalemin 0015 KDV kırılımında TaxExemptionReasonCode=308; ItemClassificationCode=02 olan kalemde 339 bulunmalıdır. Profil Bazlı Alan Kontrolleri
| Profil | Zorunlu Değer | Koşul | Hata |
|---|---|---|---|
IHRACAT | GTİP | Her kalemde 12 haneli sayısal değer | SCHEME |
HKS | KUNYENO | Her InvoiceLine içinde bulunmalıdır | SCHEME |
ILAC_TIBBICIHAZ | ILAC, TIBBICIHAZ veya DIGER | Her InvoiceLine bu değerlerden birini taşımalıdır | SCHEME |
IDIS | ETIKETNO | Her InvoiceLine içinde bulunmalıdır | SCHEME |