TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI Revizyon Numarası: 1.80 ÜTS Versiyon 7.19.x ile uyumludur.
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
Revizyon Numarası: 1.80
ÜTS Versiyon 7.19.x ile uyumludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
2 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
DEĞİŞİKLİK TARİHÇESİ
Rev. No Yayın Tarihi Yayın Nedeni
1.0.8 07/07/2015 İlk sürüm.
1.0.13 16/02/2016 Adı, aldığı parametreler ve dönüş veri yapısı değişen bildirimler güncellendi.
14/03/2016 Bildirimlerin aldığı parametrelerdeki eksiklikler giderildi.
Paket bildirimleri ve paket ile ilgili diğer servisler eklendi.
1.0.20 01/07/2016 REST adresleri güncellendi.
12/10/2016 Servisler, servis parametreleri ve servis mesajları güncellendi.
08/11/2016 Eksik olan sorgulama servisleri eklendi.
13/12/2016 Sorgulardan Barkod Kuruluşu alanı kaldırıldı. Eksik olan sorgulama servisleri eklendi.
1.0.26 20/12/2016 Medula – ÜTS entegrasyon servisleri eklendi. Eksik olan sorgulama servisleri ve mesajlar eklendi.
1.0.27 27/12/2016 Paket ile ilgili tüm servisler silindi.
1.0.28 09/02/2017 Sistem paketi servisleri eklendi.
1.0.30 15/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.
1.0.31 23/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ı.
1.0.33 24/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.
1.0.34 13/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ı.
1.0.35 21/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.
1.0.36 18/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ı.
1.0.37 23.11.2017 1) İmha/Bertaraf Bildiriminde zorunlu "İmha/Bertaraf Belge Numarası" alanı eklendi.
2) Ödünç Geri Verme Bildiriminde zorunlu alan olan "Kurum Numarası" (KUN) alanı kaldırıldı.
3) "Tüketiciye Verme İptal Bildirimi" geçen yerler "Tüketiciye Vermeyi İptal Bildirimi" olarak güncellendi.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
3 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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 JSON 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 Adı” (MME) eklendi. Kabul edilecek tekil ürün sorgularına “Gönderen Kurum Unvan” (GKU), “Marka Model Etiket Adı” (MME) eklendi. Tekil ürün sorgularına “Marka Model Etiket Adı” (MME) eklendi. Bildirim sorgularına “Bildiren Kurum Unvan” (BKU), “Diğer Kurum Unvan” (DKU), “Marka Model Etiket Adı” (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.
1.0.51 18/12/2017 Ürün Sorgulama servisi eklendi.
04/01/2018 1) Kullanım bildirimine “Kişi Tanımlayıcı Numara”, “Kişi Kimlik Bilgisi Açıklama Türü”
ve “Kişi Kimlik Bilgisi Diğer Tür Açıklaması” alanları eklendi.
2) Geçici kullanımına verme bildirimine “Kişi Tanımlayıcı Numara”, “Kişi Kimlik Bilgisi
Açıklama Türü” ve “Kişi Kimlik Bilgisi Diğer Tür Açıklaması” alanları eklendi.
3) Tüketiciye verme bildirimine “Kişi Tanımlayıcı Numara”, “Kişi Kimlik Bilgisi Açıklama
Türü” ve “Kişi Kimlik Bilgisi Diğer Tür Açıklaması” alanları eklendi.
4) Hastanın vücudundan çıkarma bildirimine “Kişi Tanımlayıcı Numara”, “Kişi Kimlik
Bilgisi Açıklama Türü” ve “Kişi Kimlik Bilgisi Diğer Tür Açıklaması” alanları eklendi.
1.0.56 09/02/2018 Tekil ürünün TİTUBB’da kaydının olup olmadığını sorgulayan servis eklendi.
1.0.57 02/05/2018 Bazı sorgulama servislerine, yeni sorgulama yapısı eklendi (Offset ile sorgulama).
Lot takipte kullanım bildiriminin 1 adetten fazla yapılamaması eklendi.
Paket servisleri güncellendi.
Yeni takip yapısına geçildi. Üretim ve İthalat bildirimi yaparken seri ve lot numarası
girilmesine göre takip kapsamı belirleniyor.
1.0.58 Ürün tanım servisleri eklendi.
1.0.59 26.06.2018 İthalat bildirimi servisinden, gümrük beyanname parametresi zorunluluğu kaldırıldı.
1.0.64 30.07.2018 Envanter bildirimi servis bilgileri eklendi, hata ve bilgi mesajları güncellendi.
1.0.68 30.09.2018 Stok bildirimi servis bilgileri eklendi, hata ve bilgi mesajları güncellendi.
Bildirim ve tekil ürün detay sorgulama servisi eklendi.
1.0.69 03.10.2018 Bütün Ürünleri Sorgulama Servisi’nin adresi güncellendi.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
4 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
1.0.70 27.10.2018 Stok bildiriminde Stok Tarihi “STT”, Üretim Tarihi “URT” olarak güncellendi.
1.0.72 31.10.2018 Stok bildiriminde Üretim Tarihi alanı zorunlu olarak güncellendi.
Verme Bildirimi Veri Alanlarına Gerçek İşlem Tarihi eklendi ve örnek istek güncellendi.
UTS-H171: Verilen tekil ürün bilgilerine uyan birden fazla bildirim bulundu hatası ile
ilgili istek ve cevap örneği eklendi.
1.0.74 08.11.2018 Kullanım bildiriminde TUA, TUS olan tüketici parametreleri HAA, HAS olarak
güncellendi. Hata mesajları güncellendi.
1.0.75 04.12.2018 UTS-H171: Verilen tekil ürün bilgilerine uyan birden fazla bildirim bulundu hatası ile
ilgili istek ve cevap örneği güncellendi. Cevap örneğine BNO parametresi ile belge
numarası eklendi.
1.0.76 11.12.2018 Hasta/Tüketici bilgileri girişi sırasında seçilen Kimlik Bilgisi Açıklama Türü alanına
YUPASS Numarası Var seçeneği eklendi.
1.0.78 20.12.2018 Bütün Ürünleri Sorgulama Servisi ürün bilgisi dönüş değerlerine “Takip Durumu”
eklendi.
1.0.79 24.12.2018 Eksik alma bildirimini görüntüleme ve güncelleme ile ilgili dokümantasyon eklendi.
1.0.80 10.01.2019 Tekil ürün bilgilerini girerek Kabul Edilecek Tekil Ürünleri sorgulayan servis adresi, istek
ve cevap alanları eklendi.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
5 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
İÇİNDEKİLER
1 GİRİŞ ........................................................................................................................................................ 18
1.1 AMAÇ ........................................................................................................................................................ 18
1.2 KAPSAM ................................................................................................................................................... 18
1.3 TERİMLER VE KISALTMALAR ................................................................................................................ 18
2 WEB SERVİSLERİN GENEL YAPISI ...................................................................................................... 19
2.1 ÜTS’NİN DİĞER BİLGİ SİSTEMLERİ İLE ENTEGRASYONU ................................................................. 19
3 WEB SERVİSLER .................................................................................................................................... 20
3.1 HAREKET BİLDİRİM SERVİSLERİ .......................................................................................................... 20
3.1.1.1 Üretim Bildirimi Servis Adresi.................................................................................................................... 20
3.1.1.2 Üretim Bildirimi Veri Alanları ..................................................................................................................... 20
3.1.1.3 Üretim Bildirimi Örnek İstek ...................................................................................................................... 22
3.1.2.1 İthalat Bildirimi Servis Adresi .................................................................................................................... 23
3.1.2.2 İthalat Bildirimi Veri Alanları ...................................................................................................................... 23
3.1.2.3 İthalat Bildirimi Örnek İstek ....................................................................................................................... 25
3.1.3.1 Verme Bildirimi Servis Adresi.................................................................................................................... 27
3.1.3.2 Verme Bildirimi Örnek İstek ...................................................................................................................... 28
3.1.3.3 Eşsiz Kimlik Bilgisi İle Verme Bildirimi Servis Adresi ................................................................................ 29
3.1.3.4 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları .................................................................................. 29
3.1.3.5 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Örnek İstek ................................................................................... 30
3.1.4.1 Alma Bildirimi Servis Adresi ...................................................................................................................... 30
3.1.4.2 Alma Bildirimi Veri Alanları........................................................................................................................ 30
3.1.4.3 Alma Bildirimi Örnek İstek ......................................................................................................................... 32
3.1.4.4 Eşsiz Kimlik Bilgisi İle Alma Bildirimi Servis Adresi .................................................................................. 33
3.1.4.5 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları .................................................................................... 33
3.1.4.6 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Örnek İstek ..................................................................................... 34
3.1.5.1 ÜTS’de Tanımsız Yere Verme Bildirimi Servis Adresi .............................................................................. 34
3.1.5.2 ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ............................................................................... 34
3.1.5.3 ÜTS’de Tanımsız Yere Verme Bildirimi Örnek İstek ................................................................................. 35
3.1.5.4 Eşsiz Kimlik Bilgisi İle ÜTS’de Tanımsız Yere Verme Bildirimi Servis Adresi .......................................... 36
3.1.5.5 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ............................................ 36
3.1.5.6 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Örnek İstek ............................................. 37
3.1.6.1 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Servis Adresi .................................................................... 37
3.1.1 ÜRETİM BİLDİRİMİ ........................................................................................................................................ 20
3.1.2 İTHALAT BİLDİRİMİ........................................................................................................................................ 23
3.1.3 VERME BİLDİRİMİ ......................................................................................................................................... 27
3.1.4 ALMA BİLDİRİMİ ........................................................................................................................................... 30
3.1.5 ÜTS’DE TANIMSIZ YERE VERME BİLDİRİMİ .................................................................................................... 34
3.1.6 ÜTS’DE TANIMSIZ YERDEN İADE ALMA BİLDİRİMİ .......................................................................................... 37
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
6 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.6.2 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları ...................................................................... 37
3.1.6.3 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Örnek İstek ....................................................................... 39
3.1.6.4 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Servis Adresi ................................. 39
3.1.6.5 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları .................................. 39
3.1.6.6 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Örnek İstek .................................... 40
3.1.7.1 Kullanım Bildirimi Servis Adresi ................................................................................................................ 40
3.1.7.2 Kullanım Bildirimi Veri Alanları .................................................................................................................. 40
3.1.7.3 Kullanım Bildirimi Örnek İstek ................................................................................................................... 42
3.1.7.4 Eşsiz Kimlik Bilgisi İle Kullanım Bildirimi Servis Adresi ............................................................................ 43
3.1.7.5 Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları .............................................................................. 43
3.1.7.6 Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Örnek İstek ............................................................................... 44
3.1.8.1 Tüketiciye Verme Bildirimi Servis Adresi .................................................................................................. 45
3.1.8.2 Tüketiciye Verme Bildirimi Veri Alanları .................................................................................................... 45
3.1.8.3 Tüketiciye Verme Bildirimi Örnek İstek ..................................................................................................... 47
3.1.8.4 Eşsiz Kimlik Bilgisi İle Tüketiciye Verme Bildirimi Bildirimi Servis Adresi ................................................. 47
3.1.8.5 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Bildirimi Veri Alanları ................................................... 47
3.1.8.6 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Örnek İstek .................................................................. 49
3.1.9.1 Tüketiciden İade Alma Bildirimi Servis Adresi .......................................................................................... 50
3.1.9.2 Tüketiciden İade Alma Bildirimi Veri Alanları ............................................................................................ 50
3.1.9.3 Tüketiciden İade Alma Bildirimi Örnek İstek ............................................................................................. 51
3.1.9.4 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Servis Adresi ....................................................... 52
3.1.9.5 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları......................................................... 52
3.1.9.6 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Örnek İstek .......................................................... 53
3.1.10.1 Geçici Kullanıma Verme Bildirimi Servis Adresi ....................................................................................... 53
3.1.10.2 Geçici Kullanıma Verme Bildirimi Veri Alanları ......................................................................................... 53
3.1.10.3 Geçici Kullanıma Verme Bildirimi Örnek İstek .......................................................................................... 55
3.1.10.4 Eşsiz Kimlik Bilgisi İle Geçici Kullanıma Verme Bildirimi Servis Adresi .................................................... 55
3.1.10.5 Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları ..................................................... 56
3.1.10.6 Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Örnek İstek ....................................................... 57
3.1.11.1 Kullanımdan Alma Bildirimi Servis Adresi ................................................................................................. 58
3.1.11.2 Kullanımdan Alma Bildirimi Veri Alanları .................................................................................................. 58
3.1.11.3 Kullanımdan Alma Bildirimi Örnek İstek .................................................................................................... 59
3.1.11.4 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Servis Adresi ............................................................. 59
3.1.11.5 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları ............................................................... 59
3.1.7 KULLANIM BİLDİRİMİ ..................................................................................................................................... 40
3.1.8 TÜKETİCİYE VERME BİLDİRİMİ....................................................................................................................... 45
3.1.9 TÜKETİCİDEN İADE ALMA BİLDİRİMİ ............................................................................................................... 50
3.1.10 GEÇİCİ KULLANIMA VERME BİLDİRİMİ ............................................................................................................ 53
3.1.11 KULLANIMDAN ALMA BİLDİRİMİ ..................................................................................................................... 57
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
7 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.11.6 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Örnek İstek ................................................................ 60
3.1.12.1 Yeniden İşleme Bildirimi Servis Adresi ..................................................................................................... 60
3.1.12.2 Yeniden İşleme Bildirimi Veri Alanları ....................................................................................................... 60
3.1.12.3 Yeniden İşleme Bildirimi Örnek İstek ........................................................................................................ 61
3.1.12.4 Eşsiz Kimlik Bilgisi İle Yeniden İşleme Bildirimi Servis Adresi .................................................................. 61
3.1.12.5 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları ................................................................... 61
3.1.12.6 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Örnek İstek ..................................................................... 62
3.1.13.1 İhracat Bildirimi Servis Adresi ................................................................................................................... 62
3.1.13.2 İhracat Bildirimi Veri Alanları ..................................................................................................................... 62
3.1.13.3 İhracat Bildirimi Örnek İstek ...................................................................................................................... 63
3.1.13.4 Eşsiz Kimlik Bilgisi İle İhracat Bildirimi Servis Adresi ............................................................................... 63
3.1.13.5 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları ................................................................................. 63
3.1.13.6 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Örnek İstek .................................................................................. 64
3.1.14.1 Mahrecine İade Etme Bildirimi Servis Adresi ............................................................................................ 64
3.1.14.2 Mahrecine İade Etme Bildirimi Veri Alanları ............................................................................................. 65
3.1.14.3 Mahrecine İade Etme Bildirimi Örnek İstek ............................................................................................... 65
3.1.14.4 Eşsiz Kimlik Bilgisi İle Mahrecine İade Etme Bildirimi Servis Adresi ........................................................ 65
3.1.14.5 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları .......................................................... 65
3.1.14.6 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Örnek İstek ........................................................... 66
3.1.15.1 HEK / Zayiat Bildirimi Servis Adresi .......................................................................................................... 66
3.1.15.2 HEK / Zayiat Bildirimi Veri Alanları ........................................................................................................... 66
3.1.15.3 HEK / Zayiat Bildirimi Örnek İstek ............................................................................................................. 67
3.1.15.4 Eşsiz Kimlik Bilgisi İle HEK / Zayiat Bildirimi Servis Adresi ...................................................................... 68
3.1.15.5 Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları ........................................................................ 68
3.1.15.6 Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Örnek İstek ......................................................................... 68
3.1.16.1 Geri Çekme Verme Bildirimi Servis Adresi ............................................................................................... 69
3.1.16.2 Geri Çekme Verme Bildirimi Veri Alanları ................................................................................................. 69
3.1.16.3 Geri Çekme Verme Bildirimi Örnek İstek .................................................................................................. 69
3.1.16.4 Eşsiz Kimlik Bilgisi İle Geri Çekme Verme Bildirimi Servis Adresi ............................................................ 70
3.1.16.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları ............................................................. 70
3.1.16.6 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Örnek İstek............................................................... 70
3.1.17.1 Geri Çekme Alma Bildirimi Servis Adresi .................................................................................................. 71
3.1.17.2 Geri Çekme Alma Bildirimi Veri Alanları ................................................................................................... 71
3.1.12 YENİDEN İŞLEME BİLDİRİMİ ........................................................................................................................... 60
3.1.13 İHRACAT BİLDİRİMİ ....................................................................................................................................... 62
3.1.14 MAHRECİNE İADE ETME BİLDİRİMİ................................................................................................................. 64
3.1.15 HEK / ZAYİAT BİLDİRİMİ ............................................................................................................................... 66
3.1.16 GERİ ÇEKME VERME BİLDİRİMİ ..................................................................................................................... 69
3.1.17 GERİ ÇEKME ALMA BİLDİRİMİ ....................................................................................................................... 70
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
8 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.17.3 Geri Çekme Alma Bildirimi Örnek İstek .................................................................................................... 72
3.1.17.4 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Servis Adresi .............................................................. 73
3.1.17.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları ................................................................ 73
3.1.17.3 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Örnek İstek ................................................................. 73
3.1.18.1 Islah / Düzeltici Faaliyet Bildirimi Servis Adresi ........................................................................................ 74
3.1.18.2 Islah / Düzeltici Faaliyet Bildirimi Veri Alanları .......................................................................................... 74
3.1.18.3 Islah / Düzeltici Faaliyet Bildirimi Örnek İstek ........................................................................................... 74
3.1.18.4 Eşsiz Kimlik Bilgisi İle Islah / Düzeltici Faaliyet Bildirimi Servis Adresi .................................................... 75
3.1.18.5 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları ...................................................... 75
3.1.18.6 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Örnek İstek........................................................ 75
3.1.19.1 İmha / Bertaraf Bildirimi Servis Adresi ...................................................................................................... 75
3.1.19.2 İmha / Bertaraf Bildirimi Veri Alanları ........................................................................................................ 76
3.1.19.3 İmha / Bertaraf Bildirimi Örnek İstek ......................................................................................................... 77
3.1.19.4 Eşsiz Kimlik Bilgisi İle İmha / Bertaraf Bildirimi Servis Adresi ................................................................... 77
3.1.19.5 Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları .................................................................... 77
3.1.19.6 Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Örnek İstek ...................................................................... 78
3.1.20.1 Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi ............................................................................ 79
3.1.20.2 Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları ............................................................................. 79
3.1.20.3 Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek .............................................................................. 81
3.1.20.4 Eşsiz Kimlik Bilgisi İle Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi ........................................ 81
3.1.20.5 Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları .......................................... 81
3.1.20.6 Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek ........................................... 83
3.1.21.1 Ödünç Verme Bildirimi Servis Adresi ........................................................................................................ 84
3.1.21.2 Ödünç Verme Bildirimi Veri Alanları ......................................................................................................... 84
3.1.21.3 Ödünç Verme Bildirimi Örnek İstek ........................................................................................................... 84
3.1.21.4 Eşsiz Kimlik Bilgisi İle Ödünç Verme Bildirimi Servis Adresi .................................................................... 85
3.1.21.5 Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Veri Alanları ...................................................................... 85
3.1.21.6 Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Örnek İstek ....................................................................... 85
3.1.22.1 Ödünç Alma Bildirimi Servis Adresi .......................................................................................................... 86
3.1.22.2 Ödünç Alma Bildirimi Veri Alanları ............................................................................................................ 86
3.1.22.3 Ödünç Alma Bildirimi Örnek İstek ............................................................................................................. 87
3.1.22.4 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Servis Adresi ....................................................................... 87
3.1.22.5 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Veri Alanları ........................................................................ 87
3.1.22.6 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Örnek İstek .......................................................................... 88
3.1.18 ISLAH / DÜZELTİCİ FAALİYET BİLDİRİMİ .......................................................................................................... 74
3.1.19 İMHA / BERTARAF BİLDİRİMİ .......................................................................................................................... 75
3.1.20 HASTANIN VÜCUDUNDAN ÇIKARMA BİLDİRİMİ ................................................................................................ 79
3.1.21 ÖDÜNÇ VERME BİLDİRİMİ ............................................................................................................................. 84
3.1.22 ÖDÜNÇ ALMA BİLDİRİMİ ............................................................................................................................... 86
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
9 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.23.1 Ödünç Geri Verme Bildirimi Servis Adresi ................................................................................................ 88
3.1.23.2 Ödünç Geri Verme Bildirimi Veri Alanları .................................................................................................. 89
3.1.23.3 Ödünç Geri Verme Bildirimi Örnek İstek ................................................................................................... 89
3.1.23.4 Eşsiz Kimlik Bilgisi İle Ödünç Geri Verme Bildirimi Servis Adresi ............................................................ 89
3.1.23.5 Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Veri Alanları .............................................................. 89
3.1.23.6 Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Örnek İstek ............................................................... 90
3.1.24.1 Ödünç Geri Alma Bildirimi Servis Adresi .................................................................................................. 90
3.1.24.2 Ödünç Geri Alma Bildirimi Veri Alanları .................................................................................................... 90
3.1.24.3 Ödünç Geri Alma Bildirimi Örnek İstek ..................................................................................................... 92
3.1.24.4 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Servis Adresi ............................................................... 92
3.1.24.5 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Veri Alanları ................................................................. 92
3.1.24.6 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Örnek İstek .................................................................. 93
3.1.25.1 Envanter Bildirimi Servis Adresi ................................................................................................................ 93
3.1.25.2 Envanter Bildirimi Veri Alanları ................................................................................................................. 93
3.1.25.3 Envanter Bildirimi Örnek İstek .................................................................................................................. 94
3.1.26.1 Stok Bildirimi Servis Adresi ....................................................................................................................... 94
3.1.26.2 Stok Bildirimi Veri Alanları......................................................................................................................... 94
3.1.26.3 Stok Bildirimi Örnek İstek .......................................................................................................................... 95
3.2 İPTAL BİLDİRİMLERİ ............................................................................................................................... 96
3.2.1.1 İptal Bildirimi Veri Alanları ......................................................................................................................... 98
3.2.1.2 İptal Bildirimleri Örnek İstek ...................................................................................................................... 98
3.3 BİLDİRİM CEVABI .................................................................................................................................... 98
3.4 SORGULAMA SERVİSLERİ ..................................................................................................................... 99
3.4.1.1 Tekil Ürün Sorgula Servis Adresi .............................................................................................................. 99
3.4.1.2 Tekil Ürün Sorgula İstek Veri Alanları ....................................................................................................... 99
3.4.1.3 Tekil Ürün Sorgula Cevap Veri Alanları .................................................................................................. 100
3.4.1.4 Tekil Ürün Sorgula Örnek İstek ............................................................................................................... 102
3.4.1.5 Eşsiz Kimlik Bilgisi ile Tekil Ürün Sorgula Servis Adresi ........................................................................ 102
3.4.1.6 Eşsiz Kimlik İle Tekil Ürün Sorgula İstek Veri Alanları ............................................................................ 102
3.4.1.7 Eşsiz Kimlik İle Tekil Ürün Sorgula Örnek İstek ..................................................................................... 102
3.4.2.1 Üretici/İthalatçı Tekil Ürün Sorgula Servis Adresi ................................................................................... 102
3.1.23 ÖDÜNÇ GERİ VERME BİLDİRİMİ .................................................................................................................... 88
3.1.24 ÖDÜNÇ GERİ ALMA BİLDİRİMİ ....................................................................................................................... 90
3.1.25 ENVANTER BİLDİRİMİ ................................................................................................................................... 93
3.1.26 STOK BİLDİRİMİ ........................................................................................................................................... 94
3.2.1 İPTAL BİLDİRİMLERİ SERVİS ADRESLERİ ........................................................................................................ 96
3.3.1 BİLDİRİM CEVABI VERİ ALANLARI .................................................................................................................. 98
3.4.1 TEKİL ÜRÜN SORGULA ................................................................................................................................. 99
3.4.2 ÜRETİCİ/İTHALATÇI TEKİL ÜRÜN SORGULA .................................................................................................. 102
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
10 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.2.2 Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları ............................................................................ 103
3.4.2.3 Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları ......................................................................... 103
3.4.2.4 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek ...................................................................................... 105
3.4.3.1 Üretici/İthalatçı Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ................................... 105
3.4.3.2 Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ............................ 105
3.4.3.3 Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ......................... 106
3.4.3.4 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ........................... 108
3.4.3.5 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) ..................................... 108
3.4.4.1 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Servis Adresi ............................................ 109
3.4.4.2 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları ..................................... 109
3.4.4.3 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları .................................. 109
3.4.4.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek ............................................... 113
3.4.5.1 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi
ile) 113
3.4.5.2 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi
ile) 113
3.4.5.3 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi
ile) 114
3.4.5.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi ADT)
ile) 117
3.4.5.5 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF)
ile) 118
3.4.6.1 Askıdaki Tekil Ürün Sorgula Servis Adresi ............................................................................................. 118
3.4.6.2 Askıdaki Tekil Ürün Sorgula İstek Veri Alanları ...................................................................................... 118
3.4.6.3 Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları ................................................................................... 119
3.4.6.4 Askıdaki Tekil Ürün Sorgula Örnek İstek ................................................................................................ 121
3.4.7.1 Askıdaki Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ............................................. 121
3.4.7.2 Askıdaki Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ...................................... 121
3.4.7.3 Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ................................... 122
3.4.7.4 Askıdaki Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ..................................... 123
3.4.7.5 Askıdaki Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) ............................................... 124
3.4.8.1 Ödünç Alınan Tekil Ürün Sorgula Servis Adresi ..................................................................................... 124
3.4.8.2 Ödünç Alınan Tekil Ürün Sorgula İstek Veri Alanları .............................................................................. 124
3.4.3 ÜRETİCİ/İTHALATÇI TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) ................................................ 105
3.4.4 ÜRETİCİ/İTHALATÇI SİSTEMİN DIŞINA ÇIKMIŞ TEKİL ÜRÜN SORGULA ............................................................ 109
3.4.5 ÜRETİCİ/İTHALATÇI SİSTEMİN DIŞINA ÇIKMIŞ TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .......... 113
3.4.6 ASKIDAKİ TEKİL ÜRÜN SORGULA ................................................................................................................ 118
3.4.7 ASKIDAKİ TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .............................................................. 121
3.4.8 ÖDÜNÇ ALINAN TEKİL ÜRÜN SORGULA ....................................................................................................... 124
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
11 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.8.3 Ödünç Alınan Tekil Ürün Sorgula Cevap Veri Alanları ........................................................................... 125
3.4.8.4 Ödünç Alınan Tekil Ürün Sorgula Örnek İstek ........................................................................................ 127
3.4.9.1 Bildirim Sorgula Servis Adresi ................................................................................................................ 127
3.4.9.2 Bildirim Sorgula İstek Veri Alanları ......................................................................................................... 127
3.4.9.3 Bildirim Sorgula Cevap Veri Alanları ....................................................................................................... 128
3.4.9.4 Bildirim Sorgula Örnek İstek ................................................................................................................... 132
3.4.10.1 Bildirim Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ................................................................. 132
3.4.10.2 Bildirim Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile).......................................................... 132
3.4.10.3 Bildirim Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ....................................................... 133
3.4.10.4 Bildirim Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ......................................................... 137
3.4.10.5 Bildirim Sorgula Örnek İstek (Offset Parametresi (OFF) ile) .................................................................. 138
3.4.11.1 Kabul Edilecek Tekil Ürün Sorgula Servis Adresi ................................................................................... 138
3.4.11.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları ............................................................................ 138
3.4.11.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları ......................................................................... 138
3.4.11.4 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek ...................................................................................... 140
3.4.12.1 Kabul Edilecek Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ................................... 140
3.4.12.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ............................ 141
3.4.12.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ......................... 141
3.4.12.4 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ........................... 143
3.4.12.5 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) ..................................... 143
3.4.13.1 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Servis Adresi ................................................ 144
3.4.13.2 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları ......................................... 144
3.4.13.3 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları ...................................... 144
3.4.13.4 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Örnek İstek ve Cevap ................................... 146
3.4.14.1 Ödünç Alınacak Tekil Ürün Sorgula Servis Adresi ................................................................................. 147
3.4.14.2 Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları .......................................................................... 147
3.4.14.3 Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları ....................................................................... 148
3.4.14.4 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek .................................................................................... 150
3.4.15.1 Ödünç Alınacak Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ................................. 150
3.4.15.2 Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) .......................... 150
3.4.15.3 Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)........................ 151
3.4.15.4 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile).......................... 153
3.4.9 BİLDİRİM SORGULA .................................................................................................................................... 127
3.4.10 BİLDİRİM SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .................................................................................. 132
3.4.11 KABUL EDİLECEK TEKİL ÜRÜN SORGULA .................................................................................................... 138
3.4.12 KABUL EDİLECEK TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .................................................. 140
3.4.13 TEKİL ÜRÜN BİLGİLERİ İLE KABUL EDİLECEK TEKİL ÜRÜN SORGULA ............................................................. 144
3.4.14 ÖDÜNÇ ALINACAK TEKİL ÜRÜN SORGULA ................................................................................................... 147
3.4.15 ÖDÜNÇ ALINACAK TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) ................................................. 150
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
12 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.15.5 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) ................................... 153
3.4.16.1 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Servis Adresi ............................................................ 154
3.4.16.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları ..................................................... 154
3.4.16.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları .................................................. 154
3.4.16.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula ................................................................................... 156
3.4.17.1 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ............ 156
3.4.17.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ..... 156
3.4.17.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)... 157
3.4.17.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula (Kayıt Sayısı Parametresi (ADT) ile) ........................ 159
3.4.17.5 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) .............. 159
3.4.18.1 Tekil Ürünün Kaynağını Sorgula Servis Adresi....................................................................................... 159
3.4.18.2 Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları ............................................................................... 159
3.4.18.3 Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları ............................................................................. 160
3.4.18.4 Tekil Ürünün Kaynağını Sorgula Örnek İstek ......................................................................................... 161
3.4.19.1 Bildirim ve Tekil Ürün Detay Sorgula Servis Adresi ................................................................................ 161
3.4.19.2 Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları ......................................................................... 161
3.4.19.3 Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları ...................................................................... 161
3.4.19.4 Bildirim ve Tekil Ürün Detay Sorgula Örnek İstek................................................................................... 169
3.4.19.5 Bildirim ve Tekil Ürün Detay Sorgula Örnek Cevap ................................................................................ 169
3.4.20.1 Eksik Alma Bildirimlerini Görüntüle ......................................................................................................... 170
3.4.20.2 Eksik Alma Bildiriminin Görülme Durumunu Güncelle ............................................................................ 173
3.5 PAKET TRANSFER SİSTEMİ (PTS) SERVİSLERİ ................................................................................ 174
3.5.1.1 Paket Ekle Servis Adresi ......................................................................................................................... 174
3.5.1.2 Paket Ekle İstek Veri Alanları.................................................................................................................. 174
3.5.1.3 Paket Ekle Cevap Veri Alanları ............................................................................................................... 175
3.5.1.4 Paket Ekle Örnek İstek ........................................................................................................................... 176
3.5.2.1 Paket Sil Servis Adresi ............................................................................................................................ 177
3.5.2.2 Paket Sil İstek Veri Alanları..................................................................................................................... 177
3.5.2.3 Paket Sil Cevap Veri Alanları .................................................................................................................. 177
3.5.2.4 Paket Sil Örnek İstek .............................................................................................................................. 178
3.5.3.1 Paket Getir Servis Adresi ........................................................................................................................ 178
3.4.16 KABUL EDİLECEK GERİ ÇEKİLMİŞ TEKİL ÜRÜN SORGULA ............................................................................. 154
3.4.17 KABUL EDİLECEK GERİ ÇEKİLMİŞ TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) ........................... 156
3.4.18 TEKİL ÜRÜNÜN KAYNAĞINI SORGULA ......................................................................................................... 159
3.4.19 BİLDİRİM VE TEKİL ÜRÜN DETAY SORGULA ................................................................................................. 161
3.4.20 EKSİK ALMA BİLDİRİMİ ............................................................................................................................... 170
3.5.1 PAKET EKLE .............................................................................................................................................. 174
3.5.2 PAKET SİL ................................................................................................................................................. 177
3.5.3 PAKET GETİR ............................................................................................................................................ 178
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
13 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.5.3.2 Paket Getir İstek Veri Alanları ................................................................................................................. 178
3.5.3.3 Paket Getir Cevap Veri Alanları .............................................................................................................. 179
3.5.3.4 Paket Getir Örnek İstek ........................................................................................................................... 180
3.5.4.1 Kuruma Gelen Paketi Okundu İşaretle Servis Adresi ............................................................................. 180
3.5.4.2 Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları ...................................................................... 180
3.5.4.3 Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları ................................................................... 181
3.5.4.4 Kuruma Gelen Paketi Okundu İşaretle Örnek İstek ................................................................................ 181
3.5.5.1 Kuruma Gelen Paketi Getir Servis Adresi ............................................................................................... 182
3.5.5.2 Kuruma Gelen Paketi Getir İstek Veri Alanları........................................................................................ 182
3.5.5.3 Kuruma Gelen Paketi Getir Cevap Veri Alanları ..................................................................................... 182
3.5.5.4 Kuruma Gelen Paketi Getir Örnek İstek ................................................................................................. 183
3.5.6.1 Kuruma Gelen Paketleri Sorgula Servis Adresi ...................................................................................... 183
3.5.6.2 Kuruma Gelen Paketleri Sorgula İstek Veri Alanları ............................................................................... 184
3.5.6.3 Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları ............................................................................ 184
3.5.6.4 Kuruma Gelen Paketleri Sorgula Örnek İstek ......................................................................................... 185
3.6 FİRMA SORGULAMA SERVİSİ .............................................................................................................. 186
3.7 ÜRÜN SORGULAMA SERVİSİ .............................................................................................................. 187
3.8 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİSİ ......................................................................................... 192
4 EKLER .................................................................................................................................................... 196
4.1 EK-A SERVİS MESAJLARI .................................................................................................................... 196
3.5.4 KURUMA GELEN PAKETİ OKUNDU İŞARETLE................................................................................................ 180
3.5.5 KURUMA GELEN PAKETİ GETİR .................................................................................................................. 182
3.5.6 KURUMA GELEN PAKETLERİ SORGULA ....................................................................................................... 183
3.6.1 FİRMA SORGULAMA SERVİS ADRESİ ........................................................................................................... 186
3.6.2 FİRMA SORGULAMA SERVİSİ VERİ ALANLARI ............................................................................................... 186
3.6.3 ÜRÜN SORGULAMA SERVİSİ ÖRNEK İSTEK .................................................................................................. 187
3.7.1 ÜRÜN SORGULAMA SERVİS ADRESİ ............................................................................................................ 188
3.7.2 ÜRÜN SORGULAMA SERVİSİ VERİ ALANLARI ............................................................................................... 188
3.7.3 ÜRÜN SORGULAMA SERVİSİ ÖRNEK İSTEK .................................................................................................. 191
3.8.1 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİS ADRESİ .......................................................................................... 192
3.8.2 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİSİ VERİ ALANLARI .............................................................................. 192
3.8.3 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİSİ ÖRNEK İSTEK ................................................................................ 194
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
14 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
TABLOLAR
Tablo 1. Üretim Bildirimi Veri Alanları ...................................................................................................................... 20
Tablo 2. İthalat Bildirimi Veri Alanları....................................................................................................................... 23
Tablo 3. Verme Bildirimi Veri Alanları ...................................................................................................................... 27
Tablo 4. Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları .................................................................................. 29
Tablo 5. Alma Bildirimi Veri Alanları ........................................................................................................................ 30
Tablo 6. Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları ..................................................................................... 33
Tablo 7 . ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ............................................................................... 34
Tablo 8. Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ............................................. 36
Tablo 9 .ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları ...................................................................... 37
Tablo 10. Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları ................................. 39
Tablo 11.Kullanım Bildirimi Veri Alanları ................................................................................................................. 40
Tablo 12. Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları ............................................................................. 43
Tablo 13 .Tüketiciye Verme Bildirimi Veri Alanları .................................................................................................. 45
Tablo 14. Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Veri Alanları ............................................................... 48
Tablo 15 .Tüketiciden İade Alma Bildirimi Veri Alanları........................................................................................... 50
Tablo 16. Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları ....................................................... 52
Tablo 17 . Geçici Kullanıma Verme Bildirimi Veri Alanları ...................................................................................... 53
Tablo 18. Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları .................................................... 56
Tablo 19 . Kullanımdan Alma Bildirimi Veri Alanları ................................................................................................ 58
Tablo 20 . Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları............................................................. 59
Tablo 21. Yeniden İşleme Bildirimi Veri Alanları ..................................................................................................... 60
Tablo 22. Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları .................................................................. 61
Tablo 23 . İhracat Bildirimi Veri Alanları .................................................................................................................. 62
Tablo 24. Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları ................................................................................ 63
Tablo 25 . Mahrecine İade Etme Bildirimi Veri Alanları ........................................................................................... 65
Tablo 26. Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları ........................................................ 65
Tablo 27 .HEK / Zayiat Bildirimi Veri Alanları .......................................................................................................... 66
Tablo 28. Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları ....................................................................... 68
Tablo 29. Geri Çekme Verme Bildirimi Veri Alanları ............................................................................................... 69
Tablo 30. Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları ............................................................ 70
Tablo 31. Geri Çekme Alma Bildirimi Veri Alanları .................................................................................................. 71
Tablo 32. Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları .............................................................. 73
Tablo 33 .Islah / Düzeltici Faaliyet Bildirimi Veri Alanları ........................................................................................ 74
Tablo 34. Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları ..................................................... 75
Tablo 35 . İmha / Bertaraf Bildirimi Veri Alanları ..................................................................................................... 76
Tablo 36. Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları ................................................................... 77
Tablo 37 . Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları ........................................................................... 79
Tablo 38. Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları ........................................ 81
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
15 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Tablo 39 . Ödünç Verme Bildirimi Veri Alanları ....................................................................................................... 84
Tablo 40. Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Veri Alanları ..................................................................... 85
Tablo 41. Ödünç Alma Bildirimi Veri Alanları .......................................................................................................... 86
Tablo 42. Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Veri Alanları ....................................................................... 87
Tablo 43. Ödünç Geri Verme Bildirimi Veri Alanları ................................................................................................ 89
Tablo 44. Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Veri Alanları ............................................................. 89
Tablo 45. Ödünç Geri Alma Bildirimi Veri Alanları ................................................................................................... 90
Tablo 46. Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Veri Alanları ............................................................... 92
Tablo 47. Envanter Bildirimi Veri Alanları ................................................................................................................ 93
Tablo 48. Stok Bildirimi Veri Alanları ....................................................................................................................... 94
Tablo 49. İptal Bildirimleri Servis Adresleri .............................................................................................................. 96
Tablo 50. İptal Bildirimi Veri Alanları........................................................................................................................ 98
Tablo 51. Bildirim Cevabı Veri Alanları .................................................................................................................... 98
Tablo 52. Tekil Ürün Sorgula İstek Veri Alanları ..................................................................................................... 99
Tablo 53. Tekil Ürün Sorgula Cevap Veri Alanları ................................................................................................. 100
Tablo 54. Eşsiz Kimlik ile Tekil Ürün Sorgula İstek Veri Alanları .......................................................................... 102
Tablo 55. Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları .......................................................................... 103
Tablo 56. Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları ........................................................................ 103
Tablo 57. Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) .......................... 105
Tablo 58. Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ........................ 106
Tablo 59. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları .................................... 109
Tablo 60. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları ................................. 109
Tablo 61. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi
ile) .......................................................................................................................................................................... 113
Tablo 62. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi
ile) .......................................................................................................................................................................... 114
Tablo 63. Askıdaki Tekil Ürün Sorgula İstek Veri Alanları ..................................................................................... 118
Tablo 64. Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları .................................................................................. 119
Tablo 65. Askıdaki Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ..................................... 121
Tablo 66. Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) .................................. 122
Tablo 67. Ödünç Alınan Tekil Ürün Sorgula İstek Veri Alanları ........................................................................... 124
Tablo 68. Ödünç Alınan Tekil Ürün Sorgula Cevap Veri Alanları .......................................................................... 125
Tablo 69. Bildirim Sorgula İstek Veri Alanları ........................................................................................................ 127
Tablo 70. Bildirim Sorgula Cevap Veri Alanları ..................................................................................................... 128
Tablo 71. Bildirim Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ........................................................ 132
Tablo 72. Bildirim Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ..................................................... 133
Tablo 73. Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları .......................................................................... 138
Tablo 74. Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları ........................................................................ 138
Tablo 75. Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) .......................... 141
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
16 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Tablo 76. Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ........................ 141
Tablo 77. Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları ........................................ 144
Tablo 78. Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları .................................... 145
Tablo 79. Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları ......................................................................... 147
Tablo 80. Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları ...................................................................... 148
Tablo 81. Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ......................... 150
Tablo 82. Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ...................... 151
Tablo 83. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları .................................................... 154
Tablo 84. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları ................................................. 154
Tablo 85. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) .... 156
Tablo 86. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) . 157
Tablo 87. Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları .............................................................................. 159
Tablo 88. Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları ........................................................................... 160
Tablo 89. Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları ....................................................................... 161
Tablo 90. Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları .................................................................... 161
Tablo 91. Eksik Alma Bildirimlerini Görüntüle İstek Veri Alanları .......................................................................... 170
Tablo 92. Eksik Alma Bildirimi Sorgula Cevap Veri Alanları ................................................................................. 170
Tablo 93. Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Veri Alanları .................................................. 173
Tablo 94. Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Cevap Veri Alanları ...................................... 173
Tablo 95. Paket Ekle İstek Veri Alanları ................................................................................................................ 174
Tablo 96. Paket Ekle Cevap Veri Alanları ............................................................................................................. 175
Tablo 97. Paket Sil İstek Veri Alanları ................................................................................................................... 177
Tablo 98. Paket Sil Cevap Veri Alanları ................................................................................................................ 177
Tablo 99. Paket Getir İstek Veri Alanları ............................................................................................................... 178
Tablo 100. Paket Getir Cevap Veri Alanları .......................................................................................................... 179
Tablo 101. Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları .................................................................. 180
Tablo 102. Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları ................................................................ 181
Tablo 103. Kuruma Gelen Paketi Getir İstek Veri Alanları .................................................................................... 182
Tablo 104. Kuruma Gelen Paketi Getir Cevap Veri Alanları ................................................................................ 182
Tablo 105. Kuruma Gelen Paketleri Sorgula İstek Veri Alanları ........................................................................... 184
Tablo 106. Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları ......................................................................... 184
Tablo 107. Firma Sorgulama Servisi İstek Veri Alanları ........................................................................................ 186
Tablo 108. Firma Sorgulama Servisi Sonuç Veri Alanları ..................................................................................... 186
Tablo 109. Ürün Sorgulama Servisi İstek Veri Alanları ......................................................................................... 188
Tablo 110. Ürün Sorgulama Servisi Sonuç Veri Alanları....................................................................................... 188
Tablo 111. Ürün Sorgulama Servisi Ürün Sonuç Veri Alanları .............................................................................. 188
Tablo 112. Bütün Ürünleri Sorgulama Servisi İstek Veri Alanları .......................................................................... 193
Tablo 113. Bütün Ürünleri Sorgulama Servisi Sonuç Veri Alanları ....................................................................... 193
Tablo 114. Bütün Ürünleri Sorgulama Servisi Ürün Sonuç Veri Alanları .............................................................. 193
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
17 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Tablo 115. Servis Mesajları ................................................................................................................................... 196
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
18 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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 Tanım
BİLGEM Bilişim ve Bilgi Güvenliği İleri Teknolojiler Araştırma Merkezi
Hareket Bildirimi 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.
İdare TİTCK
JSON JavaScript Object Notation
REST Representational State Transfer
Sistem Ürün Takip Sistemi
Tekil Ürün Ü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İTCK T.C. Sağlık Bakanlığı Türkiye İlaç ve Tıbbi Cihaz Kurumu
TÜBİTAK Türkiye Bilimsel ve Teknolojik Araştırma Kurumu
MERSİS Merkezi Sicil Kayıt Sistemi
UDI Unique Device Identification
URL Uniform Resource Locator
Ürün Kurumların ve firmaların ÜTS’de kayıtlı tıbbi cihaz ve kozmetik ürünlerinin her
biridir.
ÜTS Ürün Takip Sistemi
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
19 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Terim / Kısaltma Tanım
YTE Yazılım Teknolojileri Araştırma Enstitüsü
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 “https://utsuygulama.saglik.gov.tr1” 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.
NOT: Web servislerin tamamında HTTP request method olarak “POST” metodu kullanılmaktadır.
1 Ürün Hareketleri ve Ürün Geri Çağırma Modülleri ÜTS’nin test ortamında da (https://utstest.saglik.gov.tr) hizmet
vermektedir. Firmalar, deneme yapmak amacıyla test ortamını da kullanabilirler. Test ortamındaki veriler gerçek
ortama aktarılmayacaktır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
20 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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ı 3.2.1.2 numaralı başlık
altında açıklanmıştır.
3.1.1 Üretim Bildirimi
Üretici, ürettiği tekil ürünlerin her biri için bir Üretim Bildirimi yapar.
3.1.1.1 Üretim Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/uretim/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/uretim/ekle
3.1.1.2 Üretim Bildirimi Veri Alanları
Tablo 1. Üretim Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot takip edilmesi istenen tekil ürünler
için gereklidir.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil takip edilmesi istenen tekil ürünler
için gereklidir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
21 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ü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.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane üretim
yapıldığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
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.
Sistem İşlem
Paketi SIP
Liste
(BRK, UNO,
LNO, SNO,
ADT)
- Koşullu
Tekil ürünün sistem işlem paketi olması
ve içinde en az bir tane takip
kapsamında ürün olması durumunda
verilmesi zorunludur.
Liste içinde verilen bilgiler alt tekil
ürünlerin bilgileridir.
Kozmetik Ürün
Seti KUS
Liste
(BRK, UNO,
LNO, SNO,
ADT)
- Koşullu
Tekil ürünün kozmetik ürün seti olması
ve içinde en az bir tane takip
kapsamında ürün olması durumunda
verilmesi zorunludur.
Liste içinde verilen bilgiler alt tekil
ürünlerin bilgileridir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
22 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Gönüllü Takip
Kapsamı GTK
Tek Seçimli
Liste 5 Hayır
Herhangi bir takip konfigürasyonu
bulunmayan ürünlerin, firmalar
tarafından gönüllü takip edilebilmesi için
gerekli alandır.
Aşağıdaki değerlerden birini alabilir.
TEKIL
LOT
3.1.1.3 Üretim Bildirimi Örnek İstek
Örnek 1 lot takip edilen ürün:
{
"UNO" : "1111111110324",
"LNO" : "250515186001",
"ADT" : 100,
"UDI" : "011111111110324111603021719030210250515186001",
"URT" : "2016-03-02",
"SKT" : "2019-03-02"
}
Örnek 2 tekil takip edilen ürün:
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999",
"UDI" : "011111111110010111603021719030221KYY012345678999",
"URT" : "2016-03-02",
"SKT" : "2019-03-02"
}
NOT: Tekil takip edilen ürünlerde “ADT” bilgisi “1” girilmelidir veya o alan girilmemelidir.
Örnek 3 tekil takip edilen sistem işlem paketi:
{
"UNO" : "9321502013475",
"SNO" : "112212345678MM9",
"UDI" : "019321502013475111603021719030221112212345678MM9",
"ADT" : 1,
"URT" : "2016-03-02",
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
23 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"SKT" : "2019-03-02",
"SIP" : [
{
"UNO" : "2451643000038",
"SNO" : "B8NN12345678999"
},
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 10
}
]
}
Örnek 4 takip konfigürasyonu bulunmayan tekil ürünü gönüllü tekil bazda takip ederek üretim yapılması:
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999",
"UDI" : "011111111110010111603021719030221KYY012345678999",
"URT" : "2016-03-02",
"SKT" : "2019-03-02",
"GTK" : "TEKIL"
}
3.1.2 İthalat Bildirimi
İthalatçı, ithal ettiği tekil ürünler için İthalat Bildirimi yapar.
3.1.2.1 İthalat Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ithalat/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ithalat/ekle
3.1.2.2 İthalat Bildirimi Veri Alanları
Tablo 2. İthalat Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
24 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot takip edilmesi istenen tekil ürünler
için gereklidir.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil takip edilmesi istenen tekil ürünler
için gereklidir.
Ü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.
İthalat Tarihi ITT Tarih 10 Koşullu
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
Kozmetik ürünler için üretim tarihinin
bilinmediği durumda ithalat tarihi
verilmelidir.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane ithal
edildiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
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. *
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
25 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Menşei Ülke MEU Sayı 3 Evet Ülke kodudur. *
Gümrük
Beyanname
Numarası
GBN Metin 16 Hayır -
Sistem İşlem
Paketi SIP
Liste
(BRK, UNO,
LNO, SNO,
ADT)
- Koşullu
Tekil ürünün sistem işlem paketi olması
ve içinde en az bir tane takip
kapsamında ürün olması durumunda
verilmesi zorunludur.
Liste içinde verilen bilgiler alt tekil
ürünlerin bilgileridir.
Kozmetik Ürün
Seti KUS
Liste
(BRK, UNO,
LNO, SNO,
ADT)
- Koşullu
Tekil ürünün kozmetik ürün seti olması
ve içinde en az bir tane takip
kapsamında ürün olması durumunda
verilmesi zorunludur.
Liste içinde verilen bilgiler alt tekil
ürünlerin bilgileridir.
Gönüllü Takip
Kapsamı GTK
Tek Seçimli
Liste 5 Hayır
Herhangi bir takip konfigürasyonu
bulunmayan ürünlerin, firmalar
tarafından gönüllü takip edilebilmesi için
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.
3.1.2.3 İthalat Bildirimi Örnek İstek
Örnek 1 lot takip edilen ürün:
{
"UNO" : "1111111110058",
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
26 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"LNO" : "250515186001",
"ADT" : 100,
"UDI" : "011111111110058111603021719030210250515186001",
"URT" : "2016-03-02",
"SKT" : "2019-03-02",
"IEU" : "038",
"MEU" : "452",
"GBN" : "15343100IM003176"
}
Örnek 2 tekil takip edilen ürün:
{
"UNO" : "1111111110065",
"SNO" : "KYY012345678999",
"UDI" : "011111111110065111603021719030221KYY012345678999",
"URT" : "2016-03-02",
"SKT" : "2019-03-02",
"IEU" : "716",
"MEU" : "082",
"GBN" : "15343100IM003176"
}
NOT: Tekil takip edilen ürünlerde “ADT” bilgisi “1” girilmelidir veya o alan girilmemelidir.
Örnek 3 tekil takip edilen sistem işlem paketi:
{
"UNO" : "851479856540",
"SNO" : "112212345678MM9",
"UDI" : "01851479856540111603021719030221112212345678MM9",
"ADT" : 1,
"URT" : "2016-03-02",
"SKT" : "2019-03-02",
"IEU" : "400",
"MEU" : "400",
"GBN" : "15343100IM003176",
"SIP" : [
{
"UNO" : "1111111110065",
"SNO" : "KYY012345678999"
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
27 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
},
{
"UNO" : "1111111110058",
"LNO" : "250515186001",
"ADT" : 1
}
]
}
Örnek 4 takip konfigürasyonu bulunmayan tekil ürünü gönüllü tekil bazda takip ederek ithalat yapılması:
{
"UNO" : "1111111110065",
"SNO" : "KYY012345678999",
"UDI" : "011111111110065111603021719030221KYY012345678999",
"URT" : "2016-03-02",
"SKT" : "2019-03-02",
"IEU" : "716",
"MEU" : "082",
"GBN" : "15343100IM003176",
"GTK" : "TEKIL"
}
3.1.3 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.
3.1.3.1 Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/ekle
Tablo 3. Verme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
28 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
verildiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Kurum No KUN Sayı - Evet Tekil ürünün verildiği kurum/firmanın
ÜTS’de tanımlı numarasıdır.
Bedelsiz
Numune BEN
Tek Seçimli
Liste 5 Hayır
Verilen tekil ürünlerin bedelsiz numune
olup olmadığını ifade etmektedir.
Aşağıdaki değerleri alabilir. Varsayılan
değeri HAYIR’dır.
EVET: Evet
HAYIR: Hayır
Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.
Gerçek İşlem
Tarihi GIT Tarih 10 Hayır
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
Boş bırakıldığında default olarak
bildirimin yapıldığı tarih alınır.
3.1.3.2 Verme Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 25,
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
29 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"KUN" : 7,
"BEN" : "HAYIR",
"BNO" : "123B",
"GIT" : "2018-10-31"
}
3.1.3.3 Eşsiz Kimlik Bilgisi İle Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/ekle/essizKimlik
3.1.3.4 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları
Tablo 4. Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
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.
Adet ADT Sayı - Hayır
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
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 Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
30 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.3.5 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"KUN" : 7,
"ADT" : 5,
"BNO": "123"
}
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.
3.1.4.1 Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/alma/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/alma/ekle
3.1.4.2 Alma Bildirimi Veri Alanları
Tablo 5. Alma Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Verme Bildirim
ID VBI Sayı - Koşullu
Hangi verme bildirimine karşılık olarak
alım yapıldığını ifade eder.
Adet ADT Sayı - Hayır
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
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.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
31 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Gönderen
Kurum
Numarası
GKK Sayı - Koşullu
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.
Ürün Numarası UNO Metin 23 Koşullu
Ürünün ürün numarası/barkod
numarasıdır.
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
Numarası LNO 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.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası 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.
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
32 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.4.3 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" : "1111111110324",
"LNO" : "250515186001",
"ADT" : 5,
“GKK" : 10
}
Örnek 3: Verilen tekil ürün bilgilerine uyan birden fazla bildirim bulundu hatası ile ilgili örnek durum:
Alma Bildirimi İsteği:
{
"UNO":"1111111110010",
"LNO":"lot1",
“ADT”: 20
}
Birden Fazla Verme Bildirimi İçeren Alma Bildirimi Cevabı:
{
"MSJ": [{
"MET": "Verilen Tekil Ürün bilgilerine uyan birden fazla bildirim bulundu!",
"KOD": "UTS-H171",
"TIP": "HATA",
"MPA": [],
}],
"VBB": [{
"VBI": "96be8de1-f7d7-11e8-a3a9-f783d4ccac99",
"ADT": 20,
"GKK": 10,
"TRH": "2018-12-04",
"BNO": "B20LOT1"
},
{
"VBI": "a68b5aa1-f7d7-11e8-a3a9-f783d4ccac99",
"ADT": 20,
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
33 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"GKK": 10,
"TRH": "2018-12-04",
"BNO": "B10LOT1"
}
],
}
Bildirim İdsi (VBI) Bir Önceki Cevabın VBB Listesinden Alınan İkinci Alma Bildirimi İsteği:
{
"UNO":"1111111110010",
"LNO":"lot1",
"ADT": 20,
"VBI": "96be8de1-f7d7-11e8-a3a9-f783d4ccac99"
}
İkinci Alma Bildirimi Cevabı:
{
"SNC": "15713f21-f7d8-11e8-a3a9-f783d4ccac99",
"MSJ": [
{
"MET": "Bildirim id'si 15713f21-f7d8-11e8-a3a9-f783d4ccac99 olan alma bildirimi yapıldı.",
"KOD": "UTS-B006",
"TIP": "BILGI",
"MPA": ["15713f21-f7d8-11e8-a3a9-f783d4ccac99"],
}],
}
3.1.4.4 Eşsiz Kimlik Bilgisi İle Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/alma/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/alma/ekle/essizKimlik
3.1.4.5 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları
Tablo 6. Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Bildirim kodu verilmediği durumda tekil
ürün eşsiz kimliği (Unique Device
Identifier) ile alma bildirimi yapılmak
istendiğinde verilmesi gerekmektedir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
34 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Adet ADT Sayı - Hayır
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
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.
Gönderen
Kurum
Numarası
GKK Sayı - Hayır
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.
3.1.4.6 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"ADT" : 5,
"GKK" : 10
}
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.
3.1.5.1 ÜTS’de Tanımsız Yere Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/ekle
3.1.5.2 ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları
Tablo 7 . ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
35 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
verildiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Bedelsiz
Numune BEN
Tek Seçimli
Liste 5 Hayır
Verilen tekil ürünlerin bedelsiz numune
olup olmadığını ifade etmektedir.
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.
Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.
3.1.5.3 ÜTS’de Tanımsız Yere Verme Bildirimi Örnek İstek
{
"UNO" : "1111111110058",
"LNO" : "250515186001",
"ADT" : 25,
"VKN" : "1234567890",
"BNO" : "123B",
"BEN" : "HAYIR"
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
36 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.5.4 Eşsiz Kimlik Bilgisi İle ÜTS’de Tanımsız Yere Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/ekle/essizKimlik
3.1.5.5 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ı
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
verildiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Bedelsiz
Numune BEN
Tek Seçimli
Liste 5 Hayır
Verilen tekil ürünlerin bedelsiz numune
olup olmadığını ifade etmektedir.
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.
MERSİS No MEN Sayı - Koşullu
Tekil ürünün MERSİS’te tanımlı bir
firmaya verilmesi durumunda
verilmelidir.
T.C. Kimlik No TKN Sayı - Koşullu
Tekil ürünün ESBİS’te tanımlı bir
firmaya verilmesi durumunda
verilmelidir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
37 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Meslek Kodu MEK Sayı - Koşullu
Tekil ürünün ESBİS’te tanımlı bir
firmaya verilmesi durumunda
verilmelidir.
Oda Kodu ODK Sayı - Koşullu
Tekil ürünün ESBİS’te tanımlı bir
firmaya verilmesi durumunda
verilmelidir.
Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.
3.1.5.6 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"ADT" : 5,
"VKN" : "1234567890",
"BNO" : "123B",
"BEN" : "HAYIR"
}
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.
3.1.6.1 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/ekle
3.1.6.2 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları
Tablo 9 .ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
38 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ü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.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
verildiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
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 Numarası UNO Metin 23 Koşullu
Ürünün ürün numarası/barkod
numarasıdır.
Bildirim kodu veya eşsiz kimlik
verilmediği takdirde tekil ürün bilgileri ile
iade alma yapılmak istendiğinde ürün
numarası verilmelidir.
Lot/Batch
Numarası LNO 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.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
39 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Seri/Sıra
Numarası 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.
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
3.1.6.3 Ü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" : "1111111110324",
"LNO" : "250515186001",
"ADT" : 5
}
3.1.6.4 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Servis Adresi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/ekle/essizKimlik
3.1.6.5 Eşsiz Kimlik Bilgisi ile Ü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ı
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
40 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Bildirim kodu verilmediği durumda tekil
ürün eşsiz kimliği (Unique Device
Identifier) ile alma bildirimi yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Hayır
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
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.
3.1.6.6 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 5
}
3.1.7 Kullanım Bildirimi
Sağlık kuruluşu/uygulama tesisi tekil ürünü hasta/tüketiciye kullandığında Kullanım Bildirimi yapar.
3.1.7.1 Kullanım Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/ekle
3.1.7.2 Kullanım Bildirimi Veri Alanları
Tablo 11.Kullanım Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
41 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip ve lot takip edilen tekil
ürünler için 1 olarak verilir. Adet
verilmezse 1 olarak kabul edilir.
Hasta Adı HAA Metin 50 Koşullu Kullanırken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
Hasta Soyadı HAS Metin 50 Koşullu Kullanırken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
T.C. Kimlik No TKN Sayı - Koşullu
Kullanırken kimlik numarası gerekli ise
ve Türkiye Cumhuriyeti vatandaşına
kullanılması durumunda verilir. (Takip
konfigürasyonu var ise)
Yabancı Kimlik
No YKN Sayı - Koşullu
Kullanırken kimlik numarası gerekli ise
ve yabancı kimlik numarası sahibi
hastaya kullanılması durumunda verilir.
(Takip konfigürasyonu var ise)
Pasaport No PAN Metin 20 Koşullu
Kullanırken kimlik numarası gerekli ise
ve yabancı kimlik numarası olmayan
yabancı hastaya kullanılması
durumunda verilir. (Takip
konfigürasyonu var ise)
Kullanım Tarihi GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
42 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Kişi Tanımlayıcı
Numara KTN Sayı - Koşullu
Kullanırken kimlik numarası gerekli ise
ve kişinin T.C..Kimlik No, Yabancı
Kimlik No ya da pasaport numarası
bilinmiyorsa kişiyi tanımlayan bir
numara verilir. (Takip konfigürasyonu
var ise)
Kişi Kimlik Bilgisi
Açıklama Türü TUR
Tek Seçimli
Liste - Koşullu
Kullanırken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
Aşağıdaki değerlerden birini alabilir.
TC_KIMLIK_NUMARASI_VAR
YABANCI_KIMLIK_NUMARASI_VAR
PASAPORT_NUMARASI_VAR
YUPASS_NUMARASI_VAR
YENI_DOGAN
KIMLIGI_BELIRSIZ
DIGER
Kişi Kimlik Bilgisi
Diğer Tür
Açıklaması
DTA Metin 50 Koşullu
Kişi Kimlik Bilgisi Açıklama Türü alanı
değerinin DIGER olması durumunda bu
alan zorunludur.
Serbest metin şeklinde açıklama türü
tanımlanır.
3.1.7.3 Kullanım Bildirimi Örnek İstek
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999",
"GIT" : "2017-11-22",
"TKN" : "11223344678",
"HAA" : "Ali",
"HAS" : "Yılmaz",
“TUR” : “TC_KIMLIK_NUMARASI_VAR”
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
43 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.7.4 Eşsiz Kimlik Bilgisi İle Kullanım Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/ekle/essizKimlik
3.1.7.5 Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları
Tablo 12. Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Koşullu
Tekil takip ve lot takip edilen tekil
ürünler için 1 olarak verilir. Adet
verilmezse 1 olarak kabul edilir.
Hasta Adı HAA Metin 50 Koşullu Kullanırken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
Hasta Soyadı HAS Metin 50 Koşullu Kullanırken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
T.C. Kimlik No TKN Sayı - Koşullu
Kullanırken kimlik numarası gerekli ise
ve Türkiye Cumhuriyeti vatandaşına
kullanılması durumunda verilir. (Takip
konfigürasyonu var ise)
Yabancı Kimlik
No YKN Sayı - Koşullu
Kullanırken kimlik numarası gerekli ise
ve yabancı kimlik numarası sahibi
hastaya kullanılması durumunda verilir.
(Takip konfigürasyonu var ise)
Pasaport No PAN Metin 20 Koşullu
Kullanırken kimlik numarası gerekli ise
ve yabancı kimlik numarası olmayan
yabancı hastaya kullanılması
durumunda verilir. (Takip
konfigürasyonu var ise)
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
44 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Kullanım Tarihi GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
Kişi Tanımlayıcı
Numara KTN Sayı - Koşullu
Kullanırken kimlik numarası gerekli ise
ve kişinin T.C..Kimlik No, Yabancı
Kimlik No ya da pasaport numarası
bilinmiyorsa kişiyi tanımlayan bir
numara verilir. (Takip konfigürasyonu
var ise)
Kişi Kimlik Bilgisi
Açıklama Türü TUR
Tek Seçimli
Liste - Koşullu
Kullanırken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
Aşağıdaki değerlerden birini alabilir.
TC_KIMLIK_NUMARASI_VAR
YABANCI_KIMLIK_NUMARASI_VAR
PASAPORT_NUMARASI_VAR
YUPASS_NUMARASI_VAR
YENI_DOGAN
KIMLIGI_BELIRSIZ
DIGER
Kişi Kimlik Bilgisi
Diğer Tür
Açıklaması
DTA Metin 50 Koşullu
Kişi Kimlik Bilgisi Açıklama Türü alanı
değerinin DIGER olması durumunda bu
alan zorunludur.
Serbest metin şeklinde açıklama türü
tanımlanır.
3.1.7.6 Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"GIT" : "2017-11-22",
"TKN" : "11223344678",
"HAA" : "Ali",
"HAS" : "Yılmaz",
“TUR” : “TC_KIMLIK_NUMARASI_VAR”
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
45 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
}
3.1.8 Tüketiciye Verme Bildirimi
Satış yeri, tüketiciye verdiği tekil ürünler için tüketiciye verme bildirimi yapar. Satış, hibe vb. yöntemler için
Tüketiciye Verme Bildirimi yapılır.
NOT: Tüketiciye reçete karşılığı verilen ve SGK’nın geri ödeme kapsamında bulunan optik tekil ürünler için ÜTS’ye
Tüketiciye Verme Bildirimi (veya iptal bildirimi) yapılmayacaktır. Bu durum hâlihazırdaki gibi MEDULA’ya
bildirilecektir.
3.1.8.1 Tüketiciye Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/ekle
3.1.8.2 Tüketiciye Verme Bildirimi Veri Alanları
Tablo 13 .Tüketiciye Verme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane üretim
yapıldığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
46 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Bedelsiz
Numune BEN
Tek Seçimli
Liste 5 Hayır
Verilen tekil ürünlerin bedelsiz numune
olup olmadığını ifade etmektedir.
Aşağıdaki değerleri alabilir. Varsayılan
değeri HAYIR’dır.
EVET: Evet
HAYIR: Hayır
Tüketici Adı TUA Metin 50 Koşullu Satarken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
Tüketici Soyadı TUS Metin 50 Koşullu Satarken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
T.C. Kimlik No TKN Sayı - Koşullu
Satarken kimlik numarası gerekli ise ve
Türkiye Cumhuriyeti vatandaşı ise
verilir. (Takip konfigürasyonu var ise)
Yabancı Kimlik
No YKN Sayı - Koşullu
Satarken kimlik numarası gerekli ise ve
yabancı kimlik numarası sahibi ise
verilir. (Takip konfigürasyonu var ise)
Pasaport No PAN Metin 20 Koşullu
Satarken kimlik numarası gerekli ise ve
yabancı kimlik numarası sahibi değil ise
verilir. (Takip konfigürasyonu var ise)
Tüketiciye
Verme Tarihi GIT Tarih 10 Evet
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
Kişi Tanımlayıcı
Numara KTN Sayı - Koşullu
Satarken kimlik numarası gerekli ise ve
kişinin T.C..Kimlik No, Yabancı Kimlik
No ya da pasaport numarası
bilinmiyorsa kişiyi tanımlayan bir
numara verilir. (Takip konfigürasyonu
var ise)
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
47 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Kişi Kimlik Bilgisi
Açıklama Türü TUR
Tek Seçimli
Liste - Koşullu
Satarken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
Aşağıdaki değerlerden birini alabilir.
TC_KIMLIK_NUMARASI_VAR
YABANCI_KIMLIK_NUMARASI_VAR
PASAPORT_NUMARASI_VAR
YUPASS_NUMARASI_VAR
YENI_DOGAN
KIMLIGI_BELIRSIZ
DIGER
Kişi Kimlik Bilgisi
Diğer Tür
Açıklaması
DTA Metin 50 Koşullu
Kişi Kimlik Bilgisi Açıklama Türü alanı
değerinin DIGER olması durumunda bu
alan zorunludur.
Serbest metin şeklinde açıklama türü
tanımlanır.
3.1.8.3 Tüketiciye Verme Bildirimi Örnek İstek
{
"UNO" : "1111111110324",
"LNO" : "250515186001",
"ADT" : 25,
"GIT" : "2017-11-20",
"BEN" : "HAYIR",
"TKN" : "11223344678",
"TUA" : "Ali",
"TUS" : "Yılmaz",
“TUR” : “TC_KIMLIK_NUMARASI_VAR”
}
3.1.8.4 Eşsiz Kimlik Bilgisi İle Tüketiciye Verme Bildirimi Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/ekle/essizKimlik
3.1.8.5 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
48 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Tablo 14. Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane üretim
yapıldığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Bedelsiz
Numune BEN
Tek Seçimli
Liste 5 Hayır
Verilen tekil ürünlerin bedelsiz numune
olup olmadığını ifade etmektedir.
Aşağıdaki değerleri alabilir. Varsayılan
değeri HAYIR’dır.
EVET: Evet
HAYIR: Hayır
Tüketici Adı TUA Metin 50 Koşullu Satarken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
Tüketici Soyadı TUS Metin 50 Koşullu Satarken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
T.C. Kimlik No TKN Sayı - Koşullu
Satarken kimlik numarası gerekli ise ve
T.C. Kimlik Numarası var ise verilir.
(Takip konfigürasyonu var ise)
Yabancı Kimlik
No YKN Sayı - Koşullu
Satarken kimlik numarası gerekli ise ve
Yabancı Kimlik No var ise verilir. (Takip
konfigürasyonu var ise)
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
49 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Tüketiciye
Verme Tarihi GIT Tarih 10 Evet
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
Kişi Tanımlayıcı
Numara KTN Sayı - Koşullu
Satarken kimlik numarası gerekli ise ve
kişinin T.C..Kimlik No, Yabancı Kimlik
No ya da pasaport numarası
bilinmiyorsa kişiyi tanımlayan bir
numara verilir. (Takip konfigürasyonu
var ise)
Kişi Kimlik Bilgisi
Açıklama Türü TUR
Tek Seçimli
Liste - Koşullu
Satarken kimlik numarası gerekli ise
verilir. (Takip konfigürasyonu var ise)
Aşağıdaki değerlerden birini alabilir.
TC_KIMLIK_NUMARASI_VAR
YABANCI_KIMLIK_NUMARASI_VAR
PASAPORT_NUMARASI_VAR
YUPASS_NUMARASI_VAR
YENI_DOGAN
KIMLIGI_BELIRSIZ
DIGER
Kişi Kimlik Bilgisi
Diğer Tür
Açıklaması
DTA Metin 50 Koşullu
Kişi Kimlik Bilgisi Açıklama Türü alanı
değerinin DIGER olması durumunda bu
alan zorunludur.
Serbest metin şeklinde açıklama türü
tanımlanır.
3.1.8.6 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 25,
"GIT" : "2017-11-20",
"BEN" : "HAYIR",
"TKN" : "11223344678",
"TUA" : "Ali",
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
50 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"TUS" : "Yılmaz",
“TUR” : “TC_KIMLIK_NUMARASI_VAR”
}
3.1.9 Tüketiciden İade Alma Bildirimi
Kurum/firma, daha önce tüketiciye verdiği tekil ürünü geri alması durumunda Tüketiciden İade Alma Bildirimi yapar.
NOT: Tüketiciye reçete karşılığı verilen ve SGK’nın geri ödeme kapsamında bulunan optik tekil ürünler için ÜTS’ye
Tüketiciden İade Alma Bildirimi (veya iptal bildirimi) yapılmayacaktır. Bu durum hâlihazırdaki gibi MEDULA’ya
bildirilecektir.
3.1.9.1 Tüketiciden İade Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/ekle
3.1.9.2 Tüketiciden İade Alma Bildirimi Veri Alanları
Tablo 15 .Tüketiciden İade Alma Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Tüketiciye
Verme Bildirimi
ID
TID Sayı - Koşullu Hangi tüketiciye verme bildirimi için iade
alımı yapıldığını ifade eder.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane iade
alındığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Tüketiciye Veren
Kurum No VKN Sayı - Koşullu
Tüketiciden iade alma işlemi, tüketiciye
veren kurumdan yapılıyorsa zorunlu
değildir, farklı kurumdan yapılıyorsa
zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
51 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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 Numarası UNO Metin 23 Koşullu
Ürünün ürün numarası/barkod
numarasıdır.
Bildirim kodu veya eşsiz kimlik
verilmediği takdirde tekil ürün bilgileri ile
iade alma yapılmak istendiğinde ürün
numarası verilmelidir.
Lot/Batch
Numarası LNO 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.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası 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.
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
3.1.9.3 Tüketiciden İade Alma Bildirimi Örnek İstek
Örnek 1 tüketiciye verme bildirim ID ile yapılan tüketiciden iade alma bildirimi isteği:
{
"TID" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29",
"ADT" : 15
}
Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan tüketiciden iade alma bildirimi isteği:
{
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
52 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"UNO" : "1111111110324",
"LNO" : "250515186001",
"ADT" : 5
}
Örnek 3 tüketiciden iade alma bildiriminin farklı kurumdan yapılma istediği:
{
"UNO" : "1111111110324",
"LNO" : "250515186001",
"ADT" : 5,
"VKN" : 7
}
3.1.9.4 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/ekle/essizKimlik
3.1.9.5 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları
Tablo 16. Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Bildirim kodu verilmediği durumda tekil
ürün eşsiz kimliği (Unique Device
Identifier) ile alma bildirimi yapılmak
istendiğinde verilmesi gerekmektedir.
Tüketiciye Veren
Kurum No VKN Sayı - Koşullu
Tüketiciden iade alma işlemi, tüketiciye
veren kurumdan yapılıyorsa zorunlu
değildir, farklı kurumdan yapılıyorsa
zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
53 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Adet ADT Sayı - Hayır
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
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.
3.1.9.6 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 5
}
Eşsiz kimlik bilgisi ile tüketiciden iade alma bildiriminin farklı kurumdan yapılma istediği:
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 5,
“VKN” : 7
}
3.1.10 Geçici Kullanıma Verme Bildirimi
Kurum/firma, geçici süreliğine bir kişinin kullanımına verdiği tekil ürünler için Geçici Kullanıma Verme Bildirimi
yapar.
3.1.10.1 Geçici Kullanıma Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/ekle
3.1.10.2 Geçici Kullanıma Verme Bildirimi Veri Alanları
Tablo 17 . Geçici Kullanıma Verme Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
54 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane üretim
yapıldığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Tüketici Adı TUA Metin 50 Evet Tekil ürünün verildiği kişinin adıdır.
Tüketici Soyadı TUS Metin 50 Evet Tekil ürünün verildiği kişinin soyadıdır.
T.C. Kimlik No TKN Sayı - Koşullu
Tekil ürünün Türkiye Cumhuriyeti
vatandaşına verilmesi durumunda
verilmesi zorunludur.
Yabancı Kimlik
No YKN Sayı - Koşullu
Tekil ürünün yabancı kimlik numarası
sahibi tüketiciye verilmesi durumunda
verilmesi zorunludur.
Pasaport No PAN Metin 20 Koşullu
Tekil ürünün yabancı kimlik numarası
olmayan yabancı hastaya kullanılması
durumunda verilmesi zorunludur.
Geçici
Kullanıma
Verme Tarihi
GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
55 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Kişi Tanımlayıcı
Numara KTN Sayı - Koşullu
Tekil ürünün verildiği kişinin T.C..Kimlik
No, Yabancı Kimlik No ya da pasaport
numarası bilinmiyorsa kişiyi tanımlayan
bir numara verilir.
Kişi Kimlik Bilgisi
Açıklama Türü TUR
Tek Seçimli
Liste - Zorunlu
Aşağıdaki değerlerden birini alabilir.
TC_KIMLIK_NUMARASI_VAR
YABANCI_KIMLIK_NUMARASI_VAR
PASAPORT_NUMARASI_VAR
YUPASS_NUMARASI_VAR
YENI_DOGAN
KIMLIGI_BELIRSIZ
DIGER
Kişi Kimlik Bilgisi
Diğer Tür
Açıklaması
DTA Metin 50 Koşullu
Kişi Kimlik Bilgisi Açıklama Türü alanı
değerinin DIGER olması durumunda bu
alan zorunludur.
Serbest metin şeklinde açıklama türü
tanımlanır.
3.1.10.3 Geçici Kullanıma Verme Bildirimi Örnek İstek
{
"UNO" : "1111111110324",
"LNO" : "250515186001",
"ADT" : 25,
"GIT" : "2017-11-22",
"TKN" : "11223344678",
"TUA" : "Ali",
"TUS" : "Yılmaz",
“TUR” : “TC_KIMLIK_NUMARASI_VAR”
}
3.1.10.4 Eşsiz Kimlik Bilgisi İle Geçici Kullanıma Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/ekle/essizKimlik
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
56 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.10.5 Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları
Tablo 18. Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane üretim
yapıldığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Tüketici Adı TUA Metin 50 Evet Tekil ürünün verildiği kişinin adıdır.
Tüketici Soyadı TUS Metin 50 Evet Tekil ürünün verildiği kişinin soyadıdır.
T.C. Kimlik No TKN Sayı - Koşullu
Tekil ürünün Türkiye Cumhuriyeti
vatandaşına verilmesi durumunda
verilmesi zorunludur.
Yabancı Kimlik
No YKN Sayı - Koşullu
Tekil ürünün yabancı kimlik numarası
sahibi tüketiciye verilmesi durumunda
verilmesi zorunludur.
Pasaport No PAN Metin 20 Koşullu
Tekil ürünün yabancı kimlik numarası
olmayan yabancı hastaya kullanılması
durumunda verilmesi zorunludur.
Geçici
Kullanıma
Verme Tarihi
GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
57 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Kişi Tanımlayıcı
Numara KTN Sayı - Koşullu
Tekil ürünün verildiği kişinin T.C..Kimlik
No, Yabancı Kimlik No ya da pasaport
numarası bilinmiyorsa kişiyi tanımlayan
bir numara verilir.
Kişi Kimlik Bilgisi
Açıklama Türü TUR
Tek Seçimli
Liste - Zorunlu
Aşağıdaki değerlerden birini alabilir.
TC_KIMLIK_NUMARASI_VAR
YABANCI_KIMLIK_NUMARASI_VAR
PASAPORT_NUMARASI_VAR
YUPASS_NUMARASI_VAR
YENI_DOGAN
KIMLIGI_BELIRSIZ
DIGER
Kişi Kimlik Bilgisi
Diğer Tür
Açıklaması
DTA Metin 50 Koşullu
Kişi Kimlik Bilgisi Açıklama Türü alanı
değerinin DIGER olması durumunda bu
alan zorunludur.
Serbest metin şeklinde açıklama türü
tanımlanır.
3.1.10.6 Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 25,
"GIT" : "2017-11-22",
"TKN" : "11223344678",
"TUA" : "Ali",
"TUS" : "Yılmaz",
“TUR” : “TC_KIMLIK_NUMARASI_VAR”
}
3.1.11 Kullanımdan Alma Bildirimi
Kurum/firma, geçici süreliğine hasta/tüketicinin kullanımına verdiği tekil ürünleri geri aldığında Kullanımdan Alma
Bildirimi yapar.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
58 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.11.1 Kullanımdan Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/ekle
3.1.11.2 Kullanımdan Alma Bildirimi Veri Alanları
Tablo 19 . Kullanımdan Alma Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Geçici
Kullanıma
Verme Bildirim
ID
GKI Sayı - Evet
Kullanımdan alma işleminin hangi geçici
kullanıma verme bildirimi için yapıldığını
ifade eder.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane üretim
yapıldığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
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 Numarası UNO Metin 23 Koşullu
Ürünün ürün numarası/barkod
numarasıdır.
Bildirim kodu veya eşsiz kimlik
verilmediği takdirde tekil ürün bilgileri ile
iade alma yapılmak istendiğinde ürün
numarası verilmelidir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
59 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Lot/Batch
Numarası LNO 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.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası 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.
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
3.1.11.3 Kullanımdan Alma Bildirimi Örnek İstek
Örnek 1 geçici kullanıma verme bildirim ID ile yapılan kullanımdan alma bildirimi isteği:
{
"GKI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29",
"ADT" : 15
}
Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan kullanımdan alma bildirimi isteği:
{
"UNO" : "1111111110324",
"LNO" : "250515186001",
"ADT" : 5
}
3.1.11.4 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/ekle/essizKimlik
3.1.11.5 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları
Tablo 20 . Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
60 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Bildirim kodu verilmediği durumda tekil
ürün eşsiz kimliği (Unique Device
Identifier) ile alma bildirimi yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Hayır
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
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.
3.1.11.6 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 5
}
3.1.12 Yeniden İşleme Bildirimi
Kurum/firma ÜTS’de tanımlı tekil ürünü başka bir tekil ürünün üretiminde hammadde olarak kullanması durumunda
yeniden işleme bildirimi yapar.
3.1.12.1 Yeniden İşleme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/ekle
3.1.12.2 Yeniden İşleme Bildirimi Veri Alanları
Tablo 21. Yeniden İşleme Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
61 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane yeniden
işleme yapıldığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
3.1.12.3 Yeniden İşleme Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 25
}
3.1.12.4 Eşsiz Kimlik Bilgisi İle Yeniden İşleme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/ekle/essizKimlik
3.1.12.5 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları
Tablo 22. Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
62 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
kullanıldığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
3.1.12.6 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 25
}
3.1.13 İhracat Bildirimi
İhracatçı, ihraç ettiği tekil ürünler için İhracat Bildirimi yapar.
3.1.13.1 İhracat Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/ekle
3.1.13.2 İhracat Bildirimi Veri Alanları
Tablo 23 . İhracat Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
63 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane ihraç
edildiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Bedelsiz
Numune BEN
Tek Seçimli
Liste 5 Hayır
Verilen tekil ürünlerin bedelsiz numune
olup olmadığını ifade etmektedir.
Aşağıdaki değerleri alabilir. Varsayılan
değeri HAYIR’dır.
EVET: Evet
HAYIR: Hayır
Gümrük
Beyanname
Numarası
GBN Metin 16 Evet -
3.1.13.3 İhracat Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 25,
"GBN" : "15343100IM003176",
"BEN" : "HAYIR"
}
3.1.13.4 Eşsiz Kimlik Bilgisi İle İhracat Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/ekle/essizKimlik
3.1.13.5 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları
Tablo 24. Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
64 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
kullanıldığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Bedelsiz
Numune BEN
Tek Seçimli
Liste 5 Hayır
Verilen tekil ürünlerin bedelsiz numune
olup olmadığını ifade etmektedir.
Aşağıdaki değerleri alabilir. Varsayılan
değeri HAYIR’dır.
EVET: Evet
HAYIR: Hayır
Gümrük
Beyanname
Numarası
GBN Metin 16 Evet -
3.1.13.6 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 25,
"GBN" : "15343100IM003176",
"BEN" : "HAYIR"
}
3.1.14 Mahrecine İade Etme Bildirimi
İthalatçı, ithal ettiği tekil ürünü iade ettiğinde Mahrecine İade Bildirimi yapar.
3.1.14.1 Mahrecine İade Etme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/ekle
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
65 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.14.2 Mahrecine İade Etme Bildirimi Veri Alanları
Tablo 25 . Mahrecine İade Etme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
mahrecine iade edildiğini ifade
etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Gümrük
Beyanname
Numarası
GBN Metin 16 Evet -
3.1.14.3 Mahrecine İade Etme Bildirimi Örnek İstek
{
"UNO" : "1111111110058",
"LNO" : "250515186001",
"ADT" : 25,
"GBN" : "15343100IM003176"
}
3.1.14.4 Eşsiz Kimlik Bilgisi İle Mahrecine İade Etme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/ekle/essizKimlik
3.1.14.5 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları
Tablo 26. Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
66 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
mahrecine iade edildiğini ifade
etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Gümrük
Beyanname
Numarası
GBN Metin 16 Evet -
3.1.14.6 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 25,
"GBN" : "15343100IM003176"
}
3.1.15 HEK / Zayiat Bildirimi
Kurum/firma, ekonomik ömrünü tamamlayan veya zayi olan tekil ürünleri için HEK / Zayiat bildirimi yapar. HEK
ifadesi Hurda / Enkaz / Köhne kelimelerinin kısaltmasıdır.
3.1.15.1 HEK / Zayiat Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/ekle
3.1.15.2 HEK / Zayiat Bildirimi Veri Alanları
Tablo 27 .HEK / Zayiat Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
67 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane HEK /
Zayiat yapıldığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Türü TUR Metin 20 Evet
Aşağıdaki değerlerden birini alabilir.
HEK: HEK
DOGAL_AFET: Doğal Afet
YANGIN: Yangın
CALINMA: Çalınma
DIGER: Diğer
Diğer Tür
Açıklaması DTA Metin 50 Koşullu
Türü alanının değeri Diğer olması
durumunda bu alan zorunludur.
Serbest metin şeklinde gerekçe
tanımlanır.
3.1.15.3 HEK / Zayiat Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 25,
"TUR" : "DOGAL_AFET"
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
68 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.15.4 Eşsiz Kimlik Bilgisi İle HEK / Zayiat Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/ekle/essizKimlik
3.1.15.5 Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları
Tablo 28. Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane HEK /
Zayiat yapıldığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Türü TUR Metin 20 Evet
Aşağıdaki değerlerden birini alabilir.
HEK: HEK
DOGAL_AFET: Doğal Afet
YANGIN: Yangın
CALINMA: Çalınma
DIGER: Diğer
Diğer Tür
Açıklaması DTA Metin 50 Koşullu
Türü alanının değeri Diğer olması
durumunda bu alan zorunludur.
Serbest metin şeklinde gerekçe
tanımlanır.
3.1.15.6 Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"ADT" : 25,
"TUR" : "DOGAL_AFET"
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
69 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.16 Geri Çekme Verme Bildirimi
Kurum/firma, geri çekme kapsamındaki tekil ürünleri başka bir kurum/firmaya verdiğinde Geri Çekme Verme
Bildirimi yapar.
3.1.16.1 Geri Çekme Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/ekle
3.1.16.2 Geri Çekme Verme Bildirimi Veri Alanları
Tablo 29. Geri Çekme Verme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
verildiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Kurum No KUN Sayı - Evet Tekil ürünün verildiği kurum/firmanın
ÜTS’de tanımlı numarasıdır.
Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.
3.1.16.3 Geri Çekme Verme Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 25,
"KUN" : 7,
"BNO" : "123B"
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
70 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
}
3.1.16.4 Eşsiz Kimlik Bilgisi İle Geri Çekme Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/ekle/essizKimlik
3.1.16.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları
Tablo 30. Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
verildiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Kurum No KUN Sayı - Evet Tekil ürünün verildiği kurum/firmanın
ÜTS’de tanımlı numarasıdır.
Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.
3.1.16.6 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"ADT" : 25,
"KUN" : 7,
"BNO" : "123B"
}
3.1.17 Geri Çekme Alma Bildirimi
Kurum/firma, geri çekme kapsamında kendisine verilen tekil ürünleri kabul etmek için Geri Çekme Alma Bildirimi
yapar.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
71 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.17.1 Geri Çekme Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/ekle
3.1.17.2 Geri Çekme Alma Bildirimi Veri Alanları
Tablo 31. Geri Çekme Alma Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Geri Çekme
Verme Bildirim
ID
GVI Metin 36 Evet Hangi verme bildirimi için alım
yapıldığını ifade eder.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
alındığını ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Gönderen
Kurum
Numarası
GKK Sayı - Koşullu
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.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
72 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Koşullu
Ürünün ürün numarası/barkod
numarasıdır.
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
Numarası LNO 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.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası 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.
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
3.1.17.3 Geri Çekme Alma Bildirimi Örnek İstek
Örnek 1 geri çekme verme bildirim ID ile yapılan geri çekme alma bildirimi isteği:
{
"GVI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29",
"ADT" : 15
}
Örnek 2 ürün no, lot/batch no ve seri/sıra no ve seri/sıra no ile yapılan geri çekme alma bildirimi isteği:
{
"UNO" : "1111111110324",
"LNO" : "250515186001",
"ADT" : 5,
“GKK” : 10
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
73 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.17.4 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/ekle/essizKimlik
3.1.17.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları
Tablo 32. Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Bildirim kodu verilmediği durumda tekil
ürün eşsiz kimliği (Unique Device
Identifier) ile alma bildirimi yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Hayır
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
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.
Gönderen
Kurum
Numarası
GKK Sayı - Hayır
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 bildirimine alma bildirimi
yapılmak istendiğini belirtmek için
gereklidir.
3.1.17.3 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"ADT" : 5,
"GKK" : 10
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
74 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.18 Islah / Düzeltici Faaliyet Bildirimi
Kurum/firma, uygunsuz veya teknik düzenlemeye aykırı olduğu için geri çekilen tekil ürünlerdeki gerekli
düzenlemeyi yaptığında Islah Bildirimi yapar.
3.1.18.1 Islah / Düzeltici Faaliyet Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/ekle
3.1.18.2 Islah / Düzeltici Faaliyet Bildirimi Veri Alanları
Tablo 33 .Islah / Düzeltici Faaliyet Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane ıslah
ettiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Kurum
Numarası KUN Sayı - Koşullu
Üretici/İthalatçı’nın tekil ürünü kendi
üzerine almadan bulunduğu kurumda
ıslah / düzeltici faaliyet gerçekleştirmesi
durumunda verilir.
3.1.18.3 Islah / Düzeltici Faaliyet Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 25,
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
75 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
“UDI” : “0151022222233336111603021719030210A213B1211234”
}
3.1.18.4 Eşsiz Kimlik Bilgisi İle Islah / Düzeltici Faaliyet Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/ekle/essizKimlik
3.1.18.5 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları
Tablo 34. Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane ıslah
ettiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Kurum
Numarası KUN Sayı - Koşullu
Üretici/İthalatçı’nın tekil ürünü kendi
üzerine almadan bulunduğu kurumda
ıslah / düzeltici faaliyet gerçekleştirmesi
durumunda verilir.
3.1.18.6 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"ADT" : 25
}
3.1.19 İmha / Bertaraf Bildirimi
Kurum/firma, tekil ürünleri herhangi bir gerekçeyle imha ettiğinde İmha / Bertaraf Bildirimi yapar.
3.1.19.1 İmha / Bertaraf Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/ekle
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
76 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.19.2 İmha / Bertaraf Bildirimi Veri Alanları
Tablo 35 . İmha / Bertaraf Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane imha
ettiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Gerekçe GRK Tek Seçimli
Liste 50 Evet
Aşağıdaki değerlerden birini alabilir.
KURUM_KARARI: Kurum Kararı
GONULLU_GERI_CEKME:
Gönüllü Geri Çekme
SON_KULLANMA_TARIHI_GEC
MIS: Son Kullanma Tarihi
Geçmiş
SAHTE_KACAK: Sahte Kaçak
TASIMA_VE_SAKLAMA_KOSUL
LARI_BOZULMUS: Taşıma ve
Saklama Koşulları Bozulmuş
HASTANIN_VUCUDUNDAN_CIK
ARILMIS: Hastanın
Vücudundan Çıkarılmış
DIGER: Diğer
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
77 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Diğer Gerekçe
Açıklaması DGA Metin 50 Koşullu
Gerekçe alanının değerinin Diğer
olması durumunda verilmesi zorunludur.
İmha/Bertaraf
Belge Numarası BNO Metin 50 Evet
İmha/Bertaraf bildirimi yaparken
girilmesi gereken belge numarasıdır.
3.1.19.3 İmha / Bertaraf Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 25,
"GRK" : "TASIMA_VE_SAKLAMA_KOSULLARI_BOZULMUS",
"BNO" : "123B"
}
3.1.19.4 Eşsiz Kimlik Bilgisi İle İmha / Bertaraf Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/ekle/essizKimlik
3.1.19.5 Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları
Tablo 36. Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
78 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane imha
ettiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Gerekçe GRK Tek Seçimli
Liste 50 Evet
Aşağıdaki değerlerden birini alabilir.
KURUM_KARARI: Kurum Kararı
GONULLU_GERI_CEKME:
Gönüllü Geri Çekme
SON_KULLANMA_TARIHI_GEC
MIS: Son Kullanma Tarihi
Geçmiş
SAHTE_KACAK: Sahte Kaçak
TASIMA_VE_SAKLAMA_KOSUL
LARI_BOZULMUS: Taşıma ve
Saklama Koşulları Bozulmuş
HASTANIN_VUCUDUNDAN_CIK
ARILMIS: Hastanın
Vücudundan Çıkarılmış
DIGER: Diğer
Diğer Gerekçe
Açıklaması DGA Metin 50 Koşullu
Gerekçe alanının değerinin Diğer
olması durumunda verilmesi zorunludur.
İmha/Bertaraf
Belge Numarası BNO Metin 50 Evet
İmha/Bertaraf bildirimi yaparken
girilmesi gereken belge numarasıdır.
3.1.19.6 Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"ADT" : 25,
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
79 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"GRK" : "TASIMA_VE_SAKLAMA_KOSULLARI_BOZULMUS",
"BNO" : "123B"
}
3.1.20 Hastanın Vücudundan Çıkarma Bildirimi
Hakkında geri çekme kararı olan, miadı dolmuş veya görevini tamamlamış tıbbi cihazların tüketiciden geri alınması
durumunda Hastadan Geri Toplatma Bildirimi yapılır.
3.1.20.1 Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/ekle
3.1.20.2 Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları
Tablo 37 . Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Hasta Adı HAA Metin 50 Koşullu Kullanırken kimlik numarası gerekli olan
ürün için verilmesi zorunludur.
Hasta Soyadı HAS Metin 50 Koşullu Kullanırken kimlik numarası gerekli olan
ürün için verilmesi zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
80 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
T.C. Kimlik No TKN Sayı - Koşullu
Kullanırken kimlik numarası gerekli olan
ürünün Türkiye Cumhuriyeti
vatandaşına kullanılması durumunda
verilmesi zorunludur.
Yabancı Kimlik
No YKN Sayı - Koşullu
Kullanırken kimlik numarası gerekli olan
ürünün yabancı kimlik numarası sahibi
hastaya kullanılması durumunda
verilmesi zorunludur.
Pasaport No PAN Metin 20 Koşullu
Kullanırken kimlik numarası gerekli olan
ürünün yabancı kimlik numarası
olmayan yabancı hastaya kullanılması
durumunda verilmesi zorunludur.
Gerekçe GRK Tek Seçimli
Liste - Evet
Aşağıdaki değerlerden birini alabilir.
DOKU_UYUMSUZLUGU
GERI_CAGIRMA
KULLANIM_OMRUNU_DOLDUR
MASI
REVIZYON
DIGER
Diğer Gerekçe
Açıklaması DGA Metin 50 Koşullu
Gerekçe alanının değerinin Diğer
olması durumunda verilmesi zorunludur.
Hastanın
Vücudundan
Çıkarma Tarihi
GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
Kişi Tanımlayıcı
Numara KTN Sayı - Koşullu
Kullanırken kimlik numarası gerekli olan
ürünün T.C..Kimlik No, Yabancı Kimlik
No ya da pasaport numarası
bilinmeyen hastaya kullanılması
durumunda kişiyi tanımlayıcı bir numara
verilmesi zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
81 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Kişi Kimlik Bilgisi
Açıklama Türü TUR
Tek Seçimli
Liste - Zorunlu
Aşağıdaki değerlerden birini alabilir.
TC_KIMLIK_NUMARASI_VAR
YABANCI_KIMLIK_NUMARASI_
VAR
PASAPORT_NUMARASI_VAR
YUPASS_NUMARASI_VAR
YENI_DOGAN
KIMLIGI_BELIRSIZ
DIGER
Kişi Kimlik Bilgisi
Diğer Tür
Açıklaması
DTA Metin 50 Koşullu
Kişi Kimlik Bilgisi Açıklama Türü alanı
değerinin DIGER olması durumunda bu
alan zorunludur.
Serbest metin şeklinde açıklama türü
tanımlanır.
3.1.20.3 Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999",
"GIT" : "2017-11-22",
"TKN" : "11223344678",
"HAA" : "Ali",
"HAS" : "Yılmaz",
"GRK" : "DOKU_UYUMSUZLUGU",
“TUR” : “TC_KIMLIK_NUMARASI_VAR”
}
3.1.20.4 Eşsiz Kimlik Bilgisi İle Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/ekle/essizKimlik
3.1.20.5 Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları
Tablo 38. Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
82 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Hasta Adı HAA Metin 50 Koşullu Kullanırken kimlik numarası gerekli olan
ürün için verilmesi zorunludur.
Hasta Soyadı HAS Metin 50 Koşullu Kullanırken kimlik numarası gerekli olan
ürün için verilmesi zorunludur.
T.C. Kimlik No TKN Sayı - Koşullu
Kullanırken kimlik numarası gerekli olan
ürünün Türkiye Cumhuriyeti
vatandaşına kullanılması durumunda
verilmesi zorunludur.
Yabancı Kimlik
No YKN Sayı - Koşullu
Kullanırken kimlik numarası gerekli olan
ürünün yabancı kimlik numarası sahibi
hastaya kullanılması durumunda
verilmesi zorunludur.
Pasaport No PAN Metin 20 Koşullu
Kullanırken kimlik numarası gerekli olan
ürünün yabancı kimlik numarası
olmayan yabancı hastaya kullanılması
durumunda verilmesi zorunludur.
Gerekçe GRK Tek Seçimli
Liste - Evet
Aşağıdaki değerlerden birini alabilir.
DOKU_UYUMSUZLUGU
GERI_CAGIRMA
KULLANIM_OMRUNU_DOLDUR
MASI
REVIZYON
DIGER
Diğer Gerekçe
Açıklaması DGA Metin 50 Koşullu
Gerekçe alanının değerinin Diğer
olması durumunda verilmesi zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
83 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Hastanın
Vücudundan
Çıkarma Tarihi
GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
Kişi Tanımlayıcı
Numara KTN Sayı - Koşullu
Kullanırken kimlik numarası gerekli olan
ürünün T.C..Kimlik No, Yabancı Kimlik
No ya da pasaport numarası
bilinmeyen hastaya kullanılması
durumunda kişiyi tanımlayıcı bir numara
verilmesi zorunludur.
Kişi Kimlik Bilgisi
Açıklama Türü TUR
Tek Seçimli
Liste - Zorunlu
Aşağıdaki değerlerden birini alabilir.
TC_KIMLIK_NUMARASI_VAR
YABANCI_KIMLIK_NUMARASI_VAR
PASAPORT_NUMARASI_VAR
YUPASS_NUMARASI_VAR
YENI_DOGAN
KIMLIGI_BELIRSIZ
DIGER
Kişi Kimlik Bilgisi
Diğer Tür
Açıklaması
DTA Metin 50 Koşullu
Kişi Kimlik Bilgisi Açıklama Türü alanı
değerinin DIGER olması durumunda bu
alan zorunludur.
Serbest metin şeklinde açıklama türü
tanımlanır.
3.1.20.6 Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek
{
"UDI" : "3456",
"GIT" : "2017-11-22",
"TKN" : "11223344678",
"HAA" : "Ali",
"HAS" : "Yılmaz",
"GRK" : "DOKU_UYUMSUZLUGU",
“TUR” : “TC_KIMLIK_NUMARASI_VAR”
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
84 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.21 Ödünç Verme Bildirimi
Kurum/Firma sahip olduğu tıbbi cihaz için hastaneye geçici hizmete verdiğinde Ödünç Verme Bildirimi yapar.
Sadece tekil bazlı takip edilen ürünler için Ödünç Verme Bildirimi yapılır.
3.1.21.1 Ödünç Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/ekle
3.1.21.2 Ödünç Verme Bildirimi Veri Alanları
Tablo 39 . Ödünç Verme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane ıslah
ettiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Kurum
Numarası KUN Sayı - Evet
Tekil ürünün ödünç verildiği
kurum/firmanın ÜTS’de tanımlı
numarasıdır.
Ödünç Verme
Tarihi GIT Tarih 10 Evet
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
3.1.21.3 Ödünç Verme Bildirimi Örnek İstek
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999",
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
85 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"GIT" : "2017-11-22",
"KUN" : 7
}
3.1.21.4 Eşsiz Kimlik Bilgisi İle Ödünç Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/ekle/essizKimlik
3.1.21.5 Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Veri Alanları
Tablo 40. Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane ıslah
ettiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Kurum
Numarası KUN Sayı - Evet
Tekil ürünün ödünç verildiği
kurum/firmanın ÜTS’de tanımlı
numarasıdır.
Ödünç Verme
Tarihi GIT Tarih 10 Evet
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay ve G: Günü ifade etmektedir.
3.1.21.6 Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"GIT" : "2017-11-22",
"KUN" : 7
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
86 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.22 Ödünç Alma Bildirimi
Kurum/firma kendisine ödünç verilen tekil ürünü kabul etmek için Ödünç Alma Bildirimi yapar.
3.1.22.1 Ödünç Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/ekle
3.1.22.2 Ödünç Alma Bildirimi Veri Alanları
Tablo 41. Ödünç Alma Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ödünç Verme
Bildirim ID VBI Sayı - Evet
Hangi ödünç verme bildirimine karşılık
olarak ödünç alma yapıldığını ifade
eder.
Adet ADT Sayı - Hayır Bu bildirim sadece tekil bazlı ürünler için
yapıldığından, adet bilgisi verilmez.
Gönderen
Kurum
Numarası
GKK Sayı - Koşullu
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.
Ürün Numarası UNO Metin 23 Koşullu
Ürünün ürün numarası/barkod
numarasıdır.
Bildirim kodu veya eşsiz kimlik
verilmediği takdirde tekil ürün bilgileri ile
alma yapılmak istendiğinde ürün
numarası verilmelidir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
87 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Lot/Batch
Numarası LNO 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.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası 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.
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
3.1.22.3 Ödünç Alma Bildirimi Örnek İstek
Örnek 1 ödünç verme bildirim ID ile yapılan ödünç alma bildirimi isteği:
{
"VBI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29"
}
Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan ödünç alma bildirimi isteği:
{
"UNO" : "1111111110324",
"SNO" : "KYY012345678999"
}
3.1.22.4 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/ekle/essizKimlik
3.1.22.5 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Veri Alanları
Tablo 42. Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
88 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Bildirim kodu verilmediği durumda tekil
ürün eşsiz kimliği (Unique Device
Identifier) ile alma bildirimi yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Hayır
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
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.
Gönderen
Kurum
Numarası
GKK Sayı - Hayır
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.
3.1.22.6 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”
}
3.1.23 Ödünç Geri Verme Bildirimi
Hastanenin, Kurum/Firma’dan ödünç aldığı tıbbi cihazı, Kurum/Firma’ya geri verdiğinde Ödünç Geri Verme Bildirimi
yapar. Sadece tekil bazlı takip edilen ürünler için Ödünç Geri Verme Bildirimi yapılır.
3.1.23.1 Ödünç Geri Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/ekle
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
89 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.23.2 Ödünç Geri Verme Bildirimi Veri Alanları
Tablo 43. Ödünç Geri Verme Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 20 Koşullu
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane ıslah
ettiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
3.1.23.3 Ödünç Geri Verme Bildirimi Örnek İstek
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999"
}
3.1.23.4 Eşsiz Kimlik Bilgisi İle Ödünç Geri Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/ekle/essizKimlik
3.1.23.5 Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Veri Alanları
Tablo 44. Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
90 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Tekil ürün eşsiz kimliği (Unique Device
Identifier) ile bildirim yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Koşullu
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane ıslah
ettiğini ifade etmektedir.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
3.1.23.6 Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”
}
3.1.24 Ödünç Geri Alma Bildirimi
Kurum/firma kendisine ödünç geri verilen tekil ürünü kabul etmek için Ödünç Geri Alma Bildirimi yapar.
3.1.24.1 Ödünç Geri Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriAlma/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriAlma/ekle
3.1.24.2 Ödünç Geri Alma Bildirimi Veri Alanları
Tablo 45. Ödünç Geri Alma Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ödünç Geri
Verme Bildirim
ID
VBI Sayı - Evet
Hangi ödünç geri verme bildirimine
karşılık olarak ödünç geri alma
yapıldığını ifade eder.
Adet ADT Sayı - Hayır Bu bildirim sadece tekil bazlı ürünler için
yapıldığından, adet bilgisi verilmez.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
91 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Gönderen
Kurum
Numarası
GKK Sayı - Koşullu
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.
Ürün Numarası UNO Metin 23 Koşullu
Ürünün ürün numarası/barkod
numarasıdır.
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
Numarası LNO 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.
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası 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.
Tekil bazda takip edilen ürünler için
verilmesi zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
92 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.24.3 Ödünç Geri Alma Bildirimi Örnek İstek
Örnek 1 ödünç geri verme bildirim ID ile yapılan ödünç geri alma bildirimi isteği:
{
"VBI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29"
}
Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan ödünç geri alma bildirimi isteği:
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999"
}
3.1.24.4 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriAlma/ekle/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriAlma/ekle/essizKimlik
3.1.24.5 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Veri Alanları
Tablo 46. Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Eşsiz Kimlik UDI Metin - Zorunlu
Bildirim kodu verilmediği durumda tekil
ürün eşsiz kimliği (Unique Device
Identifier) ile alma bildirimi yapılmak
istendiğinde verilmesi gerekmektedir.
Adet ADT Sayı - Hayır
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
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.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
93 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Gönderen
Kurum
Numarası
GKK Sayı - Hayır
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.
3.1.24.6 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”
}
3.1.25 Envanter Bildirimi
Sağlık hizmet sunucuları, envantere almak istediği ürünler için bir Envanter Bildirimi yapar.
3.1.25.1 Envanter Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/envanter/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/envanter/ekle
3.1.25.2 Envanter Bildirimi Veri Alanları
Tablo 47. Envanter Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Üretici/İthalatçı
Firma No UIK Sayı - Evet
Ürünün üretici/ithalatçı kurum
numarasıdır.
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu Tekil ürünün lot/batch numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
94 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Seri/Sıra
Numarası SNO Metin 20 Evet Tekil ürünün seri/sıra numarasıdır.
Envanter Tarihi ENT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay, G: Gün.
Son Kalibrasyon
Tarihi SKT Tarih 10 Hayır
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay, G: Gün.
Son Bakım
Tarihi SBT Tarih 10 Hayır
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay, G: Gün.
3.1.25.3 Envanter Bildirimi Örnek İstek
{
"UIK" : "2081250",
"UNO" : "9321502013475",
“LNO” : “4356”,
"SNO" : "112212345678MM9",
"ENT" : "2018-08-05",
"SKT" : "2018-11-05",
"SBT" : "2018-12-05"
}
3.1.26 Stok Bildirimi
Sağlık hizmet sunucuları dışındaki kurumlar, stok yapmak istediği ürünler için Stok Bildirimi yapar.
3.1.26.1 Stok Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/stok/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/stok/ekle
3.1.26.2 Stok Bildirimi Veri Alanları
Tablo 48. Stok Bildirimi Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
95 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Üretici/İthalatçı
Firma No UIK Sayı - Evet
Ürünün üretici/ithalatçı kurum
numarasıdır.
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Koşullu Tekil ürünün lot/batch numarasıdır.
Seri/Sıra
Numarası SNO Metin 20 Evet Tekil ürünün seri/sıra numarasıdır.
Adet ADT Sayı - Hayır
Tekil takip edilen ürünler için verilmez.
Lot bazında takip edilen ürünler için
aynı lot/seri/batch’ten kaç tane
alındığını ifade etmektedir.
Üretim Tarihi URT Tarih 10 Evet
Ürünün üretim tarihi girilmelidir.
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay, G: Gün.
Son Kullanma
Tarihi SKT Tarih 10 Hayır
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay, G: Gün.
3.1.26.3 Stok Bildirimi Örnek İstek
Örnek 1 lot ürün:
{
"UIK" : "2081250",
"UNO" : "9321502013475",
“LNO” : “4356”,
“ADT”: 100,
"URT" : "2018-11-05",
"SKT" : "2018-12-05"
}
Örnek 2 tekil takip ürün:
{
"UIK" : "2081250",
"UNO" : "9321502013475",
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
96 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
“SNO” : “4356”,
"URT" : "2018-11-05",
"SKT" : "2018-12-05"
}
3.2 İPTAL BİLDİRİMLERİ
Kurum/firma, hatalı yaptığı bildirimi iptal etmek için iptal bildirimi yapar. Her bir bildirime karşılık farklı iptal bildirimleri
vardır. Tüm iptal bildirimlerinin aldığı parametre tipleri ve dönüş veri yapıları aynıdır.
Not: Alma ve Geri Çekme Alma bildirimlerine karşılık olarak iptal bildirimi yoktur.
3.2.1 İptal Bildirimleri Servis Adresleri
Tablo 49. İptal Bildirimleri Servis Adresleri
İptal Bildirim Adı Servis Adresi
Üretim İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/uretim/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/uretim/iptal
İthalat İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ithalat/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ithalat/iptal
Verme İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/iptal
ÜTS’de Tanımsız Yere Verme İptal Bildirimi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/iptal
Test Ortamı:
https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/iptal
ÜTS’de Tanımsız Yerden İade Alma İptal
Bildirimi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/iptal
Test Ortamı:
https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/iptal
Kullanım İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/iptal
Tüketiciye Vermeyi İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/iptal
Tüketiciden İade Alma İptal Bildirimi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/iptal
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
97 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
İptal Bildirim Adı Servis Adresi
Geçici Kullanıma Verme İptal Bildirimi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/iptal
Kullanımdan Alma İptal Bildirimi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/iptal
Yeniden İşleme İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/iptal
İhracat İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/iptal
Mahrecine İade Etme İptal Bildirimi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/iptal
HEK / Zayiat İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/iptal
Geri Çekme Verme İptal Bildirimi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/iptal
Islah / Düzeltici Faaliyet İptal Bildirimi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/iptal
İmha / Bertaraf İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/iptal
Hastanın Vücudundan Çıkarma İptal Bildirimi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/iptal
Test Ortamı:
https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/iptal
Ödünç Verme İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/iptal
Ödünç Geri Verme İptal Bildirimi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/iptal
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
98 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
İptal Bildirim Adı Servis Adresi
Envanter İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/envanter/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/envanter/iptal
Stok İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/stok/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/stok/iptal
3.2.1.1 İptal Bildirimi Veri Alanları
Tablo 50. İptal Bildirimi Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Bildirim ID BID Metin - Evet İptal edilmek istenen bildirimin tekil
tanımlayıcısıdır.
3.2.1.2 İptal Bildirimleri Örnek İstek
{
"BID" : "d273e5e1-0dfc-11e7-a653-f52ed20ddd29"
}
3.3 BİLDİRİM CEVABI
Tüm hareket bildirimleri için dönülen cevabın veri yapısı ortaktır.
3.3.1 Bildirim Cevabı Veri Alanları
Tablo 51. Bildirim Cevabı Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Metin 36 Yapılan bildirimin ID’sidir.
Mesaj Listesi MSJ Liste
(TIP, MET, KOD, MPA)
- Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
99 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4 SORGULAMA SERVİSLERİ
3.4.1 Tekil Ürün Sorgula
Kurum/firma üzerindeki tekil ürünleri sorgular.
3.4.1.1 Tekil Ürün Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/sorgula
3.4.1.2 Tekil Ürün Sorgula İstek Veri Alanları
Tablo 52. Tekil Ürün Sorgula İstek Veri Alanları
Adı JSON
Kodu
Veri
Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
Mu? Açıklama
Ürün
Numarası UNO Metin 23
Zorunlu Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası LNO Metin 36
Koşullu Lot bazında takip edilen ürünler için verilmesi
zorunludur.
Seri/Sıra
Numarası SNO Metin 36
Koşullu Seri bazda takip edilen ürünler için verilmesi
zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
100 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.1.3 Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 53. Tekil Ürün Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC
Liste
(UTP, UNO, LNO, SNO, ADT, URT, SKT, ITT, UIK, UAK, SKG, KKG, UDI, MME)
- İşlemin başarılı olması durumunda döndürülür.
Ürün Tipi SNC.
UTP Metin 20
Aşağıdaki değerlerden birini alabilir
TIBBI_CIHAZ: Tıbbi Cihaz
KOZMETIK_URUN: Kozmetik Ürün
Ürün Numarası SNC.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
SNC.
LNO Metin 20
Seri/Sıra
Numarası
SNC.
SNO Metin 20
Adet SNC.
ADT Sayı -
Üretim Tarihi SNC.
URT Tarih 8
Son Kullanma
Tarihi
SNC.
SKT Tarih 10
Ithalat Tarihi SNC.
ITT Tarih 10
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
101 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Üretici/ İthalatçı
Kurum
Numarası
SNC.
UIK Sayı - Tekil ürünü üreten/ithal eden kurumun numarasıdır.
Ürün Ağacı
Konfigürasyonu
SNC.
UAK Metin -
Tekil ürünün sahip olduğu takip konfigürasyonudur.
Aşağıdaki değerlerden birini alabilir.
TEKIL
LOT
Satarken Kimlik
Numarası
Gerekli Mi?
SNC.
SKG Metin -
Aşağıdaki değerlerden birini alabilir.
True
False
Kullanırken
Kimlik Numarası
Gerekli Mi?
SNC.
KKG Metin -
Aşağıdaki değerlerden birini alabilir.
True
False
Eşsiz Kimlik
Numarası
SNC.
UDI Metin - Tekil ürünün eşsiz kimlik bilgisidir.
Marka Model
Etiket
SNC.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
102 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.1.4 Tekil Ürün Sorgula Örnek İstek
{
"UNO" : "1111111110027",
"LNO" : "250515186001",
"SAN" : 0
}
3.4.1.5 Eşsiz Kimlik Bilgisi ile Tekil Ürün Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/sorgula/essizKimlik
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/sorgula/essizKimlik
3.4.1.6 Eşsiz Kimlik İle Tekil Ürün Sorgula İstek Veri Alanları
Tablo 54. Eşsiz Kimlik ile Tekil Ürün Sorgula İstek Veri Alanları
Adı
JSON
Kodu
Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Eşsiz Kimlik UDI
Metin Eşsiz kimlik ile tekil ürün sorgulamak için
zorunludur.
3.4.1.7 Eşsiz Kimlik İle Tekil Ürün Sorgula Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”
}
3.4.2 Üretici/İthalatçı Tekil Ürün Sorgula
Kurum/firma sahipliğe göre tekil ürünleri sorgular.
3.4.2.1 Üretici/İthalatçı Tekil Ürün Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/uretici/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/uretici/sorgula
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
103 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.2.2 Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları
Tablo 53. ‘deki istek veri alanlarından hiçbiri girdi olarak verilmezse, sorgulama sonucunda kurumun sahip olduğu
en fazla 10 tane kayıt cevap olarak döner. Bu istek veri alanlarından sadece ürün numarası kıstas olarak verilirse;
verilen ürün numarasına sahip olan tekil ürünlerden en fazla 10 kayıt cevap olarak döner. Belirli bir seri numarasına
veya lot numarasına göre sorgulama yapılması için ürün numarasına ek olarak seri numarası (tekil takip edilen
ürünler için) veya lot numarası (lot takip edilen ürünler için) verilmesi gerekmektedir.
Tablo 55. Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası LNO Metin 20
Lot bazında takip edilen ürünler için verilmesi
zorunludur.
Seri/Sıra
Numarası SNO Metin 20
Tekil bazda takip edilen ürünler için verilmesi
zorunludur.
Sayfa Numarası SAN Sayı -
Sorgu sonucunda en fazla 10 tane kayıt
döndürülmektedir. Bu alan hangi sıradaki 10’luk
sonucun döndürülmesi gerektiğini ifade eder.
3.4.2.3 Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 56. Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC
Liste
(UTP, UNO, LNO, SNO, ADT, URT, SKT, ITT, KUN, UIK,
KUU, MME)
- İşlemin başarılı olması durumunda döndürülür.
Ürün Tipi SNC.
UTP Metin 20
Aşağıdaki değerlerden birini alabilir
TIBBI_CIHAZ: Tıbbi Cihaz
KOZMETIK_URUN: Kozmetik Ürün
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
104 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Numarası SNC.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
SNC.
LNO Metin 20
Seri/Sıra
Numarası
SNC.
SNO Metin 20
Adet SNC.
ADT Sayı -
Üretim Tarihi SNC.
URT Tarih 8
Son Kullanma
Tarihi
SNC.
SKT Tarih 10
İthalat Tarihi SNC.
ITT Tarih 10
Kurum
Numarası
SNC.
KUN Sayı - Ürünün sahibi olan kurumun numarasıdır.
Üretici/İthalatçı
Kurum
Numarası
SNC.
UIK Sayı - Tekil ürünü üreten/ithal eden kurumun numarasıdır.
Kurum Unvan SNC.
KUU Sayı -
Tekil ürünün sahibinin ÜTS’de tanımlı kurum
numarasıdır.
Marka Model
Etiket
SNC.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
105 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.2.4 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek
{
"UNO" : "1111111110027",
"LNO" : "250515186001",
"SAN" : 0
}
3.4.3 Üretici/İthalatçı Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)
Kurum/firma sahipliğe göre tekil ürünleri sorgular.
3.4.3.1 Üretici/İthalatçı Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/uretici/sorgula/offset
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/uretici/sorgula/offset
3.4.3.2 Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 57. Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
106 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Lot/Batch
Numarası LNO Metin 20
Lot bazında takip edilen ürünler için verilmesi
zorunludur.
Seri/Sıra
Numarası SNO Metin 20
Tekil bazda takip edilen ürünler için verilmesi
zorunludur.
Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.
Hiçbir değer verilmezse kabul edilen değeri 10’dur.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
3.4.3.3 Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 58. Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(LST, OFF) -
LST, OFF parametrelerinden oluşan nesnedir.
İşlemin başarılı olması durumunda döndürülür.
Liste LST
Liste
(UTP, UNO, LNO, SNO, ADT, URT, SKT, ITT, KUN, UIK,
KUU, MME)
- UTP, UNO, LNO, SNO, ADT, URT, SKT, ITT, KUN,
UIK, KUU, MME parametrelerinden oluşan listedir.
Ürün Tipi LST.
UTP Metin 20
Aşağıdaki değerlerden birini alabilir
TIBBI_CIHAZ: Tıbbi Cihaz
KOZMETIK_URUN: Kozmetik Ürün
Ürün Numarası LST.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
LST.
LNO Metin 20
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
107 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Seri/Sıra
Numarası
LST.
SNO Metin 20
Adet LST.
ADT Sayı -
Üretim Tarihi LST.
URT Tarih 8
Son Kullanma
Tarihi
LST.
SKT Tarih 10
İthalat Tarihi LST.
ITT Tarih 10
Kurum
Numarası
LST.
KUN Sayı - Ürünün sahibi olan kurumun numarasıdır.
Üretici/İthalatçı
Kurum
Numarası
LST.
UIK Sayı - Tekil ürünü üreten/ithal eden kurumun numarasıdır.
Kurum Unvan LST.
KUU Sayı -
Tekil ürünün sahibinin ÜTS’de tanımlı kurum
numarasıdır.
Marka Model
Etiket
LST.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
108 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.3.4 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)
{
"UNO" : "1111111110027",
"SNO" : "250515186001",
"ADT" : 5
}
Gelen Cevap Yapısı :
{
"SNC": {
"LST": [
{ .. }, { .. }
],
"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"
},
"MSJ": null
}
3.4.3.5 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile)
Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki
kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.
{
"UNO" : "1111111110027",
"SNO" : "250515186001",
"ADT" : 5,
“OFF”: “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
109 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
}
3.4.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula
Kurum/firma sistem dışına çıkan tekil ürünleri ve bu tekil ürünlere yapılan bildirimleri sorgular.
3.4.4.1 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Servis Adresi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ureticiIthalatci/tekilUrun/sistemDisinaCikan/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ureticiIthalatci/tekilUrun/sistemDisinaCikan/sorgula
3.4.4.2 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları
Tablo 59. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası LNO Metin 20
Lot bazında takip edilen ürünler için verilmesi
zorunludur.
Seri/Sıra
Numarası SNO Metin 20
Tekil bazda takip edilen ürünler için verilmesi
zorunludur.
Sayfa Numarası SAN Sayı -
Sorgu sonucunda en fazla 10 tane kayıt
döndürülmektedir. Bu alan hangi sıradaki 10’luk
sonucun döndürülmesi gerektiğini ifade eder.
3.4.4.3 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 60. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
110 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC
Liste
(BID, UNO, LNO, SNO, ADT, GKK, KUN, BNO, BZA, BTI,
BDR, BEN, UIK, GIT,
BKU, DKU)
- İşlemin başarılı olması durumunda döndürülür.
Bildirim ID SNC.
BID Metin 36 Bildirimin bildirim kodudur.
Ürün Numarası SNC.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
SNC.
LNO Metin 20
Lot bazında takip edilen ürünler için verilmesi
zorunludur.
Seri/Sıra
Numarası
SNC.
SNO Metin 20
Tekil bazda takip edilen ürünler için verilmesi
zorunludur.
Adet SNC.
ADT Sayı - Tekil ürün adedidir.
Kurum No SNC.
GKK Sayı - Bildirimi yapan kurum numarasıdır.
Diğer Kurum No SNC.
KUN Sayı - Tekil ürünün verildiği kurum numarasıdır.
Belge No SNC.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Zamanı SNC.
BZA Tarih 10 Bildirim zamanıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
111 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bildirim Tipi SNC.
BTI Metin -
Bildirimin tipidir. Aşağıdaki değeri alabilir.
TUKETICIYE_VERME
TUKETICIDEN_IADE_ALMA_IPTAL
KULLANIM
IHRACAT
HEK_ZAYIAT
IMHA_BERTARAF
MAHRECINE_IADE_ETME
YENIDEN_ISLEME
UTSDE_TANIMSIZ_YERE_VERME
UTSDE_TANIMSIZ_YERDEN_IADE_ALMA_I
PTAL
HASTANIN_VUCUDUNDAN_CIKARMA
Bildirim Durumu SNC.
BDR Metin -
Aşağıdaki değerlerden birini alabilir:
AKTIF
PASIF
IPTAL
KULLANIMDAN_ALINDI
VERILDI
ALINDI
TUKETICIDEN ALINDI
UTSDE_TANIMSIZ_YERDEN_IADE_ALINDI
GECICI_VERME_ALINDI
Bedelsiz
Numune
SNC.
BEN Boolean -
Tekil ürünlerin bedelsiz numune olup olmadığını
ifade etmektedir. Değer “true” ise bedelsiz numune,
“false” ise bedelsiz numune değildir.
Üretici/İthalatçı
Kurum No
SNC.
UIK Sayı -
Tekil ürünün üreticisinin/ithalatçısının ÜTS’de
tanımlı kurum numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
112 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gerçek İşlem
Tarihi
SNC.
GIT Tarih 10
Bu tarih 5 tane bildirimde dönmektedir:
Tüketiciye Verme Bildiriminde, tekil ürünün
"Tüketiciye Verme Tarihi"
Kullanım Bildiriminde, tekil ürünün “Kullanım
Tarihi”
Ödünç Verme Bildiriminde, tekil ürünü “Ödünç
Verme Tarihi”
Geçici Kullanıma Verme Bildiriminde, tekil
ürünü “Geçici Kullanıma Verme Tarihi”
Hastanın Vücudundan Çıkarma Bildiriminde,
tekil ürünü “Hastanın Vücudundan Çıkarma
Tarihi”
olarak dönmektedir.
Bildiren Kurum
Unvan
SNC.
BKU Sayı - Bildirimi yapan kurumun unvanıdır.
Diğer Kurum
Unvan
SNC.
DKU Sayı - Bildirimin yapıldığı kurumun unvanıdır.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
113 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.4.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek
{
"UNO" : " 1111111110010",
"LNO" : "250515186001",
"SAN" : 0
}
3.4.5 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)
Kurum/firma sistem dışına çıkan tekil ürünleri ve bu tekil ürünlere yapılan bildirimleri sorgular.
3.4.5.1 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi
ile)
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ureticiIthalatci/tekilUrun/sistemDisinaCikan/sorgula/offset
Test Ortamı:
https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ureticiIthalatci/tekilUrun/sistemDisinaCikan/sorgula/offset
3.4.5.2 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı
Parametresi ile)
Tablo 61. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası LNO Metin 20
Lot bazında takip edilen ürünler için verilmesi
zorunludur.
Seri/Sıra
Numarası SNO Metin 20
Tekil bazda takip edilen ürünler için verilmesi
zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
114 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.
Hiçbir değer verilmezse kabul edilen değeri 10’dur.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
3.4.5.3 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı
Parametresi ile)
Tablo 62. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(LST, OFF) -
LST, OFF parametrelerinden oluşan nesnedir.
İşlemin başarılı olması durumunda döndürülür.
Liste LST
Liste
(BID, UNO, LNO, SNO, ADT, GKK, KUN, BNO, BZA, BTI,
BDR, BEN, UIK, GIT,
BKU, DKU)
-
BID, UNO, LNO, SNO, ADT, GKK, KUN, BNO,
BZA, BTI, BDR, BEN, UIK, GIT, BKU, DKU
parametrelerini içeren listedir.
Bildirim ID LST.
BID Metin 36 Bildirimin bildirim kodudur.
Ürün Numarası LST.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
LST.
LNO Metin 20
Lot bazında takip edilen ürünler için verilmesi
zorunludur.
Seri/Sıra
Numarası
LST.
SNO Metin 20
Tekil bazda takip edilen ürünler için verilmesi
zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
115 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Adet LST.
ADT Sayı - Tekil ürün adedidir.
Kurum No LST.
GKK Sayı - Bildirimi yapan kurum numarasıdır.
Diğer Kurum No LST.
KUN Sayı - Tekil ürünün verildiği kurum numarasıdır.
Belge No LST.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Zamanı LST.
BZA Tarih 10 Bildirim zamanıdır.
Bildirim Tipi LST.
BTI Metin -
Bildirimin tipidir. Aşağıdaki değeri alabilir.
TUKETICIYE_VERME
TUKETICIDEN_IADE_ALMA_IPTAL
KULLANIM
IHRACAT
HEK_ZAYIAT
IMHA_BERTARAF
MAHRECINE_IADE_ETME
YENIDEN_ISLEME
UTSDE_TANIMSIZ_YERE_VERME
UTSDE_TANIMSIZ_YERDEN_IADE_ALMA_I
PTAL
HASTANIN_VUCUDUNDAN_CIKARMA
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
116 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bildirim Durumu LST.
BDR Metin -
Aşağıdaki değerlerden birini alabilir:
AKTIF
PASIF
IPTAL
KULLANIMDAN_ALINDI
VERILDI
ALINDI
TUKETICIDEN ALINDI
UTSDE_TANIMSIZ_YERDEN_IADE_ALINDI
GECICI_VERME_ALINDI
Bedelsiz
Numune
LST.
BEN Boolean -
Tekil ürünlerin bedelsiz numune olup olmadığını
ifade etmektedir. Değer “true” ise bedelsiz numune,
“false” ise bedelsiz numune değildir.
Üretici/İthalatçı
Kurum No
LST.
UIK Sayı -
Tekil ürünün üreticisinin/ithalatçısının ÜTS’de
tanımlı kurum numarasıdır.
Gerçek İşlem
Tarihi
LST.
GIT Tarih 10
Bu tarih 5 tane bildirimde dönmektedir:
Tüketiciye Verme Bildiriminde, tekil ürünün
"Tüketiciye Verme Tarihi"
Kullanım Bildiriminde, tekil ürünün “Kullanım
Tarihi”
Ödünç Verme Bildiriminde, tekil ürünü “Ödünç
Verme Tarihi”
Geçici Kullanıma Verme Bildiriminde, tekil
ürünü “Geçici Kullanıma Verme Tarihi”
Hastanın Vücudundan Çıkarma Bildiriminde,
tekil ürünü “Hastanın Vücudundan Çıkarma
Tarihi”
olarak dönmektedir.
Bildiren Kurum
Unvan
LST.
BKU Sayı - Bildirimi yapan kurumun unvanıdır.
Diğer Kurum
Unvan
LST.
DKU Sayı - Bildirimin yapıldığı kurumun unvanıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
117 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.5.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi
ADT) ile)
{
"UNO" : " 1111111110010",
"SNO" : "250515186001",
"ADT" : 5
}
Gelen Cevap Yapısı :
{
"SNC": {
"LST": [
{ .. }, { .. }
],
"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
118 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
},
"MSJ": null
}
3.4.5.5 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF)
ile)
Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki
kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.
{
"UNO" : "1111111110010",
"SNO" : "250515186001",
"ADT" : 5,
“OFF”: “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”
}
3.4.6 Askıdaki Tekil Ürün Sorgula
Kurum/firmanın verme bildirimi yapıp, karşı kurum/firmanın alma bildirimi yapmadığı tekil ürünleri sorgular.
3.4.6.1 Askıdaki Tekil Ürün Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/askidakiler
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/askidakiler
3.4.6.2 Askıdaki Tekil Ürün Sorgula İstek Veri Alanları
Tablo 63. Askıdaki Tekil Ürün Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gönderilen
Kurum No KUN Sayı -
Tekil ürünün verildiği kurum/firmanın ÜTS’de tanımlı
numarasıdır.
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası LNO Metin 20
Lot bazında takip edilen ürünler için verilmesi
zorunludur.
Seri/Sıra
Numarası SNO Metin 20
Tekil bazda takip edilen ürünler için verilmesi
zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
119 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sayfa Numarası SAN Sayı -
Sorgu sonucunda en fazla 10 tane kayıt
döndürülmektedir. Bu alan hangi sıradaki 10’luk
sonucun döndürülmesi gerektiğini ifade eder.
Tablo 61. ‘deki istek veri alanlarından hiçbiri girdi olarak verilmezse, sorgulama sonucunda askıda olan tekil
ürünlerden fazla 10 tane kayıt cevap olarak döner. Bu istek veri alanlarından sadece ürün numarası kıstas olarak
verilirse; verilen ürün numarasına sahip olan askıdaki tekil ürünlerden en fazla 10 kayıt cevap olarak döner. Belirli
bir seri numarasına veya lot numarasına göre sorgulama yapılması için ürün numarasına ek olarak seri numarası
(tekil takip edilen ürünler için) veya lot numarası (lot takip edilen ürünler için) verilmesi gerekmektedir. Tekil ürünün
gönderildiği kuruma göre sorgulanması isteniyorsa ürün numarası, ve seri veya lot numarasına ek olarak tekil
ürünün gönderildiği kurumun da verilmesi gerekmektedir.
3.4.6.3 Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 64. Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC
Liste
(UNO, LNO, SNO, BRK, BNO, KUN, ADT, BID, BTI, BZA,
AKU, MME)
- İşlemin başarılı olması durumunda döndürülür.
Ürün Numarası SNC.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
SNC.
LNO Metin 20
Seri/Sıra
Numarası
SNC.
SNO Metin 20
Belge Numarası SNC.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
120 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gönderilen
Kurum No
SNC.
KUN Sayı -
Tekil ürünün verildiği kurum/firmanın ÜTS’de tanımlı
numarasıdır.
Adet SNC.
ADT Sayı -
Bildirim Kodu SNC.
BID Metin 36 Verme bildiriminin bildirim kodudur.
Bildirim Tipi SNC.
BTI Metin -
Bildirimin tipidir. Aşağıdaki değerlerden birini alabilir:
VERME
GECICI_VERME
GERI_CEKME_VERME
Bildirim Zamanı SNC.
BZA Tarih 19
YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:
Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.
Alan Kurum
Unvan
SNC.
AKU Metin - Tekil ürünün verildiği kurumun unvanıdır.
Marka Model
Etiket
SNC.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
121 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.6.4 Askıdaki Tekil Ürün Sorgula Örnek İstek
{
"KUN" : 7,
"UNO" : "1111111110027",
"LNO" : "250515186001",
"SAN" : 0
}
3.4.7 Askıdaki Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)
Kurum/firmanın verme bildirimi yapıp, karşı kurum/firmanın alma bildirimi yapmadığı tekil ürünleri sorgular.
3.4.7.1 Askıdaki Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/askidakiler/offset
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/askidakiler/offset
3.4.7.2 Askıdaki Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 65. Askıdaki Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gönderilen
Kurum No KUN Sayı -
Tekil ürünün verildiği kurum/firmanın ÜTS’de tanımlı
numarasıdır.
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası LNO Metin 20
Lot bazında takip edilen ürünler için verilmesi
zorunludur.
Seri/Sıra
Numarası SNO Metin 20
Tekil bazda takip edilen ürünler için verilmesi
zorunludur.
Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.
Hiçbir değer verilmezse kabul edilen değeri 10’dur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
122 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
3.4.7.3 Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 66. Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(LST, OFF) -
LST, OFF parametrelerinden oluşan nesnedir.
İşlemin başarılı olması durumunda döndürülür.
Liste LST
Liste
(UNO, LNO, SNO, BRK, BNO, KUN, ADT, BID, BTI, BZA,
AKU, MME)
- UNO, LNO, SNO, BRK, BNO, KUN, ADT, BID, BTI, BZA, AKU, MME parametrelerinden oluşan listedir.
Ürün Numarası LST.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
LST.
LNO Metin 20
Seri/Sıra
Numarası
LST.
SNO Metin 20
Belge Numarası LST.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Gönderilen
Kurum No
LST.
KUN Sayı -
Tekil ürünün verildiği kurum/firmanın ÜTS’de tanımlı
numarasıdır.
Adet LST.
ADT Sayı -
Bildirim Kodu LST.
BID Metin 36 Verme bildiriminin bildirim kodudur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
123 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bildirim Tipi LST.
BTI Metin -
Bildirimin tipidir. Aşağıdaki değerlerden birini alabilir:
VERME
GECICI_VERME
GERI_CEKME_VERME
Bildirim Zamanı LST.
BZA Tarih 19
YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:
Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.
Alan Kurum
Unvan
LST.
AKU Metin - Tekil ürünün verildiği kurumun unvanıdır.
Marka Model
Etiket
LST.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.7.4 Askıdaki Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)
{
"KUN" : 7,
"UNO" : "1111111110027",
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
124 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"LNO" : "250515186001",
"ADT" : 5
}
Gelen Cevap Yapısı :
{
"SNC": {
"LST": [
{ .. }, { .. }
],
"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"
},
"MSJ": null
}
3.4.7.5 Askıdaki Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile)
{
"UNO" : "1111111110027", "LNO" : "250515186001", "ADT" : 5, “OFF”: “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”
}
3.4.8 Ödünç Alınan Tekil Ürün Sorgula
Kurum/firma üzerindeki ödünç alma bildirimi yaptığı tekil ürünleri sorgular.
3.4.8.1 Ödünç Alınan Tekil Ürün Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/lokasyon/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/lokasyon/sorgula
3.4.8.2 Ödünç Alınan Tekil Ürün Sorgula İstek Veri Alanları
Tablo 67. Ödünç Alınan Tekil Ürün Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası LNO Metin 20
Lot bazında takip edilen ürünler için verilmesi
zorunludur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
125 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Seri/Sıra
Numarası SNO Metin 20
Tekil bazda takip edilen ürünler için verilmesi
zorunludur.
Sayfa Numarası SAN Sayı -
Sorgu sonucunda en fazla 10 tane kayıt
döndürülmektedir. Bu alan hangi sıradaki 10’luk
sonucun döndürülmesi gerektiğini ifade eder.
Tablo 65‘ deki istek veri alanlarından hiçbiri girdi olarak verilmezse, sorgulama sonucunda ödünç alınan tekil
ürünlerden fazla 10 tane kayıt cevap olarak döner. Bu istek veri alanlarından sadece ürün numarası kıstas olarak
verilirse; verilen ürün numarasına sahip olan tekil ürünlerden en fazla 10 kayıt cevap olarak döner. Belirli bir seri
numarasına veya lot numarasına göre sorgulama yapılması için ürün numarasına ek olarak seri numarası (tekil
takip edilen ürünler için) veya lot numarası (lot takip edilen ürünler için) verilmesi gerekmektedir.
3.4.8.3 Ödünç Alınan Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 68. Ödünç Alınan Tekil Ürün Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC
Liste
(UTP, UNO, LNO, SNO, ADT, URT, SKT, ITT, UIK, UAK, SKG, KKG, UDI, UIK,
MME)
- İşlemin başarılı olması durumunda döndürülür.
Ürün Tipi SNC.
UTP Metin 20
Aşağıdaki değerlerden birini alabilir
TIBBI_CIHAZ: Tıbbi Cihaz
KOZMETIK_URUN: Kozmetik Ürün
Ürün Numarası SNC.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
SNC.
LNO Metin 20
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
126 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Seri/Sıra
Numarası
SNC.
SNO Metin 20
Adet SNC.
ADT Sayı -
Üretim Tarihi SNC.
URT Tarih 8
Son Kullanma
Tarihi
SNC.
SKT Tarih 10
Ithalat Tarihi SNC.
ITT Tarih 10
Üretici/ İthalatçı
Kurum
Numarası
SNC.
UIK Sayı - Tekil ürünü üreten/ithal eden kurumun numarasıdır.
Ürün Ağacı
Konfigürasyonu
SNC.
UAK Metin -
Tekil ürünün sahip olduğu takip konfigürasyonudur.
Aşağıdaki değerlerden birini alabilir.
TEKIL
LOT
Satarken Kimlik
Numarası
Gerekli Mi?
SNC.
SKG Metin -
Aşağıdaki değerlerden birini alabilir.
True
False
Kullanırken
Kimlik Numarası
Gerekli Mi?
SNC.
KKG Metin -
Aşağıdaki değerlerden birini alabilir.
True
False
Eşsiz Kimlik
Numarası
SNC.
UDI Metin -
Marka Model
Etiket
SNC.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
127 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Üretici/İthalatçı
Kurum No
SNC.
UIK Sayı -
Tekil ürünün üreticisinin/ithalatçısının ÜTS’de
tanımlı kurum numarasıdır.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.8.4 Ödünç Alınan Tekil Ürün Sorgula Örnek İstek
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999",
"SAN" : 0
}
3.4.9 Bildirim Sorgula
Kurum/firmanın yapmış olduğu bildirimleri sorgular.
3.4.9.1 Bildirim Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/sorgula
3.4.9.2 Bildirim Sorgula İstek Veri Alanları
Tablo 69. Bildirim Sorgula İstek Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
128 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası LNO Metin 36
Lot bazında takip edilen ürünler için verilmesi
zorunludur.
Seri/Sıra
Numarası SNO Metin 36
Tekil bazda takip edilen ürünler için verilmesi
zorunludur.
Sayfa Numarası SAN Sayı -
Sorgu sonucunda en fazla 10 tane kayıt
döndürülmektedir. Bu alan hangi sıradaki 10’luk
sonucun döndürülmesi gerektiğini ifade eder.
Tablo 67. ‘deki istek veri alanlarından hiçbiri girdi olarak verilmezse, sorgulama sonucunda kurumun yaptığı
bildirimlerden en fazla 10 tane kayıt cevap olarak döner. Bu istek veri alanlarından sadece ürün numarası kıstas
olarak verilirse; verilen ürün numarasına sahip olan bildirimlerden en fazla 10 kayıt cevap olarak döner. Belirli bir
seri numarasına veya lot numarasına göre sorgulama yapılması için ürün numarasına ek olarak seri numarası (tekil
takip edilen ürünler için) veya lot numarası (lot takip edilen ürünler için) verilmesi gerekmektedir.
3.4.9.3 Bildirim Sorgula Cevap Veri Alanları
Tablo 70. Bildirim Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC
Liste
(BTI, UNO, LNO, SNO, ADT, BNO, BDR, BID, BZA, GKK, KUN, BEN, UIK, GIT,
BKU, DKU, AAD)
- İşlemin başarılı olması durumunda döndürülür.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
129 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Tipi SNC.
BTI Metin -
Aşağıdaki değerlerden birini alabilir
alma
gecici-kullanima-verme
gecici-kullanima-verme-iptal
odunc-alma
odunc-verme
odunc-verme-iptal
geri-cekme-alma
geri-cekme-verme
geri-cekme-verme-iptal
hastanin-vucudundan-cikarma
hastanin-vucudundan-cikarma-iptal
hek-zayiat
hek-zayiat-iptal
ihracat
ihracat-iptal
imha-bertaraf
imha-bertaraf-iptal
islah-duzeltici-faaliyet
islah-duzeltici-faaliyet-iptal
ithalat
ithalat-iptal
kullanim
kullanim-iptal
kullanimdan-alma
kullanimdan-alma-iptal
mahrecine-iade-etme
mahrecine-iade-etme-iptal
tuketiciden-iade-alma
tuketiciden-iade-alma-iptal
tuketiciye-verme
tuketiciye-verme-iptal
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
130 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Tipi SNC.
BTI Metin -
uretim
uretim-iptal
utsde-tanimsiz-yere-verme
utsde-tanimsiz-yere-verme-iptal
utsde-tanimsiz-yerden-iade-alma
utsde-tanimsiz-yerden-iade-alma-iptal
verme
verme-iptal
yeniden-isleme
yeniden-isleme-iptal
Ürün Numarası SNC.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
SNC.
LNO Metin 20
Seri/Sıra
Numarası
SNC.
SNO Metin 20
Adet SNC.
ADT Sayı -
Belge numarası SNC.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Durumu SNC.
BDR Metin -
Aşağıdaki değerlerden birini alabilir:
AKTIF
PASIF
IPTAL
KULLANIMDAN_ALINDI
VERILDI
ALINDI
TUKETICIDEN ALINDI
UTSDE_TANIMSIZ_YERDEN_IADE_ALINDI
GECICI_VERME_ALINDI
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
131 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bildirim Kodu SNC.
BID Metin 36 Bildirimin bildirim kodudur.
Bildirim Zamanı SNC.
BZA Tarih 19
YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A: Ay,
G: Gün, S: Saat, D:Dakika ve s: Saniye.
Bildiren Kurum
No
SNC.
GKK Sayı -
Bildirimi yapan kurumun ÜTS’de tanımlı kurum
numarasıdır.
Diğer Kurum No SNC.
KUN Sayı -
Bildirimin yapıldığı ÜTS’de tanımlı diğer kurumun
numarasıdır.
Bedelsiz
Numune
SNC.
BEN Boolean -
Tekil ürünlerin bedelsiz numune olup olmadığını
ifade etmektedir. Değer “true” ise bedelsiz numune,
“false” ise bedelsiz numune değildir.
Üretici/İthalatçı
Kurum No
SNC.
UIK Sayı -
Tekil ürünün üreticisinin/ithalatçısının ÜTS’de tanımlı
kurum numarasıdır.
Gerçek İşlem
Tarihi
SNC.
GIT Tarih 10
Bu tarih 5 tane bildirimde dönmektedir:
Tüketiciye Verme Bildiriminde, tekil ürünün
"Tüketiciye Verme Tarihi"
Kullanım Bildiriminde, tekil ürünün“Kullanım
Tarihi”
Ödünç Verme Bildiriminde, tekil ürünü “Ödünç
Verme Tarihi”
Geçici Kullanıma Verme Bildiriminde, tekil
ürünü “Geçici Kullanıma Verme Tarihi”
Hastanın Vücudundan Çıkarma Bildiriminde,
tekil ürünü“Hastanın Vücudundan Çıkarma
Tarihi”
olarak dönmektedir.
Bildiren Kurum
Unvan
SNC.
BKU Sayı - Bildirimi yapan kurumun unvanıdır.
Diğer Kurum
Unvan
SNC.
DKU Sayı - Bildirimin yapıldığı kurumun unvanıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
132 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Alınan Adet SNC.
AAD Sayı -
Verilen bir tekil ürünün kaç adedinin alındığı
bilgisidir.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.9.4 Bildirim Sorgula Örnek İstek
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999",
"SAN" : 0
}
3.4.10 Bildirim Sorgula (Kayıt Sayısı Parametresi ile)
Kurum/firmanın yapmış olduğu bildirimleri sorgular.
3.4.10.1 Bildirim Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/sorgula/offset
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/sorgula/offset
3.4.10.2 Bildirim Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 71. Bildirim Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
133 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası LNO Metin 36
Lot bazında takip edilen ürünler için verilmesi
zorunludur.
Seri/Sıra
Numarası SNO Metin 36
Tekil bazda takip edilen ürünler için verilmesi
zorunludur.
Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.
Hiçbir değer verilmezse kabul edilen değeri 10’dur.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
3.4.10.3 Bildirim Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 72. Bildirim Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(LST, OFF) -
LST, OFF parametrelerinden oluşan nesnedir.
İşlemin başarılı olması durumunda döndürülür.
Liste LST
Liste
(BTI, UNO, LNO, SNO, ADT, BNO, BDR, BID, BZA, GKK, KUN, BEN, UIK, GIT,
BKU, DKU, AAD)
-
BTI, UNO, LNO, SNO, ADT, BNO, BDR, BID, BZA,
GKK, KUN, BEN, UIK, GIT, BKU, DKU, AAD
parametrelerinden oluşan listedir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
134 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Tipi LST.
BTI Metin -
Aşağıdaki değerlerden birini alabilir
alma
gecici-kullanima-verme
gecici-kullanima-verme-iptal
odunc-alma
odunc-verme
odunc-verme-iptal
geri-cekme-alma
geri-cekme-verme
geri-cekme-verme-iptal
hastanin-vucudundan-cikarma
hastanin-vucudundan-cikarma-iptal
hek-zayiat
hek-zayiat-iptal
ihracat
ihracat-iptal
imha-bertaraf
imha-bertaraf-iptal
islah-duzeltici-faaliyet
islah-duzeltici-faaliyet-iptal
ithalat
ithalat-iptal
kullanim
kullanim-iptal
kullanimdan-alma
kullanimdan-alma-iptal
mahrecine-iade-etme
mahrecine-iade-etme-iptal
tuketiciden-iade-alma
tuketiciden-iade-alma-iptal
tuketiciye-verme
tuketiciye-verme-iptal
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
135 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Tipi LST.
BTI Metin -
uretim
uretim-iptal
utsde-tanimsiz-yere-verme
utsde-tanimsiz-yere-verme-iptal
utsde-tanimsiz-yerden-iade-alma
utsde-tanimsiz-yerden-iade-alma-iptal
verme
verme-iptal
yeniden-isleme
yeniden-isleme-iptal
Ürün Numarası LST.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
LST.
LNO Metin 20
Seri/Sıra
Numarası
LST.
SNO Metin 20
Adet LST.
ADT Sayı -
Belge numarası LST.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Durumu LST.
BDR Metin -
Aşağıdaki değerlerden birini alabilir:
AKTIF
PASIF
IPTAL
KULLANIMDAN_ALINDI
VERILDI
ALINDI
TUKETICIDEN ALINDI
UTSDE_TANIMSIZ_YERDEN_IADE_ALINDI
GECICI_VERME_ALINDI
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
136 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bildirim Kodu LST.
BID Metin 36 Bildirimin bildirim kodudur.
Bildirim Zamanı LST.
BZA Tarih 19
YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A: Ay,
G: Gün, S: Saat, D:Dakika ve s: Saniye.
Bildiren Kurum
No
LST.
GKK Sayı -
Bildirimi yapan kurumun ÜTS’de tanımlı kurum
numarasıdır.
Diğer Kurum No LST.
KUN Sayı -
Bildirimin yapıldığı ÜTS’de tanımlı diğer kurumun
numarasıdır.
Bedelsiz
Numune
LST.
BEN Boolean -
Tekil ürünlerin bedelsiz numune olup olmadığını
ifade etmektedir. Değer “true” ise bedelsiz numune,
“false” ise bedelsiz numune değildir.
Üretici/İthalatçı
Kurum No
LST.
UIK Sayı -
Tekil ürünün üreticisinin/ithalatçısının ÜTS’de tanımlı
kurum numarasıdır.
Gerçek İşlem
Tarihi
LST.
GIT Tarih 10
Bu tarih 5 tane bildirimde dönmektedir:
Tüketiciye Verme Bildiriminde, tekil ürünün
"Tüketiciye Verme Tarihi"
Kullanım Bildiriminde, tekil ürünün“Kullanım
Tarihi”
Ödünç Verme Bildiriminde, tekil ürünü “Ödünç
Verme Tarihi”
Geçici Kullanıma Verme Bildiriminde, tekil
ürünü “Geçici Kullanıma Verme Tarihi”
Hastanın Vücudundan Çıkarma Bildiriminde,
tekil ürünü“Hastanın Vücudundan Çıkarma
Tarihi”
olarak dönmektedir.
Bildiren Kurum
Unvan
LST.
BKU Sayı - Bildirimi yapan kurumun unvanıdır.
Diğer Kurum
Unvan
LST.
DKU Sayı - Bildirimin yapıldığı kurumun unvanıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
137 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Alınan Adet LST.
AAD Sayı -
Verilen bir tekil ürünün kaç adedinin alındığı
bilgisidir.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.10.4 Bildirim Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999",
"ADT" : 5
}
Gelen Cevap Yapısı :
{
"SNC": {
"LST": [
{ .. }, { .. }
],
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
138 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"
},
"MSJ": null
}
3.4.10.5 Bildirim Sorgula Örnek İstek (Offset Parametresi (OFF) ile)
Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki
kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999",
"ADT" : 5,
“OFF”: “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”
}
3.4.11 Kabul Edilecek Tekil Ürün Sorgula
Kurum/firma kendisine yapılan verme bildirimlerini sorgular.
3.4.11.1 Kabul Edilecek Tekil Ürün Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula
3.4.11.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları
Tablo 73. Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gönderen
Kurum Kodu GKK Sayı -
Verme bildirimi yapan kurumun ÜTS’de tanımlı
numarasıdır.
Sayfa Numarası SAN Sayı -
Sorgu sonucunda en fazla 10 tane kayıt
döndürülmektedir. Bu alan hangi sıradaki 10’luk
sonucun döndürülmesi gerektiğini ifade eder.
3.4.11.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 74. Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
139 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC
Liste
(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,
GKU, MME)
- İşlemin başarılı olması durumunda döndürülür.
Gönderen
Kurum Kodu
SNC.
GKK Sayı -
Verme bildirimi yapan kurumun ÜTS’de tanımlı
numarasıdır.
Ürün Numarası SNC.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
SNC.
LNO Metin 20
Seri/Sıra
Numarası
SNC.
SNO Metin 20
Adet SNC.
ADT Sayı -
Bildirim Kodu SNC.
BID Metin 36 Bildirimin bildirim kodudur.
Belge Numarası SNC.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Zamanı SNC.
BZA Tarih 19
YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:
Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.
Bildirim Tipi SNC.
BTI Metin
Bildirimin tipidir. Aşağıdaki değeri alabilir.
VERME
Üretici/İthalatçı
Kurum
Numarası
SNC.
UIK Sayı -
Tekil ürünü üreten/ithal eden kurumun ÜTS’de
tanımlı numarasıdır.
Gönderen
Kurum Unvan
SNC.
GKU Sayı - Verme bildirimi yapan kurumun unvanıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
140 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Marka Model
Etiket
SNC.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.11.4 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek
{
"GKK" : 7,
"SAN" : 0
}
3.4.12 Kabul Edilecek Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)
Kurum/firma kendisine yapılan verme bildirimlerini sorgular.
3.4.12.1 Kabul Edilecek Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula/offset
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula/offset
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
141 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.12.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 75. Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gönderen
Kurum Kodu GKK Sayı -
Verme bildirimi yapan kurumun ÜTS’de tanımlı
numarasıdır.
Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.
Hiçbir değer verilmezse kabul edilen değeri 10’dur.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
3.4.12.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 76. Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(LST, OFF) -
LST, OFF parametrelerinden oluşan nesnedir.
İşlemin başarılı olması durumunda döndürülür.
Liste LST
Liste
(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,
GKU, MME)
- GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI,
UIK, GKU, MME parametrelerinden oluşan listedir.
Gönderen
Kurum Kodu
LST.
GKK Sayı -
Verme bildirimi yapan kurumun ÜTS’de tanımlı
numarasıdır.
Ürün Numarası LST.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
LST.
LNO Metin 20
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
142 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Seri/Sıra
Numarası
LST.
SNO Metin 20
Adet LST.
ADT Sayı -
Bildirim Kodu LST.
BID Metin 36 Bildirimin bildirim kodudur.
Belge Numarası LST.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Zamanı LST.
BZA Tarih 19
YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:
Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.
Bildirim Tipi LST.
BTI Metin
Bildirimin tipidir. Aşağıdaki değeri alabilir.
VERME
Üretici/İthalatçı
Kurum
Numarası
LST.
UIK Sayı -
Tekil ürünü üreten/ithal eden kurumun ÜTS’de
tanımlı numarasıdır.
Gönderen
Kurum Unvan
LST.
GKU Sayı - Verme bildirimi yapan kurumun unvanıdır.
Marka Model
Etiket
LST.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
143 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.12.4 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)
{
"GKK" : 7,
"ADT" : 5
}
Gelen Cevap Yapısı :
{
"SNC": {
"LST": [
{ .. }, { .. }
],
"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"
},
"MSJ": null
}
3.4.12.5 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile)
Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki
kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.
{
"GKK" : 7,
"ADT" : 5,
“OFF” : “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
144 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.13 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula
Kurum/Firma kendisine yapılan verme bildirimlerini tekil ürün bilgilerini girerek sorgular.
3.4.13.1 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula/tekilUrun/offset
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula/tekilUrun/offset
3.4.13.2 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları
Tablo 77. Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
Mu? Açıklama
Ürün Numarası UNO Metin 23 Zorunlu Ürünün ürün numarası/barkod
numarasıdır.
Lot/Batch
Numarası LNO Metin 36 Koşullu
Lot bazında takip edilen ürünler için
verilmesi zorunludur.
Seri/Sıra
Numarası SNO Metin 36 Koşullu
Seri bazda takip edilen ürünler için
verilmesi zorunludur.
Adet ADT Sayı 500
Sorgu sonucu getirilmesi istenen
kayıt sayısıdır. Hiçbir değer
verilmezse kabul edilen değeri
10’dur.
Sayfa OFF Metin -
Sorgulama başlangıç offset
adresidir. Offset adres bilgisi önceki
sorgulama sonucunda verilir.
3.4.13.3 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
145 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Tablo 78. Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(LST, OFF) -
LST, OFF parametrelerinden oluşan nesnedir.
İşlemin başarılı olması durumunda döndürülür.
Liste LST
Liste
(GKK, UNO, LNO, SNO, ADT, BID, BNO, BTI,
GIT)
- GKK, UNO, LNO, SNO, ADT, BID, BNO, BTI, GIT
parametrelerinden oluşan listedir.
Gönderen
Kurum Kodu
LST.
GKK Sayı -
Verme bildirimi yapan kurumun ÜTS’de tanımlı
numarasıdır.
Ürün Numarası LST.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
LST.
LNO Metin 20 Tekil ürünün lot/batch numarasıdır.
Seri/Sıra
Numarası
LST.
SNO Metin 20 Tekil ürünün seri/sıra numarasıdır.
Adet LST.
ADT Sayı - Verme bildirimi yapılan tekil ürünün adedidir.
Bildirim Kodu LST.
BID Metin 36 Bildirimin bildirim kodudur.
Belge Numarası LST.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Tipi LST.
BTI Metin
Bildirimin tipidir. Aşağıdaki değeri alabilir.
VERME
Gerçek İşlem
Tarihi
LST.
GIT Tarih 19
Verme işleminin gerçekte hangi tarihte yapıldığını
belirten alandır. YYYY-AA-GG formatındadır. Y: Yıl,
A: Ay, G: Gün
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
146 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.13.4 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Örnek İstek ve Cevap
Örnek istek:
{
"UNO":"01111111110010",
"LNO":"lot1",
"ADT": 10
}
Yukarıdaki isteğe dönen cevap
{
"SNC": {
"LST": [
{
"UNO": "01111111110010",
"LNO": "lot1",
"ADT": 18,
"BID": "b74e5e21-14ea-11e9-bd4d-b52780f367db",
"GKK": 2,
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
147 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"BNO": "Belge3",
"BTI": "VERME",
"GIT": "2019-01-10"
},
{
"UNO": "01111111110010",
"LNO": "lot1",
"ADT": 15,
"BID": "95847721-14ea-11e9-bd4d-b52780f367db",
"GKK": 10,
"BNO": "belgeNo1",
"BTI": "VERME",
"GIT": "2019-01-04"
}
],
"OFF": null
},
"MSJ": null
}
3.4.14 Ödünç Alınacak Tekil Ürün Sorgula
Kurum/firma kendisine yapılan ödünç verme bildirimlerini sorgular.
3.4.14.1 Ödünç Alınacak Tekil Ürün Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/bekleyenler/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/bekleyenler/sorgula
3.4.14.2 Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları
Tablo 79. Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gönderen
Kurum Kodu GKK Sayı -
Ödünç verme bildirimi yapan kurumun ÜTS’de
tanımlı numarasıdır.
Sayfa Numarası SAN Sayı -
Sorgu sonucunda en fazla 10 tane kayıt
döndürülmektedir. Bu alan hangi sıradaki 10’luk
sonucun döndürülmesi gerektiğini ifade eder.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
148 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.14.3 Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 80. Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC
Liste
(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,
GKU, MME, GIT)
- İşlemin başarılı olması durumunda döndürülür.
Gönderen
Kurum Kodu
SNC.
GKK Sayı -
Ödünç verme bildirimi yapan kurumun ÜTS’de
tanımlı numarasıdır.
Ürün Numarası SNC.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
SNC.
LNO Metin 20
Seri/Sıra
Numarası
SNC.
SNO Metin 20
Adet SNC.
ADT Sayı -
Bildirim Kodu SNC.
BID Metin 36 Bildirimin bildirim kodudur.
Belge Numarası SNC.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Zamanı SNC.
BZA Tarih 19
YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:
Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.
Bildirim Tipi SNC.
BTI Metin
Bildirimin tipidir. Aşağıdaki değeri alabilir.
ODUNC_VERME
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
149 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Üretici/İthalatçı
Kurum
Numarası
SNC.
UIK Sayı -
Tekil ürünü üreten/ithal eden kurumun ÜTS’de
tanımlı numarasıdır.
Gönderen
Kurum Unvan
SNC.
GKU Sayı - Ödünç verme bildirimi yapan kurumun unvanıdır.
Marka Model
Etiket
SNC.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Gerçek İşlem
Tarihi
SNC.
GIT Tarih 10
Bu tarih 5 tane bildirimde dönmektedir:
Tüketiciye Verme Bildiriminde, tekil ürünün
"Tüketiciye Verme Tarihi"
Kullanım Bildiriminde, tekil ürünün “Kullanım
Tarihi”
Ödünç Verme Bildiriminde, tekil ürünü “Ödünç
Verme Tarihi”
Geçici Kullanıma Verme Bildiriminde, tekil
ürünü “Geçici Kullanıma Verme Tarihi”
Hastanın Vücudundan Çıkarma Bildiriminde,
tekil ürünü“ Hastanın Vücudundan Çıkarma
Tarihi”
olarak dönmektedir.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
150 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.14.4 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek
{
"GKK" : 7,
"SAN" : 0
}
3.4.15 Ödünç Alınacak Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)
Kurum/firma kendisine yapılan ödünç verme bildirimlerini sorgular.
3.4.15.1 Ödünç Alınacak Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/bekleyenler/sorgula/offset
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/bekleyenler/sorgula/offset
3.4.15.2 Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 81. Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gönderen
Kurum Kodu GKK Sayı -
Ödünç verme bildirimi yapan kurumun ÜTS’de
tanımlı numarasıdır.
Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.
Hiçbir değer verilmezse kabul edilen değeri 10’dur.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
151 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.15.3 Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 82. Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(LST, OFF) -
LST, OFF parametrelerinden oluşan nesnedir.
İşlemin başarılı olması durumunda döndürülür.
Liste LST
Liste
(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,
GKU, MME, GIT)
-
GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI,
UIK, GKU, MME, GIT parametrelerinden oluşan
listedir.
Gönderen
Kurum Kodu
LST.
GKK Sayı -
Ödünç verme bildirimi yapan kurumun ÜTS’de
tanımlı numarasıdır.
Ürün Numarası LST.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
LST.
LNO Metin 20
Seri/Sıra
Numarası
LST.
SNO Metin 20
Adet LST.
ADT Sayı -
Bildirim Kodu LST.
BID Metin 36 Bildirimin bildirim kodudur.
Belge Numarası LST.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Zamanı LST.
BZA Tarih 19
YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:
Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.
Bildirim Tipi LST.
BTI Metin
Bildirimin tipidir. Aşağıdaki değeri alabilir.
ODUNC_VERME
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
152 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Üretici/İthalatçı
Kurum
Numarası
LST.
UIK Sayı -
Tekil ürünü üreten/ithal eden kurumun ÜTS’de
tanımlı numarasıdır.
Gönderen
Kurum Unvan
LST.
GKU Sayı - Ödünç verme bildirimi yapan kurumun unvanıdır.
Marka Model
Etiket
LST.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Gerçek İşlem
Tarihi
LST.
GIT Tarih 10
Bu tarih 5 tane bildirimde dönmektedir:
Tüketiciye Verme Bildiriminde, tekil ürünün
"Tüketiciye Verme Tarihi"
Kullanım Bildiriminde, tekil ürünün “Kullanım
Tarihi”
Ödünç Verme Bildiriminde, tekil ürünü “Ödünç
Verme Tarihi”
Geçici Kullanıma Verme Bildiriminde, tekil
ürünü “Geçici Kullanıma Verme Tarihi”
Hastanın Vücudundan Çıkarma Bildiriminde,
tekil ürünü“ Hastanın Vücudundan Çıkarma
Tarihi”
olarak dönmektedir.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
153 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.15.4 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)
{
"GKK" : 7,
"ADT" : 5
}
Gelen Cevap Yapısı :
{
"SNC": {
"LST": [
{ .. }, { .. }
],
"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"
},
"MSJ": null
}
3.4.15.5 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile)
Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki
kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.
{
"GKK" : 7,
"ADT" : 5,
“OFF” : “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
154 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.16 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula
Kurum/firma kendisine yapılan geri çekme verme bildirimlerini sorgular.
3.4.16.1 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/bekleyenler
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/bekleyenler
3.4.16.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları
Tablo 83. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gönderen
Kurum Kodu GKK Sayı -
Geri çekme verme bildirimi yapan kurumun ÜTS’de
tanımlı numarasıdır.
Sayfa Numarası SAN Sayı -
Sorgu sonucunda en fazla 10 tane kayıt
döndürülmektedir. Bu alan hangi sıradaki 10’luk
sonucun döndürülmesi gerektiğini ifade eder.
3.4.16.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 84. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC
Liste
(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,
GKU, MME)
- İşlemin başarılı olması durumunda döndürülür.
Gönderen
Kurum Kodu
SNC.
GKK Sayı -
Geri çekme verme bildirimi yapan kurumun ÜTS’de
tanımlı numarasıdır.
Ürün Numarası SNC.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
155 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Lot/Batch
Numarası
SNC.
LNO Metin 20
Seri/Sıra
Numarası
SNC.
SNO Metin 20
Adet SNC.
ADT Sayı -
Bildirim Kodu SNC.
BID Metin 36 Bildirimin bildirim kodudur.
Belge Numarası SNC.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Zamanı SNC.
BZA Tarih 19
YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:
Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.
Bildirim Tipi SNC.
BTI Metin
Bildirimin tipidir. Aşağıdaki değeri alabilir.
GERI_CEKME_VERME
Üretici/İthalatçı
Kurum
Numarası
SNC.
UIK Sayı -
Tekil ürünü üreten/ithal eden kurumun ÜTS’de
tanımlı numarasıdır.
Gönderen
Kurum Unvan
SNC.
GKU Sayı -
Geri Çekme Verme bildirimi yapan kurumun
unvanıdır.
Marka Model
Etiket
SNC.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
156 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.16.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula
{
"GKK" : 7,
"SAN" : 0
}
3.4.17 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)
Kurum/firma kendisine yapılan geri çekme verme bildirimlerini sorgular.
3.4.17.1 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/bekleyenler/offset
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/bekleyenler/offset
3.4.17.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 85. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gönderen
Kurum Kodu GKK Sayı -
Geri çekme verme bildirimi yapan kurumun ÜTS’de
tanımlı numarasıdır.
Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.
Hiçbir değer verilmezse kabul edilen değeri 10’dur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
157 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
3.4.17.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 86. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(LST, OFF) -
LST, OFF parametrelerinden oluşan nesnedir.
İşlemin başarılı olması durumunda döndürülür.
Liste LST
Liste
(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,
GKU, MME)
- GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI,
UIK, GKU, MME parametrelerinden oluşan listedir.
Gönderen
Kurum Kodu
LST.
GKK Sayı -
Geri çekme verme bildirimi yapan kurumun ÜTS’de
tanımlı numarasıdır.
Ürün Numarası LST.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
LST.
LNO Metin 20
Seri/Sıra
Numarası
LST.
SNO Metin 20
Adet LST.
ADT Sayı -
Bildirim Kodu LST.
BID Metin 36 Bildirimin bildirim kodudur.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
158 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Belge Numarası LST.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Zamanı LST.
BZA Tarih 19
YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:
Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.
Bildirim Tipi LST.
BTI Metin
Bildirimin tipidir. Aşağıdaki değeri alabilir.
GERI_CEKME_VERME
Üretici/İthalatçı
Kurum
Numarası
LST.
UIK Sayı -
Tekil ürünü üreten/ithal eden kurumun ÜTS’de
tanımlı numarasıdır.
Gönderen
Kurum Unvan
LST.
GKU Sayı -
Geri Çekme Verme bildirimi yapan kurumun
unvanıdır.
Marka Model
Etiket
LST.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
159 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.17.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula (Kayıt Sayısı Parametresi (ADT) ile)
{
"GKK" : 7,
"ADT" : 5
}
Gelen Cevap Yapısı :
{
"SNC": {
"LST": [
{ .. }, { .. }
],
"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"
},
"MSJ": null
}
3.4.17.5 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile)
Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki
kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.
{
"GKK" : 7,
"ADT" : 5,
“OFF” : “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”
}
3.4.18 Tekil Ürünün Kaynağını Sorgula
Kurum/firma tekil ürünün “TİTUBB”da kayıtlı olup olmadığını sorgular.
3.4.18.1 Tekil Ürünün Kaynağını Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/kaynak/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/kaynak/sorgula
3.4.18.2 Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları
Tablo 87. Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
160 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod numarasıdır.
Seri/Sıra
Numarası SNO Metin 20 Evet Tekil ürünün seri/sıra numarasıdır.
3.4.18.3 Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları
Tablo 88. Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(UNO, SNO, TTB)
- İşlemin başarılı olması durumunda döndürülür.
Ürün Numarası SNC.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Seri/Sıra
Numarası
SNC.
SNO Metin 20 Tekil ürünün seri/sıra numarasıdır.
TİTUBB’da
kayıtlı mı?
SNC.
TTB Boolean -
Sorgulanan tekil ürün TİTUBB’da kayıtlı ise “true”,
TİTUBB’da kayıtlı değil ise “false” döner.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
161 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.18.4 Tekil Ürünün Kaynağını Sorgula Örnek İstek
{
"UNO" : “1111111110010”,
"SNO" : “123”
}
3.4.19 Bildirim ve Tekil Ürün Detay Sorgula
Bildirimin ve bildirim yapılmış tekil ürünün detayını sorgular.
3.4.19.1 Bildirim ve Tekil Ürün Detay Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/detay/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/detay/sorgula
3.4.19.2 Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları
Tablo 89. Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Bildirim ID BID Metin 36 Evet Bildirimin ID’sidir.
3.4.19.3 Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları
Tablo 90. Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
162 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bildirim bildirim
Nesne
(BID, DBI, BDR, BTI, BZA, GBN, GKK, KUN, BNO, BEN, HZT, HDA, IBG, HVG, DGA, VKN, GIT, BKU, DKU, AAD,
BKT)
-
Bildirim ID bildirim.BID Metin 36 Bildirimin ID’sidir.
Diğer Bildirim ID bildirim.DBI Metin 36 Alma yapılan bildirimlerin verme bildirimi id’si,
iptal bildirimlerinin iptal edilmiş bildirimin id’sidir.
Billdirim Durumu bildirim.BDR Metin -
Bildirimin durumudur, aşağıdaki değerleri alır.
AKTIF,
PASIF,
IPTAL,
KULLANIMDAN_ALINDI,
VERILDI,
ALINDI,
TUKETICIDEN_IADE_ALINDI,
UTSDE_TANIMSIZ_YERDEN_IADE_ALINDI,
ODUNC_VERME_ALINDI,
ODUNC_GERI_VERME_ALINDI.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
163 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Bildirim Tipi bildirim.BTI Metin
Bildirimin tipidir, aşağıdaki değerleri alır.
ALMA,
GECICI_KULLANIMA_VERME,
GECICI_KULLANIMA_VERME_IPTAL,
GERI_CEKME_ALMA,
GERI_CEKME_VERME,
GERI_CEKME_VERME_IPTAL,
ENVANTER,
ENVANTER_IPTAL,
HASTANIN_VUCUDUNDAN_CIKARMA,
HASTANIN_VUCUDUNDAN_CIKARMA_IPTAL,
HEK_ZAYIAT,
HEK_ZAYIAT_IPTAL,
IHRACAT,
IHRACAT_IPTAL,
IMHA_BERTARAF,
IMHA_BERTARAF_IPTAL,
ISLAH_DUZELTICI_FAALIYET,
ISLAH_DUZELTICI_FAALIYET_IPTAL,
ITHALAT,
ITHALAT_IPTAL,
KULLANIM,
KULLANIM_IPTAL,
KULLANIMDAN_ALMA,
KULLANIMDAN_ALMA_IPTAL,
MAHRECINE_IADE_ETME,
MAHRECINE_IADE_ETME_IPTAL,
ODUNC_ALMA,
ODUNC_GERI_ALMA,
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
164 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
ODUNC_GERI_VERME,
ODUNC_GERI_VERME_IPTAL,
ODUNC_VERME,
ODUNC_VERME_IPTAL,
STOK,
STOK_IPTAL,
TUKETICIYE_VERME,
TUKETICIYE_VERME_IPTAL,
TUKETICIDEN_IADE_ALMA,
TUKETICIDEN_IADE_ALMA_IPTAL,
URETIM,
URETIM_IPTAL,
UTSDE_TANIMSIZ_YERE_VERME,
UTSDE_TANIMSIZ_YERE_VERME_IPTAL,
UTSDE_TANIMSIZ_YERDEN_IADE_ALMA,
UTSDE_TANIMSIZ_YERDEN_IADE_ALMA_IP
TAL,
VERME,
VERME_IPTAL,
YENIDEN_ISLEME,
YENIDEN_ISLEME_IPTAL.
Bildirim Zamanı bildirim.BZA Tarih YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:
Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.
Gümrük
Beyanname No bildirim.GBN Metin
İthalat ve mahrecine iade etme bildirimlerinde
verilen gümrük beyanname numarasıdır.
Gönderen
Kurum No bildirim.GKK Sayı
Verme bildirimlerinde gönderen kurumun
ÜTS’de kayıtlı numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
165 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Diğer Kurum No bildirim.KUN Sayı Verme yapılan kurumun ÜTS’de tanımlı
numarasıdır.
Belge No bildirim.BNO Metin 50 Verme bildirimlerinde verilen fatura ve/veya
İrsaliye numarasıdır.
Bedelsiz
Numune bildirim.BEN Metin
Tekil ürünlerin bedelsiz numune olup olmadığını
ifade etmektedir. Değer “true” ise bedelsiz
numune, “false” ise bedelsiz numune değildir.
Hek/Zayiat Türü bildirim.HZT Metin
Hek/Zayiat bildirimlerinde Hek/Zayiat türüdür.
Aşağıdaki değerleri alır.
HEK,
DOGAL_AFET,
YANGIN,
CALINMA,
DIGER.
Hek/Zayiat Diğer
Tür Açıklama bildirim.HDA Metin
Hek/Zayiat türü DIGER seçilirse, girilmesi
gereken açıklamadır.
İmha/Bertaraf
Gerekçesi bildirim.IBG Metin
İmha/Bertaraf bildirimlerinde İmha/Bertaraf
gerekçesidir. Aşağıdaki değerleri alır.
KURUM_KARARI,
GONULLU_GERI_CEKME,
SON_KULLANMA_TARIHI_GECMIS,
SAHTE_KACAK,
TASIMA_VE_SAKLAMA_KOSULLARI_BOZUL
MUS,
HASTANIN_VUCUDUNDAN_CIKARILMIS,
DIGER.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
166 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Hasta
Vücudundan
Çıkarma
Gerekçesi
bildirim.HVG Metin
Hasta vücudundan çıkarma bildirimlerindeki
gerekçelerdir, aşağıdaki değerleri alır.
DOKU_UYUMSUZLUGU,
GERI_CAGIRMA,
KULLANIM_OMRUNU_DOLDURMASI,
REVIZYON,
DIGER.
Diger Gerekçe
Açıklama bildirim. DGA Metin
Hasta vücudundan çıkarma bildirimlerindeki
gerekçe DIGER seçilmişse, girilmesi gereken
açıklamadır.
Vergi Kimlik No bildirim.VKN Metin
ÜTS’de kayıtlı olmayan firmanın vergi kimlik
numarası girilmesi zorunludur. ÜTS’de tanımsız
yere verme bildirimlerinde verilir.
Gerçek İşlem
Tarihi bildirim.GIT Tarih 10
Bu tarih 5 tane bildirimde dönmektedir:
Tüketiciye Verme Bildiriminde, tekil ürünün
"Tüketiciye Verme Tarihi"
Kullanım Bildiriminde, tekil ürünün
“Kullanım Tarihi”
Ödünç Verme Bildiriminde, tekil ürünü
“Ödünç Verme Tarihi”
Geçici Kullanıma Verme Bildiriminde, tekil
ürünü “Geçici Kullanıma Verme Tarihi”
Hastanın Vücudundan Çıkarma
Bildiriminde, tekil ürünü “Hastanın
Vücudundan Çıkarma Tarihi”
olarak dönmektedir.
Bildiren Kurum
Ünvan bildirim. BKU Metin Bildirim yapan kurumun unvanıdır.
Diğer Kurum
Ünvan bildirim. DKU Metin
Verme bildirimlerinde, verme yapılan kurumun
unvanıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
167 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Alınan Adet bildirim. AAD Sayı Alma bildirimlerinde alınan adettir.
Bildirim Yapan
Kurum Tipi bildirim. BKT Metin
Bildirimi yapan kurum tipidir, aşağıdaki değerleri
alır.
KENDISI,
TITCK,
SGK,
Tekil Ürün tekilUrun
Nesne
(UNO, SNO, LNO, MME, SKT, ITT, UTP, UIK, UAK, SKG, KKG, UDI, SIP,
SET)
-
Ürün Numarası tekilUrun.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Seri/Sıra
Numarası
tekilUrun.
SNO Metin 20 Tekil ürünün seri/sıra numarasıdır.
Lot/Batch
Numarası
tekilUrun.
LNO Metin 20 Tekil ürünün lot/batch numarasıdır.
Marka Model
Etiket
tekilUrun.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Üretim Tarihi tekilUrun.
URT Tarih 10
Tekil ürünün üretim tarihidir. YYYY-AA-GG
formatındadır. Y: Yıl, A: Ay, G: Gün.
Son Kullanma
Tarihi
tekilUrun.
SKT Tarih 12
Tekil ürünün son kullanma tarihidir. YYYY-AA-
GG SS formatındadır. Y: Yıl, A: Ay, G: Gün, S:
Saat.
İthalat Tarihi tekilUrun.
ITT Tarih 10
Tekil ürünün ithalat tarihidir. YYYY-AA-GG
formatındadır. Y: Yıl, A: Ay, G: Gün.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
168 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Türü tekilUrun.
UTP Metin
Ürünün türüdür, aşağıdaki değerleri alır.
TIBBI_CIHAZ,
KOZMETIK_URUN.
Üretici/İthalatçı
Kurum No
tekilUrun.
UIK Sayı
Tekil ürünün üretici/ithalatçı kurumunun ÜTS’de
kayıtlı numarasıdır.
Takip Kapsamı tekilUrun.
UAK Metin
Tekil ürünün takip kapsamıdır, aşağıdaki
değerleri alır.
TEKIL,
LOT,
GONULLU_TEKIL,
GONULLU_LOT.
Satarken Kimlik
No Gerekli Mi
tekilUrun.
SKG Metin
Aşağıdaki değerlerden birini alabilir.
true,
false
Kullanırken
Kimlik No
Gerekli Mi
tekilUrun.
KKG Metin
Aşağıdaki değerlerden birini alabilir.
true,
false
Eşsiz Kimlik tekilUrun.
UDI Metin Tekil ürünün eşsiz kimliğidir.
Sip İçerisindeki
Tekil Ürünler
tekilUrun.
SIP
Liste
(UAK,
UNO, LNO,
SNO, ADT)
Sip içerisindeki tekil ürün bilgileridir.
Set İçerisindeki
Tekil Ürünler
tekilUrun.
SET
Liste
(UAK,
UNO, LNO,
SNO, ADT)
Set içerisindeki tekil ürün bilgileridir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
169 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.19.4 Bildirim ve Tekil Ürün Detay Sorgula Örnek İstek
{
"BID" : “48fr34c1-d3c3-11e7-97f7-8faf3772521f”
}
3.4.19.5 Bildirim ve Tekil Ürün Detay Sorgula Örnek Cevap
NOT : Boş olan parametreler, cevapta dönmemektedir.
{
"bildirim": {
"UNO": "09934239006763",
"LNO": "1",
"SNO": "48",
"ADT": 1,
"BID": "48fr34c1-d3c3-11e7-97f7-8faf3772521f",
"BDR": "AKTIF",
"BTI": "URETIM",
"BZA": "2017-11-28 01:35:35",
"GKK": 10,
"BKT": "KENDISI"
},
"tekilUrun": {
"UNO": "08680239006763",
"LNO": "1",
"SNO": "0000001548",
"MME": "ATASUN - YOK - ATASUN STD INC STD PKT +04.25:-01.00:65 Gözlük Camı",
"URT": "2017-04-14",
"UTP": "TIBBI_CIHAZ",
"UIK": 2667269130265,
"UAK": "TEKIL",
"SKG": false,
"KKG": false
}
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
170 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.20 Eksik Alma Bildirimi
Eksik alma bildirimi, bir kurum, başka bir kuruma lot bazında takip edilen ürünlerden verme yaptığı zaman ve
karşıdaki kurumun verilen ürün adedinden daha az miktarını aldığı zaman gerçekleşir. Örneğin, A kurumu B
kurumuna 40 adet C ürününden vermiştir, ve B kurumu verilen ürünlerden 30 tanesini almıştır. A kurumuna B
kurumunun ürünleri eksik aldığına dair hatırlatma(notification) gider ve aynı zamanda bu bildirimler bir sorgu ile
görüntülenebilir.
3.4.20.1 Eksik Alma Bildirimlerini Görüntüle
3.4.20.1.1 Eksik Alma Bildirimlerini Görüntüle Servis Adresleri
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/eksikAlma/sorgula/offset
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/eksikAlma/sorgula/offset
3.4.20.1.2 Eksik Alma Bildirimlerini Görüntüle İstek Veri Alanları
Tablo 91. Eksik Alma Bildirimlerini Görüntüle İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.
Hiçbir değer verilmezse kabul edilen değeri 10’dur.
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
3.4.20.1.3 Eksik Alma Bildirimi Sorgula Cevap Veri Alanları
Tablo 92. Eksik Alma Bildirimi Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(LST, OFF) -
LST, OFF parametrelerinden oluşan nesnedir.
İşlemin başarılı olması durumunda döndürülür.
Liste LST
Liste
(UNO, LNO, ADT, MME, BID, KUN, BNO, BZA, BTI, DKU,
AAD, GDR)
- UNO, LNO, ADT, MME, BID, KUN, BNO, BZA, BTI,
DKU, AAD, GDR parametrelerinden oluşan listedir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
171 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Numarası LST.
UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
LST.
LNO Metin 20
Seri/Sıra
Numarası
LST.
SNO Metin 20
Adet LST.
ADT Sayı - Verilen ürünün adedi
Marka Model
Etiket
LST.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Bildirim Kodu LST.
BID Metin 36 Bildirimin bildirim kodudur.
Diğer Kurum No LST.
KUN Sayı -
Verne bildirimin yapıldığı ÜTS’de tanımlı diğer
kurumun numarasıdır.
Belge Numarası LST.
BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.
Bildirim Zamanı LST.
BZA Tarih 19
YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:
Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.
Bildirim Tipi LST.
BTI Metin
Bildirimin tipidir. Aşağıdaki değeri alabilir.
ALMA
GERI_CEKME_ALMA
Diğer Kurum
Unvan
LST.
DKU Sayı - Verme bildirimin yapıldığı kurumun unvanıdır.
Alınan Adet LST.
ADD Sayı - Verme yapılan kurumun aldığı adet
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
172 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Görülme
Durumu
LST.
GDR Metin -
Bildirimin görülüp görülmediğini belirtir. Aşağıdaki
değerleri alabilir:
GORULMEDI
GORULDU
Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres
bilgisi önceki sorgulama sonucunda verilir.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.4.20.1.4 Eksik Alma Bildirimi Sorgula Örnek İstek
Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki
kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.
{
"ADT":10,
"OFF":“001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
173 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.20.2 Eksik Alma Bildiriminin Görülme Durumunu Güncelle
Bildirimlerin görülme durumları güncellenebilir. Bu bildirimin görülmesini engellemez, yalnızca hangi bildirimlerin
işlenip işlenmediğini işaretlemek içindir.
3.4.20.2.1 Eksik Alma Bildiriminin Görülme Durumunu Güncelle Servis Adresleri
Gerçek Ortam: https:/utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/eksikAlma/gorulmeDurumunuGuncelle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/eksikAlma/gorulmeDurumunuGuncelle
3.4.20.2.2 Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Veri Alanları
Tablo 93. Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bildirim Kodu BID Metin 36 Bildirim durumu güncellenmek istenen bildirimin
bildirim kodu
Görülme
Durumu GDR Metin -
Bildirim durumu. Alabileceği değerler:
GORULDU
GORULMEDI
3.4.20.2.3 Eksik Alma Bildirimi Görülme Durumunu Güncelle Cevap Veri Alanları
Tablo 94. Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Metin - null döner, kullanılmamaktadır.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Bilgilendirme mesajıdır.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli bilgi mesaj metnidir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
174 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi - İşlenen bildirimin bildirim kodunu içerir.
3.4.20.2.4 Eksik Alma Bildirimi Görülme Durumunu Güncelle Örnek İstek
{
"BID": "def610f1-075a-11e9-a5c1-6d0bfaf9a6ef",
"GDR": "GORULMEDI"
}
3.5 PAKET TRANSFER SİSTEMİ (PTS) SERVİSLERİ
3.5.1 Paket Ekle
Kurum/firma bu servisi kullanarak paket oluşturur. Kurum daha önce aynı isimde paket tanımlanmışsa, eski paket
silinir ve yeni paket bu paketin yerini alır.
3.5.1.1 Paket Ekle Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/paket/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/paket/ekle
3.5.1.2 Paket Ekle İstek Veri Alanları
Tablo 95. Paket Ekle İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Paket
Numarası PNO Metin 255 Evet Eklenecek paketin, paket numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
175 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Paket Tipi TIP Tek Seçimli
Liste 1 Hayır
Eklenecek paketin tipini ifade
etmektedir. Aşağıdaki değerleri alabilir.
P: Palet
C: Kargo
S: Shrink
Alıcı Kurum
Numarası KNO Sayı - Evet
Tanımlanan paketin alıcısı olan kurumun
ÜTS’de tanımlı numarasıdır.
Paket Listesi PLI
Liste
(PNO, TIP, KNO, PLI,
TUL)
- Hayır Tanımlanan paketin içerdiği paket listesi
Tekil Ürün
Listesi TUL
Liste
(UNO,
SNO, LNO,
ADT, UDI)
- Hayır Tanımlanan paketin içerdiği tekil ürün
listesi
Ürün Numarası TUL.
UNO Metin - Hayır
Paketin içerdiği tekil ürünün ürün
numarası
Seri/Sıra
Numarası
TUL.
SNO Metin - Hayır
Paketin içerdiği tekil ürünün seri/sıra
numarası
Lot/Batch
Numarası
TUL.
LNO Metin - Hayır
Paketin içerdiği tekil ürünün lot/batch
numarası
Adet TUL.
ADT Sayı - Hayır Paketin içerdiği tekil ürünün adet bilgisi
Eşsiz kimlik TUL.
UDI Metin - Hayır Paketin içerdiği tekil ürünün eşsiz kimliği
3.5.1.3 Paket Ekle Cevap Veri Alanları
Tablo 96. Paket Ekle Cevap Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
176 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Metin - Eklenen paket numarasıdır. İşlemin başarılı olması
durumunda döndürülür.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.5.1.4 Paket Ekle Örnek İstek
{
"PNO":"paket1",
"KNO" : 7,
"TIP" : "P",
"TUL " : [
{
"UNO ":"urunNo",
"SNO ":"seriNo1",
"LNO ":"lotNo1",
"UDI" : "890b7",
"ADT ":1
}
],
"PLI ":[
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
177 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
{
"PNO ":"paket2",
"KNO" : 7,
"TIP" : "P",
"TUL ":[
{
"UNO ":"urunNo2",
"SNO ":"seriNo2",
"LNO ":"lotNo2",
"UDI" : "99",
"ADT ":100
}
]
}
]
}
3.5.2 Paket Sil
Kurum kendi oluşturduğu paketi siler.
3.5.2.1 Paket Sil Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/paket/sil
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/paket/sil
3.5.2.2 Paket Sil İstek Veri Alanları
Tablo 97. Paket Sil İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Paket
Numarası PNO Metin 255 Evet Silinecek paketin, paket numarasıdır.
3.5.2.3 Paket Sil Cevap Veri Alanları
Tablo 98. Paket Sil Cevap Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
178 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Metin - Silinen paket numarasıdır. İşlemin başarılı olması
durumunda döndürülür.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.5.2.4 Paket Sil Örnek İstek
{
"PNO":"paket1"
}
3.5.3 Paket Getir
Kurum tarafından eklenen sistem paketlerinin içeriğini görmek için kullanılır.
3.5.3.1 Paket Getir Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/paket/getir
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/paket/getir
3.5.3.2 Paket Getir İstek Veri Alanları
Tablo 99. Paket Getir İstek Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
179 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Paket
Numarası PNO Metin 255 Evet
İçeriği gösterilecek paketin, paket
numarasıdır.
3.5.3.3 Paket Getir Cevap Veri Alanları
Tablo 100. Paket Getir Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Liste -
Paket Numarası SNC
.PNO Metin 255 İçeriği gösterilecek paketin, paket numarasıdır.
Paket Tipi SNC
.TIP
Tek Seçimli
Liste 1
İçeriği gösterilecek paketin tipini ifade etmektedir.
Aşağıdaki değerleri alabilir.
P: Palet
C: Kargo
S: Shrink
Alıcı Kurum
Numarası
SNC
.KNO Sayı -
İçeriği gösterilecek paketin alıcısı olan kurumun
ÜTS’de tanımlı numarasıdır.
Paketi Oluşturan
Kurum Numarası
SNC.
OKN Sayı -
Paketi oluşturan kurumun ÜTS’de tanımlı
numarasıdır.
Paket Listesi SNC
.PLI
Liste
(PNO, TIP, KNO, PLI,
TUL)
- İçeriği gösterilecek paketin içerdiği paket listesi
Tekil Ürün
Listesi
SNC.
TUL
Liste
(UNO, SNO,
LNO, ADT,
UDI)
- İçeriği gösterilecek paketin içerdiği tekil ürün listesi
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
180 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Numarası TUL.
UNO Metin - Paketin içerdiği tekil ürünün ürün numarası
Seri/Sıra
Numarası
TUL.
SNO Metin - Paketin içerdiği tekil ürünün seri/sıra numarası
Lot/Batch
Numarası
TUL.
LNO Metin - Paketin içerdiği tekil ürünün lot/batch numarası
Adet TUL.
ADT Sayı - Paketin içerdiği tekil ürünün adet bilgisi
Eşsiz kimlik TUL.
UDI Metin - Paketin içerdiği tekil ürünün eşsiz kimliği
3.5.3.4 Paket Getir Örnek İstek
{
"PNO":"paket1"
}
3.5.4 Kuruma Gelen Paketi Okundu İşaretle
Kuruma gelen paketi okundu olarak işaretlemek için bu servis kullanılır. Okundu işaretlenen paketler sorgu
sonuçlarında filtrelenebilir (bkz. 3.5.6 Kuruma Gelen Paketleri Sorgula).
3.5.4.1 Kuruma Gelen Paketi Okundu İşaretle Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/oku
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/oku
3.5.4.2 Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları
Tablo 101. Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Paket
Numarası PNO Metin 255 Evet
Okundu işaretlenecek paketin, paket
numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
181 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Gönderen
Kurum
Numarası
KNO Sayı - Evet Sistem paketini gönderen kurumun
ÜTS’de tanımlı numarasıdır.
3.5.4.3 Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları
Tablo 102. Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Metin - Okundu işaretlenen paket numarasıdır. İşlemin
başarılı olması durumunda döndürülür.
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj
Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.5.4.4 Kuruma Gelen Paketi Okundu İşaretle Örnek İstek
{
"PNO":"paket1",
"KNO":7
}
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
182 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.5.5 Kuruma Gelen Paketi Getir
Kuruma gelen paketlerin içeriğini görmek için kullanılır.
3.5.5.1 Kuruma Gelen Paketi Getir Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/getir
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/getir
3.5.5.2 Kuruma Gelen Paketi Getir İstek Veri Alanları
Tablo 103. Kuruma Gelen Paketi Getir İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Paket
Numarası PNO Metin 255 Evet
İçeriği getirilecek paketin, paket
numarasıdır.
Gönderen
Kurum
Numarası
KNO Sayı - Evet Sistem paketini gönderen kurumun
ÜTS’de tanımlı numarasıdır.
3.5.5.3 Kuruma Gelen Paketi Getir Cevap Veri Alanları
Tablo 104. Kuruma Gelen Paketi Getir Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Paket Numarası PNO Metin 255 İçeriği gösterilecek paketin, paket numarasıdır.
Paket Tipi TIP Tek Seçimli
Liste 1
İçeriği gösterilecek paketin tipini ifade etmektedir.
Aşağıdaki değerleri alabilir.
P: Palet
C: Kargo
S: Shrink
Alıcı Kurum
Numarası KNO Sayı -
İçeriği gösterilecek paketin alıcısı olan kurumun
ÜTS’de tanımlı numarasıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
183 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Paket Listesi PLI
Liste
(PNO, TIP, KNO, PLI,
TUL)
- İçeriği gösterilecek paketin içerdiği paket listesi
Tekil Ürün
Listesi TUL
Liste
(UNO, SNO,
LNO, ADT,
UDI)
- İçeriği gösterilecek paketin içerdiği tekil ürün listesi
Ürün Numarası TUL.
UNO Metin - Paketin içerdiği tekil ürünün ürün numarası
Seri/Sıra
Numarası
TUL.
SNO Metin - Paketin içerdiği tekil ürünün seri/sıra numarası
Lot/Batch
Numarası
TUL.
LNO Metin - Paketin içerdiği tekil ürünün lot/batch numarası
Adet TUL.
ADT Sayı - Paketin içerdiği tekil ürünün adet bilgisi
Eşsiz kimlik TUL.
UDI Metin - Paketin içerdiği tekil ürünün eşsiz kimliği
3.5.5.4 Kuruma Gelen Paketi Getir Örnek İstek
{
"PNO":"paket1",
"KNO":7
}
3.5.6 Kuruma Gelen Paketleri Sorgula
Kuruma gelen sistem paketlerini sorgulamak için bu servis kullanılır.
3.5.6.1 Kuruma Gelen Paketleri Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/sorgula
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
184 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.5.6.2 Kuruma Gelen Paketleri Sorgula İstek Veri Alanları
Tablo 105. Kuruma Gelen Paketleri Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
En Küçük Tarih EKT Tarih 10 Hayır
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay, G: Gün.
Varsayılan değer 10 gün öncesidir.
En Büyük Tarih EBT Tarih 10 Hayır
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay, G: Gün.
Varsayılan değer içerisinde bulunan
gündür. En küçük tarihten, en fazla 10
gün ileride olabilir.
Okundu Bilgisi OKB Tek Seçimli
Liste 7 Hayır
Paketin okunma durumu bilgisidir.
Aşağıdaki değerleri alabilir.
AKTIF,
ASKIDA,
OKUNDU,
SILINDI
Varsayılan değer AKTIF’tir.
Kurum
Numarası KNO Sayı - Hayır
Paketi oluşturan kurumun ÜTS’de
tanımlı numarası
3.5.6.3 Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları
Tablo 106. Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC
Liste
(PNO, KNO,
OKB, TRH)
- Sorgu sonucu dönen paket listesi
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
185 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Paket Numarası SNC.
PNO Metin - Sistem paketi numarası
Kurum Numarası SNC.
KNO Sayı - Paketi oluşturan kurumun ÜTS’de tanımlı numarası
Okundu Bilgisi SNC.
OKB
Tek Seçimli
Liste -
Paketin okunup okunmadığı bilgisi
true: okundu
false: okunmadı
Oluşturulma
Tarihi
SNC.
TRH Tarih - Paketin oluşturulma tarihi
Mesaj Listesi MSJ
Liste
(TIP, MET,
KOD, MPA)
-
Hata alınması durumunda döndürülür.
Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve
Mesaj Parametrelerinden oluşan listedir.
Mesaj Tipi MSJ.
TIP Metin 5
Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.
BILGI
UYARI
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.
Mesaj Kodu MSJ.
KOD Sayı -
Bilgi sistemleri tarafından işlemeye elverişli mesaj
kodudur.
Mesaj
Parametreleri
MSJ.
MPA
Parametre
Listesi -
Genellikle metin olmakla birlikte sayı veya tarih
tipinde parametreler de döndürülebilmektedir.
3.5.6.4 Kuruma Gelen Paketleri Sorgula Örnek İstek
{
"EKT" : "2016-10-25",
"EBT" : "2016-10-29",
"OKB" : “AKTIF”,
"KNO" : 7
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
186 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
}
3.6 FİRMA SORGULAMA SERVİSİ
Firmaların MERSİS numarası, vergi numarası, ÇKYS numarası ve/ya firma unvanı ile firma tanımlayıcı numarası
içeren firma bilgilerini sorgulamasını sağlayan servistir.
3.6.1 Firma Sorgulama Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/rest/kurum/firmaSorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/rest/kurum/firmaSorgula
3.6.2 Firma Sorgulama Servisi Veri Alanları
Tablo 107. Firma Sorgulama Servisi İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
MERSİS
Numarası MRS Metin 16 Hayır Firmanın MERSİS Numarası
Vergi Numarası VRG Metin 10-11 Hayır Firmanın ÜTS Vergi Numarası
Unvan UNV Metin Hayır Firmanın ÜTS Firma Unvanı
Firma No KRN Sayı Hayır Firmanın ÜTS Firma Numarası
ÇKYS No CKY Metin 20 Hayır Firmanın ÇKYS Numarası
MRS, VRG, CKY parametrelerinden en az biri zorunludur.
En fazla 20 kayıt listelenir.
Tablo 108. Firma Sorgulama Servisi Sonuç Veri Alanları
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
187 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
MERSİS
Numarası MRS Metin 16 Firmanın MERSİS Numarası
Firma
Tanımlayıcı No KRN Metin 13 Firmanın ÜTS Tanımlayıcı Numarası
Unvan GAD Metin 674 Firmanın ÜTS Firma Unvanı
Firma Durumu DRM Metin AKTIF/PASIF
Vergi No VRG Sayı 10-11 Firmanın Vergi Numarası
3.6.3 Firma Sorgulama Servisi Örnek İstek
Örnek servis çağrısı:
İstek
{
" VRG " : " 9999999999",
}
Sonuç
[{
" KRN ": firma tanımlayıcı numarası (Long),
" GAD ": firma unvanı (String)
" DRM ": firma durumu (AKTIF/PASIF),
" MRS ": firma Mersis numarası (String)
" VRG ": firma vergi numarası (String)
}]
3.7 ÜRÜN SORGULAMA SERVİSİ
Birincil ürün numarası ve üretici ÜTS firma numarası ile ürün bilgilerini sorgulamasını sağlayan servistir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
188 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.7.1 Ürün Sorgulama Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/rest/tibbiCihaz/urunSorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS//rest/tibbiCihaz/urunSorgula
3.7.2 Ürün Sorgulama Servisi Veri Alanları
Birincil ürün numarası ürün bilgilerini sorgulamasını sağlayan servistir.
Tablo 109. Ürün Sorgulama Servisi İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Ürün Numarası UNO Metin 100 Evet Sorgulanacak ürünün birincil ürün
numarası
Tablo 110. Ürün Sorgulama Servisi Sonuç Veri Alanları
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç sonuc Sayı 1 (ürün bulundu) / 0 (ürün bulunmadı)
Sonuç
Mesajı sonucMesaji Metin Ürün bulundu / Ürün bulunamadı
Ürün Listesi urunDetayLi
st Liste Girilen barkod numaralı ürün listesi
Tablo 111. Ürün Sorgulama Servisi Ürün Sonuç Veri Alanları
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Birincil Ürün
Numarası
birincilUrunNumara
si Metin
Marka Adı markaAdi Metin
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
189 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Versiyon/
Model versiyonModel Metin
Etiket Adı etiketAdi Metin
Ürün Tipi urunTipi Metin
TIBBI_CIHAZ,
SISTEM_ISLEM_PAKETI,
ISMARLAMA_TIBBI_CIHAZ
Referans/Kat
alog No referansKatalogNo Metin
İthal/İmal
Bilgisi ithalImalBilgisi Metin ITHAL, IMAL
Kayıt Durum kayitDurumu Metin KAYITLI, REDDEDILDI, SILINDI
Kayıt Durumu
Başlangıç
Tarihi
durumBaslangicTar
ihi Taih
Mevcut kayıt durumun ne zaman
başladığını gösterir.
Sınıf sinif Metin
SINIF_I_DIGER, SINIF_I_S,
SINIF_I_M, SINIF_II_A, SINIF_II_B,
SINIF_III, EK_II_LISTE_A,
EK_II_LISTE_B,
KISISEL_TEST_CIHAZLARI,
IVD_DIGER
Tek
Kullanımlık
mı
tekKullanimlik Metin EVET, HAYIR
Lateks
İçeriyor mu latexIceriyor Metin EVET, HAYIR, BILINMIYOR
MRG Uyumlu
mu mrgUyumlu Metin
Steril
Paketlendi mi sterilPaketlendi Metin EVET, HAYIR
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
190 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Her
Kullanımda
Sterilizasyon
Gerekiyor mu
herKullanimdaSteril
izasyonGerekli Metin EVET, HAYIR
İyonize
Radyasyon
İçeriyor mu
iyonizeRadyasyonI
cerir Metin EVET, HAYIR
DEHP
İçeriyor mu dehpIceriyor Metin EVET, HAYIR, BILINMIYOR
Nanomateryal
İçeriyor mu
nanomateryalIceriy
or Metin EVET, HAYIR
Sınırlı
Kullanım
Sayısı Var mı
sinirliKullanimSayis
iVar Metin EVET, HAYIR
Sınırlı
Kullanım
Sayısı
sinirliKullanimSayis
i Sayı
Raf Ömrü Var
mı rafOmruVar Metin EVET, HAYIR
Raf Ömrü rafOmru Sayı
Ek3
Kapsamında
Satılabilir mi
ek3KapsamindaMi Metin
EVET, HAYIR (Tıbbi Cihaz Satış
Yönetmeliği EK3 göre ruhsatsız
satılabilir mi?)
Kalibrasyona
Tabi mi kalibrasyonaTabiMi Metin EVET, HAYIR
Kalibrasyon
Periyodu
kalibrasyonPeriyod
u Sayı Ay bazında kalibrasyon periyodu
Bakıma Tabi
mi bakimaTabiMi Metin EVET, HAYIR
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
191 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bakım
Periyodu bakimPeriyodu Sayı Ay bazında bakım periyodu
Takip
Durumu takipDurumu Metin Takip Ediliyor / Takip Edilmiyor
Üretici Firma üreticiFirma Metin Üretici firma no – firma adı
Branş Kodu
Türü bransTurKodu Sayı Ürüne ait branş tür kodu
GMDN Kodu gmdnKodu Sayı Ürüne ait GMDN kodu
SUT Kodu sutKodu Metin
3.7.3 Ürün Sorgulama Servisi Örnek İstek
Örnek servis çağrısı:
İstek
{
"UNO" : "048327885764"
}
Sonuç
{
"sonuc": 0,
"sonucMesaji": "Ürün bulundu.",
"urunDetayList": [
{
"ureticiFirma": "10 - Erdil Medikal Ltd. Şti. (Optisyenlik Müessesesi)",
"birincilUrunNumarasi": "1111111110317",
"markaAdi": "Örnek Marka",
"versiyonModel": "XXX-Q1",
"etiketAdi": "Görüntüleme",
"urunTipi": "TIBBI_CIHAZ",
"referansKatalogNo": null,
"ithalImalBilgisi": "IMAL",
"kayitDurumu": "KAYITLI",
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
192 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"durumBaslangicTarihi": "22/12/2017",
"sinif": "SINIF_III",
"tekKullanimlik": "HAYIR",
"latexIceriyor": "HAYIR",
"mrgUyumlu": "MR_GUVENLI_DEGIL",
"sterilPaketlendi": "HAYIR",
"herKullanimdaSterilizasyonGerekli": "HAYIR",
"iyonizeRadyasyonIcerir": "HAYIR",
"dehpIceriyor": "HAYIR",
"nanomateryalIceriyor": "HAYIR",
"sinirliKullanimSayisiVar": "HAYIR",
"sinirliKullanimSayisi": null,
"rafOmruVar": "HAYIR",
"rafOmru": null,
"ek3KapsamindaMi": "HAYIR",
"bransKodu": "81",
"bransTurKodu": "81",
"gmdnKodu": "30857",
"takipDurumu": "Takip Ediliyor",
"kalibrasyonaTabiMi": "Hayır",
"kalibrasyonPeriyodu": null,
"bakimaTabiMi": "Hayır",
"bakimPeriyodu": null,
“sutKodu”: null
}
]
}
3.8 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİSİ
Firmaların kendi ürünlerini çoklu olarak sorgulamalarını sağlayan servistir.
3.8.1 Bütün Ürünleri Sorgulama Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/rest/tibbiCihaz/tibbiCihazSorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS//rest/tibbiCihaz/tibbiCihazSorgula
3.8.2 Bütün Ürünleri Sorgulama Servisi Veri Alanları
Birincil ürün numarası ürün bilgilerini sorgulamasını sağlayan servistir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
193 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Tablo 112. Bütün Ürünleri Sorgulama Servisi İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Sayfa
Büyüklüğü
sayfaBuyu
klugu Sayı 1-250 Evet Bir sayfada kaç ürün geleceğini belirtir.
Sayfa İndeksi sayfaInde
ksi Sayı Evet
Hangi sayfadaki ürünlerin getirileceğini
belirtir.
Başlangıç Tarihi baslangic
Tarihi Tarih Hayır
dd/MM/yyyy formatında veri kabul
etmektedir. Bu tarihten sonra değişen
ürün bilgilerinin filtrelenmesinde
kullanılır.
Bitiş Tarihi bitisTarihi Tarih Hayır
dd/MM/yyyy formatında veri kabul
etmektedir. Bu tarihten önce değişen
ürün bilgilerinin filtrelenmesinde
kullanılır.
Tablo 113. Bütün Ürünleri Sorgulama Servisi Sonuç Veri Alanları
Adı Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Listesi urunDetayList İstek kriterlerine uyan ürünlerin listesi
Tablo 114. Bütün Ürünleri Sorgulama Servisi Ürün Sonuç Veri Alanları
Adı Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ürün Sınıfı sinif
Takip Durumu takipDurumu Takip Ediliyor, Takip Edilmiyor
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
194 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Birincil Ürün
Numarası birincilUrunNumarasi
Ürün Tipi urunTipi TIBBI_CIHAZ, SISTEM_ISLEM_PAKETI,
ISMARLAMA_TIBBI_CIHAZ
Durum durum KAYITLI, REDDEDILDI
Durum
Başlangıç Tarihi durumBaslagicTarihi
Ürün hangi tarihten itibaren verilen durumda
olduğunu belirtir.
Marka Adı markaAdi
Etiket Adı etiketAdi
Versiyon/ Model versiyonModel
Referans/Katalo
g No katalogNo
İthal İmal Bilgisi ithalImalBilgisi ITHAL, IMAL
Güncellenme
Tarihi guncellenmeTarihi
dd/MM/yyyy formatında ürünün en son güncellenme
tarihini belirtir.
3.8.3 Bütün Ürünleri Sorgulama Servisi Örnek İstek
Örnek servis çağrısı:
İstek
{
"sayfaBuyuklugu": "250",
"sayfaIndeksi": "0",
"baslangicTarihi": "01/01/2018"
}
Sonuç
[
{
“sinif”: “SINIF_I_DIGER”,
“takipDurumu”: “Takip Ediliyor”,
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
195 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"birincilUrunNumarasi": "55655444444",
"urunTipi": "TIBBI_CIHAZ",
"durum": "KAYITLI",
"durumBaslangicTarihi": "24/05/2018",
"markaAdi": "Bir Tıbbi Cihaz 2",
"etiketAdi": "kafatası protezi",
"versiyonModel": "XXX-Q1",
"katalogNo": null,
"ithalImalBilgisi": "ITHAL",
"guncellenmeTarihi": "24/05/2018"
}
]
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
196 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
4 EKLER
4.1 EK-A SERVİS MESAJLARI
Tablo 115. Servis Mesajları
Mesaj Kodu Mesaj Açıklaması
UTS-H001 Kullanılabilir miktar yeterli değil.
UTS-H002 Tekil Ürün bulunamadı.
UTS-H003 Geri Çekme Verme Bildirimi bulunamadı.
UTS-H004 Geri Çekme Verme (Paket) Bildirimi bulunamadı.
UTS-H005 Kurum sadece kendine ait bildirimleri iptal edebilir.
UTS-H006 Aynı lot numarasına sahip tekil ürünlerin üretim tarihleri farklı olamaz.
UTS-H007 Son kullanma tarihi formatı uygun değildir.
UTS-H008 Alınan adet, verme bildiriminde gönderilen adetten fazla olamaz.
UTS-H009 Bu tekil ürün şuan askıdadır. Yeni bir bildirim yapılamaz.
UTS-H010 Bildirim Aktif olmalıdır.
UTS-H011 İlgili işlem için stokta yeteri kadar ürün bulunmamaktadır.
UTS-H012 Bildirim yapan kurum aktif olmalıdır.
UTS-H013 İlgili bildirimin yapılabilmesi için ürünün eşsiz kimliği olmalıdır.
UTS-H014 Girilen eşsiz kimliği değerine göre ürün sistemde bulunmamaktadır.
UTS-H015 Firma tipi seçeneklerinden ESBİS veya MERNİS bilgilerinden biri girilmelidir.
UTS-H016 İlgili ürün için daha önceden bildirilmiş bir Geçici Kullanıma Verme Bildirimi bulunmamaktadır.
UTS-H017 Bu tekil ürün şuan geçici kullanıma verilmiştir. Yeni bir bildirim yapılamaz.
UTS-H018 Geri Toplatılmış Tekil Ürün için bildirim yapılamaz.
UTS-H019 İmal ürünler için İthalat Bildirimi yapılamaz.
UTS-H020 İthal ürünler için Üretim Bildirimi yapılamaz.
UTS-H021 Bir kurumda aynı numaraya sahip iki paket bulunamaz.
UTS-H022 Adet sıfırdan büyük olmalıdır.
UTS-H023 MERNİS doğrulaması başarısız.
UTS-H024 Satarken tüketici kimlik bilgisi gereklidir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
197 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H025 Girilen seri numarası daha önce tanımlanmıştır.
UTS-H026 Lot numarası boş olamaz.
UTS-H027 Sınırlı sayıda kullanılan tıbbi cihazın sınırlı kullanım sayısı olmalıdır.
UTS-H028 Son kullanma tarihi, üretim tarihinden sonra olmalıdır.
UTS-H029 Son kullanma tarihi, bugünden önce olamaz.
UTS-H030 Tekil ürün üzerinde başka bildirim olduğu için bu bildirim yapılamaz.
UTS-H031 Ürün aktif olmalıdır.
UTS-H032 Ürünün belgeleri üretim tarihinde geçerli olmalıdır.
UTS-H033 Verme bildirimindeki gönderilen adet sıfırdan büyük olmalıdır.
UTS-H034 Verme bildirimi yetkili olunan kuruma ait değildir. Başka bir kuruma yapılmıştır.
UTS-H035 Geri çekme verme bildirimi yetkili olunan kuruma ait değildir. Başka bir kuruma yapılmıştır.
UTS-H036 Tekil ürün geri çekme askı durumunda olmalıdır.
UTS-H037 Verme bildirimi veritabanında bulunmamaktadır.
UTS-H038 Paket bildirimi veritabanında bulunmamaktadır.
UTS-H039 Kullanım sayısı yeterli değil.
UTS-H040 Kozmetik ürünler için kullanım bildirimi yapılamaz.
UTS-H041 Parametreler eksik.
UTS-H042 Kurum aktif değildir.
UTS-H043 Ürün veritabanında bulunmamaktadır.
UTS-H044 Ürün bulunamadı.
UTS-H045 Ürün takip edilmemektedir.
UTS-H046 Raf ömrü dolan ürün için bildirim yapılamaz.
UTS-H047 Askıdaki ürünler için bildirim yapılamaz.
UTS-H048 Geçici kullanıma verilmiş ürün için bildirim yapılamaz.
UTS-H049 Aktif olmayan Tekil Ürün için bildirim yapılamaz.
UTS-H050 Tekil Ürün son kullanma tarihi geçmemiş olmalıdır.
UTS-H051 Tekil ürünün son kullanma tarihi geçmiştir.
UTS-H052 Yapılan istek için gönderilen parametreler eksiktir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
198 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H053 İptal edilmek istenen bildirim veritabanında bulunmamaktadır.
UTS-H054 Tekil ürün kurumunuz bünyesinde değildir.
UTS-H055 Bildirim iptal süresi dolmuştur. Bildirim iptal edilemez.
UTS-H056 Bildirim veri tabanında bulunmamaktadır.
UTS-H057 Lot takipte adet bilgisi boş olamaz.
UTS-H058 HEK Zayiat türü Diğer ise Diğer Açıklama alanı doldurulmalıdır.
UTS-H059 Hastanın vücudundan çıkarma bildiriminde gerekçe Diğer ise Diğer Gerekçe Açıklaması alanı
doldurulmalıdır.
UTS-H060 Üretim tarihi bugünden sonra olamaz.
UTS-H061 Üretim tarihi, bildirimin yapıldığı tarihten raf ömrü kadar geri gidebilir.
UTS-H062 Adet bilgisi boş olamaz.
UTS-H063 Seri numarası boş olamaz.
UTS-H064 Lot adedi sıfırdan büyük olmalıdır.
UTS-H065 Lot adedi girilmelidir.
UTS-H066 Hasta kimlik numarası girilmiş olmalıdır.
UTS-H067 Kullanım sayısı sınırsız olan ürünler için kullanım bildirimi yapılamaz.
UTS-H068 Üretim tarihi bildirim tarihinden ileride olmaz.
UTS-H069 Üretim tarihi raf ömründen geride olamaz.
UTS-H070 Bildirim adeti sıfırdan küçük veya boş olamaz.
UTS-H071 Bildirimi yapan kurum aktif olmalıdır.
UTS-H072 İthal edilen ülke ile ürün bağlantılı değildir.
UTS-H073 Menşei ülke ile ürün bağlantılı değildir.
UTS-H074 İlgili ürün için daha önceden bildirilmiş bir Tüketiciye Verme Bildirimi bulunmamaktadır.
UTS-H075 Tüketiciye verme bildiriminde iade alınan adet tüketiciye verilen adetten fazla olamaz.
UTS-H076 Tüketiciden İade Alma bildiriminde iade alınan adet sıfırdan büyük olmalıdır.
UTS-H077 Toplam tekil ürün adedinden fazla pakete eklenemez.
UTS-H078 Tekil ürün adeti sıfırdan büyük olmalıdır.
UTS-H079 Bildirimin yapılması için Geri Çekme tanımlanmış olmalıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
199 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H080 Geri Çekme sebebi "Güvensiz" olamaz.
UTS-H081 Bu tekil ürün şuan geri çekme askıdadır. Yeni bir bildirim yapılamaz.
UTS-H082 Verilen kurum sistemde bulunamadı.
UTS-H083 Paket sistemde bulunamadı.
UTS-H084 Paket veren kurumda değil.
UTS-H085 Paket mahrecine iade etme bildirimini yapan kurumda değil.
UTS-H086 Bildirim türü hatalıdır.
UTS-H087 Konfigürasyon türü tekil takip olan ürünler için girilen adet 1 veya boş olmalıdır.
UTS-H088 Bildirim yapılabilmesi için paketin aktif olması gerekmektedir.
UTS-H089 Gönderilen bildirim kodu paket verme bildirimine ait değildir.
UTS-H090 Verilen kurum sistemde mevcut değil.
UTS-H091 Tekil ürün tüketicide veya kullanımda olmalıdır.
UTS-H092 {0} seri numaralı tekil ürünler başka bir paket içinde yer almaktadır. Tekil bazlı takip edilen
tekil ürünler sadece tek paket içinde yer alabilir.
UTS-H093 Ürün geri çekildiği için bildirim gerçekleştirilemez.
UTS-H094 Tekil ürün geri çekildiği için bildirim gerçekleştirilemez.
UTS-H095 Ismarlama tıbbi cihaz sadece üründeki kişiye verilebilir.
UTS-H096 Firma güvensiz ürünü kendisi geri çekemez.
UTS-H097 Sistem işlem paketindeki alt ürünlerinin miktarları yeterli değildir.
UTS-H098 Sistem işlem paketindeki lot bazlı takip edilen ürünler için adet girilmemiştir.
UTS-H099 Tekil ürün kurumda değil ya da kurum üretici yada ithalatçı değildir.
UTS-H100 Kozmetik ürün setindeki alt ürünlerinin miktarları yeterli değildir.
UTS-H101 Kozmetik ürün setindeki lot bazlı takip edilen ürünler için adet girilmemiştir.
UTS-H102 Ismarlama tıbbi cihazlar için geçici kullanıma verme bildirimi yapılamaz.
UTS-H103 Ismarlama tıbbi cihazlar için ÜTS’de tanımsız yere verme bildirimi yapılamaz.
UTS-H104 Ismarlama tıbbi cihazlar için yeniden işleme bildirimi yapılamaz.
UTS-H105 Diğer kurum aktif olmalıdır.
UTS-H106 Diğer kurum numarası eksiktir.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
200 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H107 Sistem işlem paketinde tekil takip edilen ürün/ürünler başka bir sistem işlem paketi içerisinde
eklenmiştir.
UTS-H108 Firma kendisine verme bildirimi yapamaz.
UTS-H109 Firma kendisine geri çekme verme bildirimi yapamaz.
UTS-H110 Kozmetik ürün setindeki tekil takip edilen ürün/ürünler başka bir kozmetik ürün seti içerisinde
eklenmiştir.
UTS-H111 Bu firma ÜTS'de tanımlıdır. ÜTS'de tanımlı firmalara ÜTS'de Tanımsız Yere Verme bildirimi
yapılamaz. Verme bildirimi yapılabilir.
UTS-H112 Paket içeriğindeki tüm bildirimler başarısız oldu. Paket bildirimi eklenemedi.
UTS-H113 Paket numarasını paketi oluşturan kurumdan başkası güncelleyemez.
UTS-H114 İmal ürünler için mahrecine iade bildirimi yapılamaz.
UTS-H115 Alma bildirimi yapılmış verme bildirimi iptal edilemez.
UTS-H116 İthal edildiği ülke kodu geçerli değildir.
UTS-H117 Kullanımdan alma bildirimi yapılmış bildirim için iptal bildirimi yapılamaz.
UTS-H118 SİP içindeki tekil ürünler için geri çekme kararı verilmiş olamaz.
UTS-H119 SİP içindeki tekil ürünler için güvensiz geri çekme kararı verilmiş olamaz.
UTS-H120 SİP içindeki tekil ürünlerin son kullanma tarihi geçmiş ya da raf ömrü dolmuş olamaz.
UTS-H121 SİP içine aynı tekil ürünün farklı lotları eklenemez.
UTS-H122 Paket askıda olduğu için silme işlemi yapılamaz.
UTS-H123 Paket geri çekme askıda olduğu için silme işlemi yapılamaz.
UTS-H124 SİP tanımına göre içindeki tekil ürünler eksik.
UTS-H125 Hastanın vücudundan çıkarma gerekçesinin Geri Çağırma seçilebilmesi için ürün geri
çekilmiş olmalıdır.
UTS-H126 Bu paket şuan askıdadır. Yeni bir bildirim yapılamaz.
UTS-H127 İthalat tarihi, üretim tarihinden sonra olmalıdır.
UTS-H128 İthalat tarihi raf ömründen geride olamaz.
UTS-H129 Üretim veya ithalat tarihlerinden en az biri girilmiş olmalıdır.
UTS-H130 İthalat tarihi bildirim tarihinden ileride olmaz.
UTS-H131 Son kullanma tarihi, üretim ve ithalat tarihinden sonra olmalıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
201 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H132 ÜTS’de tanımsız yere verme bildiriminde iade alınan adet verilen adetten fazla olamaz.
UTS-H133 İlgili ürün için daha önceden ÜTS’de tanımsız yere verme bildirimi bulunmamaktadır.
UTS-H134 Tekil ürün sadece bildirim yapılan kuruma iade edilebilir.
UTS-H135 Sadece askıdaki tekil ürünler için alma bildirimi yapılabilir.
UTS-H136 Tekil ürün hastanın vücudundan çıkartıldığı için bu bildirim yapılamaz.
UTS-H137 Pakete sadece kurum üzerindeki paketler eklenebilir.
UTS-H138 Pakete sadece kurum üzerindeki tekil ürünler eklenebilir.
UTS-H139 İlgili işlem için stokta yeteri kadar ürün bulunmamaktadır. Stokta {0} adet tekil ürün
bulunmaktadır.
UTS-H140 Kozmetik ürünler için geçici kullanıma verme bildirimi yapılamaz.
UTS-H141 Lot bazında takip edilen ürünler için seri/sıra numarası verilemez.
UTS-H144 Paket içerisine, paketin içerisinde olduğu paket koyulamaz.
UTS-H145 Güncellenmek istenen paket kurum üzerinde olmalıdır.
UTS-H146 Tıbbi Cihazlar Kozmetik firmasına verilemez.
UTS-H147 Tıbbi Cihazlar için Üretim tarihi girilmesi zorunludur.
UTS-H148 Kozmetik ürünler için hastanın vücudundan çıkarma bildirimi yapılamaz.
UTS-H149 Paket sadece bildirim yapılan kuruma iade edilebilir.
UTS-H150 Pasif kurumlar ödünç verme bildirimi yapamaz.
UTS-H151 Firma kendisine verme bildirimi yapamaz.
UTS-H152 Tıbbi Cihazlar için kozmetik firmasına ödünç verme bildirimi yapılamaz.
UTS-H153 Kozmetik ürünler için ödünç verme bildirimi yapılamaz.
UTS-H154 Lot bazında takip edilen tıbbi cihazlar için ödünç verme bildirimi yapılamaz.
UTS-H155 Ödünç Verme Askıdaki ürünler için bildirim yapılamaz.
UTS-H156 Ödünç Alma bildirimi yapılmış ödünç verme bildirimi iptal edilemez.
UTS-H157 Kozmetik ürünler için ödünç alma bildirimi yapılamaz.
UTS-H158 Lot bazında takip edilen tıbbi cihazlar için ödünç alma bildirimi yapılamaz.
UTS-H159 Paketler için ödünç alma bildirimi yapılamaz.
UTS-H160 Bu tekil ürün şuan tüketicidedir. Yeni bir bildirim yapılamaz.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
202 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H161 Ismarlama tıbbi cihaz bildirimleri henüz başlamamıştır
UTS-H162 Kozmetik ürün seti bildirimleri henüz başlamamıştır
UTS-H163 Sistem işlem paketi bildirimleri henüz başlamamıştır
UTS-H164 Kimlik bilgileri girilmelidir.
UTS-H165 Seri numarası karakter sayısı hatalıdır.
UTS-H166 Lot numarası karakter sayısı hatalıdır.
UTS-H168 İade edilmek istenen bildirim veri tabanında bulunmamaktadır.
UTS-H169 Paket numarası daha önce tanımlanmıştır.
UTS-H170 Verilen Tekil Ürün bilgilerine uyan bildirim bulunamadı!
UTS-H171 Verilen Tekil Ürün bilgilerine uyan birden fazla bildirim bulundu!
UTS-H172 Okundu olarak işaretlenecek sistem paketi kuruma gelmiş olmalıdır.
UTS-H173 Yedi emin kararı bulunan tekil ürünler hareket ettirilemez
UTS-H174 Silinecek paket başka paket içinde olduğu için silinemez
UTS-H175 Girilen paket numarası mevcut olduğu için aynı paket eklenemez
UTS-H176 Paket içine eklenmek istenen paket önceden eklendiği için tekrar eklenemez
UTS-H177 Paket içine kendisi eklenemez
UTS-H178 SET tanımına göre içindeki tekil ürünler eksik
UTS-H179 ÜTS’de tanımsız yerden iade almada, iade alınan adet sıfırdan büyük olmalıdır
UTS-H180 Ödünç geri verme askıdaki ürünler için bildirim yapılamaz
UTS-H181 Verilen kurum tekil ürünün sahibi olmalıdır
UTS-H182 Tekil ürün önceden ödünç verilmiş olamaz
UTS-H183 Verilen eşsiz kimlikli ürün sistemde yoktur
UTS-H184 İptal edilmek istenen bildirime ait paket başka paket içinde olduğu için bildirim iptal edilemez
UTS-H185 Silinecek paket üzerinde bildirim olduğu için paket silinemez
UTS-H186 Aktif olmayan paket güncellenemez
UTS-H187 Vergi kimlik no girilmelidir
UTS-H188 Firma VEDOP’ta tanımlı değildir
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
203 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H189 Tekil ürün bildirim yapılan kurumda değildir. Tekil ürün kurum numarası : {0} ve unvanı : {1}
olan kurumdadır.
UTS-H190 Tekil ürünün adet bilgisi ile ilgili sorun tespit edildiği için hareket bildirimleri dondurulmuştur.
İdare ile iletişime geçiniz.
UTS-H191 Aynı lot numarası ile farklı eşsiz kimlikli ürün üretilemez / ithal edilemez.
UTS-H192 Paket içindeki tüm tekil ürün bildirimleri başarısız olduğu için paket bildirimi
gerçekleştirilememiştir.
UTS-H193 Tüketiciye Verme Bildirimini yapan kurum SGK olduğu için, bu bildirimi yapan kurum da SGK
olmalıdır.
UTS-H194 Tüketiciye Verme Bildirimini yapan kurum SGK olmadığı için, bu bildirimi yapan kurum SGK
olamaz.
UTS-H195 Tüketiciden iade alan kurum, tüketiciye verme bildirimi yapan kurum ile aynı vergi noya sahip
olmalıdır.
UTS-H196 Kozmetik Ürünler Tıbbi Cihaz firmasına verilemez.
UTS-H197 Tüketiciye verme tarihi bugünden sonra olamaz.
UTS-H198 Hastanın vücudundan çıkarma tarihi bugünden sonra olamaz.
UTS-H199 Kullanım tarihi bugünden sonra olamaz.
UTS-H200 {0} tarihi {1} tarihinden önce olamaz.
UTS-H201 Geçici kullanıma verme tarihi bugünden sonra olamaz.
UTS-H202 Ödünç verme tarihi bugünden sonra olamaz.
UTS-H203 Tekil ürün ÜTS dışındadır.
UTS-H204 Üretim / İthalat tarihinde geçerli konfigürasyon olduğu için gönüllü takip yapılamaz.
UTS-H205 Silinecek paket aktif olmalıdır.
UTS-H206 Bildirim TİTCK tarafından yapılmamıştır.
UTS-H207 Alt paket bulunamadı.
UTS-H208 Tekil ürünün eşsiz kimliği bulunduğu için, bu sorgulama eşsiz kimlik ile sorgula tarafında
yapılmalıdır. ( Tekil ürünün eşsiz kimliği : {0} )
UTS-H209 Kişi kimlik bilgisi türü Diğer ise Diğer Açıklama alanı doldurulmalıdır.
UTS-H210 Bildirim tarihi bugünden sonra olamaz.
UTS-H222 Kullanım bildirimi için adet 1 olmalıdır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
204 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H223 Ismarlama tıbbi cihazlar LOT ya da GÖNÜLLÜ LOT olarak takip edilemez.
UTS-H224 Alt tekil ürünlerin üretim tarihi, SIP/SET'in üretim tarihinden ileride olamaz.
UTS-H225 Alt tekil ürünlerin üretim/ithalat tarihi, SET üretim/ithalat tarihinden ileride olamaz.
UTS-H226 SET içine aynı tekil ürünün farklı lotları eklenemez.
UTS-H227 SIP/SET içine aynı tekil ürün eklenemez.
UTS-H228 Alt tekil ürünlerde tekil takip edilen tekil ürün bulunduğu için SIP/SET tekil takip edilmektedir.
Takip konfigürasyonu Gönüllü Lot seçilemez.
UTS-H231 Iade alınan tekil ürün olduğu için bildirim iptal edilemez.
UTS-H232 Başkasına ait tekil ürünler için kullanımdan alma bildirimi yapılamaz.
UTS-H233 Son kullanma tarihi, ithalat tarihinden sonra olmalıdır.
UTS-H234 Verilen paket numarasına ait paket bulunamadı.
UTS-H235 Vergi numarasi, gümrük beyanname belgesinde bulunan vergi numarasi ile uyumlu değildir.
UTS-H236 Gümrük beyanname bilgisi daha önce kaydedilmiştir.
UTS-H237 Girilen beyanname ve kalem numarasına ait gümrük beyanname bilgisi bulunamamıştır.
UTS-H238 Gümrük beyanname bilgisi girilen ürün ithal olmalıdır.
UTS-H239 Gümrük beyannamesi başka kurum tarafından eklenmiştir.
UTS-H240 İthal edilemek istenen ürün için tanımlı gümrük beyannamesi bulunamadı.
UTS-H241 Yeterli gümrük kotası bulunmamaktadır.
UTS-H242 Envanter tarihi bugünden sonra olamaz.
UTS-H243 Üretici/İthalatçı kurum aktif olmalıdır.
UTS-H244 Üretici/İthalatçı kurum ÜTS'de bulunmamaktadır.
UTS-H245 Ürün envanter ürünü değildir.
UTS-H246 Ürün türü tıbbi cihaz olmalıdır.
UTS-H247 Menşei ülkesi Türkiye olan ürünler için ithalat bildirimi yapılamaz.
UTS-H248 Eksik alma bildirimi yetkili olunan kuruma ait değildir. Başka bir kuruma yapılmıştır.
UTS-H249 Stok tarihi bugünden sonra olamaz.
UTS-H250 Aynı lot numarasına sahip tekil ürünlerin stok veya üretim tarihleri farklı olamaz.
UTS-H251 Son kullanma tarihi stok tarihinden önce olamaz.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
205 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H252 Üretici/İthalatçı kurum ile bildirim yapan kurum arasında bayilik ilişkisi olmalıdır.
UTS-H253 Kurum kendi üzerinden stok bildirimi yapamaz.
UTS-H254 Kurum kendi üzerinden envanter bildirimi yapamaz.
UTS-H255 Kurumdaki aynı ürün ve lot/batch numaralı tekil ürünün stok tarihinde, aynı ürün ve lot/batch
numaralı farklı üretim tarihli tekil ürün alınamaz.
UTS-H256 Kullanım bildiriminde tüketici bilgisi girilmemiş olduğu için kullanım kilitleme yapılamaz.
UTS-H257
Aynı lot numaralı tekil ürünün ÜTS''ye giriş tarihleri aynı olmalıdır. Daha önce yapılan
(üretim/ithalat/stok) bildirim(ler)inde, tekil ürünün sisteme giriş (üretim/ithalat) tarihi (yıl-ay-
gün) : {0}
UTS-B001 Yeniden işleme iptal bildirimi yapıldı.
UTS-B002 İthalat bildirimi yapıldı.
UTS-B003 İhracat bildirimi yapıldı.
UTS-B004 Kullanım bildirimi yapıldı.
UTS-B005 Geçici kullanıma verme bildirimi yapıldı.
UTS-B006 Alma bildirimi yapıldı.
UTS-B007 Geri çekme alma bildirimi yapıldı.
UTS-B008 Geri çekme alma (paket) bildirimi yapıldı.
UTS-B009 Geçici kullanıma verme iptal bildirimi yapıldı.
UTS-B010 Hastanın vücudundan çıkarma bildirimi yapıldı.
UTS-B011 Hastanın vücudundan çıkarma iptal bildirimi yapıldı.
UTS-B012 {0} numaralı paket eklendi.
UTS-B013 {0} numaralı paket güncellendi.
UTS-B014 {0} numaralı paket silindi.
UTS-B015 İthalat iptal bildirimi yapıldı.
UTS-B016 ÜTS'de tanımsız yere verme bildirimi yapıldı.
UTS-B017 ÜTS'de tanımsız yere verme iptal bildirimi yapıldı.
UTS-B018 Kullanım iptal bildirimi yapıldı.
UTS-B019 Kullanımdan alma bildirimi yapıldı.
UTS-B020 Kullanımdan alma iptal bildirimi yapıldı.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
206 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-B021 Tüketiciye vermeyi iptal bildirimi yapıldı.
UTS-B022 Üretim iptal bildirimi yapıldı.
UTS-B023 Tüketiciye verme bildirimi yapıldı.
UTS-B024 Üretim bildirimi yapıldı.
UTS-B025 Verme iptal bildirimi yapıldı.
UTS-B026 Yeniden işleme bildirimi yapıldı.
UTS-B027 Verme bildirimi yapıldı.
UTS-B028 Mahrecine iade etme bildirimi yapıldı.
UTS-B029 Mahrecine iade etme iptal bildirimi yapıldı.
UTS-B030 HEK/Zayiat bildirimi yapıldı.
UTS-B031 HEK/Zayiat iptal bildirimi yapıldı.
UTS-B032 İhracat iptal bildirimi yapıldı.
UTS-B033 Geri çekme verme bildirimi yapıldı.
UTS-B034 Tüketiciden iade alma bildirimi yapıldı.
UTS-B035 İmha/Bertaraf bildirimi yapıldı.
UTS-B036 İmha/Bertaraf iptal bildirimi yapıldı.
UTS-B037 Islah/Düzeltici faaliyet bildirimi yapıldı.
UTS-B038 Islah/Düzeltici faaliyet iptal bildirimi yapıldı.
UTS-B039 Tüketiciden iade alma iptal bildirimi yapıldı.
UTS-B040 Geri çekme verme iptal bildirimi yapıldı.
UTS-B041 Verme (paket) bildirimi yapıldı.
UTS-B042 Mahrecine iade etme (paket) bildirimi yapıldı.
UTS-B043 Verme (paket) iptal bildirimi yapıldı.
UTS-B044 Geri çekme verme (paket) bildirimi yapıldı.
UTS-B045 Alma (paket) bildirimi yapıldı.
UTS-B046 İhracat (paket) bildirimi yapıldı.
UTS-B047 ÜTS'de tanımsız yere verme (paket) bildirimi yapıldı.
UTS-B048 ÜTS'de tanımsız yere verme (paket) iptal bildirimi yapıldı.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
207 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-B049 İhracat (paket) iptal bildirimi yapıldı.
UTS-B050 Mahrecine iade etme (paket) iptal bildirimi yapıldı.
UTS-B051 Geri çekme verme (paket) iptal bildirimi yapıldı.
UTS-B052 ÜTS’de tanımsız yerden iade alma bildirimi yapıldı.
UTS-B053 ÜTS’de tanımsız yerden iade alma iptal bildirimi yapıldı.
UTS-B054 ÜTS'de tanımsız yerden iade alma (paket) bildirimi yapıldı.
UTS-B055 ÜTS'de tanımsız yerden iade alma (paket) iptal bildirimi yapıldı.
UTS-B056 Ödünç verme bildirimi yapıldı.
UTS-B057 Ödünç verme iptal bildirimi yapıldı.
UTS-B058 Ödünç alma bildirimi yapıldı.
UTS-B059 Tüketiciye verme bildirimi yapılabilir.
UTS-B060 {0} nolu sistem paketi okundu olarak işaretlendi.
UTS-B061 Ödünç geri alma bildirimi yapıldı.
UTS-B062 Sorgulanan tekil ürün TİTUBB''da kayıtlıdır.
UTS-B063 Sorgulanan tekil ürün TİTUBB''da kayıtlı değildir.
UTS-B066 Gümrük beyanname bilgisi kaydedildi.
UTS-B067 Gümrük beyanname bilgisi silindi.
UTS-B068 Envanter bildirimi yapıldı.
UTS-B069 Envanter iptal bildirimi yapıldı.
UTS-B070 Seçilen bildirimin görüldü durumu güncellendi.
UTS-B071 Stok bildirimi yapıldı.
UTS-B072 Stok iptal bildirimi yapıldı.
UTS-U001 Tekil ürün geri çekilmiştir.
UTS-U002 Ürün geri çekilmiştir.
UTS-U003 Geri çekilmemiş tekil ürünler paketten çıkarılmıştır.
UTS-U004 Uyarı: {0} nolu paket içindeki {1} tekil ürün için {2} hatası nedeniyle bildirim yapılamamıştır.
UTS-U005 Uyarı: {0} nolu paket içindeki {1} tekil ürün ve {2} numaralı bildirim için {3} hatası nedeniyle
bildirim yapılamamıştır.
TASNİF DIŞI
TÜBİTAK – BİLGEM – YTE
ÜTS PROJESİ
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016
208 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
TÜBİTAK – BİLGEM – YTE