Alt Müşteri Güncelleme

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

Açıklama

Bu servis aracılığıyla sistemde mevcut bir alt müşteri (subcustomer) kaydı güncellenebilir. Yalnızca ilgili ana bayi (mainDealerCode) veya yetkili kullanıcı kendi alt müşterilerini güncelleyebilir.

Gönderilen JSON isteğinde sadece değiştirilecek alanların yer alması tavsiye edilir. Gönderilmeyen alanlar mevcut değerlerini korur.

Header Bilgileri

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

Update Referans Alanı

Alan Adı	Tip	Zorunlu	Açıklama
updateCode	string	Evet	Güncellenecek alt müşterinin üye kodu

Not: Alan adının sistemde Updatecode olarak geçtiği durumlarda harf duyarlılığına dikkat edilmelidir (örn. "Updatecode": "SUBCUST001").

Request Body Alanları

Alan Adı	Tip	Zorunlu	Açıklama
mailDealerCode	string	Hayır	Ana bayi üye kodu
code	string	Hayır	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	Hayır	Müşteri e-posta adresi
mobile	string	Hayır	Cep telefonu numarası
phone	string	Hayır	Sabit telefon numarası
countryCodeISO	string	Hayır	Ülke kodu (örn. "TR")
cityCode	string	Hayır	Şehir kodu
currencyTypeId	integer	Hayır	Para birimi ID’si
erpCode	string	Hayır	ERP kodu (benzersiz olmalı)
isActive	boolean	Hayır	Aktif/Pasif durumu (true/false)
isCompany	boolean	Hayır	Kurumsal ise true, bireysel ise false
address	string	Hayır	Adres bilgisi
tckn	string	Hayır	Bireysel müşteriler için TCKN
taxNumber	string	Hayır	Kurumsal müşteriler için vergi numarası
taxOffice	string	Hayır	Kurumsal müşteriler için vergi dairesi
parentCode	string	Hayır	Alt müşteri ise bağlı olduğu ana bayinin kullanıcı kodu
parentUserEmail	string	Hayır	Ana bayinin ilk admin e-posta adresi
sendMail	boolean	Hayır	Güncelleme sonrası bilgilendirme e-postası gönderilsin mi
addDefaultCurrentAccount	boolean	Hayır	Güncelleme sonrası cari hesap oluşturulsun mu
paymentSetId	string	Hayır	Tanımlı ödeme seti ERP kodu

Not: isCompany değerine bağlı olarak bazı alanlar zorunlu hale gelir (örneğin taxNumber, taxOffice veya tckn).

Örnek İstek

{  
    "code": "21",  
    "countryCode": "TR",  
    "cityCode": "10",  
    "districtCode": 494,  
    "currencyCode": "TRY",  
    "erpCode": "65130asxc",  
    "address": "test1",  
    "tckn": "00000000000",  
    //"taxOffice": "Silifke",  
    "customerRepresentativeIds": [  
        "5766d60f-b848-4c6b-8886-e9c087d0002f"  
    ],  
    "isForeignNational": false,  
    "isCompany": false,  
    "firstName": "John",  
    "lastName": "Doe",  
    "email": "[email protected]",  
    "mobile": "5000000000",  
    "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 güncellendi.",  
    "customerId": null  
}

Notlar ve En İyi Uygulamalar

• updateCode değeri, güncellenecek alt müşteriyi tanımlar.
  Eğer code değeri değiştirilecekse, hem eski (updateCode) hem yeni (code) alan gönderilmelidir.
• Kısmi Güncelleme: Sadece değiştirilecek alanları gönderin; diğer alanlar mevcut değerini korur.
• sendMail = true: Sistem yapılandırmanıza göre bilgilendirme e-postası gönderilir.
  isActive = false: Müşteri pasif hale getirilir.
• Token Süresi: Token süresi dolmuşsa yeni token alınarak istek yeniden gönderilmelidir.
• Alan Uyumu: PUT /vendor/subcustomers servisi, POST /vendor/subcustomers ile aynı alan adlarını kullanır.