Bayi / Alt Bayi Kullanıcısı Oluşturma

• Endpoint: /vendor/users
• HTTP Method: POST
• 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, mevcut bir bayi veya alt bayiye bağlı yeni kullanıcı(lar) oluşturmak için kullanılır. Sistemde kayıtlı olan bir DealerCode (bayi kodu) belirtilerek, ilgili üyeliğe kullanıcı eklenir.

Not: Bu endpoint, bayi veya alt bayi kaydı oluşturmaz ya da güncellemez — yalnızca mevcut bir bayiye kullanıcı ekler.

Header Bilgileri

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

Request Body

Üst Seviye Alanlar

Alan Adı	Tip	Zorunlu	Açıklama
DealerCode	string	Evet	Kullanıcıların ekleneceği bayi veya alt bayi üye kodu.
users	array	Evet	Eklenecek kullanıcı listesi (en az 1 öğe olmalı).

User (Bayi & Alt Bayi Kullanıcı) Alanları

Alan Adı	Tip	Zorunlu	Açıklama
code	string	Evet	Kullanıcı kodu (benzersiz olmalı).
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	Kullanıcı ERP kodu (varsa benzersiz olmalı).
isActive	boolean	Hayır	Aktif/pasif durumu (varsayılan: true).
isForeignNational	boolean	Hayır	Yabancı uyruklu mu.
canUseMobile	boolean	Hayır	Mobil kullanım izni (varsayılan: false).
roles	array	Hayır	Rol ID listesi.
ruleName	array	Hayır	Yetki seti isimleri.
sendMail	boolean	Hayır	Kayıt e-postası gönderilsin mi (varsayılan: false).
taxNumber	string	Hayır	Vergi numarası.
taxOffice	string	Hayır	Vergi dairesi.
userType	integer	Hayır	Kullanıcı tipi.

Örnek Request

{  
    "dealerCode": "NT23421002",  
    "users": [  
        {  
            "canUseMobile": true,  
            "description": "test",  
            "email": "[email protected]",  
            "erpCode": "4414",  
            "code": "4414",  
            "gsm": "5000000000",  
            "isActive": true,  
            "name": "John",  
            "surname": "Doe",  
            "roles": [  
                "a6f75072-4378-4db2-b432-9862335730d0"  
            ],  
            "sendMail": true,  
            "userType": 4,  
            "tckn": "00000000000"  
        }  
    ]  
}

DealerCode alanı, kullanıcıların ekleneceği bayi veya alt bayinin üye kodunu temsil eder.

Aynı endpoint ile birden fazla kullanıcı eklenebilir.

Başarılı Response (200 OK)

{  
  "status": "success",  
  "message": "Bayi kullanıcısı başarıyla oluşturulmuştur.",  
  "customerId": 1024  
}

Notlar & En İyi Uygulamalar

• dealerCode, sistemde kayıtlı bir bayi veya alt bayi kodu olmalıdır; aksi durumda istek 404 Not Found döner.
• Bir istek içinde birden fazla kullanıcı eklenebilir.
• Her kullanıcının code, email ve gsm değerleri benzersiz olmalıdır.
• sendMail = true ise, kullanıcıya otomatik olarak kayıt bilgilendirme e-postası gönderilir.
• roles ve ruleName alanları opsiyoneldir, ancak yetkilendirme süreçlerinde önerilir.
• Token süresi dolmuşsa istek 401 Unauthorized döner; yeni token alınarak tekrar denenmelidir.