Gelen Fatura

Gelen Fatura UBL → API/ERP Mapping

Alınan UBL Invoice alanlarının gelen fatura API yanıtı ve ERP modelindeki karşılıkları.

Okuma yönü: GİB'den alınan UBL Invoice ayrıştırılır ve gelen fatura ayrıntı response'una dönüştürülür. Operasyonel durum alanları UBL'den değil, platformdaki belge kaydından gelir.

Mapping Kapsamı

Veri kaynağı	API/ERP hedefi	Ne zaman kullanılır?
UBL `Invoice`	Belge, taraf, vergi, toplam ve kalem alanları	ERP fişi ve belge ayrıntısı oluşturulurken
Platform belge kaydı	Teknik/kullanıcı durumu, geliş tarihi, okundu ve ERP işleme bilgileri	Yaşam döngüsü, iş kuyruğu ve mutabakat yönetilirken

Belge Kimliği ve Temel Alanlar

UBL Invoice yolu	API response alanı	ERP kullanımı
`cbc:ID`	`InvoiceNumber`	Fatura numarası
`cbc:ProfileID`	`ProfileId`	Senaryo ve uygulama yanıtı gereksinimi
`cbc:UUID`	`UUId`	ETTN; tekilleştirme ve uçtan uca korelasyon
`cbc:IssueDate + cbc:IssueTime`	`IssueDate`	Belge düzenleme tarihi ve saati
`cbc:InvoiceTypeCode`	`InvoiceTypeCode`	Satış, iade, istisna ve diğer belge tipi ayrımı
`cbc:DocumentCurrencyCode`	`DocumentCurrencyCode`	Belge ve muhasebe para birimi
`cbc:LineCountNumeric`	`LineCountNumeric`	Beklenen kalem sayısı kontrolü
`cbc:Note[]`	`Note[]`	Fatura notları

Taraflar, Referanslar ve Teslimat

UBL Invoice yolu	API response alanı	İçerik
`cac:AccountingSupplierParty`	`AccountingSupplierParty`	Göndericinin kimlik, unvan, adres ve vergi bilgileri
`cac:AccountingCustomerParty`	`AccountingCustomerParty`	Alıcının kimlik, unvan, adres ve vergi bilgileri
`cac:BuyerCustomerParty`	`BuyerCustomerParty`	Alıcı tarafın profile özgü ek bilgileri
`cac:BillingReference[]`	`BillingReference[]`	İlişkili fatura ve iade referansları
`cac:OrderReference`	`OrderReference`	Sipariş numarası ve tarihi
`cac:AdditionalDocumentReference[]`	`AdditionalDocumentReference[]`	Profile özgü veya destekleyici belge referansları
`cac:ContractDocumentReference[]`	`ContractDocumentReference[]`	Sözleşme ve teşvik belgesi referansları
`cac:DespatchDocumentReference[]`	`DespatchDocumentReference[]`	İrsaliye referansları
`cac:Delivery[]`	`Delivery[]`	Teslim tarihi, adresi, taşıma ve teslim koşulları

Vergi, Toplam, Ödeme ve Kalemler

UBL Invoice yolu	API response alanı	ERP kontrolü
`cac:AllowanceCharge[]`	`AllowanceCharge[]`	Belge seviyesindeki indirim ve artırımlar
`cac:TaxTotal[]`	`TaxTotal[]`	Vergi toplamı ve vergi alt kırılımları
`cac:WithholdingTaxTotal[]`	`WithholdingTaxTotal[]`	Tevkifat toplamları
`cac:LegalMonetaryTotal`	`LegalMonetaryTotal`	Vergi hariç/dahil, iskonto ve ödenecek toplam mutabakatı
`cac:PaymentMeans[]`	`PaymentMeans[]`	Ödeme yöntemi, vade ve hesap bilgileri
`cac:PaymentTerms[]`	`PaymentTerms[]`	Ödeme koşulları
`cac:InvoiceLine[]`	`InvoiceLine[]`	Kalem kimliği, miktar, fiyat, vergi, ürün ve teslimat bilgileri

Döviz Alanları

UBL alanı	API response alanı
`cbc:PricingCurrencyCode`	`PricingCurrencyCode`
`cbc:PaymentCurrencyCode`	`PaymentCurrencyCode`
`cbc:TaxCurrencyCode`	`TaxCurrencyCode`
`cbc:PaymentAlternativeCurrencyCode`	`PaymentAlternativeCurrencyCode`
`cac:PricingExchangeRate`	`PricingExchangeRate`
`cac:PaymentExchangeRate`	`PaymentExchangeRate`
`cac:TaxExchangeRate`	`TaxExchangeRate`

UBL Dışındaki Operasyonel Alanlar

Aşağıdaki alanlar faturanın XML içeriğinden türetilmez. Entegratör bu değerleri yaşam döngüsü ve ERP mutabakatı için ayrı olarak değerlendirmelidir.

API alanı	Kaynak	Kullanım
`IncomingInvoiceStatus`	Platform belge durumu	Teknik ilerleme ve hata takibi
`IncomingInvoiceStatusForUser`	Platform kullanıcı durumu	Portal/ERP karar metni
`IncomingDate`	Belgenin platforma geliş zamanı	Yeni belge pencere sorguları ve SLA takibi
`EnvelopeId`	GİB zarf kimliği	Zarf düzeyinde destek ve mutabakat
`IsErpProcessed`	Entegratör güncellemesi	ERP'ye alınmış belgeyi yeniden işleme riskini azaltma
`ErpProcessBranch`	Entegratör güncellemesi	İşlemi yapan şube/kaynak kaydı
`IsRead`, `IsReadDate`	Portal görüntüleme bilgisi	Okundu durumu

ERP Kabul Kontrolü

Kontrol	Kabul koşulu	Başarısızsa
Tekilleştirme	`UUId`/ETTN daha önce işlenmemiştir.	Yeni kayıt açmadan mevcut kayıtla mutabakat yapılır.
Kalem-toplam dengesi	Kalem, vergi ve parasal toplamlar ERP hesaplamasıyla uzlaşır.	Belge manuel incelemeye alınır.
Taraf eşleştirme	Satıcı VKN/TCKN yerel cari hesapla eşleşir.	ERP işleme bayrağı güncellenmez.
Belge aslı	UBL XML ve API ayrıntısı aynı ETTN'yi taşır.	Aktarım durdurulur ve tekrar sorgulanır.