İzibiz Developer Portal
E-Arşiv REST API

E-Arşiv Gönderme

POST{{baseUrl}}/{{version}}/earchives

JSON gövde ile e-Arşiv faturası gönderir. Belge tipi content.documentTypeCode, gönderim şekli additionalReferences içindeki SendingType ve EArchiveType ile belirlenir.

Önemli: Her gönderimde content.uuid ve content.documentNo benzersiz olmalıdır. Aşağıdaki senaryolardaki değerler doğrulama amacıyla birer kez kullanılmıştır; tekrar gönderirken bu iki alanı değiştirin.

Header Parameters

NameTypeRequiredDescription
Authorization text Yes Postman auth.bearer blogundan turetildi

Body Parameters

NameTypeRequiredDescription
documentAction text No SEND: gönder, DRAFT: taslak olarak kaydet
assignNumber text No Numaranın İzibiz tarafından atanıp atanmayacağı
seriePrefix text No Belge seri ön eki
xsltName text No Görüntüleme şablonu adı
mailFlag text No Belgenin alıcıya e-posta ile iletilip iletilmeyeceği
mailAdress text No mailFlag true ise gönderim yapılacak e-posta adresleri
content object No Fatura içeriği: profile, documentTypeCode, documentNo, uuid, issueDate, issueTime, currencyCode, supplierParty, customerParty, taxTotal, legalMonetaryTotal, lines, additionalReferences, paymentMeans, delivery
└ profile text No Senaryo: EARSIVFATURA
└ documentTypeCode text No Belge tipi: SATIS, IADE, KONAKLAMAVERGISI, HKSSATIS vb.
└ documentNo text No Fatura numarası (16 hane). assignNumber=true ise İzibiz atar
└ uuid text No Evrensel tekil tanımlama numarası (ETTN), GUID formatında
└ issueDate text No Fatura tarihi (YYYY-MM-DD)
└ issueTime text No Fatura saati (HH:mm:ss)
└ notes array No Faturaya eklenecek not satırları
└ currencyCode text No Para birimi kodu (ör. TRY)
└ supplierParty object No Satıcı (faturayı düzenleyen) bilgileri
└ contact text No İletişim kişisi
└ name text No Ad / ünvan
└ identifier text No VKN veya TCKN
└ schemeId text No Kimlik tipi: VKN veya TCKN
└ taxOffice text No Vergi dairesi
└ centralRegistrationNo text No MERSİS numarası
└ taxRegisterNo text No Ticaret sicil numarası
└ firstName text No Ad (şahıs için)
└ lastName text No Soyad (şahıs için)
└ headOffice text No Merkez bilgisi
└ customerType text No Müşteri tipi
└ glnNo text No GLN numarası
└ address object No Adres bilgileri
└ website text No Web sitesi
└ city text No İl
└ subCity text No İlçe
└ district text No Semt / mahalle
└ country text No Ülke
└ postalZone text No Posta bölgesi
└ streetName text No Cadde / sokak
└ buildingNumber text No Bina numarası
└ buildingName text No Bina adı
└ email text No E-posta adresi
└ telephone text No Telefon
└ faxNo text No Faks
└ postalCode text No Posta kodu
└ region text No Bölge
└ nationalityId text No Uyruk
└ identifications array No Ek kimlikler (MERSISNO, TICARETSICILNO vb.)
└ scheme text No Kimlik türü
└ value text No Kimlik değeri
└ additionalReferences array No Ek referanslar: XSLT şablonu, CaseCode, SendingType (ELEKTRONIK/KAGIT), EArchiveType (INTERNET) vb.
└ documentType text No Referans tipi / değeri (XSLT, ELEKTRONIK, INTERNET vb.)
└ id text No Kimlik / sıra numarası
└ issueDate text No Tarih (YYYY-MM-DD)
└ attachment object No Ek dosya (ör. XSLT şablonu)
└ characterSetCode text No Karakter seti (UTF-8)
└ encodingCode text No Kodlama (Base64)
└ filename text No Dosya adı
└ mimeCode text No MIME tipi
└ content text No Dosya içeriği (Base64)
└ documentTypeCode text No Referans türü kodu: CaseCode, SendingType, EArchiveType
└ customerParty object No Alıcı bilgileri
└ schemeId text No Kimlik tipi: VKN veya TCKN
└ identifier text No VKN veya TCKN
└ firstName text No Ad (şahıs için)
└ lastName text No Soyad (şahıs için)
└ address object No Adres bilgileri
└ subCity text No İlçe
└ city text No İl
└ country text No Ülke
└ email text No E-posta adresi
└ taxTotal object No Belge geneli vergi toplamı
└ taxAmount text No Vergi tutarı
└ taxSubTotal array No Vergi kırılımları
└ calculationSequenceNumeric text No Hesaplama sırası
└ taxableAmount text No Matrah
└ percent text No Vergi oranı (%)
└ taxAmount text No Vergi tutarı
└ taxScheme object No Vergi türü
└ name text No Ad / ünvan
└ typeCode text No Vergi kodu (ör. KDV: 0015, Konaklama vergisi: 0059)
└ allowanceCharge array No Belge geneli iskonto / artırım
└ chargeIndicator text No true: artırım, false: iskonto
└ multiplierFactorNumeric text No Oran (%)
└ reason text No Açıklama
└ amount text No Tutar
└ baseAmount text No Uygulandığı tutar
└ legalMonetaryTotal object No Parasal toplamlar
└ lineExtensionAmount text No Satır tutarları toplamı
└ taxExclusiveAmount text No Vergiler hariç tutar
└ taxInclusiveAmount text No Vergiler dahil tutar
└ payableAmount text No Ödenecek tutar
└ allowanceTotalAmount text No Toplam iskonto tutarı
└ lines array No Fatura satırları
└ id text No Kimlik / sıra numarası
└ quantity text No Miktar
└ unitCode text No Birim kodu (ör. C62: adet)
└ lineExtensionAmount text No Satır tutarı
└ allowanceCharge array No Satır iskonto / artırım
└ chargeIndicator text No true: artırım, false: iskonto
└ reason text No Açıklama
└ multiplierFactorNumeric text No Oran (%)
└ amount text No Tutar
└ baseAmount text No Uygulandığı tutar
└ taxTotal object No Satır vergi toplamı
└ taxAmount text No Vergi tutarı
└ taxSubTotal array No Vergi kırılımları
└ taxableAmount text No Matrah
└ taxAmount text No Vergi tutarı
└ calculationSequenceNumeric text No Hesaplama sırası
└ percent text No Vergi oranı (%)
└ taxScheme object No Vergi türü
└ name text No Ad / ünvan
└ typeCode text No Vergi kodu (ör. KDV: 0015, Konaklama vergisi: 0059)
└ itemName text No Mal / hizmet adı
└ itemPrice text No Birim fiyat
└ paymentMeans array No Ödeme bilgileri (internet satışında zorunlu)
└ paymentCode text No Ödeme şekli kodu
└ paymentDueDate text No Ödeme tarihi
└ instructionNote text No Ödeme açıklaması / aracı
└ delivery array No Gönderi / taşıyıcı bilgileri (internet satışında)
└ carrierParty object No Taşıyıcı (kargo) firma veya kişi bilgileri
└ identifier text No VKN veya TCKN
└ schemeId text No Kimlik tipi: VKN veya TCKN
└ firstName text No Ad (şahıs için)
└ lastName text No Soyad (şahıs için)
└ address object No Adres bilgileri
└ postalCode text No Posta kodu
└ subCity text No İlçe
└ postalZone text No Posta bölgesi
└ city text No İl