# İrsaliye Ekleme > İrsaliye Ekleme, Evobulut ön muhasebe / ERP yazılımının İrsaliye modülüne ait bir REST API servisidir. POST yöntemiyle `https://ws.evobulut.com/api/irsaliye/base/` adresine JSON gönderilerek çağrılır. - **Modül:** İrsaliye - **Yöntem:** POST - **Endpoint:** `https://ws.evobulut.com/api/irsaliye/base/` - **Kimlik doğrulama:** Login servisinden alınan Token UID - **Son güncelleme:** 2024-12-03 - **Doküman:** https://dev.evobulut.com/servis/irsaliye/irsaliye-ekleme-106 ## Açıklama | Bir İrsaliye Belgesini Master ve Detay Olarak Tek Seferde Eklemek için oluşturulan Servistir. | | | | | --- | --- | --- | --- | | Response Body JSON Açıklamaları | | | | | Ana : İrsaliye Üst Başlık Bilgileri , Detay : İrsaliye Satır (Ürün , Hizmet) Bilgilerini , Seri_Lot_ List Detay Satırın detayı olan seri lot bilgilerini İçerir. | | | | | Alan | Veri Tipi | Zorunlu | Açıklama | | cmd | string | E | INS | | UID | string | E | KULLANICI_UID Login Anında Alınan UID Token Verisi | | Ana : [ | | E | İrsaliye Master Bilgileri JSON Tag ismi Array [1] 0. index kullanılır | | a_tur | int | E | İşlem Turu ID "71" Satış İrsaliyesi "70" Alış İrsaliyesi  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 dolu yok ise 0 | | a_sbelge_seri_no | string | E | Alış İrsaliyesin de Belge No, Elektronik Satış İrsaliyesinde “GÖNDERİLMEDİ” | | a_tarih | string | E | İrsaliye Tarihi gg.aa.yyyy formatında | | a_vtarih | string | E | İrsaliye Vade Tarihi gg.aa.yyyy formatında | | a_fsevk_tar | string | H | İrsaliye Sevkiyat Tarihi gg.aa.yyyy formatında | | a_ack | string | H | İrsaliye Başlık Açıklaması | | a_depo_id | int | E | İrsaliye Satırlarındaki stoklar için Giriş/Çıkış yapılacak depo ID Bakınız veri[0].ID | | a_sube_id | int | E | İrsaliye 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_kargo_id | int | H | Kargo Şirket ID Nosu Bakınız | | a_sadres | string | H | İrsaliye Açık Adresi Bilgisi E-İrsaliye için Zorunlu örnek : “Merkez Mah Yan Sok XYZ Apartmanı” | | a_sili | string | H | İrsaliye Adresi Şehir Bilgisi E-İrsaliye için Zorunlu örnek : “Eskişehir” | | a_silce | string | H | İrsaliye Adresi İlçe Bilgisi örnek : “Tepebaşı” | | a_spostakod | string | H | İrsaliye Adresi Posta Kodu Bilgisi örnek : “26290” | | a_plaka | string | E/H | Satış İrsaliyesi Elektronik olacak ise Zorunlu Nakliye Aracı Plaka Bilgisi | | a_sofor_adi | string | E/H | Satış İrsaliyesi Elektronik olacak ise Zorunlu Şoför Adı | | a_sofor_soy_adi | string | E/H | Satış İrsaliyesi Elektronik olacak ise Zorunlu Şoför Soyadı | | a_sofor_tc | string | E/H | Satış İrsaliyesi Elektronik olacak ise Zorunlu Şoför T.C. Kimlik Nosu | | a_dorse_plaka | string | E/H | Satış İrsaliyesi Elektronik olacak ise Zorunlu Araç Dorse Plaka Numarası | | a_siparis_no | string | H | İrsaliyeye bağlı bir sipariş var ise siparişin tarihi | | a_siparis_tar | string | H | İrsaliyeye bağlı bir sipariş var ise siparişin numarası | | a_onay | int | E | 0 – İrsaliyeyi Onaysız Olarak Ekler 1-İrsaliyeyi Onaylı Olarak Ekler | | Detay : [ | | E | İrsaliye 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_ack | string | H | Satır Açıklaması | | 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_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 | | Seri_Lot_List : [ | | H | İrsaliye Detay Satırına bağlı Seri Lot Bilgileri JSON Tag ismi Array [1..n] | | a_seri_no | string | E | Seri Nosu | | a_lot_no | string | E | Lot Nosu | | a_giren | float | E | Girişlerde Pozitif Değer Çıkışlarda 0 | | a_cikan | float | E | Çıkışlarda Pozitif Değer Girişlerde 0 | | a_ack | string | H | Satir Açıklaması | | a_son_kultar | string | H | Son Kullanma Tarihi | ## Header bilgileri | X-ClientId | Login anında alınan kullanıcı Token UID bilgisi | | --- | --- | ## İstek gövdesi ```json { "cmd": "INS", "UID": "KULLANICI_UID", "Ana": [ { "a_tur": "71", "a_cari_id": "18068", "a_seri": "0", "a_sbelge_seri_no": "GÖNDERİLMEDİ", "a_tarih": "03.12.2024", "a_vtarih": "03.12.2024", "a_fsevk_tar": "03.12.2024 12:45", "a_ack": "Web Servis İrsaliye Testi", "a_depo_id": "1", "a_sube_id": "1", "a_dov_id": "0", "a_dov_kur": "1", "a_kargo_id": "0", "a_sadres": "XYZ Mah. ABC Sokak TT Apartmanu Kat:4 Daire:8 ", "a_sili": "Eskisehir", "a_silce": "Merkez", "a_spostakod": "26290", "a_plaka": "26MS100", "a_sofor_adi": "Hasan", "a_sofor_soy_adi": "Tasan", "a_sofor_tc": "11111111111", "a_dorse_plaka": "26MS100", "a_siparis_no": "", "a_siparis_tar": "", "a_onay": "0" } ], "Detay": [ { "a_stok_id": "5832", "a_ack": "XX_KALEM S001", "a_brm": "4", "a_brm_mik": "1", "a_brm_fiy": "100.00", "a_kdv": "20", "a_isk1": "0", "a_isk2": "0", "a_isk3": "0", "Seri_Lot_List": [] }, { "a_stok_id": "140123", "a_ack": "SERILOT TAKIBI 001 (Sadece Lot ve Tarih Var)", "a_brm": "4", "a_brm_mik": "10.00", "a_brm_fiy": "1500.45", "a_kdv": "10", "a_isk1": "0", "a_isk2": "0", "a_isk3": "0", "Seri_Lot_List": [ { "a_seri_no": "", "a_lot_no": "SL001-01", "a_giren": "1", "a_cikan": "0", "a_ack": "A", "a_son_kultar": "01.01.2027" } ] } ] } ``` ## Örnek istek (cURL) ```bash curl -X POST "https://ws.evobulut.com/api/irsaliye/base/" \ -H "Content-Type: application/json" \ -d '{ "cmd": "INS", "UID": "KULLANICI_UID", "Ana": [ { "a_tur": "71", "a_cari_id": "18068", "a_seri": "0", "a_sbelge_seri_no": "GÖNDERİLMEDİ", "a_tarih": "03.12.2024", "a_vtarih": "03.12.2024", "a_fsevk_tar": "03.12.2024 12:45", "a_ack": "Web Servis İrsaliye Testi", "a_depo_id": "1", "a_sube_id": "1", "a_dov_id": "0", "a_dov_kur": "1", "a_kargo_id": "0", "a_sadres": "XYZ Mah. ABC Sokak TT Apartmanu Kat:4 Daire:8 ", "a_sili": "Eskisehir", "a_silce": "Merkez", "a_spostakod": "26290", "a_plaka": "26MS100", "a_sofor_adi": "Hasan", "a_sofor_soy_adi": "Tasan", "a_sofor_tc": "11111111111", "a_dorse_plaka": "26MS100", "a_siparis_no": "", "a_siparis_tar": "", "a_onay": "0" } ], "Detay": [ { "a_stok_id": "5832", "a_ack": "XX_KALEM S001", "a_brm": "4", "a_brm_mik": "1", "a_brm_fiy": "100.00", "a_kdv": "20", "a_isk1": "0", "a_isk2": "0", "a_isk3": "0", "Seri_Lot_List": [] }, { "a_stok_id": "140123", "a_ack": "SERILOT TAKIBI 001 (Sadece Lot ve Tarih Var)", "a_brm": "4", "a_brm_mik": "10.00", "a_brm_fiy": "1500.45", "a_kdv": "10", "a_isk1": "0", "a_isk2": "0", "a_isk3": "0", "Seri_Lot_List": [ { "a_seri_no": "", "a_lot_no": "SL001-01", "a_giren": "1", "a_cikan": "0", "a_ack": "A", "a_son_kultar": "01.01.2027" } ] } ] }' ``` ## Başarılı yanıt ```json { "status": "OK", "veri": [ { "ID": "21188", "mesaj": "Kayit Basariyla Eklendi" } ] } ``` ## Başarısız yanıt ```json { "status": "ERR", "veri": [ { "mesaj": "Stok kaydı bulunamadı 5832000,140123000 . Stok_Id Değerini Kontrol ediniz. Boş olamaz. " } ] } { "status": "ERR", "veri": [ { "mesaj": "Lütfen Cari Giriniz." } ] } { "status": "ERR", "veri": [ { "mesaj": "Lütfen Depo Seçiniz." } ] } { "status": "ERR", "veri": [ { "mesaj": "Stok kaydı bulunamadı a_stok_id Eksik . Stok_Id Değerini Kontrol ediniz. Boş olamaz. " } ] } ```