PTS ÇALIŞMA PRENSİPLERİ

Benzer belgeler
T.C. SAĞLIK BAKANLIĞI ĐLAÇ VE ECZACILIK GENEL MÜDÜRLÜĞÜ

PTS XML STANDARDI KILAVUZU

PAKET TRANSFER SİSTEMİ

İTS REFERANS WEB SERVİSLERİ KULLANICI KILAVUZU

PAKET TRANSFER SİSTEMİ

PAKET TRANSFER SİSTEMİ

İTS WEB SERVİSLERİ KLAVUZU 1.2

T.C. SAĞLIK BAKANLIĞI İLAÇ VE ECZACILIK GENEL MÜDÜRLÜĞÜ. İlaç Takip Sistemi Web Servisleri Kılavuzu Sürüm 0.7

İLAÇ TAKİP SİSTEMİ WEB SERVİSLERİ KILAVUZU SÜRÜM 1.0

Güniçi Piyasası Web Servis Metotları

PAKET TRANSFER SİSTEMİ

PAKET TRANSFER SİSTEMİ

PAKET TRANSFER SİSTEMİ

İçindekiler 1 AMAÇ, KAPSAM VE WEB SERVİSLERİNİN GENEL İŞLEYİŞİ Amaç Kapsam Web Servislerinin Genel İşleyişi

PAKET TRANSFER SİSTEMİ

T.C. SAĞLIK BAKANLIĞI ĐLAÇ VE ECZACILIK GENEL MÜDÜRLÜĞÜ

e-nabız Sağlık Bilgi Yönetim Sistemi (SBYS) Entegrasyonu Yazılım Geliştirici Kılavuzu

TÜRKİYE ELEKTRONİK FON ALIM SATIM PLATFORMU WEB SERVİS İŞLEMLERİ

PAKET TRANSFER SİSTEMİ

Tel : 0(532) Web : E-Posta : info@kayikcioglugrup.com. İLETİ PAKETİ API (Entegrason) Dökümanı

UYUMSOFT İ-DÖNÜŞÜM PORTALI FATURA HATA KILAVUZU

İşbu web sitesindeki malzemeler ve dokümanlar hiçbir surette değiştirilemez, kopyalanamaz, çoğaltılamaz ve yeniden yayınlanamaz.

3G Sms&MMS GateWay Xml Interface

İTS İŞLETME KLAVUZU. Temmuz 2012

Medula Eczane Stok Bilgileri Web Servisleri Kullanım Kılavuzu

SMSEXPLORER XML API. XML API KILAVUZU v.1.0

FIRAT ÜNİVERSİTESİ BİLGİSAYAR MÜH.

Eczane İlaç Satış Onay Bildirimi Web Servislerinin Kullanım Kılavuzu

GELİR İDARESİ BAŞKANLIĞI Uygulama ve Veri Yönetimi Daire Başkanlığı E-Fatura Uygulaması (Yazılım Standartları ve Nesne Yapısı) Ocak 2010 Versiyon :

AJANS İLETİŞİM API XML API v İçindekiler. 1. AMAÇ - Sayfa 2

AÇIKLAMALARI SEBEP ÇÖZÜM

T.C.SOSYAL GÜVENLİK KURUMU. Genel Sağlık Sigortası Medula Optik E-rapor Web Servisleri Kullanım Kılavuzu

VIDEOCELL API. Versiyon 1.0.0

Firmaların/Depoların GLN(Global Location Number-Küresel YerNumarası)numaraları tanımlanmalıdır.

SMSOKUL KULLANIM KILAVUZU V. 1.0

COM API v.1.1 BELGE SÜRÜMÜ : 1.1

e-logo e-fatura Özel Entegratör Sistemi

EK1 PortalPLUS GİB arayüzü ile kullanım kılavuzu

1. Temel Tanımlar. 1.1 Şematron Kontrolü Nedir? 1.2 Zarf Nedir? 1.3 Uygulama Yanıtı Nedir? 1.4 Sistem Yanıtı Nedir? 1.5 Durum Kodu Nedir?

Açıklama Bölüm Kılavuzun ilk yayım tarihi

*1000 *1100 ZARF İŞLENİYOR. İlgili hata sonucunda yapılması gereken GIB DURUM KODLARI AÇIKLAMALARI SEBEP ÇÖZÜM

SİTE KULLANIM KOŞULLARI. No:2/1 Şişli-İstanbul adresindeki Rma Aydın Danışmanlık Tanıtım Reklam Tic. Ltd.

YENİ NESİL ÖDEME KAYDEDİCİ CİHAZLARA AİT ELEKTRONİK KAYIT, AKTİVASYON VE YETKİLİ SERVİS LİSTELERİ TEKNİK KILAVUZU

3G SMS & MMS GateWay Xml Interface

SOAP API. Mobildev Toplu Mesajlaşma API

%20dolor%20sit%20amet&receipents= , &sender=PROAKTIF

T.C.SOSYAL GÜVENLİK KURUMU. Genel Sağlık Sigortası Medula Optik E-rapor Web Servisleri Kullanım Kılavuzu

T.C. İçişleri Bakanlığı Nüfus ve Vatandaşlık İşleri Genel Müdürlüğü

TC KİMLİK NO SMS GÖNDERİM XML API

um%20dolor%20sit%20amet&receipents= , &sender=ILETICELL İstekte gönderilen parametrelerin açıklamaları aşağıdaki gibidir:

TÜİK e-vt. Web Servis Kılavuzu

Doküman JETSMS XML Mesaj Đşlemleri Yardım Dokümanı Tarih Sürüm 1.1.0

e-fatura Uygulaması (Zarf Yapısı) Versiyon : 1.4 2/10

TC KİMLİK NO SMS GÖNDERİM SOAP API

XML API. İçindekiler. Toplu SMS Sistemlerinde Güvenilir Çözüm Ortağınız 1. AMAÇ KULLANIM ŞEKLİ Genel Hata Kodları.

e-fatura UYGULAMASI (Entegrasyon Kılavuzu) Şubat 2010 ANKARA e-fatura Uygulaması (Entegrasyon Kılavuzu) Şubat 2010 Versiyon : 1.

XML API v2.0 Belge sürümü : 2.0.2

E POSTA GÜVENLİĞİ E POSTA GÜVENLİĞİ HAZIRLAYAN: TEAM VOLTRAN BARTIN ÜNİVERSİTESİ İKTİSADİ İDARİ BİLİMLER FAKÜLTESİ YÖNETİM BİLİŞİM SİSTEMLERİ

UBL UBL Türkiye Özelleştirmesi TEMEL BİLGİLER

SGK Otomasyon Tanıtım ve Kullanım Kılavuzu

Bursa Ticaret ve Sanayi Odası E-Dönüşüm ve Katma Değerli Hizmetler İş Ortaklığı Önerisi

B i l g i l e n d i r m e

Toplu İleti Gönderimi

ÇÖZÜM MARKET. LOGO e-fatura ile Kağıtsız Şirketlere Doğru...

T.C.SOSYAL GÜVENLİK KURUMU. Genel Sağlık Sigortası Medula Optik E-reçete Web Servisleri Kullanım Kılavuzu

Banka ve Şube Bilgisi Bilgi Okuma Web Servisi Kullanım Kılavuzu

Konu: İletişim Araçları. Aydın MUTLU İstanbul

NovaFortis Yazılım Danışmanlık. E-dönüşüm adaptörü

Bilim, Sanayi ve Teknoloji Bakanlığı

Bilin tarafından verilen Kullanıcı Adı ve Şifresini bu alanlara giriniz. Bilin Yazılım ve Bilişim Danışmanlığı Ltd. Şti.

e-fatura UYGULAMASI (Zarf Şema Yapısı) Mart 2011 ANKARA e-fatura Uygulaması (Zarf Yapısı) Mart 2011 Versiyon : 1.2 1/10

SİRKÜLER İstanbul, Sayı: 2015/ 051 Ref: 4/051. Konu: ELEKTRONİK DEFTER UYGULAMASININ WEBSERVİS KILAVUZUNDA GÜNCELLEME YAPILMIŞTIR

Medula Eczane E-Reçete Web Servislerinin Kullanım Kılavuzu (Test amaçlıdır, ödemeye esas teşkil etmeyecektir)

WEB SİTESİ KULLANICI SÖZLEŞMESİ

KULLANICI KILAVUZU. inter - KEP Hesap aktivasyonu ve webmail Kullanımı. Ağustos 2016

bizmed Versiyonu ile Stok İşlemlerinde Yapılan Değişiklikler

1- E-defter beratlarında Gelirler İdaresi Başkanlığı (GİB) tarafından yapılan Berat değişikliği sebebiyle programlarımızda güncellemeler yapılmıştır.

TÜİK e-vt Teknik Kılavuz

ICE BİLİŞİM TEKNOLOJİLERİ WEB SERVİS KILAVUZU. SERVİS LİNK: DÜZENLEME TABLOSU

T.C.SOSYAL GÜVENLİK KURUMU. Genel Sağlık Sigortası Medula Optik E-rapor Web Servisleri Kullanım Kılavuzu

TUİK Netsis Erp Paketi Entegrasyonu ve Yıllık İş İstatistikleri Sanayi ve Hizmet Araştırması (YSHİ) Anketi

Bilgisayarların birbirine bağlanması ve bir ağ oluşturmasının temel amacı veri alışverişi yapabilmekti. Yani bir nevi haberleşmeyi sağlamaktı.

DEVLET PLANLAMA TEŞKİLATI BİLGİ TOPLUMU DAİRESİ BAŞKANLIĞI. e-yazışma Projesi. Paket Yapısı

e-lift e-devlet Çözümleri

BİH 605 Bilgi Teknolojisi Bahar Dönemi 2015

İLETİŞİM ARAÇLARI. E-posta Forum Sohbet Sesli Görüntülü Konferans

Global Haberleşme API Kullanıcı Notları

OSI REFERANS MODELI-II

BELEDİYE ŞİRKETLERİNİN KAMU HARCAMA VE MUHASEBE BİLİŞİM SİSTEMİ (KBS) MALİ İSTATİSTİK VERİ GİRİŞLERİNE İLİŞKİN UYGULAMA KILAVUZU

COM API v2.0 Belge sürümü : 2.0.3

Zirve e-fatura Portal Paketi V. 1.0.xx

Çevrimiçi paylaşım 3.1. Baskı 1

11-Fotoğrafların kuruma ulaşımı ve yarışma sonrası hazırlanacak kataloğun katılımcılara gönderilmesi sırasında oluşabilecek hasar veya kayıplardan

Express İthalat sistemi. Gönderen için kullanım kılavuzu

JETSMS XML Mesaj İşlemleri Yardım Dokümanı Tarih Sürüm XML ile Mesaj İşlemleri

JAVA API v2.0 Belge sürümü: 2.0.2

KASPERSKY LAB. Kaspersky Small Office Security GUIDE BA BAŞLARKEN

Online Protokol Üretim Projesi

BSOFTefat E-FATURA ÇÖZÜMÜ

Transkript:

PTS ÇALIŞMA PRENSİPLERİ Eylül 2012 Türkiye İlaç ve Tıbbi Cihaz Kurumu, İlaç Takip Sistemi Şube Müdürlüğü Söğütözü Mahallesi 2176 Sok. No:5 P.K.06520 Çankaya, Ankara Telefon: (312) 218 30 00 Yardım Masası: (312) 218 34 50 E-posta: its@titck.gov.tr

PTS Çalışma Prensipleri 2 YASAL UYARI 5846 Sayılı Fikir ve Sanat Eserleri Kanunu kapsamında bir Eser niteliği taşıyan işbu doküman ve tüm içeriği NART BİLİŞİM HİZMETLERİ LTD. ŞTİ. (bundan sonra TechN arts olarak anılacaktır) tarafından hazırlanmış olup, Eser sahibi TechN arts tır. İşbu doküman ve içeriği üzerindeki işleme, çoğaltma, yayma, temsil ve işaret, ses ve/veya görüntü nakline yarayan araçlarla umuma iletim hakkını içeren mali haklar dahil olmak üzere tüm fikri mülkiyet haklarının sahibi münhasıran TechN arts'tır. TechN arts ın açık yazılı izni olmaksızın bu doküman veya bunun herhangi bir kısmı kopyalanamaz, değiştirilemez, çoğaltılamaz, postalanamaz, aktarılamaz, yeniden yayınlanamaz, dağıtılamaz veya yeni içerikler türetmek için kullanılamaz; dokümanın herhangi bir kısmının kopya görüntüsü hiçbir ortamda yayınlanamaz. Bu doküman ve içeriği üzerindeki mali haklardan herhangi birinin üçüncü şahıslara devredilmesi ve/veya dokümanın kullanma hakkının ve/veya lisansının üçüncü şahıslara verilmesi ve/veya bunların satılmasına ilişkin olarak münhasır yetkili TechN arts tır. İşbu dokümanın içeriğinde yer alan Paket Transfer Servisi ( PTS ) yazılım standartları ve çalışma prensipleri ile PTS nin XML standartı tamamen TechN arts tarafından oluşturulmuş ve uygulanmış olup yukarıda sayılmış olan tüm mali hakları münhasıran TechN arts a aittir. Dokümanın içeriğinde yer alan XML formatı TechNarts ın açık yazılı izni olmaksızın kullanılamaz, kopyalanamaz ve değiştirilemez. İşbu dokümana doğrudan ya da dolaylı şekilde erişen kişiler bu şartları ve bu şartlara uyulmaması durumunda oluşacak yasal sonuçları ve cezalandırmaları peşinen kabul ederler. TechN arts bu şartlardan herhangi birinin ihlaline karşın her türlü yasal haklarını saklı tutar. REVİZYON İNDEKSİ SÜRÜM TARİH AÇIKLAMA 2.0 17.09.2012 PTS 2. Sürüm

PTS Çalışma Prensipleri 3 İÇİNDEKİLER 1. Amaç, Kapsam, Web Servislerin Genel İşleyişi 4 1.1. Amaç 4 1.2. Kapsam 4 1.3. Web Servislerin Genel İşleyisi 4 2. PTS nin Gelişimi 5 3. PTS Paketi ve Yapısı 6 4. PTS Web Servisleri 7 4.1. Paket Gönderme Servisi 7 4.1.1. asfile Operasyonu Örnek İstek Mesajı ve Mesajdaki Veri Alanları 7 4.1.2. asstream Operasyonu Örnek İstek Mesajı ve Mesajdaki Veri Alanları 8 4.1.3. Paket Gönderme Servisi Örnek Cevap Mesajı ve Mesajdaki Veri Alanları 9 4.1.4. Hata (Fault) Mesajı Yapısı 10 4.2. Paket Alma Servisi 11 4.2.1. asfile Operasyonu Örnek İstek Mesajı ve Mesajdaki Veri Alanları 11 4.2.2. asstream Operasyonu Örnek İstek Mesajı ve Mesajdaki Veri Alanları 12 4.2.3. asfile Operasyonu Örnek Cevap Mesajı ve Mesajdaki Veri Alanları 12 4.2.4. asstream Operasyonu Örnek Cevap Mesajı ve Mesajdaki Veri Alanları 13 4.2.5. Hata (Fault) Mesajı Yapısı 14

PTS Çalışma Prensipleri 4 1. AMAÇ, KAPSAM, WEB SERVİSLERİN GENEL İŞLEYİŞİ 1.1. Amaç İlaç Takip Sistemi (İTS) bildirimleri birim bazında yapılmaktadır. Ancak sektörde ilaçlar toplu olarak transfer edilmektedir. Yapılan fiziksel transferlerde her ilaç birimine ait karekod bilgisinin okutulmasına gerek kalmaksızın İTS bildirimlerini kolaylaştırmak için Paket Transfer Sistemi (PTS) geliştirilmiştir. Bu kılavuz, PTS web servislerinin yapısını ve kullanımını paydaşlarımızla paylaşmak amacıyla hazırlanmıştır. 1.2. Kapsam Bu doküman Türkiye İlaç ve Tıbbi Cihaz Kurumu tarafından sağlanan PTS web servislerinin iletişim yapısı, mesajlaşma yapısı ve mesajlarda kullanılacak veri yapılarını anlatmaktadır. Paket Transfer Sisteminin ve paydaşlarımızın iç süreçlerine değinilmeyecektir. Örnek kodlar, github sitesi üzerinden paylaşılacaktır: https://github.com/ilactakipsistemi 1.3. Web Servislerin Genel İşleyisi İlaç Takip Sistemi web servisleri iki yönlü çalışmaktadır. İstemcinin, İstek (Request) mesajı sisteme aktarılır, sistem mesajı işler ve isteğiyle ilgili sonucu istemciye Cevap (Response) olarak iletir. Veri iletimi sırasında veya verinin işlenmesi sırasında meydana gelen hatalar istemciye Hata (Fault) mesajı olarak geri bildirilir. İstemcinin aldığı Cevap ve Hata mesajlarını değerlendirmesi gerekir ve değerlendirdiği varsayılır. İstek, cevap ve hata mesajları bir SOAP zarfının içerisinde HTTP protokolü kullanılarak taşınır. İstemciler Web Servislerine HTTP Basic Authentication yöntemi ile ulaşırlar. İletişim SSL ile şifrelenebilmektedir. Ayrıca paketler ek (Mime Attachment) olarak gönderilip alınabildiği gibi SOAP zarfının içinde Base64 Binary olarak kodlanmış olarak da gönderilip alınabilir.

PTS Çalışma Prensipleri 5 2. PTS NİN GELİŞİMİ İTS nin devreye alınmasına müteakip sektörün özellikle üretici ve ecza depoları arasındaki mal transferlerini yönetme sıkıntısı ortaya çıkmıştır. İTS nin ilaç birimi bazında bildirimlerle çalışması, sistemin paydaşları arasındaki tedarik zincirinin yönetiminde taşıma (bağ, koli, palet vb.) birimlerinin ve bu birimler içerisinde bulunan ürünlerin ilişkisinin kurulmasını zorunlu hale getirmiştir. Sektörün kendi arasında yaptığı bu konudaki standartlaştırma çalışmaları sürerken, bu transfer işleminin her paydaşın güvenebileceği ve ortak olarak kabulleneceği merkezi bir yapı tarafından sağlanması talebi oluşmuştur. Bu taleplerin Türkiye İlaç Ve Tıbbi Cihaz Kurumu na (TITCK, eski adıyla İlaç ve Eczacılık Genel Müdürlüğü) iletilmesiyle birlikte TİTCK tarafından 13.12.2010 tarihinde sektörün ilgili paydaşlarının da katılımıyla bir çalıştay yapılmıştır. Çalıştay sonucunda bu merkezi yapının TİTCK tarafından sağlanacağı bilgisi sektörle paylaşılarak; TİTCK tarafından hazırlanan ve bu yapıda kullanılması planlanan XML veri formatı paydaşların da katılımıyla belirlenmiştir. Belirlenen XML veri formatında oluşturulan dosyaların paylaşılabileceği bir platform sağlanmış ve bu platform üzerinden gönderilen her dosya paket olarak adlandırılmıştır. Paydaşlar arasındaki güvenli paylaşımı sağlamak için PTS de İTS nin yetkilendirme sistemi kullanılmış ve bu sayede İTS paydaşları herhangi ek bilgiye ihtiyaç duymaksızın PTS web servislerini kullanmalarının yolu açılmıştır. PTS özellikle 1 Ocak 2012 tarihinde İTS de ikinci faza geçilmesi ile beraber çok büyük önem kazanmış ve PTS bildirimleri alıcı tarafından istenmesi halinde zorunlu hale gelmiştir. PTS, paydaşlarımız tarafından kısa sürede benimsenmiş ve kullanılmaya başlanmıştır. PTS paydaşlarımızdan gelen talepler ve ihtiyaçlar doğrultusunda, geliştirme ekibimiz tarafından zaman zaman değiştirilmektedir.

PTS Çalışma Prensipleri 6 3. PTS PAKETİ VE YAPISI Fiziksel transferlerin bilgileri paydaşların ikili anlaşmaları haricinde PTS XML Standardı Klavuzunda belirtilen formatta paylaşılmaktadır. Bu paylaşımı PTS web servisleri üzerinden yapabilmek için ilgili XML dokümanlarının sıkıştırılmış (zip) dosyalar olarak gönderilmesi gerekmektedir. Bahsi geçen sıkıştırılmış dosyalar paket olarak adlandırılmaktadır. Paket içindeki XML dokümanı sıkıştırılırken deflate yöntemi kullanılmalıdır. Zip dosyalarının web servislerde paket kullanılmasının üç önemli sebebi bulunmaktadır: Web servislerde kullanılan SOAP zarfları XML olduğu için içeriğinde gönderilmek istenen bir XML in zarfı bozma ihtimalinin yüksek olması, Yapılan aktarımların boyut olarak küçültülmesi ve dolayısıyla aktarım sürelerinin kısaltılması, Zip dosyalarının aktarımda oluşabilecek kayıpları belirli bir dereceye kadar telafi edilebilmesi.

PTS Çalışma Prensipleri 7 4. PTS WEB SERVİSLERİ PTS bildirimleri İTS bildirimlerinden bağımsızdır. Fakat PTS, İTS nin yetkilendirme sistemini kullanır. Böylece tüm paydaşlar ek bilgi gerekmeksizin PTS web servislerini çağırabilirler. İki adet PTS web servisi bulunmaktadır; Paket Gönderme Servisi ve Paket Alma Servisi. 4.1. Paket Gönderme Servisi Fiziksel bir transferle ilgili hazırlanan paketin herhangi bir paydaşa gönderilebileceği web servisidir. Bu serviste aynı görevi yerine getiren asfile ve asstream adlı iki operasyon bulunmaktadır. Operasyonların tek farkı paketlerin gönderilme yönetimidir. Hangi operasyonu kullanarak paketin gönderileceği paydaşın insiyatifindedir. Operasyonlarda gönderilen istek (Request) tipleri birbirinden farklı olmasına rağmen aynı cevap (Response) tipini dönmektedir. Bu serviste dikkat edilmesi gerekenler aşağıdaki listelenmiştir: Gönderilecek paketin zip dosyası olması, Eğer asfile operasyonu kullanılıyorsa paketin MIME eklentisi olarak gönderilmesi ve her bildirimde bir paket gönderilmesi, Alıcı paydaşın GLN sinin doğru olması, Paydaşın kendi kendine paket göndermemesi, Gönderilen paketin MD5 toplamı ile cevapta gelen md5checksum alanı karşılaştırılarak paketin kayıpsız şekilde İTS sunucularına ulaştığının paydaş tarafından teyid edilmesi. 4.1.1. asfile Operasyonu Örnek İstek Mesajı ve Mesajdaki Veri Alanları <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:send="http://pts.titck.gov.tr/send">

PTS Çalışma Prensipleri 8 <soapenv:header/> <soapenv:body> <send:sendfileparameters> <receiver>8680002800017</receiver> </send:sendfileparameters> </soapenv:body> </soapenv:envelope> Bu operasyonda gönderilen istek mesajındaki veri alanları hakkındaki açıklamalar aşağıdaki gibidir: <receiver> Alanı Bu alanda alıcı paydaşın GLN si bulunur. İsteğin başarılı olabilmesi için gönderilen alıcı bilgisinin sistemde bulunması gerekmektedir. Dikkat! asfile operasyonuna ait istek mesajının içerisinde gönderilecek paket bulunmamaktadır. Bunun sebebi MIME eklentilerinin HTTP isteği (Request) içinde gönderiliyor olmasıdır. Ayrıca bu operasyonda her istekte sadece bir adet paket gönderilmelidir. Aksi takdirde istek başarılı olmayacaktır. 4.1.2. asstream Operasyonu Örnek İstek Mesajı ve Mesajdaki Veri Alanları <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:send="http://pts.titck.gov.tr/send"> <soapenv:header/> <soapenv:body> <send:sendstreamparameters> <parameters> <receiver>8680002800017</receiver> </parameters> <filestream>uesdbbqaaaaaaksga0f6filqbgaaaayaaaaiaaaadgvzdc50ehrpc21hawxqswecfaau AAAAAACkhgNBehYpUAYAAAAGAAAACAAkAAAAAAABACAAAAAAAAAAdGVzdC50eHQKACAAAAAAAAE AGABhmusQe3HNAWGa6xB7cc0BYZrrEHtxzQFQSwUGAAAAAAEAAQBaAAAALAAAAAAA</fileStream> </send:sendstreamparameters> </soapenv:body> </soapenv:envelope> Bu operasyonda gönderilen istek mesajındaki veri alanları hakkındaki açıklamalar aşağıdaki gibidir:

PTS Çalışma Prensipleri 9 <parameters> Alanı Bu alan asfile operasyonunda gönderilen istek tipindedir. Her iki operasyonu kullanırken farklı veri tipleri olmaması amacıyla kullanılmıştır. <receiver> Alanı Bu alanda alıcı paydaşın GLN si bulunur. İsteğin başarılı olabilmesi için gönderilen alıcı bilgisinin sistemde bulunması gerekmektedir. <filestream> Alanı Bu alan gönderilmek istenen paketi içerir. Paketler bu alana Binary Base64 olarak kodlanır ve bu alana koyulur. Base64 olarak kodlanmasının sebebi, binary verinin getirebileceği yazdırılamaz (non-printable) karakterlerin XML zarfını bozmasını engellemektir. 4.1.3. Paket Gönderme Servisi Örnek Cevap Mesajı ve Mesajdaki Veri Alanları <S:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:response xmlns:ns2="http://pts.titck.gov.tr/send"> <transferid>379537</transferid> <md5checksum>3c3944c80bda1c631dcaaa87dcaa998e</md5checksum> </ns2:response> </S:Body> </S:Envelope> Mesajındaki veri alanları hakkındaki açıklamalar aşağıdaki gibidir: <transferid> Alanı transferid yapılan transferi ifade eder ve eşsizdir. Alıcı paydaş bu değeri kullanarak paketi almaktadır. Alıcı tarafa servisi çağıran paydaş bu değeri kendisi gönderebilir ve alıcı paydaş ilgili Referans Servisini kullanarak kendine gönderilmiş olan paketlere ait transfer id leri alabilir.

PTS Çalışma Prensipleri 10 <md5checksum> Alanı Bu alanda transfer ile gönderilen paketin binary MD5 toplamı (MD5 checksum) bulunmaktadır. Bu değer paydaşın gönderdiği paketin İTS sunucularındaki kopyasından elde edilmektedir. Bu sayede gönderici paydaş göndermiş olduğu paketin MD5 toplamını alarak cevapta gelen değerle karşılaştırıp, paketin kayıp yaşanmaksızın karşı tarafa ulaşıp ulaşmadığını teyid edebilir. 4.1.4. Hata (Fault) Mesajı Yapısı Web Servisleri ile iletişim sırasında veya mesaj içeriğinin kontrolü sırasında meydana gelen hatalarda sistem, bu hata mesajıyla kullanıcıyı bilgilendirir. İstemciler gelen hata mesajlarını işleyerek kullanıcılara gerekli uyarıları yapmalıdır. Hata mesajının detay bilgilerinde <faultcode> ve <faultmessage> alanları bulunur. <faultcode> Alanı Hatanın kodunu tutar. Beş karakter uzunluktadır. Uyarı kodları ile birlikte İlaç Takip Sisteminin web sitesinde, paydaşlarımızın giriş yaptığı online işlemlerde yayınlanmaktadır. Ayrıca Referans Web Servisleri kullanılarak da hata kodları alınabilir. <faultmessage> Alanı Hata Koduna karşılık gelen okunabilir metindir. Paket gönderme bildirimine ait örnek bir hata (Fault) mesajı aşağıda gösterilmiştir: <S:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <S:Fault xmlns:ns4="http://www.w3.org/2003/05/soap-envelope"> <faultcode>s:server</faultcode> <faultstring>alıcı GLN formatı uygun değildir! GLN 13 haneli olmalı ve rakamlardan oluşmalıdır.</faultstring> <detail>

PTS Çalışma Prensipleri 11 <ns2:transfererror xmlns:ns2="http://pts.titck.gov.tr/send"> <faultcode>21002</faultcode> <faultmessage>alıcı GLN formatı uygun değildir! GLN 13 haneli olmalı ve rakamlardan oluşmalıdır.</faultmessage> </ns2:transfererror> </detail> </S:Fault> </S:Body> </S:Envelope> 4.2. Paket Alma Servisi Fiziksel bir transfere ait bir paketin alıcısı tarafından alınabileceği web servistir. Bu serviste aynı görevi yerine getiren asfile ve asstream adlı iki operasyon bulunmaktadır. Operasyonların tek farkı paketlerin alınma yönetimidir. Hangi operasyonu kullanarak paketin alınacağı paydaşın inisiyatifindedir. Bu serviste dikkat edilmesi gerekenler aşağıdaki gibidir: Alıcı paydaşa gönderilen paketin transfer id sinin doğru olması, Paketlerin, servisi kullanarak tekrar tekrar alınmaması, Alınan paketin MD5 toplamı ile cevapta gelen MD5 toplamı karşılaştırılarak paketin kayıpsız şekilde İTS sunucularından alındığının paydaş tarafından teyid edilmesi. 4.2.1. asfile Operasyonu Örnek İstek Mesajı ve Mesajdaki Veri Alanları <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:get="http://pts.titck.gov.tr/get"> <soapenv:header/> <soapenv:body> <get:getfileparameters> <transferid>379542</transferid> </get:getfileparameters> </soapenv:body> </soapenv:envelope> Mesajındaki veri alanları hakkındaki açıklamalar aşağıdaki gibidir:

PTS Çalışma Prensipleri 12 <transferid> Alanı Transfer Id yapılan transferi ifade eder ve eşsizdir. Alıcı paydaş bu değeri kullanarak hangi paketi almak istediğini ifade eder. Alıcı paydaş bu bilgiyi gönderici paydaş tan alabileceği gibi, ilgili Referans Servisini kullanarak kendine gönderilmiş olan paketlere ait transfer id leri de alabilmektedir. 4.2.2. asstream Operasyonu Örnek İstek Mesajı ve Mesajdaki Veri Alanları <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:get="http://pts.titck.gov.tr/get"> <soapenv:header/> <soapenv:body> <get: getstreamparameters> <transferid>379542</transferid> </get: getstreamparameters> </soapenv:body> </soapenv:envelope> Mesajındaki veri alanları hakkındaki açıklamalar aşağıdaki gibidir: <transferid> Alanı Transfer Id yapılan transferi ifade eder ve eşsizdir. Alıcı paydaş bu değeri kullanarak hangi paketi almak istediğini ifade eder. Alıcı paydaş bu bilgiyi gönderici paydaş tan alabileceği gibi, ilgili Referans Servisini kullanarak kendine gönderilmiş olan paketlere ait transfer id leri alabilmektedir. 4.2.3. asfile Operasyonu Örnek Cevap Mesajı ve Mesajdaki Veri Alanları <S:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:filemd5checksum xmlns:ns2="http://pts.titck.gov.tr/get"> 3c3944c80bda1c631dcaaa87dcaa998e</ns2:fileMD5checksum> </S:Body> </S:Envelope> Mesajındaki veri alanları hakkındaki açıklamalar aşağıdaki gibidir:

PTS Çalışma Prensipleri 13 <filemd5checksum> Alanı Alınan pakete ait MD5 toplamını içerir. Bu alandaki değer ile alınan paketin MD5 toplamı alıcı paydaş tarafından hesaplanarak karşılaştırılıdır. Bu sayede alınan paketin kayıpsız olup olmadığı alıcı paydaş tarafından teyid edilmiş olur. Dikkat! Bu cevabın yanında MIME eklentisi olarak ilgili transfer id ye ait paket gelmektedir. Ancak bu paket HTTP İsteği (Request) ile gelmektedir. Dolayısıyla gelen SOAP zarfı içinde paketle ilgili bir bilgi bulunmaz. 4.2.4. asstream Operasyonu Örnek Cevap Mesajı ve Mesajdaki Veri Alanları <S:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:stream xmlns:ns2="http://pts.titck.gov.tr/get"> <streammd5checksum>3c3944c80bda1c631dcaaa87dcaa998e</streammd5checksum> <filestream>uesdbbqaaaaaaksga0f6filqbgaaaayaaaaiaaaadgvzdc50ehrpc21hawxqswecfaau AAAAAACkhgNBehYpUAYAAAAGAAAACAAkAAAAAAABACAAAAAAAAAAdGVzdC50eHQKACAAAAAAAAE AGABhmusQe3HNAWGa6xB7cc0BYZrrEHtxzQFQSwUGAAAAAAEAAQBaAAAALAAAAAAA</fileStream> </ns2:stream> </S:Body> </S:Envelope> Mesajındaki veri alanları hakkındaki açıklamalar aşağıdaki gibidir: <streammd5checksum> Alanı Alınan pakete ait MD5 toplamını içerir. Bu alandaki değer ile alınan paketin MD5 toplamı alıcı paydaş tarafından hesaplanarak karşılaştırılıdır. Bu sayede alınan paketin kayıpsız olup olmadığı alıcı paydaş tarafından teyid edilmiş olur. <filestream> Alanı Bu alan alınmak istenen paketi içerir. Bu alanın içeriği paketin Binary Base64 olarak kodlanmış halidir. Base64 olarak kodlanmasının sebebi, binary verinin getirebileceği yazdırılamaz (non-printable) karakterlerin XML zarfını bozmasını engellemektir.

PTS Çalışma Prensipleri 14 4.2.5. Hata (Fault) Mesajı Yapısı Web Servisleri ile iletişim sırasında veya mesaj içeriğinin kontrolü sırasında meydana gelen hatalarda sistem bu hata mesajıyla kullanıcıyı bilgilendirir. İstemciler gelen hata mesajlarını işleyerek kullanıcılara gerekli uyarıları yapmalıdır. Hata mesajının detay bilgilerinde <faultcode> ve <faultmessage> alanları bulunur. <faultcode> Alanı Hatanın kodunu tutar. Beş karakter uzunluktadır. Uyarı kodları ile birlikte İTS portalde, Online İşlemlerde yayınlanmaktadır. Ayrıca Referans Web Servisleri kullanılarak da hata kodları alınabilir. <faultmessage> Alanı Hata Koduna karşılık gelen okunabilir metindir. Paket gönderme bildirimine ait örnek bir hata (Fault) mesajı aşağıda gösterilmiştir: <S:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <S:Fault xmlns:ns4="http://www.w3.org/2003/05/soap-envelope"> <faultcode>s:server</faultcode> <faultstring>alınmak istenen paket 100 defa alınmaya çalışılmış. Bir paket en fazla 100 defa alınabilir, Lütfen süreçleriniz kontrol ediniz.</faultstring> <detail> <ns2:transfererror xmlns:ns2="http://pts.titck.gov.tr/get"> <faultcode>21012</faultcode> <faultmessage>alınmak istenen paket 100 defa alınmaya çalışılmış. Bir paket en fazla 100 defa alınabilir, Lütfen süreçleriniz kontrol ediniz.</faultmessage> </ns2:transfererror> </detail> </S:Fault> </S:Body> </S:Envelope>