# 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. - **Modül:** Kişi Yönetimi - **Yöntem:** POST - **Endpoint:** `https://ws.evobulut.com/api/cari/base/` - **Kimlik doğrulama:** Login servisinden alınan Token UID - **Son güncelleme:** 2025-06-13 - **Doküman:** https://dev.evobulut.com/servis/kisi-yonetimi/kisi-blok-ekle-287 ## 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-ClientId | Login 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": "mail@cari.com", "a_aciklama": "açıklama", "a_bildirim": "0", "a_reklam": "0", "a_efatura": "0", "a_eirsaliye": "0" }, { "a_eposta": "mail2@cari.com", "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" } ] } } ``` ## Örnek istek (cURL) ```bash 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": "mail@cari.com", "a_aciklama": "açıklama", "a_bildirim": "0", "a_reklam": "0", "a_efatura": "0", "a_eirsaliye": "0" }, { "a_eposta": "mail2@cari.com", "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 ```json { "status": "OK", "veri": { "mesaj": "Kayıt başarıyla oluşturuldu", "id": 173352 } } ``` ## Başarısız yanıt ```json { "status": "ERR", "veri": [ { "mesaj": "Veri geçersiz, kontrol ediniz.", "data": [ "Kod tekrarı, eklenemedi." //... //birden fazla hata mesajı verebilir ] } ] } ```