bulut API Dokümantasyonu
Postman
Ana Sayfa › Fatura › Fatura Blok Ekle

Fatura Blok Ekle

Fatura Blok Ekle, Evobulut ön muhasebe / ERP yazılımının Fatura modülüne ait bir REST API servisidir. POST yöntemiyle https://ws.evobulut.com/api/fatura/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/fatura/base/
Açıklama
Bir Faturayı Master ve Detay Olarak Tek Seferde Eklemek için oluşturulan Servistir.

Response Body JSON Açıklamaları
Ana : Fatura Üst Başlık Bilgileri
Detay : Fatura Satır (Ürün , Hizmet) Bilgilerini İçerir.

Alan Veri Tipi Zorunlu Açıklama
cmd string E fatura_batch_ins
UID string E KULLANICI_UID Login Anında Alınan UID Token Verisi
Ana : [
E Fatura Master Bilgileri JSON Tag ismi Array [1] 0. index kullanılır
a_tur int E İşlem Turu ID "31" Satış Faturası "30" Alış Faturası  Bakınız Ana[0].a_id
a_cari_id int E Müşteri ID (Firma yada Kişi Kaydındaki Tekil Anahtar)  Bakınız  Ana[0]["R.a_id"]
a_seri int H Otomatik Seri No ID nosu belge no otomatik verilecek ise
a_sbelge_seri_no string E Alış faturalarında Belge No, Elektronik Satışlarda “GÖNDERİLMEDİ”
a_tarih string E Fatura Tarihi gg.aa.yyyy formatında
a_vtarih string E Fatura Vade Tarihi gg.aa.yyyy formatında
a_ack string H Fatura Başlık Açıklaması
a_depo_id int E Fatura Satırlarındaki stoklar için Giriş/Çıkış yapılacak depo ID Bakınız veri[0].ID
a_sube_id int E Fatura Kaydının Bağlanacağı Şube ID Değeri  Bakınız veri[0].ID
a_dov_id int E Yerel para birimi ID (TL) için (0)  Bakınız Ana[0].ID
a_dov_kur float E Yerel para birimi (TL) için (1.0000) xxxxxx.yyyyy Ondalık Ayraç (.) Nokta
a_fulke string H Fatura Adresi Ülke Bilgisi E-Fatura için Zorunlu örnek : “Türkiye”
a_fili string H Fatura Adresi Şehir Bilgisi E-Fatura için Zorunlu örnek : “Eskişehir”
a_siparis_no string H Sipariş No
a_siparis_tar string H Sipariş Tarihi gg.aa.yyyy formatında
a_sulke string H Sevkiyat Ulke
a_sili string H Sevkiyat İl
a_silce string H Sevkiyat İlçe
a_sadres int H Sevkiyat Adresi Açık adres
a_spostakod string H Sevkiyat Posta Kodu
a_filce string H Fatura Adresi İlçe Bilgisi örnek : “Tepebaşı”
a_fpostakod string H Fatura Adresi Posta Kodu Bilgisi örnek : “26290” 
a_fadres1 string H Fatura Açık Adresi Bilgisi E-Fatura için Zorunlu örnek : “Merkez Mah Yan Sok XYZ Apartmanı”
a_fkapino string H Fatura Adresi Kapı No Bilgisi E-Fatura için Zorunlu örnek : “1”
a_onay int E 0 – Faturayı Onaysız Olarak Ekler 1-Faturayı Onaylı Olarak Ekler
Nots : [
H Fatura Master Bilgileri altında verilebilecek Detay Not JSON Tag ismi Array [1..n]
Sira int E Not Sıra Numarası
Aciklama string E Not Bilgisi
Detay : [
E Fatura Detay Satır Bilgileri JSON Tag ismi Array [1..n]
a_stok_id int E Stok Kartı ID Nosu   Bakınız  Ana[0].a_id
a_brm int E Satışını Birim ID (Adet, Metre, Litre Koli v.s.)  Bakınız  Ana[0].a_id
a_brm_mik float E Satışın Seçilen Biriminin Miktarı
a_brm_fiy float E Seçilen Birimin Fiyatı
a_ack string H Satır Açıklaması
a_alt_adi string H Alternatif Stok Ad bilgisi
a_dov_id int E Yerel para birimi ID (TL) için (0)  Bakınız Ana[0].ID
a_dov_kur float E Yerel para birimi (TL) için (1.0000) xxxxxx.yyyyy Ondalık Ayraç (.) Nokta
a_kdv float E Satırın KDV Oran Bilgisi (10.00 , 20.00) %10 %20 kdv
a_isk1 float H Satırın 1. İndirim (iskonto) Oran Bilgisi (0.00 Boş olması halinde)
a_isk2 float H Satırın 2. İndirim (iskonto) Oran Bilgisi (0.00 Boş olması halinde) Merdiven iskonto
a_isk3 float H Satırın 2. İndirim (iskonto) Oran Bilgisi (0.00 Boş olması halinde) Merdiven iskonto
Header Bilgileri
X-ClientIdLogin anında alınan kullanıcı Token UID bilgisi
İstek Gövdesi (JSON)
{
  "cmd": "fatura_batch_ins",
  "UID": "KULLANICI_UID",
  "Ana": [
    {
      "a_tur": "31",
      "a_cari_id": "18068",
      "a_seri": "0",
      "a_sbelge_seri_no": "GÖNDERİLMEDİ",
      "a_tarih": "28.11.2024",
      "a_vtarih": "30.12.2024",
      "a_ack": "Fatura Genel Açıklaması",
      "a_depo_id": "1",
      "a_sube_id": "1",
      "a_dov_id": "0",
      "a_dov_kur": "1.0000",
      "a_fulke": "Türkiye",
      "a_fili": "Eskişehir",
      "a_filce": "Tepebaşı",
      "a_fpostakod": "26210",
      "a_fadres1": "Merkez Mah Yan Sok XYZ Apartmanı ",
      "a_fkapino": "1",
      "a_onay": "0",
      "a_siparis_no": "SIP-2026-000142",
      "a_siparis_tar": "10.07.2026",
      "a_sadres": "Atatürk Mah. Cumhuriyet Cad. No:9999 Kat:9999 Daire:999",
      "a_sili": "İstanbul",
      "a_silce": "Kadıköy",
      "Nots": [
        {
          "Sira": "1",
          "Aciklama": "Not 1"
        },
        {
          "Sira": "2",
          "Aciklama": "Not 2"
        }
      ]
    }
  ],
  "Detay": [
    {
      "a_stok_id": "5832",
      "a_brm": "1",
      "a_brm_mik": "1.00",
      "a_brm_fiy": "74.92",
      "a_ack": "Satır Açıklaması Ürün Adı Ola Bilir",
      "a_alt_adi": "Alternatif Stok Adı",
      "a_dov_id": "0",
      "a_dov_kur": "1.0000",
      "a_kdv": "20.00",
      "a_isk1": "0.0000",
      "a_isk2": "0.0000",
      "a_isk3": "0.0000"
    },
    {
      "a_stok_id": "5833",
      "a_brm": "1",
      "a_brm_mik": "1.00",
      "a_brm_fiy": "158.32",
      "a_ack": "Satır Açıklaması Ürün Adı Ola Bilir",
      "a_alt_adi": "Alternatif Stok Adı",
      "a_dov_id": "0",
      "a_dov_kur": "1.0000",
      "a_kdv": "1.00",
      "a_isk1": "0.0000",
      "a_isk2": "0.0000",
      "a_isk3": "0.0000"
    }
  ]
}
Kod Örnekleri
curl -X POST "https://ws.evobulut.com/api/fatura/base/" \
  -H "Content-Type: application/json" \
  -d '{
  "cmd": "fatura_batch_ins",
  "UID": "KULLANICI_UID",
  "Ana": [
    {
      "a_tur": "31",
      "a_cari_id": "18068",
      "a_seri": "0",
      "a_sbelge_seri_no": "GÖNDERİLMEDİ",
      "a_tarih": "28.11.2024",
      "a_vtarih": "30.12.2024",
      "a_ack": "Fatura Genel Açıklaması",
      "a_depo_id": "1",
      "a_sube_id": "1",
      "a_dov_id": "0",
      "a_dov_kur": "1.0000",
      "a_fulke": "Türkiye",
      "a_fili": "Eskişehir",
      "a_filce": "Tepebaşı",
      "a_fpostakod": "26210",
      "a_fadres1": "Merkez Mah Yan Sok XYZ Apartmanı ",
      "a_fkapino": "1",
      "a_onay": "0",
      "a_siparis_no": "SIP-2026-000142",
      "a_siparis_tar": "10.07.2026",
      "a_sadres": "Atatürk Mah. Cumhuriyet Cad. No:9999 Kat:9999 Daire:999",
      "a_sili": "İstanbul",
      "a_silce": "Kadıköy",
      "Nots": [
        {
          "Sira": "1",
          "Aciklama": "Not 1"
        },
        {
          "Sira": "2",
          "Aciklama": "Not 2"
        }
      ]
    }
  ],
  "Detay": [
    {
      "a_stok_id": "5832",
      "a_brm": "1",
      "a_brm_mik": "1.00",
      "a_brm_fiy": "74.92",
      "a_ack": "Satır Açıklaması Ürün Adı Ola Bilir",
      "a_alt_adi": "Alternatif Stok Adı",
      "a_dov_id": "0",
      "a_dov_kur": "1.0000",
      "a_kdv": "20.00",
      "a_isk1": "0.0000",
      "a_isk2": "0.0000",
      "a_isk3": "0.0000"
    },
    {
      "a_stok_id": "5833",
      "a_brm": "1",
      "a_brm_mik": "1.00",
      "a_brm_fiy": "158.32",
      "a_ack": "Satır Açıklaması Ürün Adı Ola Bilir",
      "a_alt_adi": "Alternatif Stok Adı",
      "a_dov_id": "0",
      "a_dov_kur": "1.0000",
      "a_kdv": "1.00",
      "a_isk1": "0.0000",
      "a_isk2": "0.0000",
      "a_isk3": "0.0000"
    }
  ]
}'
Başarılı Yanıt
200 OK
{
  "status": "OK",
  "veri": {
    "ID": "18526",
    "Ana": [
      {
        "Satir": "0",
        "a_id": "18526",
        "a_tur": "31",
        "a_adi": "Insert Fatura",
        "BELGE_TUR": "Satis Faturasi",
        "a_gc": "-1",
        "a_seri": "0",
        "BELGE_SERI_AD": "",
        "a_kod": "0",
        "a_tarih": "13.02.2023 00:00:00",
        "a_fis_tur": "0",
        "a_fis_tur_adi": "",
        "a_cari_id": "162220",
        "CARI_ADI": "okn ",
        "a_ack": "  insert islemi",
        "a_depo_id": "1",
        "DEPO_ADI": "Eskisehir Meselik Depo",
        "a_fcari": "",
        "a_fadres1": "Deneme Adresi Acik",
        "a_fadres2": "",
        "a_fvda": "",
        "a_fvno": "",
        "a_tevkifat": "0",
        "TEVKIFAT_ADI": "",
        "a_vergi_muaf": "0",
        "VER_MUAF_ADI": "-",
        "VER_MUAF_KOD": "",
        "a_sube_id": "1",
        "SUBE_ADI": "Eskisehir Subesi",
        "a_per_id": "0",
        "PERSONELADI": " ",
        "a_isk_tut": "0",
        "a_iskd": "0",
        "a_iskd_tut": "0",
        "a_kdv_tut": "0",
        "a_otv_tut": "0",
        "a_oiv_tut": "0",
        "a_tev_tut": "0",
        "TEVKIFAT_ORAN": "0",
        "a_modul": "1054",
        "a_tutar": "0",
        "a_modul_ref": "0",
        "a_dov_id": "0",
        "Doviz_Kodu": "TL",
        "Doviz_Sembolu": "TL",
        "Doviz_Adi": "Turk Lirasi",
        "a_dov_kur": "1",
        "a_dov_tut": "0",
        "a_onay": "0",
        "a_cuser": "25986",
        "CUSERNAME": "Ali ALKAN",
        "a_cdate": "14.08.2023 16:34:00",
        "a_muser": "25986",
        "a_mdate": "14.08.2023 16:34:00",
        "MUSERNAME": "Ali ALKAN",
        "a_udf": "",
        "a_udf_grp": "",
        "a_ettn": "2165fd01-abd3-43ef-a868-a629597c4de9",
        "a_edrm": "0",
        "FAT_DUR": "",
        "a_etur": "3",
        "FAT_TUR": "E-Arsiv",
        "a_gonder": "0",
        "a_vtarih": "13.03.2023 00:00:00",
        "a_tutar_kapanan": "0",
        "a_tutar_kalan": "0",
        "a_sbelge_seri_no": "GÖNDERİLMEDİ",
        "muh_id": "0",
        "muh_tur": "0",
        "a_kamp_no": "",
        "a_kamp_statu": "",
        "a_kargo_id": "0",
        "a_kargo_adi": "",
        "a_takip_no": "",
        "a_kargo_metod": "",
        "a_kargo_tar": "",
        "a_fatadres_id": "6552",
        "a_fatadres_adi": "Sevk Adresi - ( bulvar magaza - 2100 )",
        "a_fulke": "",
        "a_fili": "Eskisehir",
        "a_filce": "Odunpazari",
        "a_fpostakod": "26220",
        "a_fkapi_no": "25",
        "a_skapi_no": "0",
        "a_sahip": "25986",
        "a_sahip_adi": "Ali ALKAN",
        "a_sontar": "",
        "a_sadres": "",
        "a_sili": "",
        "a_silce": "",
        "a_spostakod": "",
        "a_sevk_id": "0",
        "a_sevk_adi": "",
        "a_mkod": "okn3223",
        "a_belge_drm": "0",
        "a_belge_drm_ubl": "0",
        "a_kabul_red": "0",
        "a_kabul_red_adi": "",
        "a_kabul_red_ack": "",
        "a_edrm_ack": "0",
        "a_zrf_uuid": "",
        "cari_kilit": "0",
        "a_kdv_yuv": "0",
        "a_mn_kapat": "0",
        "a_ihracat": "0",
        "a_siparis_no": "",
        "a_siparis_tar": "",
        "a_sgk_dosyano": "",
        "a_stopaj_oran": "0",
        "a_stopaj_matrah": "0",
        "a_stopaj_tut": "0",
        "a_satis_poli": "0",
        "a_satis_poli_carp": "0",
        "a_isk_oran": "0",
        "a_alis_poli": "0",
        "a_alis_poli_carp": "0",
        "a_gvsoran": "0",
        "a_gvstutar": "0",
        "a_meraoran": "0",
        "a_meratutar": "0",
        "a_sgkkoran": "0",
        "a_sgkktutar": "0",
        "a_btuoran": "0",
        "a_btututar": "0",
        "a_mus_sube_kodu": "",
        "a_oykb_vkn": "",
        "a_eticaret": "0",
        "ETICARETADI": "",
        "a_iskd_vergi_dahil": "0",
        "a_calisma_sekli": "0",
        "a_bakiye": "54884.6",
        "a_bakiye_adi": "B",
        "a_kff": "0",
        "a_stok_yansitmayacak": "0"
      }
    ],
    "Teklif_Toplam": [
      {
        "Ara_Toplam": "0  TL",
        "Toplam_Indirim": "0 TL",
        "Brut_Toplam": "0 TL",
        "Toplam_KDV_18": "0 TL",
        "Toplam_KDV": "0 TL",
        "Tevkifat_Tutari": "0 TL",
        "Genel_Toplam": "0 TL",
        "Turk_Lirasi_Karsiligi": "0 TL"
      }
    ],
    "Detay": [],
    "cari_kilit": "0",
    "ACK": []
  }
}
Başarısız Yanıt
200 OK — status: ERR

{"status":"ERR","veri":[{"mesaj":" Kayıt Ekleme Yetkiniz Yoktur !"}]}
{"status":"ERR","veri":[{"mesaj":" Eklemek İçin Müşteri Seçiniz !"}]}
{"status":"ERR","veri":[{"mesaj":" Seçilen Müşteri Kayıtlarda Yok! "}]}
{"status":"ERR","veri":[{"mesaj":" Seçilen Şube Kayıtlarda Yok! "}]}
{"status":"ERR","veri":[{"mesaj":" Seçilen Döviz Kayıtlarda Yok! "}]}
{"status":"ERR","veri":[{"mesaj":" Depo Seçimi Boş Olamaz! "}]}
{"status":"ERR","veri":[{"mesaj":" Seçilen Depo Kayıtlarda Yok! "}]}

{"status":"ERR","veri":[{"mesaj":" Lütfen Stok Seçiniz ! "}]}
{"status":"ERR","veri":[{"mesaj":" Seçilen Stok Kayıtlarda Yok!  "}]}
{"status":"ERR","veri":[{"mesaj":" Lütfen Miktar Giriniz !  "}]}
Fatura modülündeki diğer servisler

Fatura modülünün tamamı (32 servis) →