İzibiz Developer Portal
E-Müstahsil REST API

Belge Gönderme

POST{{baseUrl}}/{{v2}}/ecreditnotes/send

JSON gövde ile müstahsil makbuzu gönderir. {{version}} (v1) ve {{v2}} sürümlerinin ikisi de çalışır.

Kurallar:

  • seriePrefix hesapta tanımlı bir seri olmalıdır; tanımlı seriler GET {{baseUrl}}/{{v2}}/ecreditnotes/series ile listelenir. Tanımsız ön ek gönderilirse "Seri ön eki sistemde bulunamadı" hatası alınır.
  • content.supplierParty.identifier oturum açan hesabın VKN/TCKN değeriyle aynı olmalıdır.
  • Her gönderimde content.uuid ve content.documentNo benzersiz olmalıdır.
  • Görüntüleme şablonu için gövdeye xsltName eklenir (örn. DEFAULT) ya da content.additionalReferences içinde documentType: "XSLT" kaydıyla şablon Base64 olarak gömülür.

SMS doğrulamalı gönderim (05.11.2026 itibarıyla zorunlu): Makbuz gönderilmeden önce müstahsilin telefonuna POST {{baseUrl}}/{{v2}}/ecreditnotes/outbox/send-sms-code ile SMS kodu gönderilir ve kod POST {{baseUrl}}/{{v2}}/ecreditnotes/outbox/verify-sms-code ile doğrulanır (status: VERIFIED). Doğrulama yanıtındaki değerler gövdede şu alanlara yazılır:

  • customerParty.address.telephone ← phoneNumber
  • customerParty.address.name ← "SMS" (sabit değer)
  • customerParty.address.id ← code
  • supplierParty.address.otherCommunication.name ← "SMS_PROVIDER" (sabit değer)
  • supplierParty.address.otherCommunication.channelCode ← smsProvider
  • supplierParty.address.otherCommunication.value ← smsProviderVkn

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

Header Parametreleri

AdTipZorunluAciklama
Authorization text Evet v1/auth/token endpointten alınan token

Body Parametreleri

AdTipZorunluAciklama
seriePrefix text Hayir Belge seri ön eki
assignNumber text Hayir Numaranın İzibiz tarafından atanıp atanmayacağı
idAssigned text Hayir Numaranın önceden atanmış olup olmadığı
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 text Evet Makbuz içeriği: profile, documentTypeCode, documentNo, uuid, issueDate, issueTime, currencyCode, supplierParty, customerParty, paymentMeans, taxTotal, legalMonetaryTotal, lines, additionalReferences

Yanit Kodlari

KodAciklama
200