İ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 Parametreleri

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

Body Parametreleri

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

Ornek Yanit

{
    "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
}

Yanit Kodlari

KodAciklama
200