TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI

Transkript

1 Revizyon : 1.56 ÜTS Versiyon 7.8.x ile uyumludur.

2 DEĞİŞİKLİK TARİHÇESİ Rev. No Yayın Tarihi Yayın Nedeni Hazırlayan(lar) /07/2015 İlk sürüm /02/2016, aldığı parametreler ve dönüş veri yapısı değişen bildirimler güncellendi. Burak İbrahim SEVİNDİ Eren ŞENELMİŞ Eren ŞENELMİŞ 14/03/2016 Bildirimlerin aldığı parametrelerdeki eksiklikler giderildi. Paket bildirimleri ve paket ile ilgili diğer servisler eklendi. Eren ŞENELMİŞ /07/2016 REST adresleri güncellendi. Ahmet Çağrı ŞİMŞEK Murat NARMANLI 12/10/2016 Servisler, servis parametreleri ve servis mesajları güncellendi. Kerim ÖZTÜRK 08/11/2016 Eksik olan sorgulama servisleri eklendi. Kerim ÖZTÜRK 13/12/2016 Sorgulardan Barkod Kuruluşu alanı kaldırıldı. Eksik olan sorgulama servisleri eklendi. Ahmet Çağrı Şimşek /12/2016 Medula ÜTS entegrasyon servisleri eklendi. Eksik olan sorgulama servisleri ve mesajlar eklendi. Kerim ÖZTÜRK /12/2016 Paket ile ilgili tüm servisler silindi. Kerim ÖZTÜRK /02/2017 Sistem paketi servisleri eklendi. Emre ÇİLESİZ /02/2017 Tekil ürün bilgisi ve eşsiz kimlik ile yapılan alma/iade alma bildirim servisleri eklendi. Sorgulama istek ve cevap alanları güncellendi /03/2017 Her bildirim ve sorgulama için örnek istek yapıları eklendi. Eşsiz kimlik ile yapılan bildirimlerin istek ve cevap alanları eklendi. Geçici verme bildirimi isim değişikliği ödünç olarak güncellendi. Medula ÜTS entegrasyon servisleri çıkarıldı /04/2017 Ödünç geri verme, iptali, ödünç geri alma bildirimi servisleri eklendi, sistem dışına çıkan tekil ürün ve bildirimleri servisi eklendi /06/2017 ÜTS de tanımsız yere verme ve ÜTS de tanımsız yere paket verme bildirimlerinde MERSIS yerine VEDOP sorgusu yapılması sonucu değişen veri alanları /09/17 UDI ve eşsiz kimlik alanları açıklamaları düzeltildi, Tüketiciye Verme ve Kullanım bildirimleri kimlik no alanları açıklamaları düzeltildi /10/2017 Farklı kurumların Tüketiciden İade Alma Bildirimi yapabilmesi için gereken veri alanları eklendi, hata mesajları eklendi ve bazı hata mesajlarında güncellemeler yapıldı. Nurseda ÖZDEMİR Kerim ÖZTÜRK Kerim ÖZTÜRK Ahmet Çağrı Şimşek Ahmet Çağrı Şimşek Kerim ÖZTÜRK 2 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3 ) İmha/Bertaraf Bildiriminde zorunlu "İmha/Bertaraf Belge " alanı eklendi. Kerim Öztürk 2) Ödünç Geri Verme Bildiriminde zorunlu alan olan "Kurum " (KUN) alanı kaldırıldı. 3) "Tüketiciye Verme İptal Bildirimi" geçen yerler "Tüketiciye Vermeyi İptal Bildirimi" olarak güncellendi. 4) Tüketiciye Verme Bildirimine zorunlu tarih alanı "Tüketiciye Verme Tarihi" eklendi, Kullanım Bildirimine zorunlu tarih alanı "Kullanım Tarihi" eklendi, Ödünç Verme Bildirimine zorunlu tarih alanı "Ödünç Verme Tarihi" eklendi, Geçici Kullanıma Verme Bildirimine zorunlu tarih alanı "Geçici Kullanıma Verme Tarihi" eklendi, Hastanın Vücudundan Çıkarma Bildirimine zorunlu tarih alanı "Hastanın Vücudundan Çıkarma Tarihi" eklendi, Bu tarihlerin ortak adı "GIT" (Gerçek İşlem Tarihi). 5) Üretim ve İthalat Bildirimlerine zorunlu olmayan Gönüllü Takip Kapsamı (GTK) alanı eklendi. 6) Askıdaki tekil ürünleri sorgularına Alan Kurum Unvan (AKU), Marka Model Etiket (MME) eklendi. Kabul edilecek tekil ürün sorgularına Gönderen Kurum Unvan (GKU), Marka Model Etiket (MME) eklendi. Tekil ürün sorgularına Marka Model Etiket (MME) eklendi. Bildirim sorgularına Bildiren Kurum Unvan (BKU), Diğer Kurum Unvan (DKU), Marka Model Etiket (MME) eklendi. 4. maddede eklenen Gerçek İşlem Tarihi (GIT), gerekli sorgulara da eklendi. Gerekli sorgulara Üretici İthalatçı Kurum No (UIK) eklendi. 7) Sisteme eklenen uyarı mesajları dokümana eklendi /12/2017 Ürün Sorgulama servisi eklendi. Akif BOYNUEĞRİ 04/01/ /02/2018 1) Kullanım bildirimine Kişi Tanımlayıcı Numara, Kişi Kimlik Bilgisi Türü ve Kişi Kimlik Bilgisi Diğer Tür sı alanları eklendi. 2) Geçici kullanımına verme bildirimine Kişi Tanımlayıcı Numara, Kişi Kimlik Bilgisi Türü ve Kişi Kimlik Bilgisi Diğer Tür sı alanları eklendi. 3) Tüketiciye verme bildirimine Kişi Tanımlayıcı Numara, Kişi Kimlik Bilgisi Türü ve Kişi Kimlik Bilgisi Diğer Tür sı alanları eklendi. 4) Hastanın vücudundan çıkarma bildirimine Kişi Tanımlayıcı Numara, Kişi Kimlik Bilgisi Türü ve Kişi Kimlik Bilgisi Diğer Tür sı alanları eklendi. Tekil ürünün TİTUBB da kaydının olup olmadığını sorgulayan servis eklendi. Nurseda ÖZDEMİR Kerim ÖZTÜRK 3 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

4 İÇİNDEKİLER 1 GİRİŞ AMAÇ KAPSAM TERİMLER VE KISALTMALAR WEB SERVİSLERİN GENEL YAPISI ÜTS NİN DİĞER BİLGİ SİSTEMLERİ İLE ENTEGRASYONU WEB SERVİSLER HAREKET BİLDİRİM SERVİSLERİ ÜRETİM BİLDİRİMİ Üretim Bildirimi Servis Adresi Üretim Bildirimi Veri Alanları Üretim Bildirimi Örnek İstek İTHALAT BİLDİRİMİ İthalat Bildirimi Servis Adresi İthalat Bildirimi Veri Alanları İthalat Bildirimi Örnek İstek VERME BİLDİRİMİ Verme Bildirimi Servis Adresi Verme Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Verme Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Verme Bildirimi Örnek İstek ALMA BİLDİRİMİ Alma Bildirimi Servis Adresi Alma Bildirimi Veri Alanları Alma Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Alma Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Alma Bildirimi Örnek İstek ÜTS DE TANIMSIZ YERE VERME BİLDİRİMİ ÜTS de Tanımsız Yere Verme Bildirimi Servis Adresi ÜTS de Tanımsız Yere Verme Bildirimi Veri Alanları ÜTS de Tanımsız Yere Verme Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle ÜTS de Tanımsız Yere Verme Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile ÜTS de Tanımsız Yere Verme Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile ÜTS de Tanımsız Yere Verme Bildirimi Örnek İstek ÜTS DE TANIMSIZ YERDEN İADE ALMA BİLDİRİMİ ÜTS de Tanımsız Yerden İade Alma Bildirimi Servis Adresi / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

5 ÜTS de Tanımsız Yerden İade Alma Bildirimi Veri Alanları ÜTS de Tanımsız Yerden İade Alma Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi ile ÜTS de Tanımsız Yerden İade Alma Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile ÜTS de Tanımsız Yerden İade Alma Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile ÜTS de Tanımsız Yerden İade Alma Bildirimi Örnek İstek KULLANIM BİLDİRİMİ Kullanım Bildirimi Servis Adresi Kullanım Bildirimi Veri Alanları Kullanım Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Kullanım Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Örnek İstek TÜKETİCİYE VERME BİLDİRİMİ Tüketiciye Verme Bildirimi Servis Adresi Tüketiciye Verme Bildirimi Veri Alanları Tüketiciye Verme Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Tüketiciye Verme Bildirimi Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Örnek İstek TÜKETİCİDEN İADE ALMA BİLDİRİMİ Tüketiciden İade Alma Bildirimi Servis Adresi Tüketiciden İade Alma Bildirimi Veri Alanları Tüketiciden İade Alma Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Örnek İstek GEÇİCİ KULLANIMA VERME BİLDİRİMİ Geçici Kullanıma Verme Bildirimi Servis Adresi Geçici Kullanıma Verme Bildirimi Veri Alanları Geçici Kullanıma Verme Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Geçici Kullanıma Verme Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Örnek İstek KULLANIMDAN ALMA BİLDİRİMİ Kullanımdan Alma Bildirimi Servis Adresi Kullanımdan Alma Bildirimi Veri Alanları Kullanımdan Alma Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

6 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Örnek İstek YENİDEN İŞLEME BİLDİRİMİ Yeniden İşleme Bildirimi Servis Adresi Yeniden İşleme Bildirimi Veri Alanları Yeniden İşleme Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Yeniden İşleme Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Örnek İstek İHRACAT BİLDİRİMİ İhracat Bildirimi Servis Adresi İhracat Bildirimi Veri Alanları İhracat Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle İhracat Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Örnek İstek MAHRECİNE İADE ETME BİLDİRİMİ Mahrecine İade Etme Bildirimi Servis Adresi Mahrecine İade Etme Bildirimi Veri Alanları Mahrecine İade Etme Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Mahrecine İade Etme Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Örnek İstek HEK / ZAYİAT BİLDİRİMİ HEK / Zayiat Bildirimi Servis Adresi HEK / Zayiat Bildirimi Veri Alanları HEK / Zayiat Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle HEK / Zayiat Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Örnek İstek GERİ ÇEKME VERME BİLDİRİMİ Geri Çekme Verme Bildirimi Servis Adresi Geri Çekme Verme Bildirimi Veri Alanları Geri Çekme Verme Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Geri Çekme Verme Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Örnek İstek GERİ ÇEKME ALMA BİLDİRİMİ Geri Çekme Alma Bildirimi Servis Adresi Geri Çekme Alma Bildirimi Veri Alanları / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

7 Geri Çekme Alma Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Örnek İstek ISLAH / DÜZELTİCİ FAALİYET BİLDİRİMİ Islah / Düzeltici Faaliyet Bildirimi Servis Adresi Islah / Düzeltici Faaliyet Bildirimi Veri Alanları Islah / Düzeltici Faaliyet Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Islah / Düzeltici Faaliyet Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Örnek İstek İMHA / BERTARAF BİLDİRİMİ İmha / Bertaraf Bildirimi Servis Adresi İmha / Bertaraf Bildirimi Veri Alanları İmha / Bertaraf Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle İmha / Bertaraf Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Örnek İstek HASTANIN VÜCUDUNDAN ÇIKARMA BİLDİRİMİ Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek ÖDÜNÇ VERME BİLDİRİMİ Ödünç Verme Bildirimi Servis Adresi Ödünç Verme Bildirimi Veri Alanları Ödünç Verme Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Ödünç Verme Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Örnek İstek ÖDÜNÇ ALMA BİLDİRİMİ Ödünç Alma Bildirimi Servis Adresi Ödünç Alma Bildirimi Veri Alanları Ödünç Alma Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Örnek İstek / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

8 ÖDÜNÇ GERİ VERME BİLDİRİMİ Ödünç Geri Verme Bildirimi Servis Adresi Ödünç Geri Verme Bildirimi Veri Alanları Ödünç Geri Verme Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi İle Ödünç Geri Verme Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Örnek İstek ÖDÜNÇ GERİ ALMA BİLDİRİMİ Ödünç Geri Alma Bildirimi Servis Adresi Ödünç Geri Alma Bildirimi Veri Alanları Ödünç Geri Alma Bildirimi Örnek İstek Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Servis Adresi Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Veri Alanları Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Örnek İstek İPTAL BİLDİRİMLERİ İPTAL BİLDİRİMLERİ SERVİS ADRESLERİ İptal Bildirimi Veri Alanları İptal Bildirimleri Örnek İstek BİLDİRİM CEVABI BİLDİRİM CEVABI VERİ ALANLARI SORGULAMA SERVİSLERİ TEKİL ÜRÜN SORGULA Tekil Ürün Sorgula Servis Adresi Tekil Ürün Sorgula İstek Veri Alanları Tekil Ürün Sorgula Cevap Veri Alanları Tekil Ürün Sorgula Örnek İstek Eşsiz Kimlik Bilgisi ile Tekil Ürün Sorgula Servis Adresi Eşsiz Kimlik İle Tekil Ürün Sorgula İstek Veri Alanları Eşsiz Kimlik İle Tekil Ürün Sorgula Örnek İstek ÜRETİCİ/İTHALATÇI TEKİL ÜRÜN SORGULA Üretici/İthalatçı Tekil Ürün Sorgula Servis Adresi Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek ÜRETİCİ/İTHALATÇI SİSTEMİN DIŞINA ÇIKMIŞ TEKİL ÜRÜN SORGULA Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Servis Adresi Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

9 3.4.4 ASKIDAKİ TEKİL ÜRÜN SORGULA Askıdaki Tekil Ürün Sorgula Servis Adresi Askıdaki Tekil Ürün Sorgula İstek Veri Alanları Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları Askıdaki Tekil Ürün Sorgula Örnek İstek ÖDÜNÇ ALINAN TEKİL ÜRÜN SORGULA Ödünç Alınan Tekil Ürün Sorgula Servis Adresi Ödünç Alınan Tekil Ürün Sorgula İstek Veri Alanları Ödünç Alınan Tekil Ürün Sorgula Cevap Veri Alanları Ödünç Alınan Tekil Ürün Sorgula Örnek İstek BİLDİRİM SORGULA Bildirim Sorgula Servis Adresi Bildirim Sorgula İstek Veri Alanları Bildirim Sorgula Cevap Veri Alanları Bildirim Sorgula Örnek İstek KABUL EDİLECEK TEKİL ÜRÜN SORGULA Kabul Edilecek Tekil Ürün Sorgula Servis Adresi Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları Kabul Edilecek Tekil Ürün Sorgula Örnek İstek ÖDÜNÇ ALINACAK TEKİL ÜRÜN SORGULA Ödünç Alınacak Tekil Ürün Sorgula Servis Adresi Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek KABUL EDİLECEK GERİ ÇEKİLMİŞ TEKİL ÜRÜN SORGULA Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Servis Adresi Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula TEKİL ÜRÜNÜN KAYNAĞINI SORGULA Tekil Ürünün Kaynağını Sorgula Servis Adresi Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları Tekil Ürünün Kaynağını Sorgula Örnek İstek PAKET TRANSFER SİSTEMİ (PTS) SERVİSLERİ PAKET EKLE Paket Ekle Servis Adresi Paket Ekle İstek Veri Alanları / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

10 Paket Ekle Cevap Veri Alanları Paket Ekle Örnek İstek PAKET SİL Paket Sil Servis Adresi Paket Sil İstek Veri Alanları Paket Sil Cevap Veri Alanları Paket Sil Örnek İstek PAKET GETİR Paket Getir Servis Adresi Paket Getir İstek Veri Alanları Paket Getir Cevap Veri Alanları Paket Getir Örnek İstek KURUMA GELEN PAKETİ OKUNDU İŞARETLE Kuruma Gelen Paketi Okundu İşaretle Servis Adresi Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları Kuruma Gelen Paketi Okundu İşaretle Örnek İstek KURUMA GELEN PAKETİ GETİR Kuruma Gelen Paketi Getir Servis Adresi Kuruma Gelen Paketi Getir İstek Veri Alanları Kuruma Gelen Paketi Getir Cevap Veri Alanları Kuruma Gelen Paketi Getir Örnek İstek KURUMA GELEN PAKETLERİ SORGULA Kuruma Gelen Paketleri Sorgula Servis Adresi Kuruma Gelen Paketleri Sorgula İstek Veri Alanları Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları Kuruma Gelen Paketleri Sorgula Örnek İstek FİRMA SORGULAMA SERVİSİ FİRMA SORGULAMA SERVİS ADRESİ FİRMA SORGULAMA SERVİSİ VERİ ALANLARI ÜRÜN SORGULAMA SERVİSİ ÖRNEK İSTEK ÜRÜN SORGULAMA SERVİSİ ÜRÜN SORGULAMA SERVİS ADRESİ ÜRÜN SORGULAMA SERVİSİ VERİ ALANLARI ÜRÜN SORGULAMA SERVİSİ ÖRNEK İSTEK EKLER EK-A SERVİS MESAJLARI / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

11 TABLOLAR Tablo 1. Üretim Bildirimi Veri Alanları Tablo 2. İthalat Bildirimi Veri Alanları Tablo 3. Verme Bildirimi Veri Alanları Tablo 4. Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları Tablo 5. Alma Bildirimi Veri Alanları Tablo 6. Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları Tablo 7. ÜTS de Tanımsız Yere Verme Bildirimi Veri Alanları Tablo 8. Eşsiz Kimlik Bilgisi ile ÜTS de Tanımsız Yere Verme Bildirimi Veri Alanları Tablo 9.ÜTS de Tanımsız Yerden İade Alma Bildirimi Veri Alanları Tablo 10. Eşsiz Kimlik Bilgisi ile ÜTS de Tanımsız Yerden İade Alma Bildirimi Veri Alanları Tablo 11.Kullanım Bildirimi Veri Alanları Tablo 12. Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları Tablo 13.Tüketiciye Verme Bildirimi Veri Alanları Tablo 14. Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Veri Alanları Tablo 15.Tüketiciden İade Alma Bildirimi Veri Alanları Tablo 16. Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları Tablo 17. Geçici Kullanıma Verme Bildirimi Veri Alanları Tablo 18. Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları Tablo 19. Kullanımdan Alma Bildirimi Veri Alanları Tablo 20. Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları Tablo 21. Yeniden İşleme Bildirimi Veri Alanları Tablo 22. Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları Tablo 23. İhracat Bildirimi Veri Alanları Tablo 24. Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları Tablo 25. Mahrecine İade Etme Bildirimi Veri Alanları Tablo 26. Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları Tablo 27.HEK / Zayiat Bildirimi Veri Alanları Tablo 28. Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları Tablo 29. Geri Çekme Verme Bildirimi Veri Alanları Tablo 30. Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları Tablo 31. Geri Çekme Alma Bildirimi Veri Alanları Tablo 32. Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları Tablo 33.Islah / Düzeltici Faaliyet Bildirimi Veri Alanları Tablo 34. Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları Tablo 35. İmha / Bertaraf Bildirimi Veri Alanları Tablo 36. Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları Tablo 37. Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları Tablo 38. Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

12 Tablo 39. Ödünç Verme Bildirimi Veri Alanları Tablo 40. Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Veri Alanları Tablo 41. Ödünç Alma Bildirimi Veri Alanları Tablo 42. Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Veri Alanları Tablo 43. Ödünç Geri Verme Bildirimi Veri Alanları Tablo 44. Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Veri Alanları Tablo 45. Ödünç Geri Alma Bildirimi Veri Alanları Tablo 46. Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Veri Alanları Tablo 47. İptal Bildirimleri Servis Adresleri Tablo 48. İptal Bildirimi Veri Alanları Tablo 49. Bildirim Cevabı Veri Alanları Tablo 50. Tekil Ürün Sorgula İstek Veri Alanları Tablo 51. Tekil Ürün Sorgula Cevap Veri Alanları Tablo 52. Eşsiz Kimlik ile Tekil Ürün Sorgula İstek Veri Alanları Tablo 53. Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları Tablo 54. Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları Tablo 55. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları Tablo 56. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları Tablo 57. Askıdaki Tekil Ürün Sorgula İstek Veri Alanları Tablo 58. Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları Tablo 59. Ödünç Alınan Tekil Ürün Sorgula İstek Veri Alanları Tablo 60. Ödünç Alınan Tekil Ürün Sorgula Cevap Veri Alanları Tablo 61. Bildirim Sorgula İstek Veri Alanları Tablo 62. Bildirim Sorgula Cevap Veri Alanları Tablo 63. Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları Tablo 64. Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları Tablo 65. Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları Tablo 66. Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları Tablo 67. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları Tablo 68. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları Tablo 69. Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları Tablo 70. Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları Tablo 71. Paket Ekle İstek Veri Alanları Tablo 72. Paket Ekle Cevap Veri Alanları Tablo 73. Paket Sil İstek Veri Alanları Tablo 74. Paket Sil Cevap Veri Alanları Tablo 75. Paket Getir İstek Veri Alanları Tablo 76. Paket Getir Cevap Veri Alanları Tablo 77. Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

13 Tablo 78. Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları Tablo 79. Kuruma Gelen Paketi Getir İstek Veri Alanları Tablo 80. Kuruma Gelen Paketi Getir Cevap Veri Alanları Tablo 81. Kuruma Gelen Paketleri Sorgula İstek Veri Alanları Tablo 82. Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları Tablo 83. Firma Sorgulama Servisi Veri Alanları Tablo 84. Ürün Sorgulama Servisi Veri Alanları Tablo 85. Servis Mesajları / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

14 1 GİRİŞ 1.1 AMAÇ Kurumlar ve firmalar hareket bildirimlerini yapabilmek için ÜTS tarafından sağlanacak web servislerini veya ÜTS web ara yüzünü kullanabilecektir. ÜTS web servislerini kullanabilmek için kurumların ve firmaların bilgi sistemlerinin entegrasyonlarını web servis tanımlarına göre ÜTS ile sağlamaları gereklidir. Bu dokümanın amacı ÜTS nin sağlayacağı web servisleri kullanmak isteyen kurum veya firmaların ihtiyaç duyacakları bilgileri sunmaktır. 1.2 KAPSAM Bu dokümanda tekil ürünlerin hem normal hareketleri hem de geri çekme kapsamındaki hareketleri için kullanılan servisler tanımlanmıştır. Kurum veya firmalar bu servisleri kullanarak tekil ürünün sahipliği, miktarı veya kullanım sayısındaki değişimleri bildirebilecektir. Dokümanda her bir servisin amacı kısaca açıklanmış; servisin erişim adresi, servisi çağırmak için gerekli parametreler ve servisin döndüğü cevabın veri yapısı tanımlanmıştır. 1.3 TERİMLER VE KISALTMALAR Terim / Kısaltma BİLGEM Hareket Bildirimi İdare REST Sistem Tekil Ürün TİTCK TÜBİTAK MERSİS UDI URL Ürün ÜTS Tanım Bilişim ve Bilgi Güvenliği İleri Teknolojiler Araştırma Merkezi Her bir tekil ürünün veya lot/parti/batch in bir hareketi için yapılan bildirimdir. Her hareket bildirimi ÜTS tarafından önceden belirlenmiş bir formata sahiptir. TİTCK JavaScript Object Notation Representational State Transfer Ürün Takip Sistemi Ürünlerin her bir tekil birimidir. Örneğin; her bir tansiyon ölçme aleti veya her bir parfüm şişesi bir tekil üründür. T.C. Sağlık Bakanlığı Türkiye İlaç ve Tıbbi Cihaz Kurumu Türkiye Bilimsel ve Teknolojik Araştırma Kurumu Merkezi Sicil Kayıt Sistemi Unique Device Identification Uniform Resource Locator Kurumların ve firmaların ÜTS de kayıtlı tıbbi cihaz ve kozmetik ürünlerinin her biridir. Ürün Takip Sistemi 14 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

15 YTE Terim / Kısaltma Yazılım Teknolojileri Araştırma Enstitüsü Tanım 2 WEB SERVİSLERİN GENEL YAPISI 2.1 ÜTS NİN DİĞER BİLGİ SİSTEMLERİ İLE ENTEGRASYONU ÜTS nin kullanıcılara sunduğu bütün işlevler standart REST servisleri şeklindedir. Bu işlevler, ÜTS tarafından sağlanan kullanıcı arayüzleri aracılığıyla kullanılabileceği gibi, başka bilgi sistemlerinin entegrasyonuna da açıktır. Kullanıcıların kendi bilgi sistemlerini ÜTS ye entegre etmek için öncelikle ÜTS arayüzlerini kullanarak entegrasyon anahtarı almaları gerekmektedir. Entegrasyon anahtarı e-imza kullanılarak üretilen bir koddur. Bu kod sistem token ı olarak adlandırılmaktadır. Sistem token ının amacı, ÜTS ye bildirim göndermek isteyen bilgi sistemlerinin kimliğini doğrulamak ve yetkilerinin sınırlarını belirlemektir. Kullanıcı bilgi sistemi, sistem token ını aldıktan sonra, yapacağı her web servis çağrısının başlık (header) kısmına utstoken etiketiyle sistem token ının değerini eklemelidir. Aksi halde, yani sistem token ının utstoken etiketiyle REST çağrısının başlık kısmına eklenmediği durumlarda, ÜTS yetki hatası verir ve işlemi tamamlamaz. Kullanıcılar kendi bilgi sistemlerini ÜTS ye entegre etmek için kullanacakları sistem token ını aşağıdaki adımları izleyerek alabilirler (Bu adımları yapacak olan kullanıcılar, firmalarında / kurumlarında imza yetkilisi rolüne sahip olmalıdırlar. Kullanıcıların imza yetkilisi rolüne sahip olup olmadığı MERSİS'ten otomatik olarak sorgulanmaktadır.). 1. Yetkili kullanıcı grubundaki bir kullanıcı ile 1 adresinden ÜTS ye giriş yapılır. Kullanıcı gerekirse Hesap Değiştir bağlantısını kullanarak işlem yapmak istediği kurum / firma ile ilgili hesaba geçiş yapmalıdır. 2. Kullanıcı, menüden Kullanıcı Sistem Kullanıcısı Tanımlama İşlemleri seçeneğini seçer. 3. Kullanıcı, karşısına gelen ekrandaki metni e-imza kullanarak imzalar. 4. ÜTS kullanıcıya sistem token ı üretir ve kullanıcı bu token ı kendi bilgi sistemine kopyalar. 1 Ürün Hareketleri ve Ürün Geri Çağırma Modülleri ÜTS nin test ortamında da ( hizmet vermektedir. Firmalar, deneme yapmak amacıyla test ortamını da kullanabilirler. Test ortamındaki veriler gerçek ortama aktarılmayacaktır. 15 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

16 3 WEB SERVİSLER 3.1 HAREKET BİLDİRİM SERVİSLERİ Tekil ürün hareketleri bakımından değerlendirildiğinde ÜTS, kapalı bir sistemdir. Tekil ürünler Üretim veya İthalat bildirimiyle beraber Sistem (ÜTS) içerisinde yer almaya başlar. Tekil ürün, Verme ve Alma bildirimleriyle Sistem de tanımlı kurumlar/firmalar arasında el değiştirmiş olur. ÜTS de tanımlı olmayan bir kurum/firmaya tekil ürün verildiğinde ÜTS de Tanımsız Yere Verme Bildirimi kullanılır. Tekil ürün bu bildirimle beraber Sistem in dışına çıkmış olur. Hasta veya tüketiciye ücreti karşılığında veya ücretsiz olarak verilen tekil ürünler için Tüketiciye Verme Bildirimi kullanılır. Tekil ürün Tüketiciye Verme Bildirimi yle de Sistem in dışına çıkmış olur. Hakkında geri çekme kararı olan tekil ürünlerin hareketleri kısıtlanabilmektedir. Hareketi kısıtlanan tekil ürünler için özelleşmiş servisler tanımlanmıştır. Her bir bildirim ayrı bir bölümde açıklanmıştır. Bildirimin çağırılacağı servis adresi ve servis çağırımı ile beraber gönderilmesi gereken alanlar belirtilmiştir. Tüm hareket bildirimleri sonucunda servisin döndürdüğü veri yapıları ortaktır. Bu veri yapısı numaralı başlık altında açıklanmıştır Üretim Bildirimi Üretici, ürettiği tekil ürünlerin her biri için bir Üretim Bildirimi yapar Üretim Bildirimi Servis Adresi Gerçek Ortam: Test Ortamı: Üretim Bildirimi Veri Alanları Tablo 1. Üretim Bildirimi Veri Alanları Ürün UNO Metin 23 Evet Ürünün ürün numarası/barkod numarasıdır. Lot/Batch Seri/Sıra LNO Metin 20 Koşullu SNO Metin 20 Koşullu Tekil bazda takip edilen ürünler için 16 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

17 Üretim Tarihi URT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A: Ay, G: Gün. Son Kullanma Tarihi SKT Tarih 13 Hayır YYYY-AA-GG SS formatındadır. Y: Yıl, A: Ay, G: Gün, S: Saat. GS1 ürünler için saat verilmez. HIBCC ürünlerin özelliğine göre saat ve gün alanları verilmeyebilir. Tekil takip edilen ürünler için verilmez. Adet ADT Sayı - Koşullu aynı lot/seri/batch ten kaç tane üretim yapıldığını ifade etmektedir. Eşsiz Kimlik UDI Metin - Koşullu Unique Device Identifier (UDI) ya da Karekod olarak da bilinen tekil ürünün Eşsiz Kimliği mevcut ise verilebilir. Tekil ürünün sistem işlem paketi olması Liste ve içinde en az bir tane takip Sistem İşlem Paketi SIP (BRK, UNO, LNO, SNO, - Koşullu kapsamında ürün olması durumunda ADT) Liste içinde verilen bilgiler alt tekil ürünlerin bilgileridir. Tekil ürünün kozmetik ürün seti olması Liste ve içinde en az bir tane takip Kozmetik Ürün Seti KUS (BRK, UNO, LNO, SNO, - Koşullu kapsamında ürün olması durumunda ADT) Liste içinde verilen bilgiler alt tekil ürünlerin bilgileridir. 17 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

18 Herhangi bir takip konfigürasyonu bulunmayan ürünlerin, firmalar tarafından gönüllü takip edilebilmesi için Gönüllü Takip Kapsamı GTK Tek Seçimli Liste 5 Hayır gerekli alandır. Aşağıdaki değerlerden birini alabilir. TEKIL LOT Üretim Bildirimi Örnek İstek Örnek 1 lot takip edilen ürün: "UNO" : " ", "LNO" : " ", "ADT" : 100, "UDI" : " ", "URT" : " ", "SKT" : " " Örnek 2 tekil takip edilen ürün: "UNO" : " ", "SNO" : "KYY ", "UDI" : " KYY ", "URT" : " ", "SKT" : " " NOT: Tekil takip edilen ürünlerde ADT bilgisi 1 girilmelidir veya o alan girilmemelidir. Örnek 3 tekil takip edilen sistem işlem paketi: "UNO" : " ", "SNO" : " MM9", "UDI" : " MM9", "ADT" : 1, "URT" : " ", 18 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

19 "SKT" : " ", "SIP" : [, ] "UNO" : " ", "SNO" : "B8NN " "UNO" : " ", "LNO" : " ", "ADT" : 10 Örnek 4 takip konfigürasyonu bulunmayan tekil ürünü gönüllü tekil bazda takip ederek üretim yapılması: "UNO" : " ", "SNO" : "KYY ", "UDI" : " KYY ", "URT" : " ", "SKT" : " ", "GTK" : "TEKIL" İthalat Bildirimi İthalatçı, ithal ettiği tekil ürünler için İthalat Bildirimi yapar İthalat Bildirimi Servis Adresi Gerçek Ortam: Test Ortamı: İthalat Bildirimi Veri Alanları Tablo 2. İthalat Bildirimi Veri Alanları Ürün UNO Metin 23 Evet Ürünün ürün numarası/barkod numarasıdır. 19 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

20 Lot/Batch Seri/Sıra LNO Metin 20 Koşullu SNO Metin 20 Koşullu Tekil bazda takip edilen ürünler için Üretim Tarihi URT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A: Ay ve G: Günü ifade etmektedir. Kozmetik ürünler için ithalat tarihi verilmişse üretim tarihi verilemeyebilir. Son Kullanma Tarihi SKT Tarih 13 Hayır YYYY-AA-GG SS formatındadır. Y: Yıl, A: Ay, G: Gün ve S saati ifade etmektedir. GS1 ürünler için saat verilmez. HIBCC ürünlerin özelliğine göre saat ve gün alanları verilmeyebilir. YYYY-AA-GG formatındadır. Y: Yıl, A: Ay ve G: Günü ifade etmektedir. İthalat Tarihi ITT Tarih 10 Koşullu Kozmetik ürünler için üretim tarihinin bilinmediği durumda ithalat tarihi verilmelidir. Tekil takip edilen ürünler için verilmez. Adet ADT Sayı - Koşullu aynı lot/seri/batch ten kaç tane ithal edildiğini ifade etmektedir. Eşsiz Kimlik UDI Metin - Koşullu Unique Device Identifier (UDI) ya da Karekod olarak da bilinen tekil ürünün Eşsiz Kimliği mevcut ise verilebilir. İthal Edildiği Ülke IEU Sayı 3 Evet Ülke kodudur. * 20 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

21 Menşei Ülke MEU Sayı 3 Evet Ülke kodudur. * Gümrük Beyanname GBN Metin 16 Evet - Tekil ürünün sistem işlem paketi olması Liste ve içinde en az bir tane takip Sistem İşlem Paketi SIP (BRK, UNO, LNO, SNO, - Koşullu kapsamında ürün olması durumunda ADT) Liste içinde verilen bilgiler alt tekil ürünlerin bilgileridir. Tekil ürünün kozmetik ürün seti olması Liste ve içinde en az bir tane takip Kozmetik Ürün Seti KUS (BRK, UNO, LNO, SNO, - Koşullu kapsamında ürün olması durumunda ADT) Liste içinde verilen bilgiler alt tekil ürünlerin bilgileridir. Herhangi bir takip konfigürasyonu bulunmayan ürünlerin, firmalar tarafından gönüllü takip edilebilmesi için Gönüllü Takip Kapsamı GTK Tek Seçimli Liste 5 Hayır gerekli alandır. Aşağıdaki değerlerden birini alabilir. TEKIL LOT * Risk Yönetimi ve Kontrol Genel Müdürlüğü nün yayınladığı kodlar kullanılmaktadır İthalat Bildirimi Örnek İstek Örnek 1 lot takip edilen ürün: "UNO" : " ", 21 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

22 "LNO" : " ", "ADT" : 100, "UDI" : " ", "URT" : " ", "SKT" : " ", "IEU" : "038", "MEU" : "452", "GBN" : " IM003176" Örnek 2 tekil takip edilen ürün: "UNO" : " ", "SNO" : "KYY ", "UDI" : " KYY ", "URT" : " ", "SKT" : " ", "IEU" : "716", "MEU" : "082", "GBN" : " IM003176" NOT: Tekil takip edilen ürünlerde ADT bilgisi 1 girilmelidir veya o alan girilmemelidir. Örnek 3 tekil takip edilen sistem işlem paketi: "UNO" : " ", "SNO" : " MM9", "UDI" : " MM9", "ADT" : 1, "URT" : " ", "SKT" : " ", "IEU" : "400", "MEU" : "400", "GBN" : " IM003176", "SIP" : [ "UNO" : " ", "SNO" : "KYY " 22 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

23 ], "UNO" : " ", "LNO" : " ", "ADT" : 1 Örnek 4 takip konfigürasyonu bulunmayan tekil ürünü gönüllü tekil bazda takip ederek ithalat yapılması: "UNO" : " ", "SNO" : "KYY ", "UDI" : " KYY ", "URT" : " ", "SKT" : " ", "IEU" : "716", "MEU" : "082", "GBN" : " IM003176", "GTK" : "TEKIL" Verme Bildirimi Kurum/firma kullanıcısı sahip olduğu tekil ürünlerini başka bir kurum/firmaya verdiğinde Verme Bildirimi yapar. Satış, hibe, iade vb. yöntemler için Verme Bildirimi yapılır Verme Bildirimi Servis Adresi Gerçek Ortam: Test Ortamı: Bildirimi Veri Alanları Tablo 3. Verme Bildirimi Veri Alanları Ürün UNO Metin 23 Evet Ürünün ürün numarası/barkod numarasıdır. 23 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

24 Lot/Batch Seri/Sıra LNO Metin 20 Koşullu SNO Metin 20 Koşullu Tekil bazda takip edilen ürünler için Tekil takip edilen ürünler için verilmez. Adet ADT Sayı - Koşullu aynı lot/seri/batch ten kaç tane verildiğini ifade etmektedir. Kurum No KUN Sayı - Evet Tekil ürünün verildiği kurum/firmanın ÜTS de tanımlı numarasıdır. Verilen tekil ürünlerin bedelsiz numune olup olmadığını ifade etmektedir. Bedelsiz Numune BEN Tek Seçimli Liste 5 Hayır Aşağıdaki değerleri alabilir. Varsayılan değeri HAYIR dır. EVET: Evet HAYIR: Hayır Belge BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır Verme Bildirimi Örnek İstek "UNO" : " ", "LNO" : " ", "ADT" : 25, "KUN" : 7, "BEN" : "HAYIR", "BNO" : "123B" 24 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

25 Eşsiz Kimlik Bilgisi İle Verme Bildirimi Servis Adresi Gerçek Ortam: Test Ortamı: Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları Tablo 4. Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları Eşsiz Kimlik UDI Metin - Unique Device Identifier (UDI) ya da Karekod olarak da bilinen Tekil ürün eşsiz kimliği (Unique Device Identifier) ile bildirim yapılmak istendiğinde verilmesi gerekmektedir. Tekil takip edilen ürünler için verilmez. Adet ADT Sayı - Hayır aynı lot/seri/batch ten kaç tane alındığını ifade etmektedir. Verilen miktardan daha az sayıda tekil ürün alındığı durumda kullanılır. Varsayılan değeri verme bildirimindeki adet bilgisidir. Kurum No KUN Sayı - Evet Tekil ürünün verildiği kurum/firmanın ÜTS de tanımlı numarasıdır. Belge BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır Eşsiz Kimlik Bilgisi ile Verme Bildirimi Örnek İstek UDI : A213B , "KUN" : 7, "ADT" : 5, "BNO": "123" 25 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

26 3.1.4 Alma Bildirimi Kurum/firma kendisine verilen tekil ürünleri kabul etmek için Alma Bildirimi yapar. Bu bildirimle beraber tekil ürünün sahipliği alıcı tarafa geçmiş olur Alma Bildirimi Servis Adresi Gerçek Ortam: Test Ortamı: Alma Bildirimi Veri Alanları Tablo 5. Alma Bildirimi Veri Alanları Verme Bildirim ID VBI Sayı - Koşullu Hangi verme bildirimine karşılık olarak alım yapıldığını ifade eder. Tekil takip edilen ürünler için verilmez. Adet ADT Sayı - Hayır aynı lot/seri/batch ten kaç tane alındığını ifade etmektedir. Verilen miktardan daha az sayıda tekil ürün alındığı durumda kullanılır. Gönderen Kurum GKK Sayı - Koşullu Varsayılan değeri verme bildirimindeki adet bilgisidir. Bildirimi yapan kurumun ÜTS de tanımlı numarasıdır. Bir kurumda aynı tekil ürün bilgilerine sahip tekil ürünler için farklı kurumlardan verme bildirimi yapılmışsa, hangi kurumdan gelen verme bildirimine alma bildirimi yapılmak istendiğini belirtmek için gereklidir. Eşsiz Kimlik UDI Metin - Koşullu Bildirim kodu verilmediği durumda tekil ürün eşsiz kimliği (Unique Device Identifier) ile alma bildirimi yapılmak istendiğinde verilmesi gerekmektedir. 26 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

27 Ürünün ürün numarası/barkod numarasıdır. Ürün UNO Metin 23 Koşullu Bildirim kodu veya eşsiz kimlik verilmediği takdirde tekil ürün bilgileri ile alma yapılmak istendiğinde ürün numarası verilmelidir. Lot/Batch Seri/Sıra LNO Metin 20 Koşullu SNO Metin 20 Koşullu Bildirim kodu veya eşsiz kimlik verilmediği takdirde tekil ürün bilgileri ile alma yapılmak istendiğinde ürün numarası ile beraber verilmelidir. Bildirim kodu veya eşsiz kimlik verilmediği takdirde tekil ürün bilgileri ile alma yapılmak istendiğinde ürün numarası ile beraber verilmelidir. Tekil bazda takip edilen ürünler için Alma Bildirimi Örnek İstek Örnek 1 verme bildirimi ID ile yapılan alma bildirimi isteği: "VBI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29", "ADT" : 15 Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan alma bildirimi isteği: "UNO" : " ", "LNO" : " ", "ADT" : 5, GKK" : / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

28 Eşsiz Kimlik Bilgisi İle Alma Bildirimi Servis Adresi Gerçek Ortam: Test Ortamı: Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları Tablo 6. Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları Eşsiz Kimlik UDI Metin - Bildirim kodu verilmediği durumda tekil ürün eşsiz kimliği (Unique Device Identifier) ile alma bildirimi yapılmak istendiğinde verilmesi gerekmektedir. Tekil takip edilen ürünler için verilmez. Adet ADT Sayı - Hayır aynı lot/seri/batch ten kaç tane alındığını ifade etmektedir. Verilen miktardan daha az sayıda tekil ürün alındığı durumda kullanılır. Gönderen Kurum GKK Sayı - Hayır Varsayılan değeri verme bildirimindeki adet bilgisidir. Bildirimi yapan kurumun ÜTS de tanımlı numarasıdır. Bir kuruma aynı eşsiz kimlikli tekil ürün için farklı kurumlardan verme bildirimi yapılmışsa, hangi kurumdan gelen verme bildirmine alma bildirimi yapılmak istendiğini belirtmek için gereklidir Eşsiz Kimlik Bilgisi ile Alma Bildirimi Örnek İstek UDI : A213B , "ADT" : 5, "GKK" : / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

29 3.1.5 ÜTS de Tanımsız Yere Verme Bildirimi Kurum/firma ÜTS'de tanımlı olmayan bir firmaya tekil ürün verdiğinde ÜTS de Tanımsız Yere Verme Bildirimi yapar ÜTS de Tanımsız Yere Verme Bildirimi Servis Adresi Gerçek Ortam: Test Ortamı: ÜTS de Tanımsız Yere Verme Bildirimi Veri Alanları Tablo 7. ÜTS de Tanımsız Yere Verme Bildirimi Veri Alanları Ürün UNO Metin 23 Evet Ürünün ürün numarası/barkod numarasıdır. Lot/Batch Seri/Sıra LNO Metin 20 Koşullu SNO Metin 20 Koşullu Tekil bazda takip edilen ürünler için Tekil takip edilen ürünler için verilmez. Adet ADT Sayı - Koşullu aynı lot/seri/batch ten kaç tane verildiğini ifade etmektedir. Verilen tekil ürünlerin bedelsiz numune olup olmadığını ifade etmektedir. Bedelsiz Numune BEN Tek Seçimli Liste 5 Hayır Aşağıdaki değerleri alabilir. Varsayılan değeri HAYIR dır. EVET: Evet HAYIR: Hayır Vergi Kimlik No VKN Sayı - Evet ÜTS de kayıtlı olmayan firmanın vergi kimlik numarası girilmesi zorunludur. 29 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

30 Belge BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır ÜTS de Tanımsız Yere Verme Bildirimi Örnek İstek "UNO" : " ", "LNO" : " ", "ADT" : 25, "VKN" : " ", "BNO" : "123B", "BEN" : "HAYIR" Eşsiz Kimlik Bilgisi İle ÜTS de Tanımsız Yere Verme Bildirimi Servis Adresi Gerçek Ortam: Test Ortamı: Eşsiz Kimlik Bilgisi ile ÜTS de Tanımsız Yere Verme Bildirimi Veri Alanları Tablo 8. Eşsiz Kimlik Bilgisi ile ÜTS de Tanımsız Yere Verme Bildirimi Veri Alanları Eşsiz Kimlik UDI Metin - Tekil ürün eşsiz kimliği (Unique Device Identifier) ile bildirim yapılmak istendiğinde verilmesi gerekmektedir. Tekil takip edilen ürünler için verilmez. Adet ADT Sayı - Koşullu aynı lot/seri/batch ten kaç tane verildiğini ifade etmektedir. 30 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

31 Verilen tekil ürünlerin bedelsiz numune olup olmadığını ifade etmektedir. Bedelsiz Numune BEN Tek Seçimli Liste 5 Hayır Aşağıdaki değerleri alabilir. Varsayılan değeri HAYIR dır. EVET: Evet HAYIR: Hayır Vergi Kimlik No VKN Sayı - Evet MERSİS No MEN Sayı - Koşullu T.C. Kimlik No TKN Sayı - Koşullu Meslek MEK Sayı - Koşullu Oda ODK Sayı - Koşullu ÜTS de kayıtlı olmayan firmanın vergi kimlik numarası girilmesi zorunludur. Tekil ürünün MERSİS te tanımlı bir firmaya verilmesi durumunda verilmelidir. Tekil ürünün ESBİS te tanımlı bir firmaya verilmesi durumunda verilmelidir. Tekil ürünün ESBİS te tanımlı bir firmaya verilmesi durumunda verilmelidir. Tekil ürünün ESBİS te tanımlı bir firmaya verilmesi durumunda verilmelidir. Belge BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır Eşsiz Kimlik Bilgisi ile ÜTS de Tanımsız Yere Verme Bildirimi Örnek İstek UDI : A213B , "ADT" : 5, "VKN" : " ", "BNO" : "123B", "BEN" : "HAYIR" 31 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

32 3.1.6 ÜTS de Tanımsız Yerden İade Alma Bildirimi Kurum/firma ÜTS'de tanımlı olmayan bir firmaya verdiği tekil ürünlerini iade aldığında ÜTS de Tanımsız Yerden İade Alma Bildirimi yapar ÜTS de Tanımsız Yerden İade Alma Bildirimi Servis Adresi Gerçek Ortam: Test Ortamı: ÜTS de Tanımsız Yerden İade Alma Bildirimi Veri Alanları Tablo 9.ÜTS de Tanımsız Yerden İade Alma Bildirimi Veri Alanları ÜTS de Tanımsız Yere Verme Bildirim ID UTI Sayı - Koşullu ÜTS de tanımsız yerden iade alma bildiriminin hangi ÜTS de tanımsız yere verme bildirimi için yapıldığını ifade eder. Tekil takip edilen ürünler için verilmez. Adet ADT Sayı - Koşullu aynı lot/seri/batch ten kaç tane verildiğini ifade etmektedir. Eşsiz Kimlik UDI Metin - Koşullu Bildirim kodu verilmediği durumda tekil ürün eşsiz kimliği (Unique Device Identifier) ile alma bildirimi yapılmak istendiğinde verilmesi gerekmektedir. Ürünün ürün numarası/barkod numarasıdır. Ürün UNO Metin 23 Koşullu Bildirim kodu veya eşsiz kimlik verilmediği takdirde tekil ürün bilgileri ile iade alma yapılmak istendiğinde ürün numarası verilmelidir. 32 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

33 Lot/Batch Seri/Sıra LNO Metin 20 Koşullu SNO Metin 20 Koşullu Bildirim kodu veya eşsiz kimlik verilmediği takdirde tekil ürün bilgileri ile iade alma yapılmak istendiğinde ürün numarası ile beraber verilmelidir. Bildirim kodu veya eşsiz kimlik verilmediği takdirde tekil ürün bilgileri ile iade alma yapılmak istendiğinde ürün numarası ile beraber verilmelidir. Tekil bazda takip edilen ürünler için ÜTS de Tanımsız Yerden İade Alma Bildirimi Örnek İstek Örnek 1 ÜTS de tanımsız yere verme bildirim ID ile yapılan ÜTS de tanımsız yerden iade alma bildirimi isteği: "UTI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29", "ADT" : 15 Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan ÜTS de tanımsız yerden iade alma bildirimi isteği: "UNO" : " ", "LNO" : " ", "ADT" : Eşsiz Kimlik Bilgisi ile ÜTS de Tanımsız Yerden İade Alma Bildirimi Servis Adresi Gerçek Ortam: Test Ortamı: 33 / 146 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani