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