bulut API Dokümantasyonu
Postman
Ana Sayfa › İrsaliye › İrsaliye Ekleme

İ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; kimlik doğrulama için Login servisinden alınan Token UID değeri gereklidir.

POSThttps://ws.evobulut.com/api/irsaliye/base/
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-ClientIdLogin 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"
        }
      ]
    }
  ]
}
Kod Örnekleri
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
200 OK
{
  "status": "OK",
  "veri": [
    {
      "ID": "21188",
      "mesaj": "Kayit Basariyla Eklendi"
    }
  ]
}
Başarısız Yanıt
200 OK — status: ERR
{
    "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. "  } ]
}