bulut API Dokümantasyonu
Postman
Ana Sayfa › Kişi Yönetimi › Kişi Blok Ekle

Kişi Blok Ekle

Kişi Blok Ekle, Evobulut ön muhasebe / ERP yazılımının Kişi Yönetimi modülüne ait bir REST API servisidir. POST yöntemiyle https://ws.evobulut.com/api/cari/base/ adresine JSON gönderilerek çağrılır; kimlik doğrulama için Login servisinden alınan Token UID değeri gereklidir.

POSThttps://ws.evobulut.com/api/cari/base/
Açıklama

Kişi kaydını ona bağlı adres, telefon, eposta bilgileri ile beraber tek seferde eklemek için geliştirilen servistir.


Response Body JSON Açıklamaları

data : Ana veri Bloğu 

telefonlar : telefon kayıtları 

e-postalar : mail kayıtları 

adresler : adres kayıtları

Alan Veri Tipi Zorunlu Açıklama
cmd string E batch_ins
UID string E KULLANICI_UID Login Anında Alınan UID Token Verisi
data : {
E Kişi Temel Bilgileri JSON Tag ismi Jobject
a_kod string E Kişi Kodu Boş geçilemez ve tekrarlamayan bir değer girilmeli.
a_ad string E Kişi Adı
a_soy string H Kişi Soy Adı
a_tip int E S = 1 Zorunlu Sabit Değer Kişi İçin Sabit 1 Değeri Girilmeli
a_tcno string H Kişi T.C. Kimlik Nosu
a_dogtar string H Kişi Doğum Tarihi gg.aa.yyyy Formatında veri yada boş geçile bilir.
a_mus_tip int H Müşteri Tipi   (Detay İçin Bakınız !)
telefonlar : [
H Firma Telefon Bilgileri Jarray [1..n]
a_no string E Telefon Numarası
a_hat string H Dahili Hat Nosu
a_aciklama string H Telefon Açıklaması
a_tur_adi string H Telefon Türü (Sabit, GSM, Fax, İş Telefonu, Ev Telefonu V.S)
e-postalar : [
H Firma E-Posta Bilgileri Jarray [1..n]
a_eposta string E E-Posta Adresi
a_aciklama string H E-Posta Açıklaması
a_bildirim int E 1 = Bildirim Gönderilir, 0 = Bildirim Gönderilmez.
a_reklam int E 1 = Reklam Gönderilir, 0 = Reklam Gönderilmez.
a_efatura int E 1 = E-Fatura Gönderilir, 0 = E-Fatura Gönderilmez.
a_eirsaliye int E 1 = E-İrsaliye Gönderilir, 0 = E-İrsaliye Gönderilmez.
adresler : [
H Firma İletişim Posta Adres Bilgileri Jarray [1..n]
a_adres_tip_adi string E Adres Türü Ev Adresi, Fatura Adresi, İş Adres v.s.
a_aciklama string H Adres Açıklaması
a_adres string E Açık adres bilgisi
a_pk string H Posta Kodu
a_enlem_lat float H Konum Enlem Bilgisi
a_boylam_lon float H Konum Boylam Bilgisi
a_ulke_adi string E Adres Ülke Bilgisi Boş İse Türkiye Olarak Alınır (Kayıt Bulunamaz ise Otomatik Oluşturulur)
a_sehir_adi string H Şehir Adı Boş İse İlçe Göz Adrı Edilir. (Boş Değil iken Kayıt Bulunamaz ise Otomatik Oluşturulur)
a_ilce_adi string H İlçe adı Şehre bağlı olan İlçe Adı (Boş Değil iken Kayıt Bulunamaz ise Otomatik Oluşturulur)
Header Bilgileri
X-ClientIdLogin anında alınan kullanıcı Token UID bilgisi
İstek Gövdesi (JSON)
{
  "UID": "KULLANICI_UID",
  "cmd": "batch_ins",
  "data": {
    "a_kod": "MKOD003",
    "a_ad": "HASAN (Test Müşterisi)",
    "a_soy": "TASAN",
    "a_tip": "1",
    "a_tcno": "",
    "a_dogtar": "15.12.2002",
    "a_mus_tip": "1",
    "telefonlar": [
      {
        "a_no": "05422424242",
        "a_hat": "",
        "a_aciklama": "Hasan GSM 1",
        "a_tur_adi": "GSM"
      },
      {
        "a_no": "02222333333",
        "a_hat": "102",
        "a_aciklama": "İş Telefonu 1",
        "a_tur_adi": "Sabit"
      },
      {
        "a_no": "053333333",
        "a_hat": "",
        "a_aciklama": "Hasan GSM 2",
        "a_tur_adi": "GSM"
      },
      {
        "a_no": "05322323232",
        "a_hat": "",
        "a_aciklama": "Hasan GSM 3",
        "a_tur_adi": "GSM"
      }
    ],
    "e-postalar": [
      {
        "a_eposta": "[email protected]",
        "a_aciklama": "açıklama",
        "a_bildirim": "0",
        "a_reklam": "0",
        "a_efatura": "0",
        "a_eirsaliye": "0"
      },
      {
        "a_eposta": "[email protected]",
        "a_aciklama": "açıklama2",
        "a_bildirim": "1",
        "a_reklam": "1",
        "a_efatura": "1",
        "a_eirsaliye": "1"
      }
    ],
    "adresler": [
      {
        "a_adres_tip_adi": "Ev Adresi",
        "a_aciklama": "Hasan Bey in Ev Adresi",
        "a_adres": "Yeni Mahç. Eski Sok Geniş Apt. kat:4 Daire :5 ",
        "a_pk": "26000",
        "a_enlem_lat": "30.000025",
        "a_boylam_lon": "30.00025",
        "a_ulke_adi": "Türkiye",
        "a_sehir_adi": "Eskişehir",
        "a_ilce_adi": "Odunpazarı"
      },
      {
        "a_adres_tip_adi": "İş Adresi",
        "a_aciklama": "Şirket Muhasebe Adresi",
        "a_adres": "XX Mah. YY Sok ZZ Apt. kat:4 Daire :5 ",
        "a_pk": "26000",
        "a_enlem_lat": "30.000025",
        "a_boylam_lon": "30.00025",
        "a_ulke_adi": "Türkiye",
        "a_sehir_adi": "Bursa",
        "a_ilce_adi": "Gemlik"
      }
    ]
  }
}
Kod Örnekleri
curl -X POST "https://ws.evobulut.com/api/cari/base/" \
  -H "Content-Type: application/json" \
  -d '{
  "UID": "KULLANICI_UID",
  "cmd": "batch_ins",
  "data": {
    "a_kod": "MKOD003",
    "a_ad": "HASAN (Test Müşterisi)",
    "a_soy": "TASAN",
    "a_tip": "1",
    "a_tcno": "",
    "a_dogtar": "15.12.2002",
    "a_mus_tip": "1",
    "telefonlar": [
      {
        "a_no": "05422424242",
        "a_hat": "",
        "a_aciklama": "Hasan GSM 1",
        "a_tur_adi": "GSM"
      },
      {
        "a_no": "02222333333",
        "a_hat": "102",
        "a_aciklama": "İş Telefonu 1",
        "a_tur_adi": "Sabit"
      },
      {
        "a_no": "053333333",
        "a_hat": "",
        "a_aciklama": "Hasan GSM 2",
        "a_tur_adi": "GSM"
      },
      {
        "a_no": "05322323232",
        "a_hat": "",
        "a_aciklama": "Hasan GSM 3",
        "a_tur_adi": "GSM"
      }
    ],
    "e-postalar": [
      {
        "a_eposta": "[email protected]",
        "a_aciklama": "açıklama",
        "a_bildirim": "0",
        "a_reklam": "0",
        "a_efatura": "0",
        "a_eirsaliye": "0"
      },
      {
        "a_eposta": "[email protected]",
        "a_aciklama": "açıklama2",
        "a_bildirim": "1",
        "a_reklam": "1",
        "a_efatura": "1",
        "a_eirsaliye": "1"
      }
    ],
    "adresler": [
      {
        "a_adres_tip_adi": "Ev Adresi",
        "a_aciklama": "Hasan Bey in Ev Adresi",
        "a_adres": "Yeni Mahç. Eski Sok Geniş Apt. kat:4 Daire :5 ",
        "a_pk": "26000",
        "a_enlem_lat": "30.000025",
        "a_boylam_lon": "30.00025",
        "a_ulke_adi": "Türkiye",
        "a_sehir_adi": "Eskişehir",
        "a_ilce_adi": "Odunpazarı"
      },
      {
        "a_adres_tip_adi": "İş Adresi",
        "a_aciklama": "Şirket Muhasebe Adresi",
        "a_adres": "XX Mah. YY Sok ZZ Apt. kat:4 Daire :5 ",
        "a_pk": "26000",
        "a_enlem_lat": "30.000025",
        "a_boylam_lon": "30.00025",
        "a_ulke_adi": "Türkiye",
        "a_sehir_adi": "Bursa",
        "a_ilce_adi": "Gemlik"
      }
    ]
  }
}'
Başarılı Yanıt
200 OK
{
  "status": "OK",
  "veri": {
    "mesaj": "Kayıt başarıyla oluşturuldu",
    "id": 173352
  }
}
Başarısız Yanıt
200 OK — status: ERR
{
    "status": "ERR",
    "veri": [
        {
            "mesaj": "Veri geçersiz, kontrol ediniz.",
            "data": [
                "Kod tekrarı, eklenemedi." 
			  //...
			  //birden fazla hata mesajı verebilir
            ]
        }
    ]
}
Kişi Yönetimi modülündeki diğer servisler

Kişi Yönetimi modülünün tamamı (20 servis) →