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 Parameters

Name	Type	Required	Description
`Authorization`	`text`	Yes	v1/auth/token endpointten alınan token

Body Parameters

Name	Type	Required	Description
`phoneNumber`	`text`	Yes	SMS doğrulama kodunun gönderileceği müstahsilin telefon numarası.
`amount`	`number`	No	İşleme (makbuza) ilişkin tutar. Örnek: 1250.50 (Opsiyonel)
`documentNo`	`text`	No	İlgili e-Müstahsil Makbuzu belge numarası. (Opsiyonel)

Sample Response

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

Response Codes

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