İzibiz Developer Portal
Müşteri Kaydı

Müşteri Kaydı Oluşturma

POST{{baseUrl}}/{{version}}/customers

Yeni müşteri kaydı açar, paket atar ve istenen ürünleri aktive eder.

Yetki: Bu uç kanal token'ı ile çağrılır (channelAdmin rolü). Normal müşteri token'ı yetersizdir.

Partner referansları — üçü birlikte tutarlı olmalıdır, aksi halde PARTNER_NOT_VALID (106) döner:

Alan Açıklama
channelRef.id Kanal
dealerRef.id Bayi
subDelaerRef.id Alt bayi

Dikkat: subDelaerRef alan adı API'de bu şekilde yazılmıştır (subDealerRef değil). Doğru yazımla gönderilirse referans tanınmaz ve PARTNER_NOT_VALID alınır.

Diğer kurallar:

  • identifier geçerli bir VKN (10 hane) veya TCKN (11 hane) olmalıdır.
  • Tüzel kişide firstName / lastName null bırakılır ve commercialName doldurulur; gerçek kişide her ikisi de verilir.
  • bundle nesnesi paket listesinden alınan alanların tamamını taşımalıdır (id, label, type, channelId, duration, price, amount, standardPrice). Paketler GET {{baseUrl}}/{{version}}/bundles/type/{type}/channel/{channelId} ile listelenir.
  • bundle.activationDate ve customerProduct[].activationRequestDate geçmiş tarih olamaz, en fazla 3 ay ileri olabilir.
  • contactInfo.phoneNumber sistemde başka bir müşteride kayıtlı olmamalıdır; aksi halde 145 — Telefon numarası sistemde kayıtlıdır hatası alınır.
  • customerProduct[].product: EINVOICE, EARCHIVE, ARCHIVE. Tanımlı ürünler GET {{baseUrl}}/{{version}}/bundles/system-products ile listelenir.

Doğrulama sırası: tarih → partner → telefon. Bir hata düzeltildiğinde bir sonraki kontrolün hatası görünür.

Yanıt: id (müşteri id), username (kimlik numarası) ve createTempPassword: true verildiyse activationKey. Bu anahtar PATCH {{baseUrl}}/{{version}}/users/change-password ucunda kullanıcıya şifre belirletmek için kullanılır.

Header Parameters

NameTypeRequiredDescription
Authorization text Yes **Kanal token'ı** gerekir — `Kanal Olarak Token Alma` ucundan alınır. Müşteri hesabı token'ı bu işlem için yetersizdir.
Content-Type text Yes

Body Parameters

NameTypeRequiredDescription
identifier text Yes VKN veya TCKN
firstName text No Ad
lastName text No Soyad
commercialName text No Ticari unvan
taxOffice text No Vergi dairesi
configType text No Konfigürasyon tipi
createTempPassword text No Geçici şifre oluşturulup kullanıcıya gönderilsin mi
address text Yes Adres: city, country, district, phoneNumber, street
bundle text Yes Atanacak paket: id, label, type, duration, price, amount, standardPrice, activationDate
contactInfo text No İletişim: email, name, phoneNumber
customerProduct text Yes Aktive edilecek ürünler: product (EINVOICE, EARCHIVE, ARCHIVE), activationRequestDate, gbAlias, pkAlias

Sample Response

{
    "data": {
        "id": 83649,
        "username": "6260181590",
        "configType": "O",
        "commercialName": "ÖRNEK TEKNOLOJİ ANONİM ŞİRKETİ",
        "identifier": "6260181590",
        "firstName": null,
        "lastName": null,
        "taxOffice": "KÜÇÜKYALI VERGİ DAİRESİ MÜD.",
        "createTempPassword": true,
        "activationKey": "$2a$10$..."
    },
    "error": null,
    "warning": null
}

Response Codes

CodeDescription
200