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

NameTypeRequiredDescription
Authorization text Yes v1/auth/token endpointten alınan token

Body Parameters

NameTypeRequiredDescription
seriePrefix text No Belge seri ön eki
assignNumber text No Numaranın İzibiz tarafından atanıp atanmayacağı
idAssigned text No Numaranın önceden atanmış olup olmadığı
mailFlag text No Belgenin alıcıya e-posta ile iletilip iletilmeyeceği
mailAdress text No mailFlag true ise gönderim yapılacak e-posta adresleri
content text Yes Makbuz içeriği: profile, documentTypeCode, documentNo, uuid, issueDate, issueTime, currencyCode, supplierParty, customerParty, paymentMeans, taxTotal, legalMonetaryTotal, lines, additionalReferences

Response Codes

CodeDescription
200