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.
`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.
`BillingReference[]`	`cac:BillingReference`	İade faturasında kaynak belgenin numarası, tarihi ve belge tipi bu koleksiyonla aktarı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.
`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.
`InvoiceLine[].Item.CommodityClassification[].ItemClassificationCode`	`cac:InvoiceLine/cac:Item/cac:CommodityClassification/cbc:ItemClassificationCode`	`YATIRIMTESVIK` profilinde zorunludur. Değer `01`, `02`, `03` veya `04` olmalıdır.
`ContractDocumentReference[]` `SchemeId=YTBNO`	`cac:ContractDocumentReference/cbc:ID` + `cbc:IssueDate`	`YATIRIMTESVIK` profilinde zorunludur. `ID` 6 haneli, `IssueDate` dolu olmalıdır.
`InvoiceLine[].Delivery[].Shipment.GoodsItem[].RequiredCustomsId`	`cac:InvoiceLine/cac:Delivery/cac:Shipment/cac:GoodsItem/cbc:RequiredCustomsID`	`IHRACAT` profilinde her kalemde zorunludur. GTİP değeri 12 haneli ve yalnızca rakam olmalıdır.
`InvoiceLine[].Item.AdditionalItemIdentification[]` `SchemeId=KUNYENO`	`cac:InvoiceLine/cac:Item/cac:AdditionalItemIdentification/cbc:ID` `schemeID="KUNYENO"`	`HKS` profilinde her kalemde zorunludur. Değer tam 19 karakter olmalıdır.
`InvoiceLine[].Item.AdditionalItemIdentification[]` `SchemeId=ILACSchemeId=TIBBICIHAZSchemeId=DIGER`	`cac:InvoiceLine/cac:Item/cac:AdditionalItemIdentification/cbc:ID`	`ILAC_TIBBICIHAZ` profilinde her kalem bu üç şema değerinden birini taşımalıdır.
`InvoiceLine[].Item.AdditionalItemIdentification[]` `SchemeId=ETIKETNO`	`cac:InvoiceLine/cac:Item/cac:AdditionalItemIdentification/cbc:ID` `schemeID="ETIKETNO"`	`IDIS` profilinde her kalemde zorunludur. Değer 2 harf ve ardından 7 rakam içermelidir.
`IdisSevkiyatNo`	`cac:AccountingSupplierParty/cac:Party/cac:PartyIdentification/cbc:ID` `schemeID="SEVKIYATNO"`	`IDIS` profilinde zorunludur. Değer `SE-` ön eki ve ardından 7 rakam içermelidir.
`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.

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.

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`