Alt Müşteri Oluşturma

• Endpoint: /vendor/subcustomers
• HTTP Method: POST
• Request Content-Type: application/json
• Yetkilendirme: Geçerli AccessToken zorunludur.
  (Bkz: 2. Kimlik Doğrulama – AccessToken Alınması)

Açıklama

Bu servis, sistemde mevcut bir ana bayi (mainDealerCode) altında yeni bir alt müşteri (subcustomer) kaydı oluşturmak için kullanılır.

Alt müşteri, bağlı olduğu ana bayiye ilişkin ticari, ödeme ve erişim bilgilerini devralabilir.

Not: mainDealerCode (veya eski versiyonlarda mailDealerCode) alanı, alt müşterinin hangi bayiye bağlı olacağını belirtir.

Header Bilgileri

Header Adı	Zorunlu	Açıklama
Authorization	Evet	Bearer {AccessToken} formatında geçerli token
Content-Type	Evet	application/json

Request Body Alanları

Alan Adı	Tip	Zorunlu	Açıklama
mailDealerCode	string	Evet	Ana bayi üye kodu (üst müşteri kodu)
code	string	Evet	Alt müşteri üye kodu (benzersiz olmalı)
companyName	string	Evet (isCompany = true)	Kurumsal müşteriler için firma adı
firstName	string	Evet (isCompany = false)	Bireysel müşteriler için ad
lastName	string	Evet (isCompany = false)	Bireysel müşteriler için soyad
email	string	Evet	Müşteri e-posta adresi
mobile	string	Evet	Cep telefonu numarası
phone	string	Hayır	Sabit telefon numarası
countryCode	string	Evet	Ülke kodu (örn. "TR")
cityCode	string	Hayır	Şehir kodu
districtCode	integer	Hayır	İlçe kodu
currencyCode	integer	Evet	Para birimi ID’si
erpCode	string	Evet	ERP kodu (benzersiz olmalı)
isActive	boolean	Hayır	Aktif/Pasif durumu
isCompany	boolean	Evet	Kurumsal ise true, bireysel ise false
address	string	Hayır	Adres bilgisi
tckn	string	Evet (isCompany = false)	Bireysel müşteriler için TCKN
taxNumber	string	Evet (isCompany = true)	Kurumsal müşteriler için vergi numarası
taxOffice	string	Evet (isCompany = true)	Kurumsal müşteriler için vergi dairesi
sendMail	boolean	Hayır	Kayıt sonrası e-posta gönderilsin mi
addDefaultCurrentAccount	boolean	Hayır	Kayıt sonrası cari hesap oluşturulsun mu
paymentSetId	string	Hayır	Tanımlı ödeme seti ERP kodu
canUseMobile	boolean	Hayır	Mobil kullanıma izin verilsin mi
customerRepresentativeIds	array	Hayır	Müşteri temsilcisi ID’leri
passportNo	string	Hayır	Yabancı kimlik veya pasaport numarası
isForeignNational	boolean	Hayır	Yabancı uyruklu mu
title	string	Hayır	Ünvan veya ek bilgi
parentCode	string	Hayır	Ana bayi kodu (opsiyonel)
parentUserEmail	string	Hayır	Ana bayi kullanıcı e-postası (opsiyonel)

Örnek İstek

{  
    "code": "550",  
    "countryCode": "TR",  
    "cityCode": "10",  
    "districtCode": 494,  
    "currencyCode": "TRY",  
    "erpCode": "550",  
    "address": "test",  
    "tckn": "00000000000",  
    //"taxOffice": "Silifke",  
    "customerRepresentativeIds": [  
        "5766d60f-b848-4c6b-8886-e9c087d0002f"  
    ],  
    "isForeignNational": false,  
    "isCompany": false,  
    "firstName": "John",  
    "lastName": "Doe",  
    "email": "[email protected]",  
    "mobile": "5003998991",  
    "canUseMobile": false,  
    "sendMail": true,  
    "isActive": true,  
    "mainDealerCode": "NT65126658",  
    "paymentSetId": "15863986-6509-48c9-aaa7-419f90db879d"  
}

Başarılı Response

{  
    "status": "success",  
    "message": "Müşteri başarıyla oluşturuldu.",  
    "customerId": "aac398d1-0e54-411c-92b1-c2ead39ca0a2"  
}

Not: customerId, sistemde oluşturulan alt müşterinin benzersiz kimliğidir.

Kullanım Notları ve En İyi Uygulamalar

• Ana bayi bağımlılığı: Her alt müşteri mutlaka bir mainDealerCode ile ilişkilendirilmelidir.
• Zorunluluklar
  • isCompany = true → companyName, taxNumber, taxOffice zorunlu.
  • isCompany = false → firstName, lastName, tckn zorunlu.
• E-posta bildirimi: sendMail = true ise bilgilendirme e-postası otomatik gönderilir.
• Cari hesap: addDefaultCurrentAccount = true verilirse müşteriyle ilişkili cari hesap oluşturulur.
• Token yenileme: Token süresi dolmuşsa, önce yenilenip istek tekrar gönderilmelidir.
• Mobil erişim: canUseMobile = true ise kullanıcı mobil uygulamada oturum açabilir.