Alt Bayi Güncelleme

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

Açıklama

Bu servis aracılığıyla Portal ekranında olduğu gibi mevcut alt bayi ve alt bayiye ait kullanıcı(lar) güncellenebilir.

İstek gövdesinde yalnızca değiştirmek istediğiniz alanları gönderebilirsiniz; 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 bayinin üye kodu

Not: Bazı kurulumlarda alan adı Updatecode olarak geçebilir. Harf duyarlılığına (case sensitivity) dikkat edin.

Request Body Alanları

Vendor (Alt Bayi)

Alan Adı	Tip	Zorunlu	Açıklama
mainDealerCode	string	Evet	Ana bayi üye kodu
address	string	Hayır	Adres bilgisi
cityCode	string	Hayır	Şehir kodu
districtCode	string	Hayır	İlçe kodu
countryCode	string	Evet	Ülke kodu (örn. "TR")
code	string	Evet	Alt bayi kullanıcı kodu (benzersiz)
erpCode	string	Evet	ERP kodu (benzersiz)
isForeignNational	boolean	Hayır	Yabancı uyruklu mu
isIndividual	boolean	Evet	Bireysel (true) / Kurumsal (false)
name	string	Evet	Alt bayi adı
parentTenantId	string	Hayır	Ana tenant ID
paymentExCurrencyType	string	Hayır	Ödeme döviz/para birimi tipi
paymentSetDefinitionId	string	Hayır	Ödeme seti ID (tekil seçim; usablePaymentSetDefinitionIds içinde olmalı)
usablePaymentSetDefinitionIds	array	Hayır	Kullanılabilir ödeme setleri ID listesi
phone	string	Hayır	Sabit telefon
taxNumber	string	Şarta bağlı	Vergi numarası (genellikle isIndividual = false ise zorunlu)
taxOffice	string	Şarta bağlı	Vergi dairesi (genellikle isIndividual = false ise zorunlu)
customerRepresentativeIds	array	Hayır	Müşteri temsilcisi ID listesi

Users (Alt Bayi Kullanıcı) Alanları

Alan Adı	Tip	Zorunlu	Açıklama
userCode	string	Evet	Kullanıcı kodu
name	string	Evet	Kullanıcı adı
surname	string	Evet	Kullanıcı soyadı
email	string	Evet	Kullanıcı e-posta adresi
gsm	string	Evet	Cep telefonu
title	string	Hayır	Ünvan
description	string	Hayır	Açıklama
erpCode	string	Hayır	ERP kodu
isActive	boolean	Hayır	Aktif/pasif durumu
isIndividual	boolean	Hayır	Bireysel mi / Kurumsal mı
isForeignNational	boolean	Hayır	Yabancı uyruklu mu
paymentExCurrencyType	string	Hayır	Ödeme döviz/para birimi tipi
roles	array	Hayır	Rol ID listesi
ruleName	array	Hayır	Yetki seti isimleri
sendRegisterMail	boolean	Hayır	Güncelleme sonrası e-posta gönderilsin mi
taxNumber	string	Hayır	Vergi numarası
taxOffice	string	Hayır	Vergi dairesi
canUseMobile	boolean	Hayır	Mobil kullanım izni
userType	integer	Hayır	Kullanıcı tipi

Örnek Request

{  
  "code": "742",  
  "phone": "5000000000",  
  "countryCode": "TR",  
  "cityCode": "10",  
  "districtCode": 494,  
  "currencyCode": "TRY",  
  "erpCode": "742",  
  "address": "TEST ADRESİ Güncelleme11",  
  "taxNumber": "00000000000",  
  "customerRepresentativeIds": [  
      "8fc535a7-3a0c-4994-b19b-0f3c4da748a5"  
  ],  
  "isForeignNational": false,  
  "isCompany": false,  
  "name": "TEST VENDOR ALT BAYİSİ",  
  "parentTenantId": "7c394922-d312-4f91-8a9a-31e349d94380",  
  "paymentExCurrencyType": "string",  
"usablePaymentSetDefinitionIds": [  
  "eb8628f3-f5ee-8785-455c-d2ca1edb8c30",  
  "9104fd8e-b13f-54ba-004b-a5b6453231bc"  
],  
  "users": [  
      {  
          "id":"ee4faa61-55af-4069-a544-e4a6bd24c9b4",  
          "canUseMobile": false,  
          "description": "test",  
          "email": "[email protected]",  
          "code": "7423",  
          "gsm": "5000000000",  
          "isActive": true,  
          "name": "test",  
          "surname": "kullanıcısı",  
          "roles": [  
              "2d37006c-6000-4315-90fe-2dc2fe1fb184"  
          ],  
          "sendMail": false,  
          "userType": 8248  
      }  
  ],  
  "mainDealerCode": "NT65126658"  
}

Başarılı Response

{  
  "status": "success",  
  "message": "Alt bayi başarıyla güncellendi.",  
  "subDealerId": 1024  
}

Not: Daha önceki örnekte mesaj/alan adları “Müşteri / customerId” idi. Alt bayi kontekstine uygun olacak şekilde Alt bayi ve subDealerId olarak düzelttik.

Notlar & İyi Uygulamalar

• updateCode: Güncellenecek kaydı işaret eder. code alanını değiştiriyorsanız, hem eski kodu (updateCode) hem de yeni kodu (code) göndermeyi unutmayın.
• Ödeme setleri: paymentSetDefinitionId tekil seçim, usablePaymentSetDefinitionIds çoklu listedir. Tekil seçim listede yer almalıdır.
• Kurumsal güncellemeler: isIndividual = false ise, iş kurallarınıza göre taxNumber ve taxOffice zorunlu olabilir.
• Kısmi güncelleme: Değişmeyen alanları göndermeyin; sistem mevcut değerleri korur.
• Token: Süresi dolmuş token ile istek 401 döner; yeni token alıp isteği tekrar deneyin.