bulut API Dokümantasyonu
Postman
Ana Sayfa › Firma Yönetimi › Firma Blok Ekle

Firma Blok Ekle

Firma Blok Ekle, Evobulut ön muhasebe / ERP yazılımının Firma 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

Firma 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 FirmaTemel Bilgileri JSON Tag ismi Jobject
a_kod string E Firma Kodu Boş geçilemez ve tekrarlamayan bir değer girilmeli.
a_ad string E Firmanın Adı 
a_resmi_ad string E Firmanın Resmi Adı, verilmezse a_ad kullanılır
a_tip int E S = 0

Zorunlu Sabit Değer Firma İçin Sabit 0 Değeri Girilmeli
a_vergidairesi string H Firma Vergi Dairesinin adı
a_verginosu string H Firma Vergi Nosu (Veri olduğu taktirde E-Fatura Mükkellef Sorgusu Otomatik Yapılmaktadır.GB PK Adres alımı)
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)
İstek Gövdesi (JSON)
{
  "UID": "KULLANICI_UID",
  "cmd": "batch_ins",
  "data": {
    "a_kod": "FRM001",
    "a_ad": "ABC Firması",
    "a_resmi_ad": "ABC Ltd.Şti",
    "a_tip": "0",
    "a_vergidairesi": "ESKİŞEHİR",
    "a_verginosu": "11111111111",
    "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": "Fatura Adresi",
        "a_aciklama": "Şirket Muhasebe 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": "İstanbul",
        "a_ilce_adi": "Beyoğlu"
      },
      {
        "a_adres_tip_adi": "Sevkiyat Adresi",
        "a_aciklama": "Firma Depo 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": "İstanbul",
        "a_ilce_adi": "Bebek"
      }
    ]
  }
}
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": "FRM001",
    "a_ad": "ABC Firması",
    "a_resmi_ad": "ABC Ltd.Şti",
    "a_tip": "0",
    "a_vergidairesi": "ESKİŞEHİR",
    "a_verginosu": "11111111111",
    "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": "Fatura Adresi",
        "a_aciklama": "Şirket Muhasebe 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": "İstanbul",
        "a_ilce_adi": "Beyoğlu"
      },
      {
        "a_adres_tip_adi": "Sevkiyat Adresi",
        "a_aciklama": "Firma Depo 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": "İstanbul",
        "a_ilce_adi": "Bebek"
      }
    ]
  }
}'
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
            ]
        }
    ]
}
Firma Yönetimi modülündeki diğer servisler

Firma Yönetimi modülünün tamamı (23 servis) →