Upload
others
View
4
Download
0
Embed Size (px)
Citation preview
TAKİP VE İZLEME WEB SERVİS
TANIMLARI DOKÜMANI
Revizyon Numarası: 1.94
ÜTS Versiyon 8.4.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 / 231 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 / 231 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.
1.0.70 27.10.2018 Stok bildiriminde Stok Tarihi “STT”, Üretim Tarihi “URT” 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
4 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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.
1.0.81 23.05.2019 Bildirim sorgulama servisi cevap veri alanları güncellendi.
1.0.82 22.08.2019
Eczane stok bildirimi için sorgulama servisleri ve bildirim ekleme servisleri eklendi.
Yetkili Bayi ile ithalat bildirimi yapılırken kullanılacak istek parametresi eklendi.
Firmaya yapılan alma bildirimlerinin alınmak istenmiyor olarak işaretlenebilmesi için ve
sorgulanabilmesi için servis eklendi.
Hata mesajları güncellendi.
1.0.83 03.09.2019 Ürün Sorgulama Servisi ve Bütün Ürünleri Sorgulama servisi veri alanlarına “Sistemde Tekil Ürünü
Var Mı” ve “Ret Sebebi” alanı eklendi.
1.0.84 12.09.2019 Yetkili Bayi ile ithalat bildirimi yapma servisi için veri alanları ve örnek istek eklendi.
1.0.85 14.10.2019 Yeni Doğan Bilgisi kimlik türü bilgisi alanından çıkarılarak ayrı bir alana alındı. Hek/Zayiat bildirim
türüne “STOK_DUZELTME” seçeneği eklendi.
1.0.87 15.11.2019 Tüketim Bildirimi ve Tüketim İptal Bildirimleri servisleri eklendi.
1.0.88 25.11.2019
Ürün Sorgulama Servisi ve Bütün Ürünleri Sorgulama Servisi veri alanlarından “Sistemde Tekil
Ürünü Var Mı” ve “Ret Sebebi” alanı kaldırıldı. Sistemde Tekil Ürünü Var olan cihazların “durum”
alanı “Kayıtlı/Tekil Ürünü Var” olarak güncellendi.
1.0.89 10.01.2020 Ayrıntılı tekil ürün ve bildirim sorgulama için gerekli web servis tanımları eklendi
1.0.90 14.02.2020 Ürün Sorgulama servisine Raf Ömrü Birimi eklendi.
1.0.91 02.04.2020 Ürün Sorgulama servisine Yönetmelik ve Ürün Sayısı bilgisi, Bütün Ürünleri Sorgulama Servisine
ise Ürün Sayısı bilgisi 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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
1.0.92 04.05.2020 Belge numarası ile kuruma gelen verme ve geri çekme verme bildirimlerinin sorgulanabilmesi
sağlandı.
1.0.93 24.06.2020 Piyasaya arz barkodu vererek alt ürün bilgileri sorgulama eklendi
1.0.94 28.06.2020
Kozmetik Firmaya Verme bildirimi web servisleri eklendi. Kuruma gelen bildirimleri sorgulama web
servisleri güncellendi.
Kuruma gelen bildirimleri sorgulama web servisine dış barkod ile yapılan örnek 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
6 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
İÇİNDEKİLER
1 GİRİŞ ........................................................................................................................................................ 20
1.1 AMAÇ ........................................................................................................................................................ 20
1.2 KAPSAM ................................................................................................................................................... 20
1.3 TERİMLER VE KISALTMALAR ................................................................................................................ 20
2 WEB SERVİSLERİN GENEL YAPISI ...................................................................................................... 21
2.1 ÜTS’NİN DİĞER BİLGİ SİSTEMLERİ İLE ENTEGRASYONU ................................................................. 21
3 WEB SERVİSLER .................................................................................................................................... 22
3.1 HAREKET BİLDİRİM SERVİSLERİ .......................................................................................................... 22
3.1.1.1 Üretim Bildirimi Servis Adresi.................................................................................................................... 22
3.1.1.2 Üretim Bildirimi Veri Alanları ..................................................................................................................... 23
3.1.1.3 Üretim Bildirimi Örnek İstek ...................................................................................................................... 24
3.1.2.1 İthalat Bildirimi Servis Adresi .................................................................................................................... 26
3.1.2.2 İthalat Bildirimi Veri Alanları ...................................................................................................................... 26
3.1.2.3 İthalat Bildirimi Örnek İstek ....................................................................................................................... 28
3.1.3.1 Yetkili Bayi İle İthalat Bildirimi Servis Adresi ............................................................................................. 29
3.1.3.2 Yetkili Bayi İle İthalat Bildirimi Veri Alanları .............................................................................................. 29
3.1.3.3 Yetkili Bayi İle İthalat Bildirimi Örnek İstek ................................................................................................ 32
3.1.4.1 Verme Bildirimi Servis Adresi.................................................................................................................... 32
3.1.4.2 Verme Bildirimi Veri Alanları ..................................................................................................................... 32
3.1.4.3 Verme Bildirimi Örnek İstek ...................................................................................................................... 33
3.1.4.4 Eşsiz Kimlik Bilgisi İle Verme Bildirimi Servis Adresi ................................................................................ 33
3.1.4.5 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları .................................................................................. 33
3.1.4.6 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Örnek İstek ................................................................................... 34
3.1.5.1 Kozmetik Firmaya Verme Bildirimi Servis Adresi...................................................................................... 35
3.1.5.2 Kozmetik Firmaya Verme Bildirimi Veri Alanları ....................................................................................... 35
3.1.5.3 Kozmetik Firmaya Verme Bildirimi Örnek İstek ........................................................................................ 35
3.1.6.1 Alma Bildirimi Servis Adresi ...................................................................................................................... 36
3.1.6.2 Alma Bildirimi Veri Alanları........................................................................................................................ 36
3.1.6.3 Alma Bildirimi Örnek İstek ......................................................................................................................... 37
3.1.6.4 Eşsiz Kimlik Bilgisi İle Alma Bildirimi Servis Adresi .................................................................................. 39
3.1.6.5 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları .................................................................................... 39
3.1.6.6 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Örnek İstek ..................................................................................... 40
3.1.1 ÜRETİM BİLDİRİMİ ........................................................................................................................................ 22
3.1.2 İTHALAT BİLDİRİMİ........................................................................................................................................ 25
3.1.3 YETKİLİ BAYİ İLE İTHALAT BİLDİRİMİ .............................................................................................................. 29
3.1.4 VERME BİLDİRİMİ ......................................................................................................................................... 32
3.1.5 KOZMETİK FİRMAYA VERME BİLDİRİMİ ........................................................................................................... 34
3.1.6 ALMA BİLDİRİMİ ........................................................................................................................................... 36
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.7.1 ÜTS’de Tanımsız Yere Verme Bildirimi Servis Adresi .............................................................................. 40
3.1.7.2 ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ............................................................................... 40
3.1.7.3 ÜTS’de Tanımsız Yere Verme Bildirimi Örnek İstek ................................................................................. 41
3.1.7.4 Eşsiz Kimlik Bilgisi İle ÜTS’de Tanımsız Yere Verme Bildirimi Servis Adresi .......................................... 41
3.1.7.5 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ............................................ 41
3.1.7.6 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Örnek İstek ............................................. 43
3.1.8.1 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Servis Adresi .................................................................... 43
3.1.8.2 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları ...................................................................... 43
3.1.8.3 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Örnek İstek ....................................................................... 44
3.1.8.4 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Servis Adresi ................................. 45
3.1.8.5 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları .................................. 45
3.1.8.6 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Örnek İstek .................................... 45
3.1.9.1 Kullanım Bildirimi Servis Adresi ................................................................................................................ 46
3.1.9.2 Kullanım Bildirimi Veri Alanları .................................................................................................................. 46
3.1.9.3 Kullanım Bildirimi Örnek İstek ................................................................................................................... 48
3.1.9.4 Eşsiz Kimlik Bilgisi İle Kullanım Bildirimi Servis Adresi ............................................................................ 48
3.1.9.5 Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları .............................................................................. 48
3.1.9.6 Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Örnek İstek ............................................................................... 50
3.1.10.1 Tüketiciye Verme Bildirimi Servis Adresi .................................................................................................. 51
3.1.10.2 Tüketiciye Verme Bildirimi Veri Alanları .................................................................................................... 51
3.1.10.3 Tüketiciye Verme Bildirimi Örnek İstek ..................................................................................................... 53
3.1.10.4 Eşsiz Kimlik Bilgisi İle Tüketiciye Verme Bildirimi Servis Adresi ............................................................... 53
3.1.10.5 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Veri Alanları ................................................................ 53
3.1.10.6 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Örnek İstek .................................................................. 55
3.1.11.1 Tüketiciden İade Alma Bildirimi Servis Adresi .......................................................................................... 56
3.1.11.2 Tüketiciden İade Alma Bildirimi Veri Alanları ............................................................................................ 56
3.1.11.3 Tüketiciden İade Alma Bildirimi Örnek İstek ............................................................................................. 57
3.1.11.4 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Servis Adresi ....................................................... 58
3.1.11.5 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları......................................................... 58
3.1.11.6 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Örnek İstek .......................................................... 59
3.1.12.1 Geçici Kullanıma Verme Bildirimi Servis Adresi ....................................................................................... 59
3.1.12.2 Geçici Kullanıma Verme Bildirimi Veri Alanları ......................................................................................... 59
3.1.12.3 Geçici Kullanıma Verme Bildirimi Örnek İstek .......................................................................................... 61
3.1.7 ÜTS’DE TANIMSIZ YERE VERME BİLDİRİMİ .................................................................................................... 40
3.1.8 ÜTS’DE TANIMSIZ YERDEN İADE ALMA BİLDİRİMİ .......................................................................................... 43
3.1.9 KULLANIM BİLDİRİMİ ..................................................................................................................................... 46
3.1.10 TÜKETİCİYE VERME BİLDİRİMİ....................................................................................................................... 51
3.1.11 TÜKETİCİDEN İADE ALMA BİLDİRİMİ ............................................................................................................... 56
3.1.12 GEÇİCİ KULLANIMA VERME BİLDİRİMİ ............................................................................................................ 59
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.12.4 Eşsiz Kimlik Bilgisi İle Geçici Kullanıma Verme Bildirimi Servis Adresi .................................................... 62
3.1.12.5 Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları ..................................................... 62
3.1.12.6 Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Örnek İstek ....................................................... 64
3.1.13.1 Kullanımdan Alma Bildirimi Servis Adresi ................................................................................................. 64
3.1.13.2 Kullanımdan Alma Bildirimi Veri Alanları .................................................................................................. 64
3.1.13.3 Kullanımdan Alma Bildirimi Örnek İstek .................................................................................................... 65
3.1.13.4 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Servis Adresi ............................................................. 66
3.1.13.5 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları ............................................................... 66
3.1.13.6 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Örnek İstek ................................................................ 66
3.1.14.1 Yeniden İşleme Bildirimi Servis Adresi ..................................................................................................... 66
3.1.14.2 Yeniden İşleme Bildirimi Veri Alanları ....................................................................................................... 66
3.1.14.3 Yeniden İşleme Bildirimi Örnek İstek ........................................................................................................ 67
3.1.14.4 Eşsiz Kimlik Bilgisi İle Yeniden İşleme Bildirimi Servis Adresi .................................................................. 67
3.1.14.5 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları ................................................................... 67
3.1.14.6 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Örnek İstek ..................................................................... 68
3.1.15.1 İhracat Bildirimi Servis Adresi ................................................................................................................... 68
3.1.15.2 İhracat Bildirimi Veri Alanları ..................................................................................................................... 68
3.1.15.3 İhracat Bildirimi Örnek İstek ...................................................................................................................... 69
3.1.15.4 Eşsiz Kimlik Bilgisi İle İhracat Bildirimi Servis Adresi ............................................................................... 69
3.1.15.5 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları ................................................................................. 69
3.1.15.6 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Örnek İstek .................................................................................. 70
3.1.16.1 Mahrecine İade Etme Bildirimi Servis Adresi ............................................................................................ 70
3.1.16.2 Mahrecine İade Etme Bildirimi Veri Alanları ............................................................................................. 71
3.1.16.3 Mahrecine İade Etme Bildirimi Örnek İstek ............................................................................................... 71
3.1.16.4 Eşsiz Kimlik Bilgisi İle Mahrecine İade Etme Bildirimi Servis Adresi ........................................................ 71
3.1.16.5 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları .......................................................... 71
3.1.16.6 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Örnek İstek ........................................................... 72
3.1.17.1 HEK / Zayiat Bildirimi Servis Adresi .......................................................................................................... 72
3.1.17.2 HEK / Zayiat Bildirimi Veri Alanları ........................................................................................................... 72
3.1.17.3 HEK / Zayiat Bildirimi Örnek İstek ............................................................................................................. 73
3.1.17.4 Eşsiz Kimlik Bilgisi İle HEK / Zayiat Bildirimi Servis Adresi ...................................................................... 74
3.1.17.5 Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları ........................................................................ 74
3.1.17.6 Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Örnek İstek ......................................................................... 74
3.1.13 KULLANIMDAN ALMA BİLDİRİMİ ..................................................................................................................... 64
3.1.14 YENİDEN İŞLEME BİLDİRİMİ ........................................................................................................................... 66
3.1.15 İHRACAT BİLDİRİMİ ....................................................................................................................................... 68
3.1.16 MAHRECİNE İADE ETME BİLDİRİMİ................................................................................................................. 70
3.1.17 HEK / ZAYİAT BİLDİRİMİ ............................................................................................................................... 72
3.1.18 GERİ ÇEKME VERME BİLDİRİMİ ..................................................................................................................... 75
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.18.1 Geri Çekme Verme Bildirimi Servis Adresi ............................................................................................... 75
3.1.18.2 Geri Çekme Verme Bildirimi Veri Alanları ................................................................................................. 75
3.1.18.3 Geri Çekme Verme Bildirimi Örnek İstek .................................................................................................. 75
3.1.18.4 Eşsiz Kimlik Bilgisi İle Geri Çekme Verme Bildirimi Servis Adresi ............................................................ 76
3.1.18.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları ............................................................. 76
3.1.18.6 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Örnek İstek............................................................... 76
3.1.19.1 Geri Çekme Alma Bildirimi Servis Adresi .................................................................................................. 77
3.1.19.2 Geri Çekme Alma Bildirimi Veri Alanları ................................................................................................... 77
3.1.19.3 Geri Çekme Alma Bildirimi Örnek İstek .................................................................................................... 78
3.1.19.4 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Servis Adresi .............................................................. 79
3.1.19.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları ................................................................ 79
3.1.19.3 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Örnek İstek ................................................................. 79
3.1.20.1 Islah / Düzeltici Faaliyet Bildirimi Servis Adresi ........................................................................................ 80
3.1.20.2 Islah / Düzeltici Faaliyet Bildirimi Veri Alanları .......................................................................................... 80
3.1.20.3 Islah / Düzeltici Faaliyet Bildirimi Örnek İstek ........................................................................................... 80
3.1.20.4 Eşsiz Kimlik Bilgisi İle Islah / Düzeltici Faaliyet Bildirimi Servis Adresi .................................................... 81
3.1.20.5 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları ...................................................... 81
3.1.20.6 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Örnek İstek........................................................ 81
3.1.21.1 İmha / Bertaraf Bildirimi Servis Adresi ...................................................................................................... 81
3.1.21.2 İmha / Bertaraf Bildirimi Veri Alanları ........................................................................................................ 82
3.1.21.3 İmha / Bertaraf Bildirimi Örnek İstek ......................................................................................................... 83
3.1.21.4 Eşsiz Kimlik Bilgisi İle İmha / Bertaraf Bildirimi Servis Adresi ................................................................... 83
3.1.21.5 Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları .................................................................... 83
3.1.21.6 Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Örnek İstek ...................................................................... 84
3.1.22.1 Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi ............................................................................ 85
3.1.22.2 Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları ............................................................................. 85
3.1.22.3 Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek .............................................................................. 87
3.1.22.4 Eşsiz Kimlik Bilgisi İle Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi ........................................ 88
3.1.22.5 Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları .......................................... 88
3.1.22.6 Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek ........................................... 90
3.1.23.1 Envanter Bildirimi Servis Adresi ................................................................................................................ 90
3.1.23.2 Envanter Bildirimi Veri Alanları ................................................................................................................. 90
3.1.23.3 Envanter Bildirimi Örnek İstek .................................................................................................................. 91
3.1.19 GERİ ÇEKME ALMA BİLDİRİMİ ....................................................................................................................... 77
3.1.20 ISLAH / DÜZELTİCİ FAALİYET BİLDİRİMİ .......................................................................................................... 80
3.1.21 İMHA / BERTARAF BİLDİRİMİ .......................................................................................................................... 81
3.1.22 HASTANIN VÜCUDUNDAN ÇIKARMA BİLDİRİMİ ................................................................................................ 85
3.1.23 ENVANTER BİLDİRİMİ ................................................................................................................................... 90
3.1.24 STOK BİLDİRİMİ ........................................................................................................................................... 91
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.24.1 Stok Bildirimi Servis Adresi ....................................................................................................................... 91
3.1.24.2 Stok Bildirimi Veri Alanları......................................................................................................................... 91
3.1.24.3 Stok Bildirimi Örnek İstek .......................................................................................................................... 92
3.1.25.1 Eczane Stok Bildirimi Servis Adresi .......................................................................................................... 93
3.1.25.2 Eczane Stok Bildirimi Veri Alanları ........................................................................................................... 93
3.1.25.3 Eczane Stok Bildirimi Örnek İstek ............................................................................................................. 93
3.1.26.1 Tüketim Bildirimi Servis Adresi ................................................................................................................. 94
3.1.26.2 Tüketim Bildirimi Veri Alanları ................................................................................................................... 94
3.1.26.3 Tüketim Bildirimi Örnek İstek .................................................................................................................... 95
3.2 İPTAL BİLDİRİMLERİ ............................................................................................................................... 95
3.2.1.1 İptal Bildirimi Veri Alanları ......................................................................................................................... 97
3.2.1.2 İptal Bildirimleri Örnek İstek ...................................................................................................................... 97
3.3 BİLDİRİM CEVABI .................................................................................................................................... 97
3.4 SORGULAMA SERVİSLERİ ..................................................................................................................... 98
3.4.1.1 Tekil Ürün Sorgula Servis Adresi .............................................................................................................. 98
3.4.1.2 Tekil Ürün Sorgula İstek Veri Alanları ....................................................................................................... 98
3.4.1.3 Tekil Ürün Sorgula Cevap Veri Alanları .................................................................................................... 99
3.4.1.4 Tekil Ürün Sorgula Örnek İstek ............................................................................................................... 101
3.4.1.5 Eşsiz Kimlik Bilgisi ile Tekil Ürün Sorgula Servis Adresi ........................................................................ 101
3.4.1.6 Eşsiz Kimlik İle Tekil Ürün Sorgula İstek Veri Alanları ............................................................................ 101
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.4.2.2 Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları ............................................................................ 102
3.4.2.3 Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları ......................................................................... 102
3.4.2.4 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek ...................................................................................... 104
3.4.3.1 Üretici/İthalatçı Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ................................... 104
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) ......................... 105
3.4.3.4 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ........................... 107
3.4.3.5 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) ..................................... 107
3.4.4.1 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Servis Adresi ............................................ 108
3.1.25 ECZANE STOK BİLDİRİMİ .............................................................................................................................. 93
3.1.26 TÜKETİM BİLDİRİMİ ...................................................................................................................................... 94
3.2.1 İPTAL BİLDİRİMLERİ SERVİS ADRESLERİ ........................................................................................................ 95
3.3.1 BİLDİRİM CEVABI VERİ ALANLARI .................................................................................................................. 98
3.4.1 TEKİL ÜRÜN SORGULA ................................................................................................................................. 98
3.4.2 ÜRETİCİ/İTHALATÇI TEKİL ÜRÜN SORGULA .................................................................................................. 102
3.4.3 ÜRETİCİ/İTHALATÇI TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) ................................................ 104
3.4.4 ÜRETİCİ/İTHALATÇI SİSTEMİN DIŞINA ÇIKMIŞ TEKİL ÜRÜN SORGULA ............................................................ 108
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.4.2 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları ..................................... 108
3.4.4.3 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları .................................. 108
3.4.4.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek ............................................... 112
3.4.5.1 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi
ile) 112
3.4.5.2 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi
ile) 112
3.4.5.3 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi
ile) 113
3.4.5.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT)
ile) 116
3.4.5.5 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF)
ile) 116
3.4.6.1 Askıdaki Tekil Ürün Sorgula Servis Adresi ............................................................................................. 117
3.4.6.2 Askıdaki Tekil Ürün Sorgula İstek Veri Alanları ...................................................................................... 117
3.4.6.3 Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları ................................................................................... 117
3.4.6.4 Askıdaki Tekil Ürün Sorgula Örnek İstek ................................................................................................ 119
3.4.7.1 Askıdaki Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ............................................. 119
3.4.7.2 Askıdaki Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ...................................... 120
3.4.7.3 Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ................................... 120
3.4.7.4 Askıdaki Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ..................................... 122
3.4.7.5 Askıdaki Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) ............................................... 122
3.4.8.1 Bildirim Sorgula Servis Adresi ................................................................................................................ 123
3.4.8.2 Bildirim Sorgula İstek Veri Alanları ......................................................................................................... 123
3.4.8.3 Bildirim Sorgula Cevap Veri Alanları ....................................................................................................... 124
3.4.8.4 Bildirim Sorgula Örnek İstek ................................................................................................................... 127
3.4.9.1 Bildirim Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ................................................................. 128
3.4.9.2 Bildirim Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile).......................................................... 128
3.4.9.3 Bildirim Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ....................................................... 128
3.4.9.4 Bildirim Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ......................................................... 133
3.4.9.5 Bildirim Sorgula Örnek İstek (Offset Parametresi (OFF) ile) .................................................................. 133
3.4.10.1 Kabul Edilecek Tekil Ürün Sorgula Servis Adresi ................................................................................... 133
3.4.10.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları ............................................................................ 133
3.4.5 ÜRETİCİ/İTHALATÇI SİSTEMİN DIŞINA ÇIKMIŞ TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .......... 112
3.4.6 ASKIDAKİ TEKİL ÜRÜN SORGULA ................................................................................................................ 117
3.4.7 ASKIDAKİ TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .............................................................. 119
3.4.8 BİLDİRİM SORGULA .................................................................................................................................... 123
3.4.9 BİLDİRİM SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .................................................................................. 128
3.4.10 KABUL EDİLECEK TEKİL ÜRÜN SORGULA .................................................................................................... 133
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.10.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları ......................................................................... 134
3.4.10.4 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek ...................................................................................... 136
3.4.11.1 Kabul Edilecek Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ................................... 136
3.4.11.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ............................ 136
3.4.11.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ......................... 137
3.4.11.4 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ........................... 139
3.4.11.5 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) ..................................... 140
3.4.11.6 Kabul Edilecek Tekil Ürün Sorgula Dış Barkod Örnek ........................................................................... 140
3.4.12.1 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Servis Adresi ................................................ 141
3.4.12.2 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları ......................................... 141
3.4.12.3 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları ...................................... 141
3.4.12.4 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Örnek İstek ve Cevap ................................... 143
3.4.13.1 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Servis Adresi ............................................................ 144
3.4.13.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları ..................................................... 144
3.4.13.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları .................................................. 145
3.4.13.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula ................................................................................... 147
3.4.14.1 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ............ 147
3.4.14.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ..... 147
3.4.14.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)... 148
3.4.14.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula (Kayıt Sayısı Parametresi (ADT) ile) ........................ 150
3.4.14.5 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) .............. 151
3.4.15.1 Tekil Ürünün Kaynağını Sorgula Servis Adresi....................................................................................... 151
3.4.15.2 Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları ............................................................................... 151
3.4.15.3 Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları ............................................................................. 151
3.4.15.4 Tekil Ürünün Kaynağını Sorgula Örnek İstek ......................................................................................... 152
3.4.16.1 Piyasaya Arz Bilgileri Sorgula Servis Adresi ........................................................................................... 152
3.4.16.2 Piyasaya Arz Bilgileri Sorgula İstek Veri Alanları.................................................................................... 152
3.4.16.3 Piyasaya Arz Bilgileri Sorgula Cevap Veri Alanları ................................................................................. 153
3.4.16.4 Piyasaya Arz Bilgileri Sorgula Örnek İstek ............................................................................................. 153
3.4.16.5 Piyasaya Arz Bilgileri Sorgula Örnek Cevap ........................................................................................... 153
3.4.17.1 Bildirim ve Tekil Ürün Detay Sorgula Servis Adresi ................................................................................ 154
3.4.17.2 Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları ......................................................................... 154
3.4.11 KABUL EDİLECEK TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .................................................. 136
3.4.12 TEKİL ÜRÜN BİLGİLERİ İLE KABUL EDİLECEK TEKİL ÜRÜN SORGULA ............................................................. 141
3.4.13 KABUL EDİLECEK GERİ ÇEKİLMİŞ TEKİL ÜRÜN SORGULA ............................................................................. 144
3.4.14 KABUL EDİLECEK GERİ ÇEKİLMİŞ TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) ........................... 147
3.4.15 TEKİL ÜRÜNÜN KAYNAĞINI SORGULA ......................................................................................................... 151
3.4.16 PİYASAYA ARZ BİLGİLERİ SORGULA ............................................................................................................ 152
3.4.17 BİLDİRİM VE TEKİL ÜRÜN DETAY SORGULA ................................................................................................. 153
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.17.3 Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları ...................................................................... 154
3.4.17.4 Bildirim ve Tekil Ürün Detay Sorgula Örnek İstek................................................................................... 162
3.4.17.5 Bildirim ve Tekil Ürün Detay Sorgula Örnek Cevap ................................................................................ 162
3.4.18.1 Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula Servis Adresi ................................................................... 163
3.4.18.2 Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula İstek Veri Alanları ............................................................ 163
3.4.18.3 Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula Cevap Veri Alanları ......................................................... 163
3.4.18.4 Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula Örnek İstek ...................................................................... 165
3.4.18.5 Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula Örnek Cevap ................................................................... 165
3.4.19.1 Ayrıntılı Tekil Ürün Sorgulama Servis Adresleri...................................................................................... 168
3.4.19.2 Ayrıntılı Tekil Ürün Sorgulama İstek Veri Alanları .................................................................................. 168
3.4.19.3 Ayrıntılı Tekil Ürün Sorgulama Cevap Veri Alanları ................................................................................ 169
3.4.19.4 Ayrıntılı Tekil Ürün Sorgulama Örnek İstek ............................................................................................ 170
3.4.19.5 Ayrıntılı Tekil Ürün Sorgulama Örnek Cevap.......................................................................................... 170
3.4.20.1 Ayrıntılı Bildirim Sorgulama Servis Adresleri .......................................................................................... 171
3.4.20.2 Ayrıntılı Bildirim Sorgulama İstek Alanları ............................................................................................... 171
3.4.20.3 Ayrıntılı Bildirim Sorgulama Cevap Veri Alanları .................................................................................... 175
3.4.20.4 Ayrıntılı Bildirim Sorgulama Örnek İstek ................................................................................................. 180
3.4.20.5 Ayrıntılı Bildirim Sorgulama Örnek Cevap .............................................................................................. 180
3.4.21.1 Eksik Alma Bildirimlerini Görüntüle ......................................................................................................... 181
3.4.21.2 Eksik Alma Bildiriminin Görülme Durumunu Güncelle ............................................................................ 184
3.4.22.1 Almak İstemiyorum Olarak İşaretle Servis Adresleri .............................................................................. 185
3.4.22.2 Almak İstemiyorum Olarak İşaretle İstek Veri Alanları ........................................................................... 185
3.4.22.3 Almak İstemiyorum Olarak İşaretle Örnek İstek ..................................................................................... 186
3.4.23.1 Almak İstiyorum Olarak İşaretle Servis Adresleri.................................................................................... 186
3.4.23.2 Almak İstiyorum Olarak İşaretle İstek Veri Alanları ................................................................................ 186
3.4.23.3 Almak İstiyorum Olarak İşaretle Örnek İstek .......................................................................................... 186
3.4.24.1 Alınmak İstenmeyen Verme Bildirimlerimi Sorgula Servis Adresleri ...................................................... 186
3.4.24.2 Alınmak İstenmeyen Verme Bildirimlerimi Sorgula İstek Veri Alanları ................................................... 186
3.4.24.3 Alınmak İstenmeyen Verme Bildirimlerimi Sorgula Cevap Veri Alanları ................................................ 187
3.4.24.4 Alınmak İstenmeyen Verme Bildirimlerimi Sorgula Örnek İstek ............................................................. 188
3.4.24.5 Alınmak İstenmeyen Verme Bildirimlerimi Sorgula Örnek Cevap .......................................................... 188
3.4.18 STOK YAPILABİLİR TEKİL ÜRÜN BİLGİLERİNİ SORGULAMA ............................................................................ 163
3.4.19 AYRINTILI TEKİL ÜRÜN SORGULAMA ........................................................................................................... 168
3.4.20 AYRINTILI BİLDİRİM SORGULAMA ................................................................................................................ 171
3.4.21 EKSİK ALMA BİLDİRİMİ ............................................................................................................................... 181
3.4.22 KURUMA GELEN VERME BİLDİRİMİNİ ALMAK İSTEMİYORUM OLARAK İŞARETLE .............................................. 185
3.4.23 ALMAK İSTEMİYORUM OLARAK İŞARETLENEN BİLDİRİMLERİ ALMAK İSTİYORUM OLARAK İŞARETLE .................. 186
3.4.24 ALINMAK İSTENMEYEN VERME BİLDİRİMLERİMİ SORGULA ............................................................................. 186
3.4.25 ALMAK İSTEMEDİĞİM VERME BİLDİRİMLERİNİ SORGULA ................................................................................ 189
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.25.1 Almak İstemediğim Verme Bildirimlerini Sorgula Servis Adresleri.......................................................... 189
3.4.25.2 Almak İstemediğim Verme Bildirimlerini Sorgula İstek Veri Alanları ...................................................... 189
3.4.25.3 Almak İstemediğim Verme Bildirimlerini Sorgula Cevap Veri Alanları .................................................... 190
3.4.25.4 Almak İstemediğim Verme Bildirimlerini Sorgula Örnek İstek ................................................................ 191
3.4.25.5 Almak İstemediğim Verme Bildirimlerini Sorgula Örnek Cevap.............................................................. 191
3.5 PAKET TRANSFER SİSTEMİ (PTS) SERVİSLERİ ................................................................................ 192
3.5.1.1 Paket Ekle Servis Adresi ......................................................................................................................... 192
3.5.1.2 Paket Ekle İstek Veri Alanları.................................................................................................................. 192
3.5.1.3 Paket Ekle Cevap Veri Alanları ............................................................................................................... 193
3.5.1.4 Paket Ekle Örnek İstek ........................................................................................................................... 194
3.5.2.1 Paket Sil Servis Adresi ............................................................................................................................ 195
3.5.2.2 Paket Sil İstek Veri Alanları..................................................................................................................... 195
3.5.2.3 Paket Sil Cevap Veri Alanları .................................................................................................................. 195
3.5.2.4 Paket Sil Örnek İstek .............................................................................................................................. 196
3.5.3.1 Paket Getir Servis Adresi ........................................................................................................................ 196
3.5.3.2 Paket Getir İstek Veri Alanları ................................................................................................................. 196
3.5.3.3 Paket Getir Cevap Veri Alanları .............................................................................................................. 196
3.5.3.4 Paket Getir Örnek İstek ........................................................................................................................... 198
3.5.4.1 Kuruma Gelen Paketi Okundu İşaretle Servis Adresi ............................................................................. 198
3.5.4.2 Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları ...................................................................... 198
3.5.4.3 Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları ................................................................... 198
3.5.4.4 Kuruma Gelen Paketi Okundu İşaretle Örnek İstek ................................................................................ 199
3.5.5.1 Kuruma Gelen Paketi Getir Servis Adresi ............................................................................................... 199
3.5.5.2 Kuruma Gelen Paketi Getir İstek Veri Alanları........................................................................................ 199
3.5.5.3 Kuruma Gelen Paketi Getir Cevap Veri Alanları ..................................................................................... 200
3.5.5.4 Kuruma Gelen Paketi Getir Örnek İstek ................................................................................................. 201
3.5.6.1 Kuruma Gelen Paketleri Sorgula Servis Adresi ...................................................................................... 201
3.5.6.2 Kuruma Gelen Paketleri Sorgula İstek Veri Alanları ............................................................................... 201
3.5.6.3 Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları ............................................................................ 202
3.5.6.4 Kuruma Gelen Paketleri Sorgula Örnek İstek ......................................................................................... 203
3.6 FİRMA SORGULAMA SERVİSİ .............................................................................................................. 203
3.5.1 PAKET EKLE .............................................................................................................................................. 192
3.5.2 PAKET SİL ................................................................................................................................................. 195
3.5.3 PAKET GETİR ............................................................................................................................................ 196
3.5.4 KURUMA GELEN PAKETİ OKUNDU İŞARETLE................................................................................................ 198
3.5.5 KURUMA GELEN PAKETİ GETİR .................................................................................................................. 199
3.5.6 KURUMA GELEN PAKETLERİ SORGULA ....................................................................................................... 201
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.7 ÜRÜN SORGULAMA SERVİSİ .............................................................................................................. 205
3.8 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİSİ ......................................................................................... 210
4 EKLER .................................................................................................................................................... 214
4.1 EK-A SERVİS MESAJLARI .................................................................................................................... 214
3.6.1 FİRMA SORGULAMA SERVİS ADRESİ ........................................................................................................... 204
3.6.2 FİRMA SORGULAMA SERVİSİ VERİ ALANLARI ............................................................................................... 204
3.6.3 FİRMA SORGULAMA SERVİSİ ÖRNEK İSTEK ................................................................................................. 205
3.7.1 ÜRÜN SORGULAMA SERVİS ADRESİ ............................................................................................................ 205
3.7.2 ÜRÜN SORGULAMA SERVİSİ VERİ ALANLARI ............................................................................................... 206
3.7.3 ÜRÜN SORGULAMA SERVİSİ ÖRNEK İSTEK .................................................................................................. 209
3.8.1 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİS ADRESİ .......................................................................................... 210
3.8.2 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİSİ VERİ ALANLARI .............................................................................. 211
3.8.3 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİSİ ÖRNEK İSTEK ................................................................................ 212
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
TABLOLAR
Tablo 1. Üretim Bildirimi Veri Alanları ...................................................................................................................... 23
Tablo 2. İthalat Bildirimi Veri Alanları....................................................................................................................... 26
Tablo 3. Yetkili Bayi ile İthalat Bildirimi Veri Alanları ............................................................................................... 29
Tablo 4. Verme Bildirimi Veri Alanları ...................................................................................................................... 32
Tablo 5. Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları .................................................................................. 33
Tablo 6. Kozmetik Firmaya Verme Bildirimi Veri Alanları ........................................................................................ 35
Tablo 7. Alma Bildirimi Veri Alanları ........................................................................................................................ 36
Tablo 8. Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları ..................................................................................... 39
Tablo 9 . ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ............................................................................... 40
Tablo 10. Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ........................................... 41
Tablo 11 .ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları .................................................................... 43
Tablo 12. Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları ................................. 45
Tablo 13.Kullanım Bildirimi Veri Alanları ................................................................................................................. 46
Tablo 14. Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları ............................................................................. 48
Tablo 15 .Tüketiciye Verme Bildirimi Veri Alanları .................................................................................................. 51
Tablo 16. Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Veri Alanları ............................................................... 53
Tablo 17 .Tüketiciden İade Alma Bildirimi Veri Alanları........................................................................................... 56
Tablo 18. Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları ....................................................... 58
Tablo 19 . Geçici Kullanıma Verme Bildirimi Veri Alanları ...................................................................................... 59
Tablo 20. Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları .................................................... 62
Tablo 21 . Kullanımdan Alma Bildirimi Veri Alanları ................................................................................................ 64
Tablo 22 . Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları............................................................. 66
Tablo 23. Yeniden İşleme Bildirimi Veri Alanları ..................................................................................................... 66
Tablo 24. Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları .................................................................. 67
Tablo 25 . İhracat Bildirimi Veri Alanları .................................................................................................................. 68
Tablo 26. Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları ................................................................................ 69
Tablo 27 . Mahrecine İade Etme Bildirimi Veri Alanları ........................................................................................... 71
Tablo 28. Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları ........................................................ 71
Tablo 29. HEK / Zayiat Bildirimi Veri Alanları .......................................................................................................... 72
Tablo 30. Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları ....................................................................... 74
Tablo 31. Geri Çekme Verme Bildirimi Veri Alanları ............................................................................................... 75
Tablo 32. Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları ............................................................ 76
Tablo 33. Geri Çekme Alma Bildirimi Veri Alanları .................................................................................................. 77
Tablo 34. Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları .............................................................. 79
Tablo 35 .Islah / Düzeltici Faaliyet Bildirimi Veri Alanları ........................................................................................ 80
Tablo 36. Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları ..................................................... 81
Tablo 37 . İmha / Bertaraf Bildirimi Veri Alanları ..................................................................................................... 82
Tablo 38. Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları ................................................................... 83
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Tablo 39 . Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları ........................................................................... 85
Tablo 40. Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları ........................................ 88
Tablo 41. Envanter Bildirimi Veri Alanları ................................................................................................................ 90
Tablo 42. Stok Bildirimi Veri Alanları ....................................................................................................................... 91
Tablo 43. Eczane Stok Bildirimi Veri Alanları .......................................................................................................... 93
Tablo 44. Tüketim Bildirimi Veri Alanları ................................................................................................................. 94
Tablo 45. İptal Bildirimleri Servis Adresleri .............................................................................................................. 95
Tablo 46. İptal Bildirimi Veri Alanları........................................................................................................................ 97
Tablo 47. Bildirim Cevabı Veri Alanları .................................................................................................................... 98
Tablo 48. Tekil Ürün Sorgula İstek Veri Alanları ..................................................................................................... 98
Tablo 49. Tekil Ürün Sorgula Cevap Veri Alanları ................................................................................................... 99
Tablo 50. Eşsiz Kimlik ile Tekil Ürün Sorgula İstek Veri Alanları .......................................................................... 101
Tablo 51. Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları .......................................................................... 102
Tablo 52. Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları ........................................................................ 102
Tablo 53. Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) .......................... 105
Tablo 54. Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ........................ 105
Tablo 55. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları .................................... 108
Tablo 56. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları ................................. 108
Tablo 57. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi
ile) .......................................................................................................................................................................... 112
Tablo 58. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi
ile) .......................................................................................................................................................................... 113
Tablo 59. Askıdaki Tekil Ürün Sorgula İstek Veri Alanları ..................................................................................... 117
Tablo 60. Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları .................................................................................. 117
Tablo 61. Askıdaki Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ..................................... 120
Tablo 62. Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) .................................. 120
Tablo 63. Bildirim Sorgula İstek Veri Alanları ........................................................................................................ 123
Tablo 64. Bildirim Sorgula Cevap Veri Alanları ..................................................................................................... 124
Tablo 65. Bildirim Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ........................................................ 128
Tablo 66. Bildirim Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ..................................................... 128
Tablo 67. Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları .......................................................................... 133
Tablo 68. Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları ........................................................................ 134
Tablo 69. Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) .......................... 136
Tablo 70. Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ........................ 137
Tablo 71. Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları ........................................ 141
Tablo 72. Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları .................................... 141
Tablo 73. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları .................................................... 144
Tablo 74. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları ................................................. 145
Tablo 75. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) .... 147
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Tablo 76. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) . 148
Tablo 77. Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları .............................................................................. 151
Tablo 78. Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları ........................................................................... 151
Tablo 79. Piyasaya Arz Bilgileri Sorgula İstek Veri Alanları .................................................................................. 152
Tablo 80. Piyasaya Arz Bilgileri Sorgula Cevap Veri Alanları ............................................................................... 153
Tablo 81. Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları ....................................................................... 154
Tablo 82. Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları .................................................................... 154
Tablo 83. Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula İstek Veri Alanları ........................................................... 163
Tablo 84. Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula Cevap Veri Alanları ........................................................ 163
Tablo 85. Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula Cevap Veri Alanları ........................................................ 166
Tablo 86. Ayrıntılı Tekil Ürün Sorgula İstek Veri Alanları ...................................................................................... 168
Tablo 87. Ayrıntılı Tekil Ürün Sorgulama Cevap Alanları ...................................................................................... 169
Tablo 88. Ayrıntılı Bildirim Sorgulama İstek Alanları ............................................................................................. 171
Tablo 89. Ayrıntılı Bildirim Sorgulama Cevap Veri Alanları ................................................................................... 175
Tablo 90. Eksik Alma Bildirimlerini Görüntüle İstek Veri Alanları .......................................................................... 181
Tablo 91. Eksik Alma Bildirimi Sorgula Cevap Veri Alanları ................................................................................. 182
Tablo 92. Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Veri Alanları .................................................. 184
Tablo 93. Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Cevap Veri Alanları ...................................... 184
Tablo 94. Almak İstemiyorum Olarak İşaretle İstek Veri Alanları .......................................................................... 185
Tablo 95. Almak İstiyorum Olarak İşaretle İstek Veri Alanları ............................................................................... 186
Tablo 96. Alınmak İstenmeyen Verme Bildirimlerimi Sorgula İstek Veri Alanları .................................................. 186
Tablo 97. Alınmak İstenmeyen Verme Bildirimlerimi Sorgula Cevap Veri Alanları ............................................... 187
Tablo 98. Almak İstemediğim Verme Bildirimlerini Sorgula İstek Veri Alanları ..................................................... 189
Tablo 99. Almak İstemediğim Verme Bildirimlerini Sorgula Cevap Veri Alanları .................................................. 190
Tablo 100. Paket Ekle İstek Veri Alanları .............................................................................................................. 192
Tablo 101. Paket Ekle Cevap Veri Alanları ........................................................................................................... 193
Tablo 102. Paket Sil İstek Veri Alanları ................................................................................................................. 195
Tablo 103. Paket Sil Cevap Veri Alanları .............................................................................................................. 195
Tablo 104. Paket Getir İstek Veri Alanları ............................................................................................................. 196
Tablo 105. Paket Getir Cevap Veri Alanları .......................................................................................................... 196
Tablo 106. Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları .................................................................. 198
Tablo 107. Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları ................................................................ 198
Tablo 108. Kuruma Gelen Paketi Getir İstek Veri Alanları .................................................................................... 199
Tablo 109. Kuruma Gelen Paketi Getir Cevap Veri Alanları ................................................................................ 200
Tablo 110. Kuruma Gelen Paketleri Sorgula İstek Veri Alanları ........................................................................... 201
Tablo 111. Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları ......................................................................... 202
Tablo 112. Firma Sorgulama Servisi İstek Veri Alanları ........................................................................................ 204
Tablo 113. Firma Sorgulama Servisi Sonuç Veri Alanları ..................................................................................... 204
Tablo 114. Ürün Sorgulama Servisi İstek Veri Alanları ......................................................................................... 206
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Tablo 115. Ürün Sorgulama Servisi Sonuç Veri Alanları....................................................................................... 206
Tablo 116. Ürün Sorgulama Servisi Ürün Sonuç Veri Alanları .............................................................................. 206
Tablo 117. Bütün Ürünleri Sorgulama Servisi İstek Veri Alanları .......................................................................... 211
Tablo 118. Bütün Ürünleri Sorgulama Servisi Sonuç Veri Alanları ....................................................................... 211
Tablo 119. Bütün Ürünleri Sorgulama Servisi Ürün Sonuç Veri Alanları .............................................................. 211
Tablo 120. Servis Mesajları ................................................................................................................................... 214
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 / 231 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
YTE Yazılım Teknolojileri Araştırma Enstitüsü
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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
22 / 231 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.
Üretim Bildirimi Sırasında Girilen
Seri/Lot Bilgisi Takip Durumu Adet Bilgisi
Sadece seri numarası verilirse Seri numarası ile tekil olarak takip
edilir. Adet = 1
Seri numarası + Lot Numarası birlikte
verilirse
Seri ve lot numarası ile tekil
olarak takip edilir. Adet = 1
Sadece lot numarası verilirse Lot numarası ile lot olarak takip
edilir. Adet >=1
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
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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.
Ü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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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
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:
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
{
"UNO" : "9321502013475",
"SNO" : "112212345678MM9",
"UDI" : "019321502013475111603021719030221112212345678MM9",
"ADT" : 1,
"URT" : "2016-03-02",
"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.
İthalat Bildirimi Sırasında Girilen
Seri/Lot Bilgisi Takip Durumu Adet Bilgisi
Sadece seri numarası verilirse Seri numarası ile tekil olarak takip
edilir. Adet = 1
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
İthalat Bildirimi Sırasında Girilen
Seri/Lot Bilgisi Takip Durumu Adet Bilgisi
Seri numarası + Lot Numarası birlikte
verilirse
Seri ve lot numarası ile tekil
olarak takip edilir. Adet = 1
Sadece lot numarası verilirse Lot numarası ile lot olarak takip
edilir. Adet >=1
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.
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
İ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. *
Menşei Ülke MEU Sayı 3 Evet Ülke kodudur. *
Gümrük
Beyanname
Numarası
GBN Metin 16 Hayır -
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
28 / 231 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
* 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",
"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"
}
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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"
}
Ö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 Yetkili Bayi İle İthalat Bildirimi
İthalatçı tarafından yetki verilen bayi ithalat bildirimi yapabilmektedir. Bunun için bayinin ithalat yapmak istediği
ürüne ait ithalatçı tarafından girilmiş olan yetkili distribütörlük belgesi olmalıdır.
3.1.3.1 Yetkili Bayi İle İthalat Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ithalat/yetkiliBayiIle/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ithalat/yetkiliBayiIle/ekle
3.1.3.2 Yetkili Bayi İle İthalat Bildirimi Veri Alanları
Tablo 3. Yetkili Bayi ile İthalat 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
30 / 231 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
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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. *
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
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.3.3 Yetkili Bayi İle İthalat Bildirimi Örnek İstek
{
"UIK": "10",
"UNO" : "00716795401099",
"LNO" : "21",
"ADT" : 10,
"URT" : "2019-08-08",
"IEU" : "400",
"MEU" : "400"
}
3.1.4 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.4.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
3.1.4.2 Verme Bildirimi Veri Alanları
Tablo 4. 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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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.4.3 Verme Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 25,
"KUN" : 7,
"BEN" : "HAYIR",
"BNO" : "123B",
"GIT" : "2018-10-31"
}
3.1.4.4 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.4.5 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları
Tablo 5. Eşsiz Kimlik Bilgisi ile 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
34 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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.
3.1.4.6 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"KUN" : 7,
"ADT" : 5,
"BNO": "123"
}
3.1.5 Kozmetik Firmaya Verme Bildirimi
Kurum/firma kullanıcısı sahip olduğu tekil ürünlerini ÜTS’de kayıtlı kozmetik bir kurum/firmaya verdiğinde Kozmetik
Firmaya Verme 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
35 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.5.1 Kozmetik Firmaya Verme Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kozmetikFirmayaVerme/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kozmetikFirmayaVerme /ekle
3.1.5.2 Kozmetik Firmaya Verme Bildirimi Veri Alanları
Tablo 6. Kozmetik Firmaya 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.
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.5.3 Kozmetik Firmaya Verme Bildirimi Örnek İstek
{
"UNO" : " 8691685000717",
"LNO" : "Lot1",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"ADT" : 25,
"KUN" : 17,
"BNO" : "123B",
"GIT" : "2018-10-31"
}
3.1.6 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.6.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.6.2 Alma Bildirimi Veri Alanları
Tablo 7. 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.
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.
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 / 231 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
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.6.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",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"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,
"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",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"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.6.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.6.5 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları
Tablo 8. 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.
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
40 / 231 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.6.6 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"ADT" : 5,
"GKK" : 10
}
3.1.7 Ü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.7.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.7.2 ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları
Tablo 9 . ÜTS’de Tanımsız Yere 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.
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 / 231 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 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.7.3 ÜTS’de Tanımsız Yere Verme Bildirimi Örnek İstek
{
"UNO" : "1111111110058",
"LNO" : "250515186001",
"ADT" : 25,
"VKN" : "1234567890",
"BNO" : "123B",
"BEN" : "HAYIR"
}
3.1.7.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.7.5 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları
Tablo 10. Eşsiz Kimlik Bilgisi ile Ü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
42 / 231 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 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.
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.
3.1.7.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.8 Ü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.8.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.8.2 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları
Tablo 11 .ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları
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.
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 / 231 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 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.
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.8.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:
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
{
"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.8.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.8.5 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları
Tablo 12. Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İ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.
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.8.6 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"ADT" : 5
}
3.1.9 Kullanım Bildirimi
Sağlık kuruluşu/uygulama tesisi tekil ürünü hasta/tüketiciye kullandığında Kullanım Bildirimi yapar.
3.1.9.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.9.2 Kullanım Bildirimi Veri Alanları
Tablo 13.Kullanım 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 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)
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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.
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
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Yeni Doğan Mı? YDM Metin 5 Koşullu
Bildirimin yapılacağı kişinin yeni doğan
olup olmadığını ifade etmektedir. Bu
alan aşağıda gördüğünüz iki farklı
değeri alabilir, eğer herhangi biri
gönderilmezse “HAYIR” olarak
doldurulduğu varsayılır.
- “EVET”
- “HAYIR”
3.1.9.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”
}
3.1.9.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.9.5 Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları
Tablo 14. 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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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.
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)
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 / 231 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
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
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.
Yeni Doğan Mı? YDM Metin 5 Koşullu
Bildirimin yapılacağı kişinin yeni doğan
olup olmadığını ifade etmektedir. Bu
alan aşağıda gördüğünüz iki farklı
değeri alabilir, eğer herhangi biri
gönderilmezse “HAYIR” olarak
doldurulduğu varsayılır.
EVET
HAYIR
3.1.9.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
51 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.10 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.10.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.10.2 Tüketiciye Verme Bildirimi Veri Alanları
Tablo 15 .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.
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
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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)
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
KIMLIGI_BELIRSIZ
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
53 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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.
Yeni Doğan Mı YDM Metin 5 Koşullu
Bildirimin yapılacağı kişinin yeni doğan
olup olmadığını ifade etmektedir. Bu
alan aşağıda gördüğünüz iki farklı
değeri alabilir, eğer herhangi biri
gönderilmezse “HAYIR” olarak
doldurulduğu varsayılır.
EVET
HAYIR
3.1.10.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.10.4 Eşsiz Kimlik Bilgisi İle Tüketiciye Verme 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.10.5 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Veri Alanları
Tablo 16. Eşsiz Kimlik Bilgisi ile Tüketiciye 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 / 231 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 ü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)
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.
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 / 231 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
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
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.
Yeni Doğan Mı YDM Metin 5 Koşullu
Bildirimin yapılacağı kişinin yeni doğan
olup olmadığını ifade etmektedir. Bu
alan aşağıda gördüğünüz iki farklı
değeri alabilir, eğer herhangi biri
gönderilmezse “HAYIR” olarak
doldurulduğu varsayılır.
EVET
HAYIR
3.1.10.6 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme 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
56 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"GIT" : "2017-11-20",
"BEN" : "HAYIR",
"TKN" : "11223344678",
"TUA" : "Ali",
"TUS" : "Yılmaz",
“TUR” : “TC_KIMLIK_NUMARASI_VAR”
}
3.1.11 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.11.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.11.2 Tüketiciden İade Alma Bildirimi Veri Alanları
Tablo 17 .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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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.
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.11.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",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"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:
{
"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.11.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.11.5 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları
Tablo 18. 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
59 / 231 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.11.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.12 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.12.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.12.2 Geçici Kullanıma Verme Bildirimi Veri Alanları
Tablo 19 . 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
60 / 231 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
61 / 231 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
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.
Yeni Doğan Mı YDM Metin 5 Koşullu
Bildirimin yapılacağı kişinin yeni doğan
olup olmadığını ifade etmektedir. Bu
alan aşağıda gördüğünüz iki farklı
değeri alabilir, eğer herhangi biri
gönderilmezse “HAYIR” olarak
doldurulduğu varsayılır.
EVET
HAYIR
3.1.12.3 Geçici Kullanıma Verme Bildirimi Örnek İstek
{
"UNO" : "1111111110324",
"LNO" : "250515186001",
"ADT" : 25,
"GIT" : "2017-11-22",
"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
62 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"TUS" : "Yılmaz",
“TUR” : “TC_KIMLIK_NUMARASI_VAR”
}
3.1.12.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
3.1.12.5 Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları
Tablo 20. 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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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.
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
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.
Yeni Doğan Mı YDM Metin 5 Koşullu
Bildirimin yapılacağı kişinin yeni doğan
olup olmadığını ifade etmektedir. Bu
alan aşağıda gördüğünüz iki farklı
değeri alabilir, eğer herhangi biri
gönderilmezse “HAYIR” olarak
doldurulduğu varsayılır.
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
64 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.12.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.13 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.
3.1.13.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.13.2 Kullanımdan Alma Bildirimi Veri Alanları
Tablo 21 . 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.
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 / 231 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
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.13.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
}
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.13.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.13.5 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları
Tablo 22 . Eşsiz Kimlik Bilgisi ile Kullanımdan 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.
3.1.13.6 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 5
}
3.1.14 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.14.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.14.2 Yeniden İşleme Bildirimi Veri Alanları
Tablo 23. 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
67 / 231 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.14.3 Yeniden İşleme Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 25
}
3.1.14.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.14.5 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları
Tablo 24. 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
68 / 231 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.14.6 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 25
}
3.1.15 İhracat Bildirimi
İhracatçı, ihraç ettiği tekil ürünler için İhracat Bildirimi yapar.
3.1.15.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.15.2 İhracat Bildirimi Veri Alanları
Tablo 25 . İ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
69 / 231 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.15.3 İhracat Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 25,
"GBN" : "15343100IM003176",
"BEN" : "HAYIR"
}
3.1.15.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.15.5 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları
Tablo 26. 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
70 / 231 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.15.6 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 25,
"GBN" : "15343100IM003176",
"BEN" : "HAYIR"
}
3.1.16 Mahrecine İade Etme Bildirimi
İthalatçı, ithal ettiği tekil ürünü iade ettiğinde Mahrecine İade Bildirimi yapar.
3.1.16.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
71 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.16.2 Mahrecine İade Etme Bildirimi Veri Alanları
Tablo 27 . 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.16.3 Mahrecine İade Etme Bildirimi Örnek İstek
{
"UNO" : "1111111110058",
"LNO" : "250515186001",
"ADT" : 25,
"GBN" : "15343100IM003176"
}
3.1.16.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.16.5 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları
Tablo 28. 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
72 / 231 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.16.6 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Örnek İstek
{
"UDI" : "0151022222233336111603021719030210A213B1211234",
"ADT" : 25,
"GBN" : "15343100IM003176"
}
3.1.17 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.17.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.17.2 HEK / Zayiat Bildirimi Veri Alanları
Tablo 29. 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
73 / 231 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
STOK_DUZELTME: Stok
Düzeltme
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.17.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
74 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.17.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.17.5 Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları
Tablo 30. 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
STOK_DUZELTME: Stok
Düzeltme
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.17.6 Eşsiz Kimlik Bilgisi ile HEK / Zayiat 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
75 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"TUR" : "DOGAL_AFET"
}
3.1.18 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.18.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.18.2 Geri Çekme Verme Bildirimi Veri Alanları
Tablo 31. 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.18.3 Geri Çekme Verme Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"LNO" : "250515186001",
"ADT" : 25,
"KUN" : 7,
"BNO" : "123B"
}
3.1.18.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.18.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları
Tablo 32. 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.18.6 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"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
77 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
}
3.1.19 Geri Çekme Alma Bildirimi
Kurum/firma, geri çekme kapsamında kendisine verilen tekil ürünleri kabul etmek için Geri Çekme Alma Bildirimi
yapar.
3.1.19.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.19.2 Geri Çekme Alma Bildirimi Veri Alanları
Tablo 33. 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
78 / 231 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.19.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
79 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.19.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.19.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları
Tablo 34. 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.19.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
80 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.20 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.20.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.20.2 Islah / Düzeltici Faaliyet Bildirimi Veri Alanları
Tablo 35 .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.20.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
81 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
“UDI” : “0151022222233336111603021719030210A213B1211234”
}
3.1.20.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.20.5 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları
Tablo 36. 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.20.6 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Örnek İstek
{
“UDI” : “0151022222233336111603021719030210A213B1211234”,
"ADT" : 25
}
3.1.21 İmha / Bertaraf Bildirimi
Kurum/firma, tekil ürünleri herhangi bir gerekçeyle imha ettiğinde İmha / Bertaraf Bildirimi yapar.
3.1.21.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
82 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.21.2 İmha / Bertaraf Bildirimi Veri Alanları
Tablo 37 . İ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
83 / 231 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.21.3 İmha / Bertaraf Bildirimi Örnek İstek
{
"UNO" : "2451643000007",
"LNO" : "250515186001",
"ADT" : 25,
"GRK" : "TASIMA_VE_SAKLAMA_KOSULLARI_BOZULMUS",
"BNO" : "123B"
}
3.1.21.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.21.5 Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları
Tablo 38. 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
84 / 231 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.21.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
85 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"GRK" : "TASIMA_VE_SAKLAMA_KOSULLARI_BOZULMUS",
"BNO" : "123B"
}
3.1.22 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.22.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.22.2 Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları
Tablo 39 . 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
86 / 231 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
87 / 231 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
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.
Yeni Doğan Mı YDM Metin 5 Koşullu
Bildirimin yapılacağı kişinin yeni doğan
olup olmadığını ifade etmektedir. Bu
alan aşağıda gördüğünüz iki farklı
değeri alabilir, eğer herhangi biri
gönderilmezse “HAYIR” olarak
doldurulduğu varsayılır.
- “EVET”
- “HAYIR”
3.1.22.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”
}
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.1.22.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.22.5 Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları
Tablo 40. Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma 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.
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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.
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
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
Yeni Doğan Mı YDM Metin 5 Koşullu
Bildirimin yapılacağı kişinin yeni doğan
olup olmadığını ifade etmektedir. Bu
alan aşağıda gördüğünüz iki farklı
değeri alabilir, eğer herhangi biri
gönderilmezse “HAYIR” olarak
doldurulduğu varsayılır.
EVET
HAYIR
3.1.22.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”
}
3.1.23 Envanter Bildirimi
Sağlık hizmet sunucuları, envantere almak istediği ürünler için bir Envanter Bildirimi yapar.
3.1.23.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.23.2 Envanter Bildirimi Veri Alanları
Tablo 41. 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.
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 / 231 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 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.
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.23.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.24 Stok Bildirimi
Sağlık hizmet sunucuları dışındaki kurumlar, stok yapmak istediği ürünler için Stok Bildirimi yapar.
3.1.24.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.24.2 Stok Bildirimi Veri Alanları
Tablo 42. 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
92 / 231 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.24.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",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"UNO" : "9321502013475",
“SNO” : “4356”,
"URT" : "2018-11-05",
"SKT" : "2018-12-05"
}
3.1.25 Eczane Stok Bildirimi
Eczaneler, stok bildirmek istediği tekil ürünler için Eczane Stok Bildirimi yapar. Eczane sadece İnsülin Kalem İğne
Ucu ve Şeker Ölçüm Çubuğu branş türündeki ürünler için stok bildirimi yapabilir.
3.1.25.1 Eczane Stok Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/eczane/stok/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/eczane/stok/ekle
3.1.25.2 Eczane Stok Bildirimi Veri Alanları
Tablo 43. Eczane Stok 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.
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.
3.1.25.3 Eczane Stok Bildirimi Örnek İstek
Örnek 1 lot ürün:
{
"UIK" : "1050",
"UNO" : "792461048126",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
“LNO” : “4356”,
“ADT”: 100
}
Örnek 2 tekil takip ürün:
{
"UIK" : "10505",
"UNO" : "792461048126",
“SNO” : “4356”
}
3.1.26 Tüketim Bildirimi
Sağlık Hizmet Sunucuları, belirli şartlara uyan tekil ürünler için tüketim bildirimi yapabilir. Tüketim bildirimi
yapılabilen tekil ürünler vücuda implante edilebilir olmamalıdır, SUT eşleşmesi olmamalıdır, sınırsız kullanımlık
olmamalıdır, tek bir hastaya kullanılabilir olmamalıdır. Bu şartları sağlayan ürünlerin tekil ürünleri tüketim bildirimi
yapılabilmektedir.
3.1.26.1 Tüketim Bildirimi Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketim/ekle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketim/ekle
3.1.26.2 Tüketim Bildirimi Veri Alanları
Tablo 44. Tüketim 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 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.
Gerçek İşlem
Tarihi GIT Tarih 10 Hayır
YYYY-AA-GG formatındadır. Y: Yıl, A:
Ay, G: Gün. Tarih belirtilmediğinde
otomatik olarak bildirimin yapıldığı tarih
alını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
95 / 231 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.
3.1.26.3 Tüketim Bildirimi Örnek İstek
Örnek 1 lot ürün:
{
"UNO" : "792461048126",
“LNO” : “4356”,
“ADT”: 100
}
Örnek 2 tekil takip ürün:
{
"UNO" : "792461048126",
“SNO” : “4356”
}
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 45. İ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
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
İptal Bildirim Adı Servis Adresi
Kozmetik Firmaya Verme İptal Bildirimi
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kozmetikFirmayaVerme/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kozmetikFirmayaVerme/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
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
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
İptal Bildirim Adı Servis Adresi
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
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
Tüketim İptal Bildirimi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketim/iptal
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketim/iptal
3.2.1.1 İptal Bildirimi Veri Alanları
Tablo 46. İ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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.3.1 Bildirim Cevabı Veri Alanları
Tablo 47. 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.
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 48. Tekil Ürü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
99 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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.
3.4.1.3 Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 49. 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ı -
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Ü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 - 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.
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 / 231 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.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 50. 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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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
3.4.2.2 Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları
Tablo 48. ‘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 51. Ü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 52. Üretici/İthalatçı 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
103 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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
Ürün Numarası SNC.
UNO Metin 23 Tekil ürünün, ürün numarası/barkod numarasıdır.
Lot/Batch
Numarası
SNC.
LNO Metin 20 Tekil ürünün, ürün numarası/barkod numarasıdır.
Seri/Sıra
Numarası
SNC.
SNO Metin 20 Tekil ürünün, ürün numarası/barkod numarasıdır.
Adet SNC.
ADT Sayı - Tekil ürünün adet bilgisidir.
Üretim Tarihi SNC.
URT Tarih 8 Tekil ürünün, üretim tarihidir.
Son Kullanma
Tarihi
SNC.
SKT Tarih 10 Tekil ürünün son kullanma tarihidir.
İthalat Tarihi SNC.
ITT Tarih 10 Tekil ürünün, ithalat tarihidir.
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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.
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
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.3.2 Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 53. Ü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.
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 54. Ü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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Lot/Batch
Numarası
LST.
LNO Metin 20
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.
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 / 231 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.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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
{
"UNO" : "1111111110027",
"SNO" : "250515186001",
"ADT" : 5,
“OFF”: “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”
}
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 55. Ü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 56. Ü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
109 / 231 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
110 / 231 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
111 / 231 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”
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.
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
112 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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 57. Ü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.
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
113 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.5.3 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı
Parametresi ile)
Tablo 58. Ü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.
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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”
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.
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.
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 / 231 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.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"
},
"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”
}
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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 59. 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.
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 56. ‘daki 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 60. Askıdaki 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
118 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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.
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.
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 / 231 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.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
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.7.2 Askıdaki Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 61. 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.
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 62. 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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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.
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.
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 / 231 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.7.4 Askıdaki Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)
{
"KUN" : 7,
"UNO" : "1111111110027",
"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",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"ADT" : 5, “OFF”: “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”
}
Tablo 59‘ daki istek veri alanlarından hiçbiri girdi olarak verilmezse, sorgulama sonucunda 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.
3.4.8 Bildirim Sorgula
Kurum/firmanın yapmış olduğu bildirimleri sorgular.
3.4.8.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.8.2 Bildirim Sorgula İstek Veri Alanları
Tablo 63. Bildirim 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 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 60. ‘daki 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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.8.3 Bildirim Sorgula Cevap Veri Alanları
Tablo 64. 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.
Ü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
125 / 231 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
126 / 231 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
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.
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.
Alınan Adet SNC.
AAD Sayı -
Verilen bir tekil ürünün kaç adedinin alındığı
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
127 / 231 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”
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.
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 Bildirim Sorgula Örnek İstek
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999",
"SAN" : 0 }
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.9 Bildirim Sorgula (Kayıt Sayısı Parametresi ile)
Kurum/firmanın yapmış olduğu bildirimleri sorgular.
3.4.9.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.9.2 Bildirim Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 65. Bildirim 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 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.9.3 Bildirim Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 66. 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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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.
Ü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
130 / 231 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
131 / 231 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
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.
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
132 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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”
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.
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.9.4 Bildirim Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)
{
"UNO" : "1111111110010",
"SNO" : "KYY012345678999",
"ADT" : 5
}
Gelen Cevap Yapısı :
{
"SNC": {
"LST": [
{ .. }, { .. }
],
"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"
},
"MSJ": null
}
3.4.9.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.10 Kabul Edilecek Tekil Ürün Sorgula
Kurum/firma kendisine yapılan verme bildirimlerini sorgular.
3.4.10.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.10.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları
Tablo 67. Kabul Edilecek Tekil Ürü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
134 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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.
Belge Numarası BNO Metin - Verme bildirimi sırasında verilen fatura/irsaliye
numarasıdır.
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Bildirim Kodu BID Metin 36 Bildirimin bildirim kodudur.
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.10.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 68. Kabul Edilecek 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, AUN,
AUA)
- İş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
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 / 231 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ı -
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.
Marka Model
Etiket
SNC.
MME Metin - Ürünün Marka – Model – Etiket adıdır.
Gerçek İşlem
Tarihi
SNC.
GIT 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.
Alt Ürün
Numarası
SNC.
AUN Metin 23
Dış barkodla yapılan bildirimlerde dış barkoda bağlı
olan alt barkoda ait ürün numarası/barkod
numarasıdır.
Alt Ürün Adedi SNC.
AUA Sayı -
Dış barkodla yapılan bildirimlerde dış barkodun
içeriğindeki ürün sayısı ile hesaplanan adet
miktarı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
136 / 231 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.10.4 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek
{
"GKK" : 7,
"SAN" : 0
}
3.4.11 Kabul Edilecek Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)
Kurum/firma kendisine yapılan verme bildirimlerini sorgular.
3.4.11.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
3.4.11.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 69. Kabul Edilecek Tekil Ürün 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
137 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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.
Belge Numarası BNO Metin - Verme bildirimi sırasında verilen fatura/irsaliye
numarasıdır.
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Bildirim Kodu BID Metin 36 Bildirimin bildirim kodudur.
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.11.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 70. 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, GIT, AUN,
AUA)
-
GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI,
UIK, GKU, MME, GIT, AUN, AUA parametrelerinden
oluşan listedir.
Gönderen
Kurum Kodu
LST.
GKK Sayı -
Verme bildirimi yapan 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
138 / 231 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ı -
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.
Gerçek İşlem
Tarihi
SNC.
GIT 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.
Alt Ürün
Numarası
SNC.
AUN Metin 23
Dış barkodla yapılan bildirimlerde dış barkoda bağlı
olan alt barkoda ait ü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
139 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Alt Ürün Adedi SNC.
AUA Sayı -
Dış barkodla yapılan bildirimlerde dış barkodun
içeriğindeki ürün sayısı ile hesaplanan adet
miktarı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.11.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": [
{ .. }, { .. }
],
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"
},
"MSJ": null
}
3.4.11.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”
}
3.4.11.6 Kabul Edilecek Tekil Ürün Sorgula Dış Barkod Örnek
Örnek Bildirim: Dış Barkod: 00644759775552, İç Barkod: +H99900111, İç Adet: 2
Verme Bildirimi: 00644759775552 barkoddan 6 adet yani +H99900111 barkoddan 12 adet verme yapıldı.
Kabul Edilecek Verme Bildirimi sorgulandığında gelen sonuç:
{
"SNC": {
"LST": [
{
"UNO": "00644759775552",
"LNO": "testDisBarkodLot",
"ADT": 6,
"MME": "Örnek Marka - XXX-Q1 - ",
"BID": "9fc296a1-b97a-11ea-8f4b-a16a314f8bb9",
"GKK": 10,
"GKU": "Erdil Medikal Ltd. Şti.",
"BNO": "test",
"BZA": "2020-06-28 23:04:50",
"BTI": "VERME",
"UIK": 10,
"GIT": "2020-06-28",
"AUN": "+H99900111",
"AUA": 12
} ], "OFF": null },
"MSJ": null}
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.12 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.12.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.12.2 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları
Tablo 71. 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.12.3 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 72. 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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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.
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
143 / 231 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.12.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,
"BNO": "Belge3",
"BTI": "VERME",
"GIT": "2019-01-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
144 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"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.13 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula
Kurum/firma kendisine yapılan geri çekme verme bildirimlerini sorgular.
3.4.13.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.13.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları
Tablo 73. 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.
Belge Numarası BNO Metin - Geri Çekme Verme bildirimi sırasında verilen
fatura/irsaliye numarasıdır.
Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.
Bildirim Kodu 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
145 / 231 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.
3.4.13.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları
Tablo 74. 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, GIT, AUN,
AUA)
- İş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.
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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.
Gerçek İşlem
Tarihi
SNC.
GIT 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.
Alt Ürün
Numarası
SNC.
AUN Metin 23
Dış barkodla yapılan bildirimlerde dış barkoda bağlı
olan alt barkoda ait ürün numarası/barkod
numarasıdır.
Alt Ürün Adedi SNC.
AUA Sayı -
Dış barkodla yapılan bildirimlerde dış barkodun
içeriğindeki ürün sayısı ile hesaplanan adet
miktarı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.
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 / 231 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.13.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula
{
"BNO" : “faturairsaliyenumarasi”,
“UNO” : “1211212121212”,
“GKK” : 10,
"SAN" : 0
}
3.4.14 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.14.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.14.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 75. 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.
Belge Numarası BNO Metin - Geri Çekme Verme bildirimi sırasında verilen
fatura/irsaliye numarasıdır.
Ü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
148 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bildirim Kodu BID Metin 36 Bildirimin bildirim kodudur.
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.14.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)
Tablo 76. 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, GIT, AUN,
AUA)
- 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
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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.
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.
Gerçek İşlem
Tarihi
SNC.
GIT 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.
Alt Ürün
Numarası
SNC.
AUN Metin 23
Dış barkodla yapılan bildirimlerde dış barkoda bağlı
olan alt barkoda ait ürün numarası/barkod
numarasıdır.
Alt Ürün Adedi SNC.
AUA Sayı -
Dış barkodla yapılan bildirimlerde dış barkodun
içeriğindeki ürün sayısı ile hesaplanan adet
miktarıdır.
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
150 / 231 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.14.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula (Kayıt Sayısı Parametresi (ADT) ile)
{
"BNO" : “faturairsaliyenumarasi”,
“UNO” : “1211212121212”,
“GKK” : 10,
"ADT" : 5
}
Gelen Cevap Yapısı :
{
"SNC": {
"LST": [
{ .. }, { .. }
],
"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"
},
"MSJ": null
}
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.14.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.
{
"BNO" : “faturairsaliyenumarasi”,
"ADT" : 5,
“OFF” : “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”
}
3.4.15 Tekil Ürünün Kaynağını Sorgula
Kurum/firma tekil ürünün “TİTUBB”da kayıtlı olup olmadığını sorgular.
3.4.15.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.15.2 Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları
Tablo 77. Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter
)
Zorunl
u 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.15.3 Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları
Tablo 78. 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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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.
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 Tekil Ürünün Kaynağını Sorgula Örnek İstek
{
"UNO" : “1111111110010”,
"SNO" : “123”
}
3.4.16 Piyasaya Arz Bilgileri Sorgula
Ürünün piyasaya arz bilgilerinden efektif ürün bilgilerini sorgulama
3.4.16.1 Piyasaya Arz Bilgileri Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/piyasayaArzBilgisi/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/piyasayaArzBilgisi/sorgula
3.4.16.2 Piyasaya Arz Bilgileri Sorgula İstek Veri Alanları
Tablo 79. Piyasaya Arz Bilgileri 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
153 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter
)
Zorunl
u mu? Açıklama
Piyasaya Arz
Barkodu PAB Metin - Evet Ürünün piyasaya arz barkodu
Üretici/İthalatçı
kurum
numarası
URT Sayı Evet Ürünün üretici/ithalatçı kurum numarası
3.4.16.3 Piyasaya Arz Bilgileri Sorgula Cevap Veri Alanları
Tablo 80. Piyasaya Arz Bilgileri Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Piyasaya Arz
Barkodu PAB Metin - Ürünün piyasaya arz (dış barkod) barkodudur.
Efektif ürün
numarası EUN Metin -
Ana ürünün ürün numarasıdır. Dış barkoda bağlı
alt ürün numarasıdır.
Miktar MKT Sayı - Efektif ürünün piyasaya arz içerisindeki adedidir.
3.4.16.4 Piyasaya Arz Bilgileri Sorgula Örnek İstek
{
"PAB":"1111111110010",
"URT":10
}
3.4.16.5 Piyasaya Arz Bilgileri Sorgula Örnek Cevap
{
"PAB": "1111111110010",
"EUN": "00644759775552",
"MKT": 10
}
3.4.17 Bildirim ve Tekil Ürün Detay Sorgula
Bildirimin ve bildirim yapılmış tekil ürünün detayını sorgular.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.17.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.17.2 Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları
Tablo 81. Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter
)
Zorunl
u mu? Açıklama
Bildirim ID BID Metin 36 Evet Bildirimin ID’sidir.
3.4.17.3 Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları
Tablo 82. Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları
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, PAB,
PAA)
-
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.
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gönderen
Kurum No bildirim.GKK Sayı
Verme bildirimlerinde gönderen kurumun
ÜTS’de kayıtlı numarasıdır.
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_AL
INDI,
ODUNC_VERME_ALINDI,
ODUNC_GERI_VERME_ALINDI.
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Hek/Zayiat
Diğer Tür
Açıklama
bildirim.HDA Metin Hek/Zayiat türü DIGER seçilirse, girilmesi
gereken açıklamadı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
157 / 231 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,
STOK,
STOK_IPTAL,
TUKETICIYE_VERME,
TUKETICIYE_VERME_IPTAL,
TUKETICIDEN_IADE_ALMA,
TUKETICIDEN_IADE_ALMA_IPTAL,
URETIM,
URETIM_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
158 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
UTSDE_TANIMSIZ_YERE_VERME,
UTSDE_TANIMSIZ_YERE_VERME_IP
TAL,
UTSDE_TANIMSIZ_YERDEN_IADE_AL
MA,
UTSDE_TANIMSIZ_YERDEN_IADE_AL
MA_IPTAL,
VERME,
VERME_IPTAL,
YENIDEN_ISLEME,
YENIDEN_ISLEME_IPTAL.
İ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_BOZ
ULMUS,
HASTANIN_VUCUDUNDAN_CIKARILMIS,
DIGER.
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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”
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.
Alınan Adet bildirim. AAD Sayı Alma bildirimlerinde alınan adettir.
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.
Bildirim Yapan
Kurum Tipi bildirim. BKT Metin
Bildirimi yapan kurum tipidir, aşağıdaki
değerleri alır.
KENDISI,
TITCK,
SGK,
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Tüketici / Hasta
Bilgisi Bildirim.TKT
Nesne (TKN, TUA, TUS, YKN, PAN, KTN)
Bildirimde bulunan tüketici / hasta bilgisidir.
TUA: Tüketici/Hastaya ait ad bilgisidir.
TUS: Tüketici/Hastaya ait soyad
bilgisidir.
TKN: Tüketici/Hastaya ait TC Kimlik
numarasıdır.
YKN: Tüketici/Hastaya ait yabancı kimlik
numarasıdır.
PAN: Tüketici/Hastaya ait pasaport
numarasıdır.
KTN: Tüketici/Hastaya ait kişi
tanımlayıcı numaradır.
Piyasaya Arz
Barkodu Bildirim. PAB Metin 23
Dış Barkod ile yapılan bildirimlerde piyasaya
arz barkodu bilgisidir.
Piyasaya Arz
Adedi Bildirim. PAA Sayı -
Dış Barkod ile yapılan bildirimlerde piyasaya
arz barkodu içindeki alt ürün miktarı ile
hesaplanan adet bilgisidir.
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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.
Ü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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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.
3.4.17.4 Bildirim ve Tekil Ürün Detay Sorgula Örnek İstek
{
"BID" : “48fr34c1-d3c3-11e7-97f7-8faf3772521f”
}
3.4.17.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",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"UTP": "TIBBI_CIHAZ",
"UIK": 2667269130265,
"UAK": "TEKIL",
"SKG": false,
"KKG": false
}
}
3.4.18 Stok Yapılabilir Tekil Ürün Bilgilerini Sorgulama
Kurum/firma; stok bildirimi yapmadan önce üretici tarafından bilgileri girilen stok yapılabilir tekil ürünleri sorgular.
3.4.18.1 Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/stokYapilabilirTekilUrun/sorgula
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/stokYapilabilirTekilUrun/sorgula
3.4.18.2 Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula İstek Veri Alanları
Tablo 83. Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter
)
Zorunl
u 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 Hayır Tekil ürünün seri/sıra numarasıdır.
Lot/Batch
Numarası LNO Metin 20 Hayır Tekil ürünün lot/batch 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.18.3 Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula Cevap Veri Alanları
Tablo 84. Stok Yapılabilir Tekil Ürün Bilgilerini 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
164 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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, ADT, MRK, UIK, UIU, URT,
SKT)
- UNO, LNO, SNO, ADT, MRK, UIK, UIU, URT, SKT
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
Adet LST.
ADT Sayı -
Üretici/ İthalatçı
Kurum
Numarası
LST.
UIK Sayı - Tekil ürünü üreten/ithal eden kurumun numarasıdır.
Üretici/ İthalatçı
Kurum Unvan
LST.
UIK Metin - Tekil ürünü üreten/ithal eden kurumun ünvanıdır.
Marka LST.
MRK Metin - Ürünün Marka adıdır.
Üretim Tarihi LST.
URT Tarih 8 Tekil ürünün, üretim tarihidir.
Son Kullanma
Tarihi
LST.
SKT Tarih 10 Tekil ürünün son kullanma tarihidir.
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
165 / 231 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.18.4 Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula Örnek İstek
{
"UNO" : “792461048126”
}
3.4.18.5 Stok Yapılabilir Tekil Ürün Bilgilerini Sorgula Örnek Cevap
{
"SNC": {
"LST": [
{
"UNO": "00792461048126",
"LNO": "",
"SNO": "seri1",
"UIK": 10,
"URT": "08/08/2019",
"SKT": "08/08/2019"
},
{
"UNO": "00792461048126",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"LNO": "lot1",
"SNO": "",
"UIK": 10,
"URT": "08/08/2019",
"SKT": "08/08/2019"
},
{
"UNO": "00792461048126",
"LNO": "lot10",
"SNO": "",
"UIK": 10,
"URT": "08/08/2019",
"SKT": "08/08/2019"
}
],
"OFF":
"001c0010001004056c6f74313008000000000000000af07ffffffcf07ffffffcd5b142713f6112ade0a693149b06f9ea00
04"
},
"MSJ": null
}
Tablo 85. Stok Yapılabilir Tekil Ürün Bilgilerini 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, SNO, ADT, MRK, UIK, UIU, URT,
SKT)
- UNO, LNO, SNO, ADT, MRK, UIK, UIU, URT, SKT
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
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 / 231 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ı -
Üretici/ İthalatçı
Kurum
Numarası
LST.
UIK Sayı - Tekil ürünü üreten/ithal eden kurumun numarasıdır.
Üretici/ İthalatçı
Kurum Unvan
LST.
UIK Metin - Tekil ürünü üreten/ithal eden kurumun ünvanıdır.
Marka LST.
MRK Metin - Ürünün Marka adıdır.
Üretim Tarihi LST.
URT Tarih 8 Tekil ürünün, üretim tarihidir.
Son Kullanma
Tarihi
LST.
SKT Tarih 10 Tekil ürünün son kullanma tarihidir.
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.
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 / 231 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.19 Ayrıntılı Tekil Ürün Sorgulama
Kullanıcı, üzerindeki tüm tekil ürünleri sorgulamak için kullanır, fakat mevcut saat içerisinde yapılan değişiklikler
gelen sonuçlarda görünmeyecektir. Bu saat içerisinde yapılan değişiklikler(mesela 10:15’te yapılan bir değişiklik),
sonraki saatin başında yansımaya başlayacaktır(yukarıdaki örnek için saat 11:00’da). Verinin miktarına göre tüm
değişiklikler anında yansımayabilir.
Uyarı: Bu web servis deneyseldir ve ileride adresi, veri alanları, döndüğü değerler değiştirilebilir veya tamamen
kaldırılabilir. Ayrıca, bu web servisin performansı, diğer web servisler kadar iyi olmayabilir. Eğer çok uzun süren
istekler olursa(15-20 saniyeden fazla) bunları talep ile bildirirseniz bizim için iyi olur, performansını daha rahat
ölçmüş oluruz.
3.4.19.1 Ayrıntılı Tekil Ürün Sorgulama Servis Adresleri
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/ayrintiliTekilUrun/sorgula
Test Ortamı: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/ayrintiliTekilUrun/sorgula
3.4.19.2 Ayrıntılı Tekil Ürün Sorgulama İstek Veri Alanları
Not: Aşağıdaki tüm alanlar opsiyoneldir. Eğer hiçbir alanı yollamazsanız filtre olmadan tekil ürünleri getirir.
Tablo 86. Ayrıntılı Tekil Ürün Sorgula İstek Veri Alanları
Adı JSON
Kodu Veri Tipi Açıklama
Ürün Numarası UNO Metin Ürünün ürün numarası/barkod numarasıdır.
Seri/Sıra
Numarası SNO Metin Tekil ürünün seri/sıra numarasıdır.
Lot/Batch
Numarası LNO Metin Tekil ürünün lot/batch numarasıdır.
Eşsiz Kimlik UDI Metin Tekil ürünün eşsiz kimliği
Üretici/İthalatçı
Kurum No UIK Sayı Tekil ürünün üretici/ithalatçısı
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi Açıklama
Adet ADT Sayı Sorgu sonucu getirilmesi istenen kayıt sayısıdır. Hiçbir değer
verilmezse kabul edilen değeri 15’tir. En fazla 250 verilebilir.
Sayfa SAY Sayı Sorgulanmak istenen sayfa. 0’dan başlamakta. Eğer herhangi bir
değer verilmezse kabul edilen değer 0’dır.
3.4.19.3 Ayrıntılı Tekil Ürün Sorgulama Cevap Veri Alanları
Tablo 87. Ayrıntılı Tekil Ürün Sorgulama Cevap Alanları
Adı JSON Kodu Veri Tipi Açıklama
Sonuç SNC Liste Verileri içeren bir JSON listesi
Sahibi SNC.sahibi Sayı Tekil ürünün ait olduğu kurumun
kurum numarası
Ürün numarası SNC.urunNumarasi Metin
Seri/Sıra Numarası SNC.seriNumarasi Metin
Lot/Batch Numarası SNC.lotBatchNumarasi Metin
Adet SNC.adet Sayı
Eşsiz Kimlik SNC.essizKimlik Metin
Oluşturulma Tarihi SNC.olusturulmaTarihi Sayı Tekil ürünün oluşturulduğu tarihin
UNIX zamanı cinsinden ifadesi
Sahibi Unvan SNC.sahibiUnvan Metin Tekil ürünün ait olduğu kurumun
unvanı
Son Kullanma Tarihi SNC.sonKullanmaTarihi Sayı Ürünün son kullanma tarihinin UNIX
zamanı cinsinden ifadesi
Üretici/İthalatçı
Kurum Numarası SNC.ureticiIthalatciKurumNo Sayı
Tekil ürünün üretici veya
ithalatçısının
Üretim Tarihi SNC.uretimTarihi Sayı Ürünün üretim tarihinin UNIX
zamanı cinsinden ifadesi
Ürün Tanımı SNC.urunTanimi Metin
Son Kullanma Tarihi
String SNC.sonKullanmaTarihiString Metin
Son kullanma tarihinin YYYY-AA-
GG formatında gösterilen hali
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi Açıklama
Oluşturulma Tarihi
String SNC.olusturulmaTarihiString Metin
Oluşturulma tarihinin YYYY-AA-GG
formatında gösterilen hali
Üretim Tarihi String SNC.uretimTarihiString Metin Üretim Tarihinin YYYY-AA-GG
formatında gösterilen hali
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 Metni MSJ.
MET Metin
İ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.19.4 Ayrıntılı Tekil Ürün Sorgulama Örnek İstek
{
"UNO":"792461048126",
"LNO":"DHI984",
"UIK":25698795464
"ADT":50,
"SAY":0
}
3.4.19.5 Ayrıntılı Tekil Ürün Sorgulama Örnek Cevap
{
"SNC": [
{
"sahibi": 26549461649,
"urunNumarasi": "792461048126",
"seriNumarasi": null,
"lotBatchNumarasi": " DHI984",
"adet": 357,
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"essizKimlik": null,
"olusturulmaTarihi": 1578639763000,
"sahibiUnvan": "Örnek Firma Adı.",
"sonKullanmaTarihi": null,
"ureticiIthalatciKurumNo": 26549849,
"uretimTarihi": 1577653200000,
"urunTanimi": "Örnek Ürün Adı",
"sonKullanmaTarihiString": null,
"olusturulmaTarihiString": "2020-01-10",
"uretimTarihiString": "2019-12-30"
}
],
"MSJ": null
}
3.4.20 Ayrıntılı Bildirim Sorgulama
Kullanıcı, yapmış olduğu tüm bildirimleri sorgulamak için kullanır, fakat mevcut saat içerisinde yapılan bildirimler
gelen sonuçlarda görünmeyecektir. Bu saat içerisinde yapılan değişiklikler(mesela 10:15’te yapılan bir değişiklik),
sonraki saatin başında yansımaya başlayacaktır(yukarıdaki örnek için saat 11:00’da). Verinin miktarına göre tüm
değişiklikler anında yansımayabilir.
Uyarı: Bu web servis deneyseldir ve ileride adresi, veri alanları, döndüğü değerler değiştirilebilir veya tamamen
kaldırılabilir. Ayrıca, bu web servisin performansı, diğer web servisler kadar iyi olmayabilir. Eğer çok uzun süren
istekler olursa(15-20 saniyeden fazla) bunları talep ile bildirirseniz bizim için iyi olur, performansını daha rahat
ölçmüş oluruz.
3.4.20.1 Ayrıntılı Bildirim Sorgulama Servis Adresleri
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/ayrintiliBildirim/sorgula
Test Ortamı: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/ayrintiliBildirim/sorgula
3.4.20.2 Ayrıntılı Bildirim Sorgulama İstek Alanları
Not: Aşağıdaki tüm alanlar opsiyoneldir. Eğer hiçbir alanı yollamazsanız filtre olmadan bildirimleri getirir.
Tablo 88. Ayrıntılı Bildirim Sorgulama İstek Alanları
Adı JSON
Kodu Veri Tipi Açıklama
Ürün Numarası UNO Metin Ürünün ürün numarası/barkod numarasıdır.
Seri/Sıra
Numarası SNO Metin Tekil ürünün seri/sıra 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
172 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi Açıklama
Lot/Batch
Numarası LNO Metin Tekil ürünün lot/batch numarasıdır.
Eşsiz Kimlik UDI Metin Tekil ürünün eşsiz kimliğ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
173 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Bildirim Tipi BTI Metin
Yapılan bildirimin tipi. Aşağıdaki değerleri alabilir:
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
ODUNC_GERI_VERME
ODUNC_GERI_VERME_IPTAL
ODUNC_VERME
ODUNC_VERME_IPTAL
STOK
STOK_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
174 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi Açıklama
TUKETICIDEN_IADE_ALMA
TUKETICIDEN_IADE_ALMA_IPTAL
TUKETIM
TUKETIM_IPTAL
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
Bildirim
Durumu BDR Metin
Bildirimin durumunu belirtir. Aşağıdaki değerleri alabilir:
AKTIF
PASIF
PAB_PASIF
IPTAL
KULLANIMDAN_ALINDI
VERILDI
ALINDI
TUKETICIDEN_IADE_ALINDI
UTSDE_TANIMSIZ_YERDEN_IADE_ALINDI
ODUNC_VERME_ALINDI
ODUNC_GERI_VERME_ALINDI
Bildirimi Yapan
Kurum Tipi BKT Metin
Aşağıdaki değerleri alabilir:
KENDISI
TITCK
SGK
SISTEM
Otomatik alma bildirimleri, sistem tarafından alınmış olarak
işaretlenir.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi Açıklama
TC Kimlik No TKN Metin Bildirimin yapıldığı hastanın TC Kimlik Numarası
Verilen Kurum
Numarası DKN Sayı Verme bildirimi yapılan kurumun kurum numarası
Belge
Numarası BNO Metin Yapılan bildirimin belge numarası
Bildirim ID BID Metin
Bildirimin
Yapıldığı Tarih
Başlangıcı
BZB Metin
Belli bir tarihten sonrasında olan bildirimlerin sorgulanması için
kullanılır. Formatı YYYY-AA-GG şeklindedir. Bitiş tarihi ile beraber
kullanılırsa belli bir aralıkta yapılan bildirimleri getirir.
Bildirimin
Yapıldığı Tarih
Sonu
BZS Metin
Belli bir tarihten önce yapılan bildirimlerin sorgulanması için
kullanılır. Formatı YYYY-AA-GG şeklindedir. Başlangıç tarihi ile
beraber kullanılırsa belli bir aralıkta yapılan bildirimleri getirir.
Adet ADT Sayı Sorgu sonucu getirilmesi istenen kayıt sayısıdır. Hiçbir değer
verilmezse kabul edilen değeri 15’tir. En fazla 250 verilebilir.
Sayfa SAY Sayı Sorgulanmak istenen sayfa. 0’dan başlamakta. Eğer herhangi bir
değer verilmezse kabul edilen değer 0’dır.
3.4.20.3 Ayrıntılı Bildirim Sorgulama Cevap Veri Alanları
Tablo 89. Ayrıntılı Bildirim Sorgulama Cevap Veri Alanları
Adı JSON Kodu Veri Tipi Açıklama
Sonuç SNC Liste Cevabı içeren bir JSON listesi
Ürün
Numarası SNC.urunNumarasi Metin Ürünün ürün numarası/barkod numarasıdır.
Seri/Sıra
Numarası SNC.seriNumarasi Metin Tekil ürünün seri/sıra 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
176 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi Açıklama
Lot/Batch
Numarası SNC.lotBatchNumarasi Metin Tekil ürünün lot/batch numarasıdır.
Eşsiz Kimlik SNC.essizKimlik Metin Tekil ürünün eşsiz kimliği
Bildiren
Kurum No SNC.bildirenKurumNo Sayı Bildirimi yapan kurumun kurum numarası
Adet SNC.adet Sayı Bildirim adedi
Ürün Tanımı SNC.urunTanimi 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
177 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Bildirim Tipi SNC.bildirimTipi Metin
Yapılan bildirimin tipi. Aşağıdaki değerleri alabilir:
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_IPT
AL
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
ODUNC_GERI_VERME
ODUNC_GERI_VERME_IPTAL
ODUNC_VERME
ODUNC_VERME_IPTAL
STOK
STOK_IPTAL
TUKETICIYE_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
178 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi Açıklama
TUKETICIYE_VERME_IPTAL
TUKETICIDEN_IADE_ALMA
TUKETICIDEN_IADE_ALMA_IPTAL
TUKETIM
TUKETIM_IPTAL
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
Bildirim
Durumu SNC.bildirimDurumu Metin
Bildirimin durumunu belirtir. Aşağıdaki değerleri
alabilir:
AKTIF
PASIF
PAB_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
179 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri Tipi Açıklama
Bildirimi
Yapan
Kurum Tipi
SNC.bildirimiYapanKurumTi
pi Metin
Aşağıdaki değerleri alabilir:
KENDISI
TITCK
SGK
SISTEM
Otomatik alma bildirimleri, sistem tarafından
alınmış olarak işaretlenir.
TC Kimlik
No SNC.tcKimlikNo Metin Bildirimin yapıldığı hastanın TC Kimlik Numarası
Pasaport No SNC.pasaportNo Metin Bildirimin yapıldığı hastanın pasaport numarası
Yabancı
Kimlik No SNC.yabanciKimlikNo Metin
Bildirimin yapıldığı hastanın yabancı kimlik
numarası
Kişi
Tanımlayıcı
No
SNC.kisiTanimlayiciNo Metin Bildirimin yapıldığı hastanın kişi tanımlayıcı
numarası
Verilen
Kurum
Numarası
SNC.digerKurumNo Sayı Verme bildirimi yapılan kurumun kurum numarası
Belge
Numarası SNC.belgeNo Metin Yapılan bildirimin belge numarası
Bildirim ID SNC.bildirimId Metin
Oluşturulma
Tarihi SNC.olusturulmaTarihi Sayı
Bildirimin yapıldığı tarihin UNIX zamanı cinsinden
ifadesi.
Oluşturulma
Tarihi String SNC.olusturulmaTarihiString Metin
Bildirimin yapıldığı tarihin string hali. Formatı
YYYY-AA-GG şeklindedir.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.20.4 Ayrıntılı Bildirim Sorgulama Örnek İstek
{
"UNO":"979466131365",
"LNO":"BGH7974AD",
“BZB”:”2020-01-01”,
“BZS”:”2020-01-31”
}
3.4.20.5 Ayrıntılı Bildirim Sorgulama Örnek Cevap
{
"SNC": [
{
"bildirimId": "88cccc41-32d4-11ea-aa85-2d09bbf8d235",
"adet": 123,
"belgeNo":”KUYHB698”,
"bildirenKurumNo": 2654945,
"bildirimDurumu": "ALINDI",
"bildirimTipi": "VERME",
"digerKurumNo":265494613,
"essizKimlik": null,
"kisiTanimlayiciNo": null,
"lotBatchNumarasi": " BGH7974AD",
"olusturulmaTarihi": 1578569899780,
"pasaportNo": null,
"seriNumarasi": null,
"tcKimlikNo": null,
"urunNumarasi": "979466131365",
"urunTanimi": "Örnek Marka 1 - Örnek Model 1 - ",
"yabanciKimlikNo": null,
"bildirimiYapanKurumTipi": "KENDISI",
"olusturulmaTarihiString": "2020-01-20"
},
{
"bildirimId": "f5011321-3375-11ea-9974-ef8f9bbe6cf8",
"adet": 1000,
"belgeNo": null,
"bildirenKurumNo": 10,
"bildirimDurumu": "AKTIF",
"bildirimTipi": "URETIM",
"digerKurumNo": null,
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"essizKimlik": null,
"kisiTanimlayiciNo": null,
"lotBatchNumarasi": " BGH7974AD",
"olusturulmaTarihi": 1578639230290,
"pasaportNo": null,
"seriNumarasi": null,
"tcKimlikNo": null,
"urunNumarasi": "979466131365",
"urunTanimi": "Örnek Marka 1 - Örnek Model 1 - ",
"yabanciKimlikNo": null,
"bildirimiYapanKurumTipi": "KENDISI",
"olusturulmaTarihiString": "2020-01-10"
}
],
"MSJ": null
}
3.4.21 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.21.1 Eksik Alma Bildirimlerini Görüntüle
3.4.21.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.21.1.2 Eksik Alma Bildirimlerini Görüntüle İstek Veri Alanları
Tablo 90. 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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.21.1.3 Eksik Alma Bildirimi Sorgula Cevap Veri Alanları
Tablo 91. 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.
Ü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ı -
Verme 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.
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 / 231 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ğ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
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.21.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”
}
3.4.21.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.21.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.21.2.2 Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Veri Alanları
Tablo 92. 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.21.2.3 Eksik Alma Bildirimi Görülme Durumunu Güncelle Cevap Veri Alanları
Tablo 93. 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.
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 / 231 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
HATA
Mesaj Metni MSJ.
MET Metin 255 İnsanların okumasına elverişli bilgi mesaj metnidir.
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.21.2.4 Eksik Alma Bildirimi Görülme Durumunu Güncelle Örnek İstek
{
"BID": "def610f1-075a-11e9-a5c1-6d0bfaf9a6ef",
"GDR": "GORULMEDI"
}
3.4.22 Kuruma Gelen Verme Bildirimini Almak İstemiyorum Olarak İşaretle
Bir kuruma gelen verme bildirimleri, alma yapması beklenen firma tarafından kabul edilmeyecekse; bu bildirimin
artık kuruma gelen verme bildirimleri arasında görüntülenmemesi için firma tarafından Almak İstemiyorum olarak
işaretlenmelidir.
3.4.22.1 Almak İstemiyorum Olarak İşaretle Servis Adresleri
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/almakIstemiyorum/almakIstemiyorumOlarakIsaretle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/almakIstemiyorum/almakIstemiyorumOlarakIsaretle
3.4.22.2 Almak İstemiyorum Olarak İşaretle İstek Veri Alanları
Tablo 94. Almak İstemiyorum Olarak İşaretle İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bildirim ID BID Metin 36 Alınmak istenmeyen verme bildirimine ait 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
186 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.22.3 Almak İstemiyorum Olarak İşaretle Örnek İstek
{
"BID": "abfc1e61-c4f1-11e9-b1cf-7b9c9dc993c7"
}
3.4.23 Almak İstemiyorum Olarak İşaretlenen Bildirimleri Almak İstiyorum Olarak İşaretle
Kurum Almak İstemiyorum olarak işaretlediği verme bildirimlerini almak isterse ve tekrar kabul edilecek tekil ürünleri
arasında görüntülemek isterse ilgili verme bildirimini Almak İstiyorum olarak işaretler.
3.4.23.1 Almak İstiyorum Olarak İşaretle Servis Adresleri
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/almakIstemiyorum/ almakIstiyorumOlarakIsaretle
Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/almakIstemiyorum/ almakIstiyorumOlarakIsaretle
3.4.23.2 Almak İstiyorum Olarak İşaretle İstek Veri Alanları
Tablo 95. Almak İstiyorum Olarak İşaretle İstek Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bildirim ID BID Metin 36 Almak istemiyorum olarak işaretlenen verme
bildirimine ait bildirim kodudur.
3.4.23.3 Almak İstiyorum Olarak İşaretle Örnek İstek
{
"BID": "abfc1e61-c4f1-11e9-b1cf-7b9c9dc993c7"
}
3.4.24 Alınmak İstenmeyen Verme Bildirimlerimi Sorgula
Bir kuruma gelen verme bildirimleri, alma yapması beklenen firma tarafından kabul edilmeyecekse; bu bildirimin
artık kuruma gelen verme bildirimleri arasında görüntülenmemesi için firma tarafından Almak İstemiyorum olarak
işaretlenir. Verme bildirimini yapan firma ise ilgili bildirimindeki tekil ürününün alınmak istenmiyor olarak işaretlenip
işaretlenmediğini sorgulayabilir.
3.4.24.1 Alınmak İstenmeyen Verme Bildirimlerimi Sorgula Servis Adresleri
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/almakIstemiyorum/sorgula/alinmakIstenmeyenVermeBildirimlerim
Test Ortamı:
https://utstest.saglik.gov.tr/UTS/uh/rest/almakIstemiyorum/sorgula/alinmakIstenmeyenVermeBildirimlerim
3.4.24.2 Alınmak İstenmeyen Verme Bildirimlerimi Sorgula İstek Veri Alanları
Tablo 96. Alınmak İstenmeyen Verme Bildirimlerimi 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
187 / 231 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.24.3 Alınmak İstenmeyen Verme Bildirimlerimi Sorgula Cevap Veri Alanları
Tablo 97. Alınmak İstenmeyen Verme Bildirimlerimi Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(LST, OFF, MSJ)
- LST, OFF, MSJ parametrelerinden oluşan nesnedir.
İşlemin başarılı olması durumunda döndürülür.
Liste LST
Liste
(UNO, LNO, ADT, BID,
GKK, KUN, DKU, AID)
- UNO, LNO, ADT, BID, GKK, KUN, DKU, AID
parametrelerinden oluşan listedir.
Ürün Numarası LST.
UNO Metin 23 Tekil ü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ı - Verilen ürünün adedir.
Bildirim Kodu LST.
BID Metin 36 Bildirimin bildirim kodudur.
Diğer Kurum No LST.
KUN Sayı -
Verme bildirimin yapıldığı ÜTS’de tanımlı diğer
kurumun 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
188 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Gönderen
Kurum Kodu
LST.
GKK Metin 50 Bildirimi yapan firmanın kurum numarasıdır.
Diğer Kurum
Unvan
LST.
DKU Sayı - Verme bildirimin yapıldığı kurumun unvanıdır.
Almak İstenme
Durumu
LST.
AID Metin -
Bildirimin alınmak istenme durumunu belirtir.
Aşağıdaki değerleri alabilir:
ALINMAK_ISTENMIYOR,
ALMAK_ISTEMIYORUM
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.24.4 Alınmak İstenmeyen Verme Bildirimlerimi Sorgula Örnek İstek
{
“ADT”: 10
}
3.4.24.5 Alınmak İstenmeyen Verme Bildirimlerimi Sorgula Örnek Cevap
{
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"SNC": {
"LST": [
{
"UNO": "01111111110010",
"LNO": "1",
"ADT": 10,
"BID": "abfc1e61-c4f1-11e9-b1cf-7b9c9dc993c7",
"GKK": 10,
"KUN": 7,
"DKU": "Halime Medikal",
"AID": "ALINMAK_ISTENMIYOR"
}
],
"OFF": null
},
"MSJ": null
}
3.4.25 Almak İstemediğim Verme Bildirimlerini Sorgula
Firma almak istemiyorum olarak işaretlediği verme bildirimlerini sorgular. Dilerse Almak İstiyorum Olarak İşaretle
servisini kullanarak bildirimi bu listeden çıkarabilir.
3.4.25.1 Almak İstemediğim Verme Bildirimlerini Sorgula Servis Adresleri
Gerçek Ortam:
https://utsuygulama.saglik.gov.tr/UTS/uh/rest/almakIstemiyorum/sorgula/almakIstemedigimVermeBildirimlerim
Test Ortamı:
https://utstest.saglik.gov.tr/UTS/uh/rest/almakIstemiyorum/sorgula/almakIstemedigimVermeBildirimlerim
3.4.25.2 Almak İstemediğim Verme Bildirimlerini Sorgula İstek Veri Alanları
Tablo 98. Almak İstemediğim Verme Bildirimlerini Sorgula İ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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.4.25.3 Almak İstemediğim Verme Bildirimlerini Sorgula Cevap Veri Alanları
Tablo 99. Almak İstemediğim Verme Bildirimlerini Sorgula Cevap Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Sonuç SNC Nesne
(LST, OFF, MSJ)
- LST, OFF, MSJ parametrelerinden oluşan nesnedir.
İşlemin başarılı olması durumunda döndürülür.
Liste LST
Liste
(UNO, LNO, ADT, BID,
GKK, KUN, DKU, AID)
- UNO, LNO, ADT, BID, GKK, KUN, DKU, AID
parametrelerinden oluşan listedir.
Ürün Numarası LST.
UNO Metin 23 Tekil ü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ı - Verilen ürünün adedir.
Bildirim Kodu LST.
BID Metin 36 Bildirimin bildirim kodudur.
Diğer Kurum No LST.
KUN Sayı -
Verme bildirimin yapıldığı ÜTS’de tanımlı diğer
kurumun numarasıdır.
Gönderen
Kurum Kodu
LST.
GKK Metin 50 Bildirimi yapan firmanın kurum numarasıdır.
Diğer Kurum
Unvan
LST.
DKU Sayı - Verme bildirimin yapıldığı kurumun unvanıdır.
Almak İstenme
Durumu
LST.
AID Metin -
Bildirimin alınmak istenme durumunu belirtir.
Aşağıdaki değerleri alabilir:
ALINMAK_ISTENMIYOR,
ALMAK_ISTEMIYORUM
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 / 231 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.25.4 Almak İstemediğim Verme Bildirimlerini Sorgula Örnek İstek
{
“ADT”: 10
}
3.4.25.5 Almak İstemediğim Verme Bildirimlerini Sorgula Örnek Cevap
{
"SNC": {
"LST": [
{
"UNO": "01111111110010",
"LNO": "1",
"ADT": 10,
"BID": "abfc1e61-c4f1-11e9-b1cf-7b9c9dc993c7",
"GKK": 7,
"KUN": 10,
"DKU": "Erdil Medikal Ltd. Şti.",
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"AID": "ALMAK_ISTEMIYORUM"
}
],
"OFF": null
},
"MSJ": null
}
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 100. 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.
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
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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 101. Paket Ekle Cevap Veri Alanları
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
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 / 231 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.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 ":[
{
"PNO ":"paket2",
"KNO" : 7,
"TIP" : "P",
"TUL ":[
{
"UNO ":"urunNo2",
"SNO ":"seriNo2",
"LNO ":"lotNo2",
"UDI" : "99",
"ADT ":100
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
}
]
}
]
}
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 102. 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 103. Paket Sil Cevap Veri Alanları
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
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 / 231 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.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 104. Paket 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 gösterilecek paketin, paket
numarasıdır.
3.5.3.3 Paket Getir Cevap Veri Alanları
Tablo 105. Paket Getir 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
197 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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
Ü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
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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 106. 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.
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 107. Kuruma Gelen Paketi Okundu İşaretle 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
199 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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
}
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 108. Kuruma Gelen Paketi 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
200 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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 109. 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.
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ı
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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
3.5.6.2 Kuruma Gelen Paketleri Sorgula İstek Veri Alanları
Tablo 110. 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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Zorunlu
mu? Açıklama
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 111. 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
Paket Numarası SNC.
PNO Metin - Sistem paketi numarası
Kurum Numarası SNC.
KNO Sayı -
Paketi oluşturan kurumun ÜTS’de tanımlı
numarası
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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 }
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.
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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 112. 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 113. Firma Sorgulama Servisi Sonuç Veri Alanları
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
MERSİS
Numarası MRS Metin 16 Firmanın MERSİS Numarası
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON
Kodu Veri Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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.
3.7.1 Ürün Sorgulama Servis Adresi
Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/rest/tibbiCihaz/urunSorgula
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 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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 114. Ü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 115. Ü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 116. Ürün Sorgulama Servisi Ürün Sonuç Veri Alanları
Adı JSON Kodu Veri
Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Birincil Ürün
Numarası birincilUrunNumarasi Metin
Marka Adı markaAdi Metin
Versiyon/
Model versiyonModel 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
207 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri
Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
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 Kayıtlı, Kayıtlı/Tekil Ürünü Var,
Reddedildi, Silindi
Kayıt Durumu
Başlangıç
Tarihi
durumBaslangicTarihi Tarih 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
Yönetmelik yonetmelik Metin 93/42/EEC, 98/79/EC, 90/385/EEC
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
208 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri
Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Her
Kullanımda
Sterilizasyon
Gerekiyor mu
herKullanimdaSterilizasy
onGerekli Metin EVET, HAYIR
İyonize
Radyasyon
İçeriyor mu
iyonizeRadyasyonIcerir Metin EVET, HAYIR
DEHP İçeriyor
mu dehpIceriyor Metin EVET, HAYIR, BILINMIYOR
Nanomateryal
İçeriyor mu nanomateryalIceriyor Metin EVET, HAYIR
Sınırlı
Kullanım
Sayısı Var mı
sinirliKullanimSayisiVar Metin EVET, HAYIR
Sınırlı
Kullanım
Sayısı
sinirliKullanimSayisi Sayı
Raf Ömrü Var
mı rafOmruVar Metin EVET, HAYIR
Raf Ömrü rafOmru Sayı
Raf Ömrü
Birimi rafOmruBirimi Metin GUN, AY, YIL
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 kalibrasyonPeriyodu Sayı Ay bazında kalibrasyon periyodu
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
209 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
Adı JSON Kodu Veri
Tipi
En Fazla
Uzunluk
(Karakter)
Açıklama
Bakıma Tabi
mi bakimaTabiMi Metin EVET, HAYIR
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
Ürün Sayısı urunSayisi Sayı
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",
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
210 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
"referansKatalogNo": null,
"ithalImalBilgisi": "IMAL",
"kayitDurumu": "Kayıtlı",
"durumBaslangicTarihi": "22/12/2017",
"sinif": "SINIF_III",
“yonetmelik”: “93/42/EEC”,
"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,
“rafOmruBirimi”: null,
"ek3KapsamindaMi": "HAYIR",
"bransKodu": "81",
"bransTurKodu": "81",
"gmdnKodu": "30857",
"takipDurumu": "Takip Ediliyor",
"kalibrasyonaTabiMi": "Hayır",
"kalibrasyonPeriyodu": null,
"bakimaTabiMi": "Hayır",
"bakimPeriyodu": null,
“sutKodu”: null,
“urunSayisi”: 1
}
]
}
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
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
211 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
3.8.2 Bütün Ürünleri Sorgulama Servisi Veri Alanları
Birincil ürün numarası ürün bilgilerini sorgulamasını sağlayan servistir.
Tablo 117. 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 118. 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 119. 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
212 / 231 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 Kayıtlı, Kayıtlı/Tekil Ürünü Var
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.
Ürün Sayısı urunSayisi
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ç
[
{
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
213 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
“sinif”: “SINIF_I_DIGER”,
“takipDurumu”: “Takip Ediliyor”,
"birincilUrunNumarasi": "55655444444",
"urunTipi": "TIBBI_CIHAZ",
"durum": "Kayıtlı",
"durumBaslangicTarihi": "24/05/2018",
"markaAdi": "Bir Tıbbi Cihaz 2",
"etiketAdi": "kafatası protezi",
"versiyonModel": "XXX-Q1",
"katalogNo": null,
"ithalImalBilgisi": "ITHAL",
"guncellenmeTarihi": "24/05/2018",
“urunSayisi”: 1
}
]
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
214 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
4 EKLER
4.1 EK-A SERVİS MESAJLARI
Tablo 120. 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 Ürün sistemde bulunmamaktadır.
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.
UTS-H025 Girilen seri numarası daha önce tanımlanmış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
215 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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 önceki bir tarih 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 Girilen üretim/ithalat tarihinde ürüne ait takip konfigürasyonu bulunamadığı için ü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
216 / 231 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 {0} 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
217 / 231 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 İptal bildirimini paketi olusturan kurum yapmalidir.
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 tekil ürünler için adet girilmemiştir.
UTS-H099 Tekil ürün kurumda değil ya da kurum üretici/ithalatçı değil.
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
218 / 231 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, 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
219 / 231 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-H142 Firma MERSIS'te tanımlı değildir.
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-H164 Kimlik bilgileri girilmelidir.
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.
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
220 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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.
UTS-H163 Sistem işlem paketi bildirimleri henüz başlamamıştır
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-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 Yediemin kararı bulunan tekil ürünler hareket ettirilemez.
UTS-H174 Silinecek paket {0} numaralı paket içinde olduğu için silinemez.
UTS-H175 {0} paket numarası mevcut olduğundan aynı paket numarası eklenemez.
UTS-H176 {0} numaralı paket {1} numaralı paketin içinde olduğu için ekleme işlemi yapılamaz.
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 İade Alma bildiriminde 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 tekil ürün sistemde mevcuttur.
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
221 / 231 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-H211 Kullanım bildirimi bulunamadı.
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
222 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H212 Verilen bildirim koduna göre bir bildirim bulunamadı.
UTS-H213 Kurum sistemde bulunamadı.
UTS-H214 Bildirim kullanım bildirimi değildir.
UTS-H215 Verilen tekil ürün bilgileri ile bildirim uyuşmuyor.
UTS-H216 Verilen kişi id ile bildirimdeki kişi id uyuşmuyor.
UTS-H217 Verilen sgk tesis noya karşılık gelen kurum ÜTS'de bulunamadı.
UTS-H218 Verilen kurum, bildirimi yapan kurum değildir.
UTS-H219 Bildirim zaten iptal edilebilir durumdadır.
UTS-H220 Ürün tek kullanımlık olmalıdır.
UTS-H221 Kullanım bildirimi SGK tarafından kilitlendiği için iptal edilemez.
UTS-H222 Kullanım bildirimi için adet 1 olmalıdır.
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-H229 Bu bildirime daha önce farklı bir SGK referans no ile kilitleme işlemi uygulanmıştır.
UTS-H230 Bildirim zaten iptal edilemez durumdadır.
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.
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
223 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
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.
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}.\n NOT : Tekil ürünün üretim tarihini, ürünün üreticisi/ithalatçısı 'Ürün Hareketleri ->
Üretici/İthalatçı Tekil Ürün Sorgula -> Sistem İçindeki Tekil Ürünler' sayfasından tekil ürün
sorgulayıp güncelleyebilir.
UTS-H258 Güncellenecek olan üretim tarihinde, ürünün takip kapsamı konfigurasyonu bulunmamaktadır.
UTS-H259 Güncellenecek olan üretim tarihi ile önceki üretim tarihi eşit olamaz.
UTS-H260 Tekil ürüne sadece stok bildirimi yapılmamış. Üretim tarihini üretim/ stok bildirimlerini iptal
ederek ve yeniden üretim/stok bildirimi yaparak güncelleyiniz.
UTS-H261 Tekil ürünün adeti zaten '0' sıfır olduğu için üretim tarihi güncellenemez.
UTS-H262 Güncellenecek üretim tarihi bugünden sonra 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
224 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H263 Güncellenecek üretim tarihi tekil ürünün son kullanma tarihinden sonra olamaz.
UTS-H264 Güncellenecek üretim tarihi önceki üretim veya stok tarihinden sonra olamaz.
UTS-H265 Tekil ürünün Üretim Tarihi güncelleme işlemini sadece ürünün üretici/ithalatçısı yapabilir.
UTS-H266 Tekil takip edilen tekil ürünlerin üretim tarihleri, iptal işlemi yapılarak güncellenmelidir.
UTS-H267 Tekil ürünlerin sahipleri olmalıdır.
UTS-H268 Eksik alma bildirimi veritabanında bulunmamaktadır.
UTS-H269 Bildirim zaten almak istemiyorum olarak işaretlenmiş.
UTS-H270 Bildirim zaten almak istiyorum olarak işaretlenmiş.
UTS-H271 Alınmış verme bildirimi almak istemiyorum olarak işaretlenemez.
UTS-H272 Tüketici/hasta bilgilerinin tümü girilmelidir.
UTS-H273 Eczaneler bayilik ilişkisi olmaksızın sadece insülin kalem iğne ucu ve şeker ölçüm çubuğu
branş türündeki ürünler için stok bildirimi yapabilir.
UTS-H278 İthalatçı kurum numarası boş olamaz.
UTS-H279 Firmanın ürüne ithalat yapma yetkisi olmalıdır.
UTS-H280 İthalatçı kurumun ürüne ait yetkili distribütörlük belgesi olmalıdır.
UTS-H281 Ürün sınıfı Sınıf-III olan tıbbi cihazlar için stok bildirimi yapılamaz.
UTS-H285 Güncellenecek olan son kullanma tarihi ile önceki son kullanma tarihi eşit olamaz.
UTS-H286 Güncellenecek son kullanma tarihi tekil ürünün üretim tarihinden önce olamaz.
UTS-H287 Güncellenecek son kullanma tarihi bugünden önce olamaz.
UTS-H288 Son kullanma tarihi raf ömründen büyük olamaz.
UTS-H289 Güncellemek istediğiniz üretim tarihinden önce yapılmış olan bildirimleriniz var. Üretim
tarihinden önceki bir tarihte bildirim yapılamaz.
UTS-H290 Güncellemek istediğiniz son kullanma tarihinden sonra yapılan bildirimleriniz var. Son
kullanma tarihinden sonraki bir tarihte bildirim yapılamaz.
UTS-H291 Ürün numarası:{0}, seri numarası:{1} ve lot/batch numarası:{2} olan tekil ürün bulunamadı.
UTS-H292 Ürün numarası:{0}, seri numarası:{1} ve lot/batch numarası:{2} olan tekil ürünün üretim
tarihi:{3}, bildirilen gerçek işlem tarihinden sonra olduğu için işlem gerçekleştirilemez.
UTS-H293 Ürün numarası:{0}, seri numarası:{1} ve lot/batch numarası:{2} olan tekil ürüne ait ürün
sistemde bulunamadı.
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
225 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H294 Ürün numarası:{0} olan ürüne geri çekme tanımlandığı için işlem gerçekleştirilemez.
UTS-H295 Ürün numarası:{0}, seri numarası:{1} ve lot/batch numarası:{2} olan tekil ürüne geri çekme
tanımlandığı için işlem gerçekleştirilemez.
UTS-H296 Ürün numarası:{0}, seri numarası:{1} ve lot/batch numarası:{2} olan tekil ürünün son kullanma
tarihi bildirilen gerçek işlem tarihinden önce olduğu için işlem gerçekleştirilemez.
UTS-H297
Ürün numarası:{0}, seri numarası:{1} ve lot/batch numarası:{2} olan tekil ürünün doz ile
hesaplanan son kullanım tarihi, son kullanma tarihinden önce olduğu için işlem
gerçekleştirilemez.
UTS-H298 Ürün numarası:{0}, seri numarası:{1} ve lot/batch numarası:{2} olan tekil ürünün durumu:{3}
olduğu için işlem gerçekleştirilemez.
UTS-H299 Ürün numarası:{0}, seri numarası:{1} ve lot/batch numarası:{2} olan tekil ürünün kullanım
adedi yetersiz olduğu için işlem gerçekleştirilemez.
UTS-H300 Bildirimi yapan kurum SGK olmalıdır.
UTS-H301 Reçete tipi Eczane olmalıdır.
UTS-H302 Aynı reçete numarası ile daha önceden tüketiciye verme bildirimi yapıldığı için işlem
gerçekleştirilemez.
UTS-H303 Reçete numarası ve reçete tipinde yapılmış aktif tüketiciye verme bildirimi bulunmadığı için
işlem gerçekleştirilemez.
UTS-H304 {0} numaralı reçete ile yapılan tüketiciye verme bildirimlerinde hata olduğu için işlem
gerçekleştirilemez.
UTS-H305
Girilen tekil ürün bilgilerine uyan, stok yapılabilir tekil ürün bilgisi bulunamamıştır.
Üretici/ithalatçı ile iletişime geçerek ilgili tekil ürün bilgilerini stok yapılabilir listeye
ekletebilirsiniz.
UTS-H306 Stok bildirimi yapan kurumun faaliyet alanı Eczane olmalıdır.
UTS-H307 Piyasaya arz barkodu ile HEK/Zayiat bildirimi yapılamaz. Bildirimin iç barkod ile yapılması
gerekmektedir.
UTS-H308 Piyasaya arz barkodu ile İmha/Bertaraf bildirimi yapılamaz. Bildirimin iç barkod ile yapılması
gerekmektedir.
UTS-H309 Piyasaya arz barkodu ile Geçici Kullanıma Verme bildirimi yapılamaz. Bildirimin iç barkod ile
yapılması gerekmektedir.
UTS-H310 Piyasaya arz barkodu ile Islah/Düzeltici Faaliyet bildirimi yapılamaz. Bildirimin iç barkod ile
yapılması 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
226 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-H311 Piyasaya arz barkodu ile Mahrecine İade Etme bildirimi yapılamaz. Bildirimin iç barkod ile
yapılması gerekmektedir.
UTS-H312 Piyasaya arz barkodu ile Yeniden İşleme bildirimi yapılamaz. Bildirimin iç barkod ile yapılması
gerekmektedir.
UTS-H313 Tüketim tarihi bugünden sonra olamaz.
UTS-H314 Bildirimi yapan kurum Sağlık Hizmet Sunucusu olmalıdır.
UTS-H315
Tekil ürün tüketim bildirimi koşullarını sağlamıyor. Ürüne tüketim bildirimi yapılabilmesi için
vücuda implante edilememelidir, sınırsız kullanımlık olmamalıdır, SUT eşleşmesi olmamalıdır
ve tek bir hastaya kullanılabilir olmamalıdır.
UTS-H316 Tekil ürün bilgisi daha önceden eklendiği için tekrar eklenemez.
UTS-H317 Sadece insülin kalem iğne ucu ve şeker ölçüm çubuğu branş türündeki ürünler için stok
yapılabilir tekil ürün eklenebilir.
UTS-H318 Bildirimin türü 'Tüketiciye Verme Bildirimi' değil.
UTS-H319 Kurum ÜTS'de bulunamadı.
UTS-H320 Tüketiciye verme bildirimi SGK tarafından kilitlendiği için iptal edilemez.
UTS-H321 Tüketiciye verme bildiriminin bir kısmı iade alındığı için bildirim kilitlenemez.
UTS-H322 Tüketiciye verme bildiriminde tüketici bilgisi girilmediği için kilitleme yapılamaz.
UTS-H323 Bildirim zaten kilitlendiği için tekrar kilitleme yapılamaz.
UTS-H324 Bildirim sırasında adet bilgisi değiştiği için işlem gerçekleştirilemedi. Lütfen bildirimi tekrar
yapınız.
UTS-H325 Raf ömrü olmayan tıbbi cihazlar için üretim tarihi girilmesi zorunludur.
UTS-H326 Raf ömrü olan ürünler için üretim veya son kullanma tarihi girilmiş olmalıdır.
UTS-H327 Son kullanma tarihi, üretim tarihine raf ömrü eklenerek hesaplanan son kullanma tarihinden
daha sonraki bir gün olarak girilemez.
UTS-H328 Son kullanma tarihi, üretim tarihi veya ithalat tarihi girilmesi zorunludur.
UTS-H329 Üretim tarihine, raf ömrü bilgisi eklenerek hesaplanan son kullanma tarihi, bugünden daha
önce olamaz.
UTS-H330 Verilen tekil ürün bilgileri ile stok yapılabilir tekil ürün bulunamadı.
UTS-H331 Girilen tekil ürün bilgileri ile mevcut bir tekil ürün bulunmakta, ve bu tekil ürünün üretim tarihi,
girilen tarih ile uyuşmamakta. Mevcut tekil ürünün üretim tarihi: {0}.\n NOT : Tekil ürünü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
227 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
üretim tarihini, 'Ürün Hareketleri -> Üretici/İthalatçı Tekil Ürün Sorgula -> Sistem İçindeki Tekil
Ürünler' sayfasından tekil ürün sorgulayıp güncelleyebilirsiniz.
UTS-H332 Tekil ürün kullanım bildirimi koşullarını sağlamadığı için bildirim yapılamaz.
UTS-H333 TİTCK tarafından tekil ürüne tanımlanan takip kapsamı ayarı uygun olmadığı için bildirim
yapılamaz.
UTS-H334 Ürün numarası:{0} olan ürün için TİTCK tarafından tanımlanan takip kapsamı ayarı uygun
olmadığı için bildirim yapılamaz.
UTS-H335 Ürünün takip kapsamı stok yapılamaz olarak ayarlandığı için ürüne stok yapılabilir tekil ürün
eklenemez.
UTS-H336 Tekil ürün envanter bildirimi koşullarını sağlamadığı için bildirim yapılamaz. Ürüne envanter
bildirimi yapılabilmesi için ürünün kalibrasyona veya bakıma tabi olması gerekmektedir.
UTS-H337 Firmalar bayilik ilişkisi olmaksızın sadece hasta alt bezi branş türündeki ürünler için stok
bildirimi yapabilir.
UTS-H338 Verilen kurum, kozmetik firması olmalıdır.
UTS-H339 Tıbbi cihaz olmayan ürünlere kozmetik firmaya verme bildirimi yapılamaz.
UTS-H340 Sistem işlem paketi alt ürünlerinden bazıları kayıtlı durumda olmadığı için ithalat bildirimi
yapılamaz.
UTS-H341 Sistem işlem paketi alt ürünlerine geri çekme kararı verilmiş olduğu için ithalat bildirimi
yapılamaz.
UTS-H342 Daha önce üretilen aynı lot numaralı sistem işlem paketi ile şuan üretilen sistem işlem
paketinin alt ürünleri aynı olmalıdır.
UTS-H343 Bildirim yapılan ürünün türü kemoterapi cihazı olmalıdır.
UTS-H344 Kemoterapi cihazları faaliyet alanı kemoterapi olmayan firmalara verilemez.
UTS-B001 Bildirim id'si {0} olan yeniden işleme iptal bildirimi yapıldı.
UTS-B002 Bildirim id'si {0} olan ithalat bildirimi yapıldı.
UTS-B003 Bildirim id'si {0} olan ihracat bildirimi yapıldı.
UTS-B004 Bildirim id'si {0} olan kullanım bildirimi yapıldı.
UTS-B005 Bildirim id'si {0} olan geçici kullanıma verme bildirimi yapıldı.
UTS-B006 Bildirim id'si {0} olan alma bildirimi yapıldı.
UTS-B007 Bildirim id'si {0} olan geri çekme alma bildirimi yapıldı.
UTS-B008 Geri çekme alma (paket) 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
228 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-B009 Bildirim id'si {0} olan geçici kullanıma verme iptal bildirimi yapıldı.
UTS-B010 Bildirim id'si {0} olan hastanın vücudundan çıkarma bildirimi yapıldı.
UTS-B011 Bildirim id'si {0} olan 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 Bildirim id'si {0} olan ithalat iptal bildirimi yapıldı.
UTS-B016 Bildirim id'si {0} olan ÜTS'de tanımsız yere verme bildirimi yapıldı.
UTS-B017 Bildirim id'si {0} olan ÜTS'de tanımsız yere verme iptal bildirimi yapıldı.
UTS-B018 Bildirim id'si {0} olan kullanım iptal bildirimi yapıldı.
UTS-B019 Bildirim id'si {0} olan kullanımdan alma bildirimi yapıldı.
UTS-B020 Bildirim id'si {0} olan kullanımdan alma iptal bildirimi yapıldı.
UTS-B021 Bildirim id'si {0} olan tüketiciye vermeyi iptal bildirimi yapıldı.
UTS-B022 Bildirim id'si {0} olan üretim iptal bildirimi yapıldı.
UTS-B023 Bildirim id'si {0} olan tüketiciye verme bildirimi yapıldı.
UTS-B024 Bildirim id'si {0} olan üretim bildirimi yapıldı.
UTS-B025 Bildirim id'si {0} olan verme iptal bildirimi yapıldı.
UTS-B026 Bildirim id'si {0} olan yeniden işleme bildirimi yapıldı.
UTS-B027 Bildirim id'si {0} olan verme bildirimi yapıldı.
UTS-B028 Bildirim id'si {0} olan mahrecine iade etme bildirimi yapıldı.
UTS-B029 Bildirim id'si {0} olan mahrecine iade etme iptal bildirimi yapıldı.
UTS-B030 Bildirim id'si {0} olan HEK/Zayiat bildirimi yapıldı.
UTS-B031 Bildirim id'si {0} olan HEK/Zayiat iptal bildirimi yapıldı.
UTS-B032 Bildirim id'si {0} olan ihracat iptal bildirimi yapıldı.
UTS-B033 Bildirim id'si {0} olan geri çekme verme bildirimi yapıldı.
UTS-B034 Bildirim id'si {0} olan tüketiciden iade alma bildirimi yapıldı.
UTS-B035 Bildirim id'si {0} olan imha/bertaraf bildirimi yapıldı.
UTS-B036 Bildirim id'si {0} olan imha/bertaraf 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
229 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-B037 Bildirim id'si {0} olan ıslah/düzeltici faaliyet bildirimi yapıldı.
UTS-B038 Bildirim id'si {0} olan ıslah/düzeltici faaliyet iptal bildirimi yapıldı.
UTS-B039 Bildirim id'si {0} olan tüketiciden iade alma iptal bildirimi yapıldı.
UTS-B040 Bildirim id'si {0} olan geri çekme verme iptal bildirimi yapıldı.
UTS-B041 Verme (paket) bildirimi yapıldı.
UTS-B042 Ödünç verme (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 Ödünç alma (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ı.
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 Bildirim id'si {0} olan ÜTS'de tanımsız yerden iade alma bildirimi yapıldı.
UTS-B053 Bildirim id'si {0} olan Ü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 Ödünç verme (paket) iptal bildirimi yapıldı.
UTS-B056 Bildirim id'si {0} olan ödünç verme bildirimi yapıldı.
UTS-B057 Bildirim id'si {0} olan ödünç verme iptal bildirimi yapıldı.
UTS-B058 Bildirim id'si {0} olan ö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 Bildirim id'si {0} olan ö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-B064 Kullanım bildiriminin iptal edilememesi sağlanmış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
230 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
UTS-B065 Kullanım bildiriminin iptal edilebilmesi sağlanmıştır.
UTS-B066 Gümrük beyanname bilgisi kaydedildi.
UTS-B067 Gümrük beyanname bilgisi silindi.
UTS-B068 Bildirim id'si {0} olan envanter bildirimi yapıldı.
UTS-B069 Bildirim id'si {0} olan envanter iptal bildirimi yapıldı.
UTS-B070 Seçilen bildirimin görüldü durumu güncellendi.
UTS-B071 Bildirim id'si {0} olan stok bildirimi yapıldı.
UTS-B072 Bildirim id'si {0} olan stok iptal bildirimi yapıldı.
UTS-B073 Listedeki tekil ürünlerin üretim tarihleri {0} tarihinden {1} tarihine güncellendi.
UTS-B074 Bildirim id'si {0} olan verme bildirimi başarıyla {1} olarak işaretlendi.
UTS-B075 Reçete numarası {0} olan tüketiciye verme bildirimi yapıldı.
UTS-B076 Reçete numarası {0} olan tüketiciye verme bildirimi iptal edildi.
UTS-B077 Listedeki tekil ürünlerin son kullanma tarihleri {0} tarihinden {1} tarihine güncellendi.
UTS-B078 Bildirim id'si {0} olan tüketim bildirimi yapıldı.
UTS-B079 Bildirim id'si {0} olan tüketim iptal bildirimi yapıldı.
UTS-B080 Stok yapılabilir tekil ürün bilgisi eklendi.
UTS-B081 Tüketiciye verme bildirimi kesinleştirilerek iptal edilememesi sağlanmıştır.
UTS-B082 Tüketiciye verme bildiriminin kesinleştirilmesi kaldırılarak, bildirimin iptal edilebilmesi
sağlanmıştır.
UTS-B083 Stok yapılabilir tekil ürün başarıyla silindi.
UTS-B084 Bildirim id''si {0} olan kozmetik firmaya verme bildirimi yapıldı.
UTS-B085 Bildirim id''si {0} olan kozmetik firmaya verme 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
231 / 231 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani
TÜBİTAK – BİLGEM – YTE