İzibiz Developer Portal
Başlarken

Dikkat Edilmesi Gereken Hususlar

Aşağıdaki maddeler ExchangeWS servisinin WSDL ve XSD şemasından çıkarılmıştır. Entegrasyon sırasında en sık karşılaşılan uyumsuzluklar bu başlıklardan kaynaklanır.

Operasyon adı ile XML eleman adı farklıdır

WSDL'de operasyon loadDocument şeklinde küçük harfle tanımlıdır. Buna karşılık gönderilecek XML isteğinin eleman adı LoadDocumentRequest şeklinde büyük harfle başlar. Diğer dört operasyonda böyle bir fark yoktur.

ID ve UUID element olarak yazılır

Bu serviste ID ve UUID, DOCUMENT/HEADER içinde birer elementtir:

<DOCUMENT>

  <HEADER>

    <ID>DVZ2025000000001</ID>
    <UUID>8e14c7a2-5b63-4d09-9f81-3c07ea2b6d54</UUID>

  </HEADER>

</DOCUMENT>

E-Müstahsil servisindeki CREDITNOTE tipinde aynı bilgiler attribute olarak yazılır. İki servis arasında kod paylaşırken bu fark gözden kaçmamalıdır.

SENDING_TYPE alanı bu serviste yoktur

DOCUMENT_PROPERTIES yalnızca SMS_FLAG, SMS_NUMBER, EMAIL_FLAG ve EMAIL alanlarını içerir. E-Müstahsil ve E-Fatura servislerinde bulunan SENDING_TYPE alanı gönderilirse şema doğrulaması başarısız olur.

READ_INCLUDED boolean tipindedir

GetDocument isteğindeki SEARCH_KEY/READ_INCLUDED alanı xs:boolean tipindedir; true veya false gönderilir. Diğer bazı İzibiz servislerinde aynı isimli alan Y/N değeri alır.

DELETE_FLAG varsayılanı N'dir

CancelDocument isteğinde DELETE_FLAG gönderilmezse N kabul edilir ve belge yalnızca iptal edilir. Y gönderildiğinde belge kayıttan da düşülür; bu işlem geri alınamaz.

ECheckWS ile aynı sözleşme kullanılır

ExchangeWS ve ECheckWS (e-Adisyon) aynı namespace'i, aynı DOCUMENT tiplerini ve aynı beş operasyonu paylaşır. İki servise birden entegrasyon yazılıyorsa istemci kodu ortak tutulabilir; yalnızca endpoint adresi değişir.

Toplu gönderim ve MTOM

SendDocument ve LoadDocument isteklerinde DOCUMENT elemanı tekrarlanabilir. Büyük içeriklerde CONTENT alanı gömülü base64 yerine cid: referansı ile MTOM eki olarak gönderilebilir; servis tanımında MTOM etkindir.

SESSION_ID her istekte gönderilir

AuthenticationWS üzerinden alınan SESSION_ID, tüm isteklerin REQUEST_HEADER bölümünde yer almalıdır. Oturum süresi dolduğunda yeni oturum açılması gerekir.