İzibiz Developer Portal
REST API

Belge Gönderme

POST{{baseUrl}}/{{v2}}/evouchers/send

JSON gövde ile e-Gider Pusulası gönderir. Yalnızca {{v2}} altında çalışır. Aşağıdaki 11 senaryonun tamamı canlı test ile doğrulanmıştır.

Belge tipleri

  • content.documentTypeCode = SATIS — vergi mükellefi olmayan kişiden / vergiden muaf esnaftan / ikinci el işletmesi alımları
  • content.documentTypeCode = IADE — müşteri iadeleri

Kurallar

  • seriePrefix hesapta tanımlı bir seri olmalıdır; tanımlı seriler GET {{baseUrl}}/{{v2}}/evouchers/series ile listelenir (doğrulananlar: GDR, KLL).
  • content.supplierParty.identifier oturum açan hesabın VKN değeriyle aynı olmalıdır.
  • Her gönderimde content.uuid ve content.documentNo benzersiz olmalıdır.
  • IADE tipinde content.billingReference zorunludur. scheme değerleri: EARSIV_FATURA, SATIS_FISI, BELGESIZ. Belgesiz iadede de kayıt gönderilir, yalnızca id alanı boş bırakılır.
  • SATIS tipinde buyerParty yoksa customerParty.address.name ve customerParty.address.id zorunludur (UBL karşılığı AccountingCustomerParty/Contact). İade doğrulama yönteminde bu ikili SMS / IADEKODU gibi kanal ve kod bilgisini taşır.
  • Telefon biçimi: 10 haneli (5xxxxxxxxx) veya başında 0 ile 11 haneli; ilk anlamlı hane 0 olamaz.
  • Boş string kullanmayın: buyerParty, lines[].product, lines[].allowanceCharge[], notes[] alanları "" gönderilirse Cannot coerce empty String hatası alınır. Kullanılmayacaksa alanı çıkarın ya da boş dizi verin.
  • issueTime gerçek bir saat olmalıdır (HH:mm:ss).

Durum kodları: GET {{baseUrl}}/{{v2}}/evouchers/lookup/{scope}.

Header Parametreleri

AdTipZorunluAciklama
Authorization text Evet v1/auth/token endpointten alınan token
Content-Type text Hayir

Body Parametreleri

AdTipZorunluAciklama
xsltName text Hayir
content object Hayir
└ issueDate text Hayir
└ issueTime text Hayir
└ documentNo text Hayir
└ profile text Hayir
└ documentTypeCode text Hayir
└ currencyCode text Hayir
└ customerParty object Hayir
└ identifier text Hayir
└ schemeId text Hayir
└ taxOffice text Hayir
└ firstName text Hayir
└ lastName text Hayir
└ address object Hayir
└ city text Hayir
└ subCity text Hayir
└ district text Hayir
└ country text Hayir
└ streetName text Hayir
└ buildingNumber text Hayir
└ buildingName text Hayir
└ telephone text Hayir
└ postalCode text Hayir
└ region text Hayir
└ name text Hayir
└ id text Hayir
└ supplierParty object Hayir
└ name text Hayir
└ identifier text Hayir
└ schemeId text Hayir
└ taxOffice text Hayir
└ address object Hayir
└ website text Hayir
└ city text Hayir
└ country text Hayir
└ streetName text Hayir
└ telephone text Hayir
└ otherCommunication object Hayir
└ channelCode text Hayir
└ name text Hayir
└ value text Hayir
└ identifications array Hayir
└ scheme text Hayir
└ value text Hayir
└ buyerParty text Hayir
└ billingReference array Hayir
└ scheme text Hayir
└ id text Hayir
└ issueDate text Hayir
└ legalMonetaryTotal object Hayir
└ lineExtensionAmount text Hayir
└ taxExclusiveAmount text Hayir
└ taxInclusiveAmount text Hayir
└ payableAmount text Hayir
└ taxTotal object Hayir
└ taxAmount text Hayir
└ taxSubTotal array Hayir
└ calculationSequenceNumeric text Hayir
└ taxableAmount text Hayir
└ taxAmount text Hayir
└ percent text Hayir
└ taxScheme object Hayir
└ name text Hayir
└ typeCode text Hayir
└ lines array Hayir
└ id text Hayir
└ quantity text Hayir
└ product text Hayir
└ unitCode text Hayir
└ itemName text Hayir
└ lineExtensionAmount text Hayir
└ itemPrice text Hayir
└ taxTotal object Hayir
└ taxAmount text Hayir
└ taxSubTotal array Hayir
└ calculationSequenceNumeric text Hayir
└ taxableAmount text Hayir
└ taxAmount text Hayir
└ percent text Hayir
└ taxScheme object Hayir
└ name text Hayir
└ typeCode text Hayir
└ allowanceCharge array Hayir
└ notes array Hayir