İzibiz Developer Portal
SOAP WS · E-Müstahsil WS (CreditNoteWS)

E-Müstahsil Gönderme (SendCreditNote)

SOAPSendCreditNoteRequest

SMS doğrulamalı gönderim (05.11.2026 itibarıyla zorunlu):

  • Makbuz gönderilmeden önce SendSmsCode ile müstahsilin telefonuna SMS kodu gönderilir ve VerifySmsCode ile doğrulanır (STATUS: VERIFIED).
  • UBL-TR formatındaki makbuz Base64 olarak kodlanıp CONTENT alanında gönderilir. Doğrulama yanıtındaki değerler UBL-TR içeriğinde şu alanlara yazılır:
<cac:AccountingSupplierParty>
   <cac:Party>
      ...
      <cac:Contact>
         <cbc:Telephone>0850 811 11 99</cbc:Telephone>
         <cbc:ElectronicMail>yazilim@izibiz.com.tr</cbc:ElectronicMail>
         <cac:OtherCommunication>
            <cbc:ChannelCode name="SMS_PROVIDER">Ekomesaj</cbc:ChannelCode>
            <cbc:Value>6220669058</cbc:Value>
         </cac:OtherCommunication>
      </cac:Contact>
   </cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty>
   <cac:Party>
      <cac:PartyIdentification>
         <cbc:ID schemeID="TCKN">11111111111</cbc:ID>
      </cac:PartyIdentification>
      ...
      <cac:Contact>
         <cbc:ID>001234</cbc:ID>
         <cbc:Name>SMS</cbc:Name>
         <cbc:Telephone>0 542 *** ** **</cbc:Telephone>
         <cbc:ElectronicMail>eposta@gmail.com</cbc:ElectronicMail>
      </cac:Contact>
      <cac:Person>
         <cbc:FirstName>MüstahsilAdi</cbc:FirstName>
         <cbc:FamilyName>MüstahsilSoyadi</cbc:FamilyName>
      </cac:Person>
   </cac:Party>
</cac:AccountingCustomerParty>
Doğrulama yanıtı UBL-TR alanı
PHONE_NUMBER AccountingCustomerParty/Party/Contact/Telephone
"SMS" (sabit değer) AccountingCustomerParty/Party/Contact/Name
CODE AccountingCustomerParty/Party/Contact/ID
"SMS_PROVIDER" (sabit değer) .../OtherCommunication/ChannelCode/@name
SMS_PROVIDER AccountingSupplierParty/Party/Contact/OtherCommunication/ChannelCode
SMS_PROVIDER_VKN AccountingSupplierParty/Party/Contact/OtherCommunication/Value

Örnek için Müstahsil makbuzu (SMS doğrulamalı) senaryosuna bakınız.

Parametreler

AdTipZorunluAciklama
REQUEST_HEADER object Evet Request Header objesi içerisinde SESSION_ID ve APPLICATION_NAME alanı zorunludur. SESSION_ID değeri Kimlik Doğrulama (Authentication) webservisinde ki Login metodundan alınan değerdir. Belge sıkıştırılarak/ziplenerek gönderiliyorsa COMPRESSED alanı gönderilmeyebilir veya Y olarak gönderilebilir. XML formatında sıkıştırılmadan yüklemek için mutlaka COMPRESSED elemanı eklenmeli ve N değeri gönderilmelidir.
└ SESSION_ID text Evet Kimlik doğrulama servisi (AuthenticationWS) oturum açma metodundan (Login) alına oturum/token/session bilgisi.
└ CLIENT_TXN_ID text Hayir İstemci uygulama tarafından işlem için üretilen işlem bilgisi (transaction id) varsa istek esnasında gönderilip, sonuçta alabileceğiniz bir değerdir. request/response eşleşmesi yapmak için kullanılabilir.
└ APPLICATION_NAME text Evet Metodu çağıran uygulamanın adı. Örnek: AppName-v1.4.67
└ COMPRESSED text Hayir İçerikte taşınan bilginin ZIP formatında sıkıştırılmış mı gönderildiği/talep edildiği bilgisi. Belge gönderim ve belge okuma servislerinde gönderilen değere göre işlem yapılmaktadır.
CREDITNOTE object Evet En az bir CREDITNOTE elementi bulunmalıdır. Toplu CREDITNOTE göndermek bu eleman çoklanır. Atanan belge numarası ID attribute içerisine, Evrensel tekil tanımlama numarasını (ETTN) UUID attribute eklenmek zorundadır.
└ CONTENT text Evet Belgenin Base64Binary olarak encode edilmiş XML veya Ziplenmiş içeriği. XML formatında sıkıştırılmadan göndermek için mutlaka COMPRESSED elemanı eklenmeli ve N değeri gönderilmelidir. Daha hızlı iletişim sağlamak için belgelerin sıkıştırılarak gönderilmesini öneriyoruz.
└ HEADER object Hayir
└ CUSTOMER object Hayir
└ IDENTIFIER text Hayir
└ NAME text Hayir
└ ISSUE_DATE text Hayir
└ PAYABLE_AMOUNT text Hayir
CREDITNOTE_PROPERTIES object Hayir CREDITNOTE belgesi ile ilgili parametrelerin belirlendiği elemandır. Belgenin alıcısına e-posta veya SMS olarak iletme isteği belirlenebilir.
└ SMS_FLAG text Hayir Belge alıcısına SMS olarak göndermek için Y değeri gönderilmelidir. Eleman gönderilmezse SMS_NUMBER dolu olsa dahi SMS gönderilmez. DİKKAT: Eğer müşterinin özel entegratör ile SMS gönderme hizmeti sözleşmesi yoksa ve Y değeri gönderilirse belgenin sisteme yüklenmesine izin verilmeyecektir. Bu durumda özel entegratör ile iletişime geçerek SMS gönderim hizmeti satın alınmalı veya SMS gönderiminin farklı bir kanaldan müşteri tarafından yapılması gerekmektedir. Bu durumda bu parametre gönderilmemeli veya N olarak gönderilmelidir.
└ SMS_NUMBER text Hayir Belgenin SMS olarak iletileceği telefon numarası. Eğer SMS_FLAG elemanına Y gönderilirse bu alan zorunludur. SMS_FLAG elemanı Y gönderilmezse bu elaman dolu olsa dahi SMS gönderilmez.
└ EMAIL_FLAG text Hayir Belge alıcısına e-posta olarak gönderilip gönderilmeyeceğinin belirlendiği parametredir. E-Posta göndermek istenilen durumda Y değeri gönderilmelidir. Eleman gönderilmezse EMAIL alanı dolu olsa dahi e-posta gönderilmez. DİKKAT: Eğer müşterinin özel entegratör ile e-posta gönderme hizmeti sözleşmesi yoksa ve Y değeri gönderilirse belgenin sisteme yüklenmesine izin verilmeyecektir. Bu durumda özel entegratör ile iletişime geçerek e-posta gönderim hizmeti satın alınmalı veya e-posta gönderiminin farklı bir kanaldan müşteri tarafından yapılması gerekmektedir. Bu durumda bu parametre gönderilmemeli veya N olarak gönderilmelidir.
└ EMAIL text Hayir Belgenin e-posta olarak iletileceği e-posta adresi. E-Posta formatında olmak zorundadır. E-Posta gönderimini özel entegratör sisteminden yapılması isteniyorsa Y değeri gönderilmelidir. Varsayılan değer N dir. EMAIL_FLAG alanı Y gönderildiği zaman bu elaman zorunludur. EMAIL_FLAG gönderilmemiş veya N değeri gönderilmişse bu elaman dolu olsa dahi e-posta gönderilmeyecektir.
└ SENDING_TYPE text Evet Belgenin yollanma şekli. ELEKTRONIK veya KAGIT olabilir. Gönderim şekli ELEKTRONIK olan belge SMS veya ePosta adresi olmak zorundadır
SERIES_PROPERTIES object Hayir Belge numarasının özel entegratör tarafından atanmasının belirleyen parametredir. Belge numarasının istemci tarafından atanmasını tavsiye ederiz.
└ SERIES_FLAG text Hayir Belge numarasının özel entegratör tarafından atanması için Y değeri gönderilmelidir. DİKKAT: SERIES_PREFIX elemanında belirlenen ön ek ile belge numarası atanacak ve belge içerisinde ki değer ezilecektir.
└ SERIES_PREFIX text Hayir Belge numarası atanacak ön ek. 3 hane alfanumerik değer içermelidir. Belge numarası yönetimi hakkında daha detaylı bilgi almak için Başlarken -> Belge Numarası Yönetimi başlığını inceleyiniz. Belge numarasının özel entegratör tarafından atanması için Y değeri gönderilmelidir. DİKKAT: SERIES_FLAG elemanı Y değeri gönderilmemişse bu alan dolu olsa dahi belge numarası atanmayacaktır.