E-Müstahsil REST API

SMS Doğrulama Kodu Gönderme

POST{{baseUrl}}/{{v2}}/ecreditnotes/outbox/send-sms-code

e-Müstahsil Makbuzu için müstahsilin (malı satan tarafın) telefonuna SMS doğrulama kodu gönderir.

GİB'in 22.05.2026 tarihli duyurusu ve güncellenen e-Müstahsil Makbuzu Teknik Kılavuzu (V1.1) ile, makbuzun müstahsil tarafından ıslak imza ile imzalanması yerine; müstahsilin telefonuna gönderilen SMS kodunun, telefon numarasının ve SMS'i gönderen operatör bilgisinin e-Müstahsil Makbuzunda yer alması zorunlu hale getirilmiştir. Bu zorunluluk 05.11.2026 tarihinden itibaren düzenlenecek tüm e-Müstahsil Makbuzları için geçerlidir.

İşlem akışı:

Telefon numarası, tutar ve belge numarası ile bu servis çağrılır. Yanıtta status değeri PENDING döner.
Müstahsilin ilettiği SMS kodu, telefon numarası ile birlikte POST {{baseUrl}}/{{v2}}/ecreditnotes/outbox/verify-sms-code servisine gönderilir.
Başarılı doğrulamada status değeri VERIFIED döner.
Doğrulama yanıtındaki telefon numarası, SMS kodu ve SMS sağlayıcı bilgileri makbuza eklenerek POST {{baseUrl}}/{{v2}}/ecreditnotes/send servisi ile belge gönderilir.

Yanıt alanları:

Alan	Açıklama
`status`	İşlemin durum değeri. Başarılı gönderimde `PENDING` döner.
`phoneNumber`	SMS gönderilen telefon numarası.
`smsProvider`	SMS'i gönderen sağlayıcının adı.
`smsProviderVkn`	SMS sağlayıcının VKN'si.

Header Parametreleri

Ad	Tip	Zorunlu	Aciklama
`Authorization`	`text`	Evet	v1/auth/token endpointten alınan token

Body Parametreleri

Ad	Tip	Zorunlu	Aciklama
`phoneNumber`	`text`	Evet	SMS doğrulama kodunun gönderileceği müstahsilin telefon numarası.
`amount`	`number`	Hayir	İşleme (makbuza) ilişkin tutar. Örnek: 1250.50 (Opsiyonel)
`documentNo`	`text`	Hayir	İlgili e-Müstahsil Makbuzu belge numarası. (Opsiyonel)

Ornek Yanit

{
    "data": {
        "status": "PENDING",
        "phoneNumber": "0537***5258",
        "smsProvider": "EKO_SMS",
        "smsProviderVkn": "6220669058"
    },
    "error": null,
    "warning": null
}

Yanit Kodlari

Kod	Aciklama
`200`	SMS kodu gönderildi, doğrulama bekleniyor (status: PENDING)