API

Veri → XBRL/UBL Mapping

Kaynak muhasebe alanlarının yevmiye, kebir ve berat çıktılarındaki teknik karşılıkları.

Mapping Kapsamı

e-Defter akışı tek bir fatura JSON'u üretmez. VBT Client'ın ayrıştırdığı muhasebe kayıtları Ledger_EntryHeaderModel ve Ledger_EntryDetailModel alanlarına, ardından GİB XBRL-GL yevmiye/kebir modeline dönüştürülür. Aşağıdaki hedef adları doğrudan platformun üretim eşlemesindeki alanlardır.

Kaynak alan	XBRL-GL hedef alanı	Platform kuralı
`EntryNumber`	`YevmiyeHeader.EntryNumber`	Muhasebe fiş numarasıdır.
`HeaderSequenceNumber`	`YevmiyeHeader.EntryNumberCounter` ve `YevmiyeDetail.LineNumberCounter`	Başlık sırası benzersiz ve kesintisiz ilerler; satırın başlık numarası üst kayıtla aynı olur.
`EnteredBy`	`YevmiyeHeader.EnteredBy`	Boş bırakılamaz.
`EnteredDate`	`YevmiyeHeader.EnteredDate`	Seçilen aylık dönem içinde ve kayıt sırasıyla uyumlu olmalıdır.
`EntryComment`	`YevmiyeHeader.EntryComment`	Fiş açıklamasını taşır.
`TotalDebit`, `TotalCredit`	`YevmiyeHeader.TotalDebit`, `YevmiyeHeader.TotalCredit`	Birbirine ve satırlardaki D/C toplamlarına eşit olmalıdır.
`LineSequenceNumber`	`YevmiyeDetail.LineNumber`	Satır sırası benzersiz ve kesintisiz ilerler.
`AccountMainId`, `AccountMainDescription`	`YevmiyeDetail.Account.AccountMainID`, `YevmiyeDetail.Account.AccountMainDescription`	Ana hesap kodu ve açıklaması boş bırakılamaz.
`AccountSubId`, `AccountSubDescription`	`YevmiyeDetail.Account.AccountSub.AccountSubID`, `YevmiyeDetail.Account.AccountSub.AccountSubDescription`	Alt hesap kodu ana hesap kodunu içermelidir.
`Amount`, `AmountCurrency`	`YevmiyeDetail.Amount`, `YevmiyeDetail.AmountCurrency`	Tutar sıfırdan büyük olmalıdır; para birimi ISO 4217 koduyla taşınır.
`AmountOriginalAmount`, `AmountOriginalCurrency`, `AmountOriginalExchangeRate*`	Aynı adlı `YevmiyeDetail` yabancı para alanları	Orijinal tutar kullanılıyorsa para birimi, kur, kur tarihi ve ilgili kur bilgileri birlikte tamamlanır.
`DebitCreditNote`	`YevmiyeDetail.DebitCreditCode`	`D` borç, `C` alacak anlamına gelir.
`PostingDate`, `DocumentReference`	`YevmiyeDetail.PostingDate`, `YevmiyeDetail.DocumentReference`	Satır tarihi başlığın `EnteredDate`, referans ise başlığın `EntryNumber` değeriyle eşleşir.
`DocumentType`, `DocumentTypeDescription`, `DocumentNumber`, `DocumentDate`	Aynı adlı `YevmiyeDetail` belge alanları	Belge türüne bağlı zorunluluklar aşağıdaki tabloda uygulanır.
`PaymentMethod`, `DetailComment`	`YevmiyeDetail.PaymentMethod`, `YevmiyeDetail.DetailComment`	Kaynak kayıt varsa aktarılır.

Kod ve Koşul Kümeleri

Alan/koşul	Kabul edilen değerler	Ek kural
`DebitCreditNote`	`D`, `C`	Fişin borç ve alacak satır toplamları eşit olmalıdır.
`DocumentType`	`check`, `invoice`, `order-customer`, `order-vendor`, `voucher`, `shipment`, `receipt`, `other`	Numara veya tarih gönderilmişse tür de gönderilir.
`check` / `invoice`	`DocumentNumber` ve `DocumentDate`	İki alan birlikte zorunludur.
`other`	`DocumentNumber`, `DocumentDate`, `DocumentTypeDescription`	Üç alan birlikte zorunludur.

Berat Kimliği

IdentificationNumber, BranchCode, dönem, defter türü ve parça numarası beratın dosya ve belge kimliğine temel olur. Paket adını entegratör üretmez; platformun döndürdüğü dosya adı GİB durum sorgusunda aynen kullanılır.

Doğrudan XML gönderimi değildir: TransferParsedFile, analiz edilmiş parça içeriğini taşır. XBRL/UBL dosyasının GİB şemasına göre üretimi platform sorumluluğundadır.