SOAP UI nedir? ve Ne için kullanılır?

SOAP(Simple Access Protocol ,tr: Basit Nesne Erişim Protokolü) en temel anlamda, internet üzerinden küçük miktarda bilgileri yada mesajları aktarma protokolüdür. 

SOAP mesajları XML formatındadırlar ve genellikle HTTP(Hyper Text Transfer Protocol) protokolü(bazende TCP/IP) kullanılarak gönderilirler.

Kimler Kullanır:

Bu uygulamayı şirketlerin test ekipleri kullanır. Firmalarda bilindiği üzere 3 versiyon bulunur. Birincisi Dev; Yazılımcının uygulamayı yazdığı ve derlediği ortamdır. PreProd; DEV ortamda yazılımcı tarafından ilk testi yapılan kodlar derlenir ve bu ortama geçilir. Burada test ekipleri testlerini gerçekleştirir ve akabinde PROD ortama geçmesi için ekipler burada onay vermelidir. PROD; Son kullanıcının alanıdır. Burada artık her şey gerçek datalar üzerinden yürür. Direk burada yazılımcı derleme yapmaz bug ve/veya müşteri sorunlarına ise burada debug etmez. Yazılımcı kendi ortamı olan DEV ortamında bu işlemleri yapar.

SOAP Yapısı:

SOAP yapısı Temel olarak 4 bölümden oluşmaktadır.

• Envelope, servis istek ve cevaplarının bilgilerini içerir. XML Root elemanı zorunluluktur. İçeriğinde Header, Body ve Fault alanlarını barındırır.
• Header, meta-data gibi bilgiler iletmeye yarar.
• Body, istekte ve cevapta mesaj adı ve parametreleri barındırır.
• Fault, istek sonucu bir hata var ise hata mesajını / durumu içerir.

SOAP Neden Tercih Edilmeli:

Firmalardaki Projelerin testlerinde

Veri hataları ve/veya servisin nasıl kullanılacağı ile ilgili bilgi alınmak istendiğinde

.Net, Java, SAP ABAP vb. ile iletişim kuran programların entegrasyonlarında kullanımı kolay olduğu için kullanılmalıdır.

SOAP Nasıl Çağrılır:

SOAP servisin kullandığı metotlar, requestte parametre yazılır ve response başarılı yada başarısız hata mesajlarına ulaşmamızı sağlayan bir uygulamadır.

Makalelerim

YOLCU BERABER FATURA NEDİR?

"Yolcu beraberi eşya ihracı" alıcıları: Türkiye'de ikamet etmeyen ve satın aldığı malı yurtdışına götüren yabancı uyruklu veya yurtdışında ikamet eden ve buna dair o ülke resmi makamlarından alınmış ikamet tezkeresi veya bu mahiyette bir belgeye sahip olan Türk uyruklu alıcılardır.
Kısacası : Türkiye'de ikamet etmeyenlere KDV hesaplanarak yapılan satışlardır.
Yolcu beraber faturada faturanın alıcısı Gümrük ve Ticaret Bakanlığı' demiştik. Satıcı alıcıya ayrıca kağıt dökümü verilebilir. GİB Portal veya özel entegratör aracılığı ile gönderilen faturalar GİB üzerinden Gümrük Ticaret Bakanlığı ve Aracı Kuruma elektronik olarak GİB tarafından iletilmektedir.

1.Yolcu Beraber Fatura Süreci

Yolcu beraber faturasını düzenlemek isteyen mükellefler E-Fatura sistemine kayıtlı olmalıdır.
Düzenleyecekleri yolcu beraberi eşya ihracı faturalarının alıcıları bilgilerini Gümrük ve Ticaret Bakanlığı olarak düzenlenir.
Düzenlenen faturalar onay için Gümrük çıkış memurunun önüne düşer.
Onaylanan faturalar ile ilgili uygulama yanıtı vergi iade ödemesi için ilgili yetki belgeli aracı kurumların sistemine düşer.

Yolcu beraber eşya faturalarının elektronik ortamda süreci için 5 farklı rol vardır.

1. Fatura Düzenleyen

Yolcu beraber eşyanın elektronik olarak gönderimi kapsamında fatura düzenleyen; standarda uygun olarak oluşturulan elektronik faturayı düzenleyen uygulamaya özel entegratör veya entegrasyon yolu ile dahil olmuş tüzel kişiliktir.

Fatura düzenleyen(mağaza) ile aracı kurumlar arasında çevrimiçi ve gerçek zamanlı entegrasyon bulunmalıdır. Böylece iptal/iade edilen ürünlere ait faturaların yetki verilmiş aracı kurumlar tarafından iadesinin yapılmaması sağlanacak ve haksız yere KDV iadesi yapılmasının önüne geçilebilecektir.
Faturalarını gerçek zamanlı olarak entegratöre iletir. Böylece alış veriş ve yurtdışı çıkışları aynı gün olan yolcuların sorun yaşaması engellemiş olacaktır.
Sistemlerinde bir sorun olması durumunda kullanılmak üzere yeterli miktarda kağıt fatura bulundurur. Sorun ortaya çıktığında kağıt ortamında fatura keser. Kağıt ortamında kestiği faturalar için daha sonra E-Fatura üzerinden fatura kesmemelidir.

BİLGİ: Fatura düzenleyen tarafından oluşturulan belgeler, öngörülen şemalara, şema kurallarına, diğer veri kurallarına ve standartlara uygun olmak zorundadır. Ayrıca fatura düzenleyen, kullandığı uygulama ile ilgili her adımda loglama yapmak zorundadır.

2. Gümrük ve Ticaret Bakanlığı

Kendisine onay için gelen yolcu beraberi eşya ihracı faturalarını ve satın alınan malı gümrük memurları aracılığıyla kontrol etme ve kontrol sonucuna göre onay işlemi yapan kurumdur.

• Onaylanan her fatura için ilgili yetki belgeli aracı kuruma uygulama yanıtı gidecektir.

3. Merkez

Faturaların elektronik belge olarak düzenlenmesi, elektronik olarak imzalanması veya Mali Mühür ile onaylanması, saklanması, iletilmesi ile fatura bilgilerinin veri standartları ve formatına uygun biçimde aktarılması ve muhatabı tarafından alınmasına ilişkin belirlenen usul ve esasları uygulayan ve denetleyendir.

• Merkez, uygulama ile ilgili her adımda loglama yapmak zorundadır. (GİB kılavuz)

4. Yetkili Aracı Kurum

Türkiye'de ikamet etmeyen yolculara KDV iadesi yapmak üzere yetki belgesi almış aracı firmalardır. E-Fatura kapsamında;

Gümrük ve Ticaret Bakanlığı tarafından gümrük memuru aracılığıyla gönderilen uygulama yanıtını alır.
Uygulama yanıtı içindeki bilgileri kontrol ederek göre yolcuya KDV iadesi ödemesi yapar.

5. Türkiye'de ikamet etmeyen yolcu

KDV iadesi alabilmek için aldığı mallar için fatura düzenletme ve pasaport ve isim bilgilerini fatura düzenleyene verme zorunluluğu vardır. Yetkili aracı kurumlardan gümrük onayından sonra iadesini alabilir.

İlgili tebliğe göre Yolcu beraberi eşya ihracı faturası;

Faturayı düzenleyecek olan mükellef (mağaza) E-Fatura sistemine dahil olmalıdır. Mükellefler düzenleyecekleri yolcu beraberi eşya ihracı faturalarında alıcı bilgilerine ilave olarak Gümrük ve Ticaret Bakanlığı'nın bilgilerine de yer vermeliler.

E-fatura dosyasının "AccountingCustomerParty" bölümünde Gümrük ve Ticaret Bakanlığı bilgileri, "BuyerCustomerParty" bölümünde ise alışverişi yapan turistin bilgileri yer almalıdır. Faturanın ProfileID değeri "YOLCUBERABERFATURA" olmalıdır. Düzenlenen faturalar onay için gümrük çıkış memurunun ekranına düşecektir.

Onaylanan faturalar ile uygulama yanıtı vergi iadesi ödemesi için ilgili yetki belgeli aracı kurumların sistemine düşecektir. Faturayı düzenleyen mükellef(mağaza) ile aracı kurumlar arasında, iptal/iade gibi durumlarda haksız vergi iadesi yapılmasının önüne geçilmesini sağlamak için gerçek zamanlı bir bağlantı olmalıdır.

Sistemsel sorunlar olabilir. Bu tür durumlarda ise ilgili mükellef, satış noktalarında yeteri kadar kağıt fatura bulundurmalıdır, gerektiğinde ise kağıt fatura düzenlemeli ve kağıt fatura düzenlediği satışlara ait tekrar bir E-Fatura düzenlememelidir.

Yeni Nesil Ödeme Sistemleri YNÖKC

Bayiden alınan cihazın kullanıma açılması işlemini yetkili ÖKC firmalarının servisleri gerçekleştirir. Cihazı bayiden satın alan mükellefler, cihaz, ruhsatname ve fatura ile birlikte yetkili servise başvurur. Yetkili servis elemanları, GİB sistemi ile iletişime geçerek cihazın kaydını yapar ve kullanıma açar. Satın alınan cihazların kullanıma açılması, mecburiyetin başlama tarihinden önce olmalıdır.

Bilgi: YN ÖKC'ler kimlik ibraz edilmek suretiyle, yetkili ÖKC firmalarının bakım-onarım/satış bayilerinden alınır. Bayiler, Gelir İdaresi Başkanlığı'nın www.gib.gov.tr internet adresinden alıcının ÖKC satın alıp alamayacağı hakkında sorgulamasını yaptıktan sonra, sorgulama çıktısını müşteriye imzalatarak satış işlemini gerçekleştirir. Vergi mükellefiyeti bulunmayanların YN ÖKC satın alması mümkün değildir. Mükellefler; YN ÖKC satın alma işlemleri sırasında satış bayilerinden cihazın kullanım şartları ve cihazın kullanımı nedeniyle katlanmak durumunda olacakları maliyetler hakkında kendilerinin bilgilendirilmesini talep etmelidirler.

Genel Bilgi: EFT-POS özellikli YN ÖKC'ler; bünyesinde banka POS'u da barındıran bütünleşik yazarkasalardır. Basit/bilgisayar bağlantılı YN ÖKC'ler ise; bünyesinde banka POS'u bulunmamakta olup mükelleflerin istemesi halinde haricen banka POS'u kablolu olarak bağlanabilmektedir. Bütün YN ÖKC'lerin ortak noktaları ise bilgisayar tabanlı olması ve internet yoluyla GİB Bilgi Sistemleri ile iletişim kurabilme özelliklerinin bulunmasıdır.

YN ÖKC'de Düzenlenecek Belgeler

Mükellefler YN ÖKC kullanmak suretiyle gerçekleştirdikleri:

Nakit satışlarda, YN ÖKC satış fişi,

Banka / kredi kartları ile yapılan satışlarda, banka slibini de ihtiva eden bütünleşik YN ÖKC satış fişi,

Fatura ile belgelendirilen satışlarda, yemek fişi/yemek kartı karşılığı verilen mal satışı ve hizmet ifalarında, mal teslimi veya hizmet ifasından önce ön tahsilat (avans) mahiyetinde alınan tutarların belgelendirilmesinde, otopark giriş işlemlerinde, Fatura tahsilatı işlemlerinde, YN ÖKC "Bilgi Fişleri Teknik Kılavuzunda belirtildiği şekilde YN ÖKC bilgi fişi, düzenleyerek müşterilerine vereceklerdir.

Yeni nesil ödeme kaydedici cihaz nedir?

Yeni Nesil Ödeme Kaydedici Cihazlar, 01.01.2016 öncesinde kullanılan yazarkasalar üzerine POS uygulamasının da yüklenebildiği, işlem sırasında slip ile fiş tedariğini aynı anda sağlayabilen ve gün sonu raporları üreterek satışa yönelik bilgileri anlık olarak GİB veritabanına iletebilme özelliği olan ödeme kaydedici cihazlardır.

Kaç tür yeni nesil ÖKC var?

Bünyesinde banka POS'u barındıran "EFT-POS Özellikli Yeni Nesil Ödeme Kaydedici Cihazlar

Bünyesinde banka POS'u barındırmayıp haricen POS cihazı bağlanabilen "Basit / Bilgisayar Bağlantılı Yeni Nesil Ödeme Kaydedici Cihaz'lar" olmak üzere iki tür Yeni Nesil Ödeme Kaydedici Cihaz bulunmaktadır.

Yeni nesil ÖKC modelleri arasındaki temel farklar neler?

EFT-POS özellikli Yeni Nesil Ödeme Kaydedici Cihaz'ler; bünyesinde banka POS'u da barındıran bütünleşik yazar kasalardır.

Basit/bilgisayar bağlantılı Yeni Nesil Ödeme Kaydedici Cihaz'ler ise; bünyesinde banka POS'u bulunmamakta olup mükelleflerin istemesi halinde haricen banka POS'u kablolu olarak bağlanabilmektedir.

Bütün Yeni Nesil Ödeme Kaydedici Cihaz'lerin ortak noktaları ise bilgisayar tabanlı olması ve internet yoluyla GİB Bilgi Sistemleri ile iletișim kurabilme özelliklerinin bulunmasıdır.

Kartlı Satışı Olmayan Mükellefler EFT-POS Özellikli Yeni Nesil Ödeme Kaydedici Cihaz Kullanabilir mi?

Banka / kredi / yemek kartı vb. kartlarla satıs yapmayan mükellefler; bünyesinde POS cihazı barındırmayan Basit / Bilgisayar Bağlantılı ÖKC cihazı kullanabilecekleri gibi, EFT-POS özelligi olan
cihazlardan temin edip, ÖKC firması aracılıgı ile Pos özelligi kısmını kullanıma açtırmadan sadece yazarkasa özelligini kullanabilirler.

Mükelleflerin banka / kredi kartı ile tahsilat yapabilmesi için eskiden oldugu gibi Yeni Nesil Ödeme Kaydedici Cihaz uygulamasında da Bankalar ile Üye Işyeri Anlaşması yapması gerekmektedir.

Yeni nesil ÖKC nereden ve nasıl alınır?

YN ÖKC'ler kimlik ibraz edilmek suretiyle, yetkili ÖKC firmalarının bakım-onarım/satış bayilerinden alınır. Bayiler, Gelir İdaresi Başkanlığı'nın www.gib.gov.tr internet adresinden alıcının ÖKC satın alıp alamayacağı hakkında sorgulamasını yaptıktan sonra, sorgulama çıktısını müşteriye imzalatarak satış işlemini gerçekleştirir. Vergi mükellefiyeti bulunmayanların YN ÖKC satın alması mümkün değildir. Mükellefler; YN ÖKC satın alma işlemleri sırasında satış bayilerinden cihazın kullanım şartları ve cihazın kullanımı nedeniyle katlanmak durumunda olacakları maliyetler hakkında kendilerinin bilgilendirilmesini talep etmelidirler.

Yeni nesil ÖKC kullanım esasları neler?

YN ÖKC'lerde satış işleminin cihazda başlatılıp cihazda sonlandırılması, günlük kapanış raporları (Z Raporu) bilgilerinin otomatik olarak Gelir İdaresi Başkanlığı Bilgi Sistemi (GİB BS)'ne iletilmiş olması esastır. ÖKC kullanan mükelleflerimiz mevcut eski nesil ödeme kaydedici cihazları ile yeni nesil ödeme kaydedici cihazlarından düzenlenen ÖKC günlük kapanış (Z) raporlarına ait mali bilgileri; 1/7/2018 tarihinden itibaren,

a) ÖKC TSM Merkezleri üzerinden,

b) Başkanlıktan e-Arşiv hizmetleri konusunda izin alan özel entegratörlerin bilgi işlem sistemleri aracılığıyla e-Arşiv uygulaması üzerinden "Perakende Mal Satışları ile Hizmet İfalarına İlişkin Mali Rapor Bildirim Kılavuzu"ndaki esaslara göre,

c) Başkanlık tarafından internet vergi dairesi üzerinden oluşturulan elektronik bildirim portalleri üzerinden, olmak üzere üç yöntemden birini seçerek GİB'e elektronik ortamda bildirilmesi gerekmektedir. Yöntem tercihi ve bildirime ilişkin usul ve esaslar www.efatura.gov.tr internet adresinde Başkanlık tarafından ayrıca duyurulacaktır." Perakende mal ve hizmet satışlarında kullanılan ve ÖKC fişi dışında belgeleri üreten harici yazılım ve donanımların en geç 1/4/2018 tarihine kadar ÖKC'ler ile bağlantılı ve birlikte çalışmasının sağlanması esastır. Bu nedenle; lokanta, restoran, market vb. işyerlerinde perakende mal ve hizmet satışında kullanılan yazarkasa dışındaki bilgisayar sistemlerinin 1/4/2018 tarihine kadar yazarkasalarla bağlantı işlemlerinin yaptırılması gerekmektedir. Bir başka ifade ile yazarkasa dışındaki bilgisayar sistemleri kullanılarak gerçekleştirilen perakende mal ve hizmet satışlarda 1/4/2018 tarihinden sonra yazarkasadan ÖKC fişinin ( fatura verilmesi halinde fatura bilgi fişinin) düzenlenmesinin sağlanması mecburi olup, belirtilen esaslara uymayan işletmelere yapılan her bir tespit için 213 sayılı Vergi Usul Kanunun mükerrer 355 inci maddesi uyarınca özel usulsüzlük cezası tatbik edilecektir.

Alınan cihaz nasıl kullanıma açılır?

Bayiden alınan cihazın kullanıma açılması işlemini yetkili ÖKC firmalarının servisleri gerçekleştirir. Cihazı bayiden satın alan mükellefler, cihaz, ruhsatname ve fatura ile birlikte yetkili servise başvurur. Yetkili servis elemanları, GİB sistemi ile iletişime geçerek cihazın kaydını yapar ve kullanıma açar. Satın alınan cihazların kullanıma açılması, mecburiyetin başlama tarihinden önce olmalıdır

Kimler yeni nesil ÖKC kullanmak zorunda?

3100 Sayılı Kanun'a göre eski nesil ÖKC kullanan veya kullanması gereken mükellefler aynı zamanda YN ÖKC kullanma mecburiyeti kapsamındadır. 3100 sayılı Kanun mevzuatına göre; birinci ve ikinci sınıf tüccarların fatura verilme zorunluluğu bulunmayan perakende mal ve hizmet satışlarında ödeme kaydedici cihaz kullanma mecburiyeti bulunmaktadır. Maliye Bakanlığınca Genel Tebliğler ile faaliyetlerinde ÖKC kullanım zorunluluğu bulunmadığı bildirilen mükelleflerin, YN ÖKC kullanma mecburiyeti bulunmamaktadır.

Kimlerin yeni nesil ÖKC kullanma zorunluluğu bulunmuyor?

3100 Sayılı Kanun'a göre eski nesil ÖKC kullanan veya kullanması gereken mükellefler aynı zamanda YN ÖKC kullanma mecburiyeti kapsamındadır. 3100 sayılı Kanun mevzuatına göre; birinci ve ikinci sınıf tüccarların fatura verilme zorunluluğu bulunmayan perakende mal ve hizmet satışlarında ödeme kaydedici cihaz kullanma mecburiyeti bulunmaktadır. Maliye Bakanlığınca Genel Tebliğler ile faaliyetlerinde ÖKC kullanım zorunluluğu bulunmadığı bildirilen mükelleflerin, YN ÖKC kullanma mecburiyeti de bulunmamaktadır.

Yeni nesil ÖKC kullanma mecburiyeti ne zaman başlayacak?

Yol kenarı otopark işletmeleri ile faaliyetlerinde seyyar banka POS'u kullananların EFT-POS özellikli ÖKC kullanma mecburiyetleri 01/10/2013 tarihinde başlamış bulunmakta. Bunlar dışında kalan ve 2014 ve öncesinde faaliyette bulunan mükelleflerin; 2014 yılı cirolarının durumuna göre yukarıda belirtilen tarihler itibariyle YN ÖKC kullanma mecburiyetleri başlayacak…

Yeni nesil ÖKC alımı için vergi dairesine gitmek gerekir mi?

YN ÖKC alımı, vergi dairesine kaydı, devri, hurdaya ayrılması vb. işlemler için vergi dairesine gitme zorunluluğu 25.12.2015 tarihinden itibaren 465 Sıra No.lu Vergi Usul Kanunu Genel Tebliği ile kaldırılmıştır. YN ÖKC satın almak isteyen mükellefler satış bayilerinden cihazlarını satın aldıktan sonra yetkili ÖKC servisleri aracılığı ile cihazlarını kullanıma hazır hale getirebileceklerdir.

Web Servis Nedir?

Web servis, elektronik cihaz tarafından başka bir elektronik cihaza sunulan, World Wide Web üzerinden birbirleriyle iletişim kuran yapıların bütününe verilen isimdir. Web Servis web üzerinden HTTP protokolü ile hizmet veren program parçalarıdır. Bir kullanıcının HTTP üzerinden bir web servisi kullanmasına RPC(Remote Procedure Call) denmektedir.

Web servisler, HTTP protokolünü kullanarak hizmet sağlayan yapıların bütününe verilen isimdir.

Genel olarak web servisler SOAP (Simple Object Access Protocol/Basit Nesne Erişim Protokolü) XML yapısını kullanarak çalışmaktadır. Bu yapının bizlere sağlamış olduğu avantaj platformdan bağımsız olarak istenilen yerden erişilmesini sağlamaktır.

Örneğin; .Net ile yazılan bir web servisi Javascript, JSON, PHP ile ve birçok yazılım diliyle kullanabilmekteyiz. Bunun sebebi ise web servisten istediğimiz sonucun(response) bizlere XML olarak sonuçları getirmesidir.

Teknik olarak özetlemek gerekir ise;

Kullanıcı bilgisayarındaki bir uygulama ve/veya başka bir yerde webservis ile çalışan bir uygulama (istemci) veri alışverişinde bulunmak istediği Web Servisin bulunduğu sunucuya XML formatındaki bir SOAP Mesajı (SOAP Request) gönderir.

XML formatındaki SOAP Mesajını alan Web Server gelen mesajı(Request) istenilen Web Servise bu parametreleri geçerek ilgili Web Servis metodunu tetikler.

Web Metot gelen parametrelere göre ilgili işlemleri yapıp oluşan sonucu(response) Web Server 'a iletir.

Web Metot'dan yanıt bekleyen Uygulama sunucumuz gelen veriyi XML formatında hazırlayıp bir SOAP Mesajı(SOAP Response) ile İstemci uygulamaya iletir.

İstemci'mizde gelen XML türündeki veriyi talepte bulunan uygulamaya göndererek aradaki bağlantıyı sonlandırır.

Web servislerin uygulamada yoğunluk getirmeyecek şekilde olması gerekir. Requestteki istenilen parametrelerin fazla data geri getirmesi yoğunluk yaratacağı gibi TimeOut hatalarına da sebep olacaktır.

Çünkü aslında Siz bir istemci olarak uygulama sunucusundaki bir web servisi tetiklediğiniz zaman istemci olarak bir soket açıp sunucudaki bir port'a veri yazarsınız ve bunun için özel bir ayarlama yapılmadığı takdirde bu işlemin tamamlanması için öngörülen default süre 1 dakikadır.

İstemci makine eğer 1 dk içerisinde bu soket üzerinde herhangi bir veri alışverişi olmazsa güvenlik önlemi olarak veri alışverişini sonlandırır. Çalışan uygulama zaman aşımı hatasına düşer. (TimeOut)

Eğer yaptığınız işlem "Zaman Aşımı" hatasına uğrarsa varsa eğer işlemin durumunu sorgulayıp iptal etmeli veya 1 dk olarak öngörülen Default Süreyi daha yukarı bir değere çekmelisiniz.

Okuyan herkese faydalı olması dileğimle…