# 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. - **Modül:** Fatura - **Yöntem:** POST - **Endpoint:** `https://ws.evobulut.com/api/fatura/base/` - **Kimlik doğrulama:** Login servisinden alınan Token UID - **Son güncelleme:** 2026-07-14 - **Doküman:** https://dev.evobulut.com/servis/fatura/fatura-blok-ekle-253 ## 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-ClientId | Login 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" } ] } ``` ## Örnek istek (cURL) ```bash 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 ```json { "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 ```json {"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 ! "}]} ```