İ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 Parameters

NameTypeRequiredDescription
Authorization text Yes v1/auth/token endpointten alınan token
Content-Type text No

Body Parameters

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