takİp ve İzleme web servİs tanimlari dokÜmani · tasnİf diŞi tÜbİtak – bİlgem – yte...

208
TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI Revizyon Numarası: 1.80 ÜTS Versiyon 7.19.x ile uyumludur.

Upload: ngominh

Post on 03-Jun-2019

269 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

Revizyon Numarası: 1.80

ÜTS Versiyon 7.19.x ile uyumludur.

Page 2: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

2 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

DEĞİŞİKLİK TARİHÇESİ

Rev. No Yayın Tarihi Yayın Nedeni

1.0.8 07/07/2015 İlk sürüm.

1.0.13 16/02/2016 Adı, aldığı parametreler ve dönüş veri yapısı değişen bildirimler güncellendi.

14/03/2016 Bildirimlerin aldığı parametrelerdeki eksiklikler giderildi.

Paket bildirimleri ve paket ile ilgili diğer servisler eklendi.

1.0.20 01/07/2016 REST adresleri güncellendi.

12/10/2016 Servisler, servis parametreleri ve servis mesajları güncellendi.

08/11/2016 Eksik olan sorgulama servisleri eklendi.

13/12/2016 Sorgulardan Barkod Kuruluşu alanı kaldırıldı. Eksik olan sorgulama servisleri eklendi.

1.0.26 20/12/2016 Medula – ÜTS entegrasyon servisleri eklendi. Eksik olan sorgulama servisleri ve mesajlar eklendi.

1.0.27 27/12/2016 Paket ile ilgili tüm servisler silindi.

1.0.28 09/02/2017 Sistem paketi servisleri eklendi.

1.0.30 15/02/2017 Tekil ürün bilgisi ve eşsiz kimlik ile yapılan alma/iade alma bildirim servisleri eklendi. Sorgulama istek ve cevap alanları güncellendi.

1.0.31 23/03/2017 Her bildirim ve sorgulama için örnek istek yapıları eklendi. Eşsiz kimlik ile yapılan bildirimlerin istek ve cevap alanları eklendi. Geçici verme bildirimi isim değişikliği “ödünç” olarak güncellendi. Medula – ÜTS entegrasyon servisleri çıkarıldı.

1.0.33 24/04/2017 Ödünç geri verme, iptali, ödünç geri alma bildirimi servisleri eklendi, sistem dışına çıkan tekil ürün ve bildirimleri servisi eklendi.

1.0.34 13/06/2017 ÜTS’de tanımsız yere verme ve ÜTS’de tanımsız yere paket verme bildirimlerinde MERSIS yerine VEDOP sorgusu yapılması sonucu değişen veri alanları.

1.0.35 21/09/17 UDI ve eşsiz kimlik alanları açıklamaları düzeltildi, Tüketiciye Verme ve Kullanım bildirimleri kimlik no alanları açıklamaları düzeltildi.

1.0.36 18/10/2017 Farklı kurumların Tüketiciden İade Alma Bildirimi yapabilmesi için gereken veri alanları eklendi, hata mesajları eklendi ve bazı hata mesajlarında güncellemeler yapıldı.

1.0.37 23.11.2017 1) İmha/Bertaraf Bildiriminde zorunlu "İmha/Bertaraf Belge Numarası" alanı eklendi.

2) Ödünç Geri Verme Bildiriminde zorunlu alan olan "Kurum Numarası" (KUN) alanı kaldırıldı.

3) "Tüketiciye Verme İptal Bildirimi" geçen yerler "Tüketiciye Vermeyi İptal Bildirimi" olarak güncellendi.

Page 3: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

3 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

4) Tüketiciye Verme Bildirimine zorunlu tarih alanı "Tüketiciye Verme Tarihi" eklendi,

Kullanım Bildirimine zorunlu tarih alanı "Kullanım Tarihi" eklendi,

Ödünç Verme Bildirimine zorunlu tarih alanı "Ödünç Verme Tarihi" eklendi,

Geçici Kullanıma Verme Bildirimine zorunlu tarih alanı "Geçici Kullanıma Verme Tarihi" eklendi,

Hastanın Vücudundan Çıkarma Bildirimine zorunlu tarih alanı "Hastanın Vücudundan Çıkarma Tarihi" eklendi,

Bu tarihlerin ortak JSON adı "GIT" (Gerçek İşlem Tarihi).

5) Üretim ve İthalat Bildirimlerine zorunlu olmayan “Gönüllü Takip Kapsamı” (GTK) alanı eklendi.

6) Askıdaki tekil ürünleri sorgularına “Alan Kurum Unvan” (AKU), “Marka Model Etiket Adı” (MME) eklendi. Kabul edilecek tekil ürün sorgularına “Gönderen Kurum Unvan” (GKU), “Marka Model Etiket Adı” (MME) eklendi. Tekil ürün sorgularına “Marka Model Etiket Adı” (MME) eklendi. Bildirim sorgularına “Bildiren Kurum Unvan” (BKU), “Diğer Kurum Unvan” (DKU), “Marka Model Etiket Adı” (MME) eklendi. 4. maddede eklenen “Gerçek İşlem Tarihi” (GIT), gerekli sorgulara da eklendi. Gerekli sorgulara “Üretici İthalatçı Kurum No” (UIK) eklendi.

7) Sisteme eklenen uyarı mesajları dokümana eklendi.

1.0.51 18/12/2017 Ürün Sorgulama servisi eklendi.

04/01/2018 1) Kullanım bildirimine “Kişi Tanımlayıcı Numara”, “Kişi Kimlik Bilgisi Açıklama Türü”

ve “Kişi Kimlik Bilgisi Diğer Tür Açıklaması” alanları eklendi.

2) Geçici kullanımına verme bildirimine “Kişi Tanımlayıcı Numara”, “Kişi Kimlik Bilgisi

Açıklama Türü” ve “Kişi Kimlik Bilgisi Diğer Tür Açıklaması” alanları eklendi.

3) Tüketiciye verme bildirimine “Kişi Tanımlayıcı Numara”, “Kişi Kimlik Bilgisi Açıklama

Türü” ve “Kişi Kimlik Bilgisi Diğer Tür Açıklaması” alanları eklendi.

4) Hastanın vücudundan çıkarma bildirimine “Kişi Tanımlayıcı Numara”, “Kişi Kimlik

Bilgisi Açıklama Türü” ve “Kişi Kimlik Bilgisi Diğer Tür Açıklaması” alanları eklendi.

1.0.56 09/02/2018 Tekil ürünün TİTUBB’da kaydının olup olmadığını sorgulayan servis eklendi.

1.0.57 02/05/2018 Bazı sorgulama servislerine, yeni sorgulama yapısı eklendi (Offset ile sorgulama).

Lot takipte kullanım bildiriminin 1 adetten fazla yapılamaması eklendi.

Paket servisleri güncellendi.

Yeni takip yapısına geçildi. Üretim ve İthalat bildirimi yaparken seri ve lot numarası

girilmesine göre takip kapsamı belirleniyor.

1.0.58 Ürün tanım servisleri eklendi.

1.0.59 26.06.2018 İthalat bildirimi servisinden, gümrük beyanname parametresi zorunluluğu kaldırıldı.

1.0.64 30.07.2018 Envanter bildirimi servis bilgileri eklendi, hata ve bilgi mesajları güncellendi.

1.0.68 30.09.2018 Stok bildirimi servis bilgileri eklendi, hata ve bilgi mesajları güncellendi.

Bildirim ve tekil ürün detay sorgulama servisi eklendi.

1.0.69 03.10.2018 Bütün Ürünleri Sorgulama Servisi’nin adresi güncellendi.

Page 4: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

4 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

1.0.70 27.10.2018 Stok bildiriminde Stok Tarihi “STT”, Üretim Tarihi “URT” olarak güncellendi.

1.0.72 31.10.2018 Stok bildiriminde Üretim Tarihi alanı zorunlu olarak güncellendi.

Verme Bildirimi Veri Alanlarına Gerçek İşlem Tarihi eklendi ve örnek istek güncellendi.

UTS-H171: Verilen tekil ürün bilgilerine uyan birden fazla bildirim bulundu hatası ile

ilgili istek ve cevap örneği eklendi.

1.0.74 08.11.2018 Kullanım bildiriminde TUA, TUS olan tüketici parametreleri HAA, HAS olarak

güncellendi. Hata mesajları güncellendi.

1.0.75 04.12.2018 UTS-H171: Verilen tekil ürün bilgilerine uyan birden fazla bildirim bulundu hatası ile

ilgili istek ve cevap örneği güncellendi. Cevap örneğine BNO parametresi ile belge

numarası eklendi.

1.0.76 11.12.2018 Hasta/Tüketici bilgileri girişi sırasında seçilen Kimlik Bilgisi Açıklama Türü alanına

YUPASS Numarası Var seçeneği eklendi.

1.0.78 20.12.2018 Bütün Ürünleri Sorgulama Servisi ürün bilgisi dönüş değerlerine “Takip Durumu”

eklendi.

1.0.79 24.12.2018 Eksik alma bildirimini görüntüleme ve güncelleme ile ilgili dokümantasyon eklendi.

1.0.80 10.01.2019 Tekil ürün bilgilerini girerek Kabul Edilecek Tekil Ürünleri sorgulayan servis adresi, istek

ve cevap alanları eklendi.

Page 5: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

5 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

İÇİNDEKİLER

1 GİRİŞ ........................................................................................................................................................ 18

1.1 AMAÇ ........................................................................................................................................................ 18

1.2 KAPSAM ................................................................................................................................................... 18

1.3 TERİMLER VE KISALTMALAR ................................................................................................................ 18

2 WEB SERVİSLERİN GENEL YAPISI ...................................................................................................... 19

2.1 ÜTS’NİN DİĞER BİLGİ SİSTEMLERİ İLE ENTEGRASYONU ................................................................. 19

3 WEB SERVİSLER .................................................................................................................................... 20

3.1 HAREKET BİLDİRİM SERVİSLERİ .......................................................................................................... 20

3.1.1.1 Üretim Bildirimi Servis Adresi.................................................................................................................... 20

3.1.1.2 Üretim Bildirimi Veri Alanları ..................................................................................................................... 20

3.1.1.3 Üretim Bildirimi Örnek İstek ...................................................................................................................... 22

3.1.2.1 İthalat Bildirimi Servis Adresi .................................................................................................................... 23

3.1.2.2 İthalat Bildirimi Veri Alanları ...................................................................................................................... 23

3.1.2.3 İthalat Bildirimi Örnek İstek ....................................................................................................................... 25

3.1.3.1 Verme Bildirimi Servis Adresi.................................................................................................................... 27

3.1.3.2 Verme Bildirimi Örnek İstek ...................................................................................................................... 28

3.1.3.3 Eşsiz Kimlik Bilgisi İle Verme Bildirimi Servis Adresi ................................................................................ 29

3.1.3.4 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları .................................................................................. 29

3.1.3.5 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Örnek İstek ................................................................................... 30

3.1.4.1 Alma Bildirimi Servis Adresi ...................................................................................................................... 30

3.1.4.2 Alma Bildirimi Veri Alanları........................................................................................................................ 30

3.1.4.3 Alma Bildirimi Örnek İstek ......................................................................................................................... 32

3.1.4.4 Eşsiz Kimlik Bilgisi İle Alma Bildirimi Servis Adresi .................................................................................. 33

3.1.4.5 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları .................................................................................... 33

3.1.4.6 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Örnek İstek ..................................................................................... 34

3.1.5.1 ÜTS’de Tanımsız Yere Verme Bildirimi Servis Adresi .............................................................................. 34

3.1.5.2 ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ............................................................................... 34

3.1.5.3 ÜTS’de Tanımsız Yere Verme Bildirimi Örnek İstek ................................................................................. 35

3.1.5.4 Eşsiz Kimlik Bilgisi İle ÜTS’de Tanımsız Yere Verme Bildirimi Servis Adresi .......................................... 36

3.1.5.5 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ............................................ 36

3.1.5.6 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Örnek İstek ............................................. 37

3.1.6.1 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Servis Adresi .................................................................... 37

3.1.1 ÜRETİM BİLDİRİMİ ........................................................................................................................................ 20

3.1.2 İTHALAT BİLDİRİMİ........................................................................................................................................ 23

3.1.3 VERME BİLDİRİMİ ......................................................................................................................................... 27

3.1.4 ALMA BİLDİRİMİ ........................................................................................................................................... 30

3.1.5 ÜTS’DE TANIMSIZ YERE VERME BİLDİRİMİ .................................................................................................... 34

3.1.6 ÜTS’DE TANIMSIZ YERDEN İADE ALMA BİLDİRİMİ .......................................................................................... 37

Page 6: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

6 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.6.2 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları ...................................................................... 37

3.1.6.3 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Örnek İstek ....................................................................... 39

3.1.6.4 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Servis Adresi ................................. 39

3.1.6.5 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları .................................. 39

3.1.6.6 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Örnek İstek .................................... 40

3.1.7.1 Kullanım Bildirimi Servis Adresi ................................................................................................................ 40

3.1.7.2 Kullanım Bildirimi Veri Alanları .................................................................................................................. 40

3.1.7.3 Kullanım Bildirimi Örnek İstek ................................................................................................................... 42

3.1.7.4 Eşsiz Kimlik Bilgisi İle Kullanım Bildirimi Servis Adresi ............................................................................ 43

3.1.7.5 Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları .............................................................................. 43

3.1.7.6 Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Örnek İstek ............................................................................... 44

3.1.8.1 Tüketiciye Verme Bildirimi Servis Adresi .................................................................................................. 45

3.1.8.2 Tüketiciye Verme Bildirimi Veri Alanları .................................................................................................... 45

3.1.8.3 Tüketiciye Verme Bildirimi Örnek İstek ..................................................................................................... 47

3.1.8.4 Eşsiz Kimlik Bilgisi İle Tüketiciye Verme Bildirimi Bildirimi Servis Adresi ................................................. 47

3.1.8.5 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Bildirimi Veri Alanları ................................................... 47

3.1.8.6 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Örnek İstek .................................................................. 49

3.1.9.1 Tüketiciden İade Alma Bildirimi Servis Adresi .......................................................................................... 50

3.1.9.2 Tüketiciden İade Alma Bildirimi Veri Alanları ............................................................................................ 50

3.1.9.3 Tüketiciden İade Alma Bildirimi Örnek İstek ............................................................................................. 51

3.1.9.4 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Servis Adresi ....................................................... 52

3.1.9.5 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları......................................................... 52

3.1.9.6 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Örnek İstek .......................................................... 53

3.1.10.1 Geçici Kullanıma Verme Bildirimi Servis Adresi ....................................................................................... 53

3.1.10.2 Geçici Kullanıma Verme Bildirimi Veri Alanları ......................................................................................... 53

3.1.10.3 Geçici Kullanıma Verme Bildirimi Örnek İstek .......................................................................................... 55

3.1.10.4 Eşsiz Kimlik Bilgisi İle Geçici Kullanıma Verme Bildirimi Servis Adresi .................................................... 55

3.1.10.5 Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları ..................................................... 56

3.1.10.6 Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Örnek İstek ....................................................... 57

3.1.11.1 Kullanımdan Alma Bildirimi Servis Adresi ................................................................................................. 58

3.1.11.2 Kullanımdan Alma Bildirimi Veri Alanları .................................................................................................. 58

3.1.11.3 Kullanımdan Alma Bildirimi Örnek İstek .................................................................................................... 59

3.1.11.4 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Servis Adresi ............................................................. 59

3.1.11.5 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları ............................................................... 59

3.1.7 KULLANIM BİLDİRİMİ ..................................................................................................................................... 40

3.1.8 TÜKETİCİYE VERME BİLDİRİMİ....................................................................................................................... 45

3.1.9 TÜKETİCİDEN İADE ALMA BİLDİRİMİ ............................................................................................................... 50

3.1.10 GEÇİCİ KULLANIMA VERME BİLDİRİMİ ............................................................................................................ 53

3.1.11 KULLANIMDAN ALMA BİLDİRİMİ ..................................................................................................................... 57

Page 7: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

7 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.11.6 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Örnek İstek ................................................................ 60

3.1.12.1 Yeniden İşleme Bildirimi Servis Adresi ..................................................................................................... 60

3.1.12.2 Yeniden İşleme Bildirimi Veri Alanları ....................................................................................................... 60

3.1.12.3 Yeniden İşleme Bildirimi Örnek İstek ........................................................................................................ 61

3.1.12.4 Eşsiz Kimlik Bilgisi İle Yeniden İşleme Bildirimi Servis Adresi .................................................................. 61

3.1.12.5 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları ................................................................... 61

3.1.12.6 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Örnek İstek ..................................................................... 62

3.1.13.1 İhracat Bildirimi Servis Adresi ................................................................................................................... 62

3.1.13.2 İhracat Bildirimi Veri Alanları ..................................................................................................................... 62

3.1.13.3 İhracat Bildirimi Örnek İstek ...................................................................................................................... 63

3.1.13.4 Eşsiz Kimlik Bilgisi İle İhracat Bildirimi Servis Adresi ............................................................................... 63

3.1.13.5 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları ................................................................................. 63

3.1.13.6 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Örnek İstek .................................................................................. 64

3.1.14.1 Mahrecine İade Etme Bildirimi Servis Adresi ............................................................................................ 64

3.1.14.2 Mahrecine İade Etme Bildirimi Veri Alanları ............................................................................................. 65

3.1.14.3 Mahrecine İade Etme Bildirimi Örnek İstek ............................................................................................... 65

3.1.14.4 Eşsiz Kimlik Bilgisi İle Mahrecine İade Etme Bildirimi Servis Adresi ........................................................ 65

3.1.14.5 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları .......................................................... 65

3.1.14.6 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Örnek İstek ........................................................... 66

3.1.15.1 HEK / Zayiat Bildirimi Servis Adresi .......................................................................................................... 66

3.1.15.2 HEK / Zayiat Bildirimi Veri Alanları ........................................................................................................... 66

3.1.15.3 HEK / Zayiat Bildirimi Örnek İstek ............................................................................................................. 67

3.1.15.4 Eşsiz Kimlik Bilgisi İle HEK / Zayiat Bildirimi Servis Adresi ...................................................................... 68

3.1.15.5 Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları ........................................................................ 68

3.1.15.6 Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Örnek İstek ......................................................................... 68

3.1.16.1 Geri Çekme Verme Bildirimi Servis Adresi ............................................................................................... 69

3.1.16.2 Geri Çekme Verme Bildirimi Veri Alanları ................................................................................................. 69

3.1.16.3 Geri Çekme Verme Bildirimi Örnek İstek .................................................................................................. 69

3.1.16.4 Eşsiz Kimlik Bilgisi İle Geri Çekme Verme Bildirimi Servis Adresi ............................................................ 70

3.1.16.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları ............................................................. 70

3.1.16.6 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Örnek İstek............................................................... 70

3.1.17.1 Geri Çekme Alma Bildirimi Servis Adresi .................................................................................................. 71

3.1.17.2 Geri Çekme Alma Bildirimi Veri Alanları ................................................................................................... 71

3.1.12 YENİDEN İŞLEME BİLDİRİMİ ........................................................................................................................... 60

3.1.13 İHRACAT BİLDİRİMİ ....................................................................................................................................... 62

3.1.14 MAHRECİNE İADE ETME BİLDİRİMİ................................................................................................................. 64

3.1.15 HEK / ZAYİAT BİLDİRİMİ ............................................................................................................................... 66

3.1.16 GERİ ÇEKME VERME BİLDİRİMİ ..................................................................................................................... 69

3.1.17 GERİ ÇEKME ALMA BİLDİRİMİ ....................................................................................................................... 70

Page 8: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

8 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.17.3 Geri Çekme Alma Bildirimi Örnek İstek .................................................................................................... 72

3.1.17.4 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Servis Adresi .............................................................. 73

3.1.17.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları ................................................................ 73

3.1.17.3 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Örnek İstek ................................................................. 73

3.1.18.1 Islah / Düzeltici Faaliyet Bildirimi Servis Adresi ........................................................................................ 74

3.1.18.2 Islah / Düzeltici Faaliyet Bildirimi Veri Alanları .......................................................................................... 74

3.1.18.3 Islah / Düzeltici Faaliyet Bildirimi Örnek İstek ........................................................................................... 74

3.1.18.4 Eşsiz Kimlik Bilgisi İle Islah / Düzeltici Faaliyet Bildirimi Servis Adresi .................................................... 75

3.1.18.5 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları ...................................................... 75

3.1.18.6 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Örnek İstek........................................................ 75

3.1.19.1 İmha / Bertaraf Bildirimi Servis Adresi ...................................................................................................... 75

3.1.19.2 İmha / Bertaraf Bildirimi Veri Alanları ........................................................................................................ 76

3.1.19.3 İmha / Bertaraf Bildirimi Örnek İstek ......................................................................................................... 77

3.1.19.4 Eşsiz Kimlik Bilgisi İle İmha / Bertaraf Bildirimi Servis Adresi ................................................................... 77

3.1.19.5 Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları .................................................................... 77

3.1.19.6 Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Örnek İstek ...................................................................... 78

3.1.20.1 Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi ............................................................................ 79

3.1.20.2 Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları ............................................................................. 79

3.1.20.3 Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek .............................................................................. 81

3.1.20.4 Eşsiz Kimlik Bilgisi İle Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi ........................................ 81

3.1.20.5 Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları .......................................... 81

3.1.20.6 Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek ........................................... 83

3.1.21.1 Ödünç Verme Bildirimi Servis Adresi ........................................................................................................ 84

3.1.21.2 Ödünç Verme Bildirimi Veri Alanları ......................................................................................................... 84

3.1.21.3 Ödünç Verme Bildirimi Örnek İstek ........................................................................................................... 84

3.1.21.4 Eşsiz Kimlik Bilgisi İle Ödünç Verme Bildirimi Servis Adresi .................................................................... 85

3.1.21.5 Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Veri Alanları ...................................................................... 85

3.1.21.6 Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Örnek İstek ....................................................................... 85

3.1.22.1 Ödünç Alma Bildirimi Servis Adresi .......................................................................................................... 86

3.1.22.2 Ödünç Alma Bildirimi Veri Alanları ............................................................................................................ 86

3.1.22.3 Ödünç Alma Bildirimi Örnek İstek ............................................................................................................. 87

3.1.22.4 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Servis Adresi ....................................................................... 87

3.1.22.5 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Veri Alanları ........................................................................ 87

3.1.22.6 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Örnek İstek .......................................................................... 88

3.1.18 ISLAH / DÜZELTİCİ FAALİYET BİLDİRİMİ .......................................................................................................... 74

3.1.19 İMHA / BERTARAF BİLDİRİMİ .......................................................................................................................... 75

3.1.20 HASTANIN VÜCUDUNDAN ÇIKARMA BİLDİRİMİ ................................................................................................ 79

3.1.21 ÖDÜNÇ VERME BİLDİRİMİ ............................................................................................................................. 84

3.1.22 ÖDÜNÇ ALMA BİLDİRİMİ ............................................................................................................................... 86

Page 9: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

9 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.23.1 Ödünç Geri Verme Bildirimi Servis Adresi ................................................................................................ 88

3.1.23.2 Ödünç Geri Verme Bildirimi Veri Alanları .................................................................................................. 89

3.1.23.3 Ödünç Geri Verme Bildirimi Örnek İstek ................................................................................................... 89

3.1.23.4 Eşsiz Kimlik Bilgisi İle Ödünç Geri Verme Bildirimi Servis Adresi ............................................................ 89

3.1.23.5 Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Veri Alanları .............................................................. 89

3.1.23.6 Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Örnek İstek ............................................................... 90

3.1.24.1 Ödünç Geri Alma Bildirimi Servis Adresi .................................................................................................. 90

3.1.24.2 Ödünç Geri Alma Bildirimi Veri Alanları .................................................................................................... 90

3.1.24.3 Ödünç Geri Alma Bildirimi Örnek İstek ..................................................................................................... 92

3.1.24.4 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Servis Adresi ............................................................... 92

3.1.24.5 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Veri Alanları ................................................................. 92

3.1.24.6 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Örnek İstek .................................................................. 93

3.1.25.1 Envanter Bildirimi Servis Adresi ................................................................................................................ 93

3.1.25.2 Envanter Bildirimi Veri Alanları ................................................................................................................. 93

3.1.25.3 Envanter Bildirimi Örnek İstek .................................................................................................................. 94

3.1.26.1 Stok Bildirimi Servis Adresi ....................................................................................................................... 94

3.1.26.2 Stok Bildirimi Veri Alanları......................................................................................................................... 94

3.1.26.3 Stok Bildirimi Örnek İstek .......................................................................................................................... 95

3.2 İPTAL BİLDİRİMLERİ ............................................................................................................................... 96

3.2.1.1 İptal Bildirimi Veri Alanları ......................................................................................................................... 98

3.2.1.2 İptal Bildirimleri Örnek İstek ...................................................................................................................... 98

3.3 BİLDİRİM CEVABI .................................................................................................................................... 98

3.4 SORGULAMA SERVİSLERİ ..................................................................................................................... 99

3.4.1.1 Tekil Ürün Sorgula Servis Adresi .............................................................................................................. 99

3.4.1.2 Tekil Ürün Sorgula İstek Veri Alanları ....................................................................................................... 99

3.4.1.3 Tekil Ürün Sorgula Cevap Veri Alanları .................................................................................................. 100

3.4.1.4 Tekil Ürün Sorgula Örnek İstek ............................................................................................................... 102

3.4.1.5 Eşsiz Kimlik Bilgisi ile Tekil Ürün Sorgula Servis Adresi ........................................................................ 102

3.4.1.6 Eşsiz Kimlik İle Tekil Ürün Sorgula İstek Veri Alanları ............................................................................ 102

3.4.1.7 Eşsiz Kimlik İle Tekil Ürün Sorgula Örnek İstek ..................................................................................... 102

3.4.2.1 Üretici/İthalatçı Tekil Ürün Sorgula Servis Adresi ................................................................................... 102

3.1.23 ÖDÜNÇ GERİ VERME BİLDİRİMİ .................................................................................................................... 88

3.1.24 ÖDÜNÇ GERİ ALMA BİLDİRİMİ ....................................................................................................................... 90

3.1.25 ENVANTER BİLDİRİMİ ................................................................................................................................... 93

3.1.26 STOK BİLDİRİMİ ........................................................................................................................................... 94

3.2.1 İPTAL BİLDİRİMLERİ SERVİS ADRESLERİ ........................................................................................................ 96

3.3.1 BİLDİRİM CEVABI VERİ ALANLARI .................................................................................................................. 98

3.4.1 TEKİL ÜRÜN SORGULA ................................................................................................................................. 99

3.4.2 ÜRETİCİ/İTHALATÇI TEKİL ÜRÜN SORGULA .................................................................................................. 102

Page 10: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

10 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.2.2 Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları ............................................................................ 103

3.4.2.3 Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları ......................................................................... 103

3.4.2.4 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek ...................................................................................... 105

3.4.3.1 Üretici/İthalatçı Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ................................... 105

3.4.3.2 Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ............................ 105

3.4.3.3 Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ......................... 106

3.4.3.4 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ........................... 108

3.4.3.5 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) ..................................... 108

3.4.4.1 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Servis Adresi ............................................ 109

3.4.4.2 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları ..................................... 109

3.4.4.3 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları .................................. 109

3.4.4.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek ............................................... 113

3.4.5.1 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi

ile) 113

3.4.5.2 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi

ile) 113

3.4.5.3 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi

ile) 114

3.4.5.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi ADT)

ile) 117

3.4.5.5 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF)

ile) 118

3.4.6.1 Askıdaki Tekil Ürün Sorgula Servis Adresi ............................................................................................. 118

3.4.6.2 Askıdaki Tekil Ürün Sorgula İstek Veri Alanları ...................................................................................... 118

3.4.6.3 Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları ................................................................................... 119

3.4.6.4 Askıdaki Tekil Ürün Sorgula Örnek İstek ................................................................................................ 121

3.4.7.1 Askıdaki Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ............................................. 121

3.4.7.2 Askıdaki Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ...................................... 121

3.4.7.3 Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ................................... 122

3.4.7.4 Askıdaki Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ..................................... 123

3.4.7.5 Askıdaki Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) ............................................... 124

3.4.8.1 Ödünç Alınan Tekil Ürün Sorgula Servis Adresi ..................................................................................... 124

3.4.8.2 Ödünç Alınan Tekil Ürün Sorgula İstek Veri Alanları .............................................................................. 124

3.4.3 ÜRETİCİ/İTHALATÇI TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) ................................................ 105

3.4.4 ÜRETİCİ/İTHALATÇI SİSTEMİN DIŞINA ÇIKMIŞ TEKİL ÜRÜN SORGULA ............................................................ 109

3.4.5 ÜRETİCİ/İTHALATÇI SİSTEMİN DIŞINA ÇIKMIŞ TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .......... 113

3.4.6 ASKIDAKİ TEKİL ÜRÜN SORGULA ................................................................................................................ 118

3.4.7 ASKIDAKİ TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .............................................................. 121

3.4.8 ÖDÜNÇ ALINAN TEKİL ÜRÜN SORGULA ....................................................................................................... 124

Page 11: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

11 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.8.3 Ödünç Alınan Tekil Ürün Sorgula Cevap Veri Alanları ........................................................................... 125

3.4.8.4 Ödünç Alınan Tekil Ürün Sorgula Örnek İstek ........................................................................................ 127

3.4.9.1 Bildirim Sorgula Servis Adresi ................................................................................................................ 127

3.4.9.2 Bildirim Sorgula İstek Veri Alanları ......................................................................................................... 127

3.4.9.3 Bildirim Sorgula Cevap Veri Alanları ....................................................................................................... 128

3.4.9.4 Bildirim Sorgula Örnek İstek ................................................................................................................... 132

3.4.10.1 Bildirim Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ................................................................. 132

3.4.10.2 Bildirim Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile).......................................................... 132

3.4.10.3 Bildirim Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ....................................................... 133

3.4.10.4 Bildirim Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ......................................................... 137

3.4.10.5 Bildirim Sorgula Örnek İstek (Offset Parametresi (OFF) ile) .................................................................. 138

3.4.11.1 Kabul Edilecek Tekil Ürün Sorgula Servis Adresi ................................................................................... 138

3.4.11.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları ............................................................................ 138

3.4.11.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları ......................................................................... 138

3.4.11.4 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek ...................................................................................... 140

3.4.12.1 Kabul Edilecek Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ................................... 140

3.4.12.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ............................ 141

3.4.12.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ......................... 141

3.4.12.4 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile) ........................... 143

3.4.12.5 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) ..................................... 143

3.4.13.1 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Servis Adresi ................................................ 144

3.4.13.2 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları ......................................... 144

3.4.13.3 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları ...................................... 144

3.4.13.4 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Örnek İstek ve Cevap ................................... 146

3.4.14.1 Ödünç Alınacak Tekil Ürün Sorgula Servis Adresi ................................................................................. 147

3.4.14.2 Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları .......................................................................... 147

3.4.14.3 Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları ....................................................................... 148

3.4.14.4 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek .................................................................................... 150

3.4.15.1 Ödünç Alınacak Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ................................. 150

3.4.15.2 Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) .......................... 150

3.4.15.3 Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)........................ 151

3.4.15.4 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile).......................... 153

3.4.9 BİLDİRİM SORGULA .................................................................................................................................... 127

3.4.10 BİLDİRİM SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .................................................................................. 132

3.4.11 KABUL EDİLECEK TEKİL ÜRÜN SORGULA .................................................................................................... 138

3.4.12 KABUL EDİLECEK TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) .................................................. 140

3.4.13 TEKİL ÜRÜN BİLGİLERİ İLE KABUL EDİLECEK TEKİL ÜRÜN SORGULA ............................................................. 144

3.4.14 ÖDÜNÇ ALINACAK TEKİL ÜRÜN SORGULA ................................................................................................... 147

3.4.15 ÖDÜNÇ ALINACAK TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) ................................................. 150

Page 12: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

12 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.15.5 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) ................................... 153

3.4.16.1 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Servis Adresi ............................................................ 154

3.4.16.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları ..................................................... 154

3.4.16.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları .................................................. 154

3.4.16.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula ................................................................................... 156

3.4.17.1 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile) ............ 156

3.4.17.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ..... 156

3.4.17.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)... 157

3.4.17.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula (Kayıt Sayısı Parametresi (ADT) ile) ........................ 159

3.4.17.5 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile) .............. 159

3.4.18.1 Tekil Ürünün Kaynağını Sorgula Servis Adresi....................................................................................... 159

3.4.18.2 Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları ............................................................................... 159

3.4.18.3 Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları ............................................................................. 160

3.4.18.4 Tekil Ürünün Kaynağını Sorgula Örnek İstek ......................................................................................... 161

3.4.19.1 Bildirim ve Tekil Ürün Detay Sorgula Servis Adresi ................................................................................ 161

3.4.19.2 Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları ......................................................................... 161

3.4.19.3 Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları ...................................................................... 161

3.4.19.4 Bildirim ve Tekil Ürün Detay Sorgula Örnek İstek................................................................................... 169

3.4.19.5 Bildirim ve Tekil Ürün Detay Sorgula Örnek Cevap ................................................................................ 169

3.4.20.1 Eksik Alma Bildirimlerini Görüntüle ......................................................................................................... 170

3.4.20.2 Eksik Alma Bildiriminin Görülme Durumunu Güncelle ............................................................................ 173

3.5 PAKET TRANSFER SİSTEMİ (PTS) SERVİSLERİ ................................................................................ 174

3.5.1.1 Paket Ekle Servis Adresi ......................................................................................................................... 174

3.5.1.2 Paket Ekle İstek Veri Alanları.................................................................................................................. 174

3.5.1.3 Paket Ekle Cevap Veri Alanları ............................................................................................................... 175

3.5.1.4 Paket Ekle Örnek İstek ........................................................................................................................... 176

3.5.2.1 Paket Sil Servis Adresi ............................................................................................................................ 177

3.5.2.2 Paket Sil İstek Veri Alanları..................................................................................................................... 177

3.5.2.3 Paket Sil Cevap Veri Alanları .................................................................................................................. 177

3.5.2.4 Paket Sil Örnek İstek .............................................................................................................................. 178

3.5.3.1 Paket Getir Servis Adresi ........................................................................................................................ 178

3.4.16 KABUL EDİLECEK GERİ ÇEKİLMİŞ TEKİL ÜRÜN SORGULA ............................................................................. 154

3.4.17 KABUL EDİLECEK GERİ ÇEKİLMİŞ TEKİL ÜRÜN SORGULA (KAYIT SAYISI PARAMETRESİ İLE) ........................... 156

3.4.18 TEKİL ÜRÜNÜN KAYNAĞINI SORGULA ......................................................................................................... 159

3.4.19 BİLDİRİM VE TEKİL ÜRÜN DETAY SORGULA ................................................................................................. 161

3.4.20 EKSİK ALMA BİLDİRİMİ ............................................................................................................................... 170

3.5.1 PAKET EKLE .............................................................................................................................................. 174

3.5.2 PAKET SİL ................................................................................................................................................. 177

3.5.3 PAKET GETİR ............................................................................................................................................ 178

Page 13: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

13 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.5.3.2 Paket Getir İstek Veri Alanları ................................................................................................................. 178

3.5.3.3 Paket Getir Cevap Veri Alanları .............................................................................................................. 179

3.5.3.4 Paket Getir Örnek İstek ........................................................................................................................... 180

3.5.4.1 Kuruma Gelen Paketi Okundu İşaretle Servis Adresi ............................................................................. 180

3.5.4.2 Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları ...................................................................... 180

3.5.4.3 Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları ................................................................... 181

3.5.4.4 Kuruma Gelen Paketi Okundu İşaretle Örnek İstek ................................................................................ 181

3.5.5.1 Kuruma Gelen Paketi Getir Servis Adresi ............................................................................................... 182

3.5.5.2 Kuruma Gelen Paketi Getir İstek Veri Alanları........................................................................................ 182

3.5.5.3 Kuruma Gelen Paketi Getir Cevap Veri Alanları ..................................................................................... 182

3.5.5.4 Kuruma Gelen Paketi Getir Örnek İstek ................................................................................................. 183

3.5.6.1 Kuruma Gelen Paketleri Sorgula Servis Adresi ...................................................................................... 183

3.5.6.2 Kuruma Gelen Paketleri Sorgula İstek Veri Alanları ............................................................................... 184

3.5.6.3 Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları ............................................................................ 184

3.5.6.4 Kuruma Gelen Paketleri Sorgula Örnek İstek ......................................................................................... 185

3.6 FİRMA SORGULAMA SERVİSİ .............................................................................................................. 186

3.7 ÜRÜN SORGULAMA SERVİSİ .............................................................................................................. 187

3.8 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİSİ ......................................................................................... 192

4 EKLER .................................................................................................................................................... 196

4.1 EK-A SERVİS MESAJLARI .................................................................................................................... 196

3.5.4 KURUMA GELEN PAKETİ OKUNDU İŞARETLE................................................................................................ 180

3.5.5 KURUMA GELEN PAKETİ GETİR .................................................................................................................. 182

3.5.6 KURUMA GELEN PAKETLERİ SORGULA ....................................................................................................... 183

3.6.1 FİRMA SORGULAMA SERVİS ADRESİ ........................................................................................................... 186

3.6.2 FİRMA SORGULAMA SERVİSİ VERİ ALANLARI ............................................................................................... 186

3.6.3 ÜRÜN SORGULAMA SERVİSİ ÖRNEK İSTEK .................................................................................................. 187

3.7.1 ÜRÜN SORGULAMA SERVİS ADRESİ ............................................................................................................ 188

3.7.2 ÜRÜN SORGULAMA SERVİSİ VERİ ALANLARI ............................................................................................... 188

3.7.3 ÜRÜN SORGULAMA SERVİSİ ÖRNEK İSTEK .................................................................................................. 191

3.8.1 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİS ADRESİ .......................................................................................... 192

3.8.2 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİSİ VERİ ALANLARI .............................................................................. 192

3.8.3 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİSİ ÖRNEK İSTEK ................................................................................ 194

Page 14: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

14 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

TABLOLAR

Tablo 1. Üretim Bildirimi Veri Alanları ...................................................................................................................... 20

Tablo 2. İthalat Bildirimi Veri Alanları....................................................................................................................... 23

Tablo 3. Verme Bildirimi Veri Alanları ...................................................................................................................... 27

Tablo 4. Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları .................................................................................. 29

Tablo 5. Alma Bildirimi Veri Alanları ........................................................................................................................ 30

Tablo 6. Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları ..................................................................................... 33

Tablo 7 . ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ............................................................................... 34

Tablo 8. Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları ............................................. 36

Tablo 9 .ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları ...................................................................... 37

Tablo 10. Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları ................................. 39

Tablo 11.Kullanım Bildirimi Veri Alanları ................................................................................................................. 40

Tablo 12. Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları ............................................................................. 43

Tablo 13 .Tüketiciye Verme Bildirimi Veri Alanları .................................................................................................. 45

Tablo 14. Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Veri Alanları ............................................................... 48

Tablo 15 .Tüketiciden İade Alma Bildirimi Veri Alanları........................................................................................... 50

Tablo 16. Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları ....................................................... 52

Tablo 17 . Geçici Kullanıma Verme Bildirimi Veri Alanları ...................................................................................... 53

Tablo 18. Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları .................................................... 56

Tablo 19 . Kullanımdan Alma Bildirimi Veri Alanları ................................................................................................ 58

Tablo 20 . Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları............................................................. 59

Tablo 21. Yeniden İşleme Bildirimi Veri Alanları ..................................................................................................... 60

Tablo 22. Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları .................................................................. 61

Tablo 23 . İhracat Bildirimi Veri Alanları .................................................................................................................. 62

Tablo 24. Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları ................................................................................ 63

Tablo 25 . Mahrecine İade Etme Bildirimi Veri Alanları ........................................................................................... 65

Tablo 26. Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları ........................................................ 65

Tablo 27 .HEK / Zayiat Bildirimi Veri Alanları .......................................................................................................... 66

Tablo 28. Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları ....................................................................... 68

Tablo 29. Geri Çekme Verme Bildirimi Veri Alanları ............................................................................................... 69

Tablo 30. Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları ............................................................ 70

Tablo 31. Geri Çekme Alma Bildirimi Veri Alanları .................................................................................................. 71

Tablo 32. Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları .............................................................. 73

Tablo 33 .Islah / Düzeltici Faaliyet Bildirimi Veri Alanları ........................................................................................ 74

Tablo 34. Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları ..................................................... 75

Tablo 35 . İmha / Bertaraf Bildirimi Veri Alanları ..................................................................................................... 76

Tablo 36. Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları ................................................................... 77

Tablo 37 . Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları ........................................................................... 79

Tablo 38. Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları ........................................ 81

Page 15: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

15 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Tablo 39 . Ödünç Verme Bildirimi Veri Alanları ....................................................................................................... 84

Tablo 40. Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Veri Alanları ..................................................................... 85

Tablo 41. Ödünç Alma Bildirimi Veri Alanları .......................................................................................................... 86

Tablo 42. Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Veri Alanları ....................................................................... 87

Tablo 43. Ödünç Geri Verme Bildirimi Veri Alanları ................................................................................................ 89

Tablo 44. Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Veri Alanları ............................................................. 89

Tablo 45. Ödünç Geri Alma Bildirimi Veri Alanları ................................................................................................... 90

Tablo 46. Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Veri Alanları ............................................................... 92

Tablo 47. Envanter Bildirimi Veri Alanları ................................................................................................................ 93

Tablo 48. Stok Bildirimi Veri Alanları ....................................................................................................................... 94

Tablo 49. İptal Bildirimleri Servis Adresleri .............................................................................................................. 96

Tablo 50. İptal Bildirimi Veri Alanları........................................................................................................................ 98

Tablo 51. Bildirim Cevabı Veri Alanları .................................................................................................................... 98

Tablo 52. Tekil Ürün Sorgula İstek Veri Alanları ..................................................................................................... 99

Tablo 53. Tekil Ürün Sorgula Cevap Veri Alanları ................................................................................................. 100

Tablo 54. Eşsiz Kimlik ile Tekil Ürün Sorgula İstek Veri Alanları .......................................................................... 102

Tablo 55. Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları .......................................................................... 103

Tablo 56. Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları ........................................................................ 103

Tablo 57. Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) .......................... 105

Tablo 58. Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ........................ 106

Tablo 59. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları .................................... 109

Tablo 60. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları ................................. 109

Tablo 61. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi

ile) .......................................................................................................................................................................... 113

Tablo 62. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi

ile) .......................................................................................................................................................................... 114

Tablo 63. Askıdaki Tekil Ürün Sorgula İstek Veri Alanları ..................................................................................... 118

Tablo 64. Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları .................................................................................. 119

Tablo 65. Askıdaki Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ..................................... 121

Tablo 66. Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) .................................. 122

Tablo 67. Ödünç Alınan Tekil Ürün Sorgula İstek Veri Alanları ........................................................................... 124

Tablo 68. Ödünç Alınan Tekil Ürün Sorgula Cevap Veri Alanları .......................................................................... 125

Tablo 69. Bildirim Sorgula İstek Veri Alanları ........................................................................................................ 127

Tablo 70. Bildirim Sorgula Cevap Veri Alanları ..................................................................................................... 128

Tablo 71. Bildirim Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ........................................................ 132

Tablo 72. Bildirim Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ..................................................... 133

Tablo 73. Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları .......................................................................... 138

Tablo 74. Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları ........................................................................ 138

Tablo 75. Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) .......................... 141

Page 16: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

16 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Tablo 76. Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ........................ 141

Tablo 77. Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları ........................................ 144

Tablo 78. Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları .................................... 145

Tablo 79. Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları ......................................................................... 147

Tablo 80. Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları ...................................................................... 148

Tablo 81. Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) ......................... 150

Tablo 82. Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) ...................... 151

Tablo 83. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları .................................................... 154

Tablo 84. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları ................................................. 154

Tablo 85. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile) .... 156

Tablo 86. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile) . 157

Tablo 87. Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları .............................................................................. 159

Tablo 88. Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları ........................................................................... 160

Tablo 89. Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları ....................................................................... 161

Tablo 90. Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları .................................................................... 161

Tablo 91. Eksik Alma Bildirimlerini Görüntüle İstek Veri Alanları .......................................................................... 170

Tablo 92. Eksik Alma Bildirimi Sorgula Cevap Veri Alanları ................................................................................. 170

Tablo 93. Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Veri Alanları .................................................. 173

Tablo 94. Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Cevap Veri Alanları ...................................... 173

Tablo 95. Paket Ekle İstek Veri Alanları ................................................................................................................ 174

Tablo 96. Paket Ekle Cevap Veri Alanları ............................................................................................................. 175

Tablo 97. Paket Sil İstek Veri Alanları ................................................................................................................... 177

Tablo 98. Paket Sil Cevap Veri Alanları ................................................................................................................ 177

Tablo 99. Paket Getir İstek Veri Alanları ............................................................................................................... 178

Tablo 100. Paket Getir Cevap Veri Alanları .......................................................................................................... 179

Tablo 101. Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları .................................................................. 180

Tablo 102. Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları ................................................................ 181

Tablo 103. Kuruma Gelen Paketi Getir İstek Veri Alanları .................................................................................... 182

Tablo 104. Kuruma Gelen Paketi Getir Cevap Veri Alanları ................................................................................ 182

Tablo 105. Kuruma Gelen Paketleri Sorgula İstek Veri Alanları ........................................................................... 184

Tablo 106. Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları ......................................................................... 184

Tablo 107. Firma Sorgulama Servisi İstek Veri Alanları ........................................................................................ 186

Tablo 108. Firma Sorgulama Servisi Sonuç Veri Alanları ..................................................................................... 186

Tablo 109. Ürün Sorgulama Servisi İstek Veri Alanları ......................................................................................... 188

Tablo 110. Ürün Sorgulama Servisi Sonuç Veri Alanları....................................................................................... 188

Tablo 111. Ürün Sorgulama Servisi Ürün Sonuç Veri Alanları .............................................................................. 188

Tablo 112. Bütün Ürünleri Sorgulama Servisi İstek Veri Alanları .......................................................................... 193

Tablo 113. Bütün Ürünleri Sorgulama Servisi Sonuç Veri Alanları ....................................................................... 193

Tablo 114. Bütün Ürünleri Sorgulama Servisi Ürün Sonuç Veri Alanları .............................................................. 193

Page 17: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

17 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Tablo 115. Servis Mesajları ................................................................................................................................... 196

Page 18: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

18 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

1 GİRİŞ

1.1 AMAÇ

Kurumlar ve firmalar hareket bildirimlerini yapabilmek için ÜTS tarafından sağlanacak web servislerini veya ÜTS

web ara yüzünü kullanabilecektir. ÜTS web servislerini kullanabilmek için kurumların ve firmaların bilgi sistemlerinin

entegrasyonlarını web servis tanımlarına göre ÜTS ile sağlamaları gereklidir. Bu dokümanın amacı ÜTS’nin

sağlayacağı web servisleri kullanmak isteyen kurum veya firmaların ihtiyaç duyacakları bilgileri sunmaktır.

1.2 KAPSAM

Bu dokümanda tekil ürünlerin hem normal hareketleri hem de geri çekme kapsamındaki hareketleri için kullanılan

servisler tanımlanmıştır. Kurum veya firmalar bu servisleri kullanarak tekil ürünün sahipliği, miktarı veya kullanım

sayısındaki değişimleri bildirebilecektir.

Dokümanda her bir servisin amacı kısaca açıklanmış; servisin erişim adresi, servisi çağırmak için gerekli

parametreler ve servisin döndüğü cevabın veri yapısı tanımlanmıştır.

1.3 TERİMLER VE KISALTMALAR

Terim / Kısaltma Tanım

BİLGEM Bilişim ve Bilgi Güvenliği İleri Teknolojiler Araştırma Merkezi

Hareket Bildirimi Her bir tekil ürünün veya lot/parti/batch’in bir hareketi için yapılan bildirimdir. Her

hareket bildirimi ÜTS tarafından önceden belirlenmiş bir formata sahiptir.

İdare TİTCK

JSON JavaScript Object Notation

REST Representational State Transfer

Sistem Ürün Takip Sistemi

Tekil Ürün Ürünlerin her bir tekil birimidir. Örneğin; her bir tansiyon ölçme aleti veya her bir

parfüm şişesi bir tekil üründür.

TİTCK T.C. Sağlık Bakanlığı Türkiye İlaç ve Tıbbi Cihaz Kurumu

TÜBİTAK Türkiye Bilimsel ve Teknolojik Araştırma Kurumu

MERSİS Merkezi Sicil Kayıt Sistemi

UDI Unique Device Identification

URL Uniform Resource Locator

Ürün Kurumların ve firmaların ÜTS’de kayıtlı tıbbi cihaz ve kozmetik ürünlerinin her

biridir.

ÜTS Ürün Takip Sistemi

Page 19: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

19 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Terim / Kısaltma Tanım

YTE Yazılım Teknolojileri Araştırma Enstitüsü

2 WEB SERVİSLERİN GENEL YAPISI

2.1 ÜTS’NİN DİĞER BİLGİ SİSTEMLERİ İLE ENTEGRASYONU

ÜTS’nin kullanıcılara sunduğu bütün işlevler standart REST servisleri şeklindedir. Bu işlevler, ÜTS tarafından

sağlanan kullanıcı arayüzleri aracılığıyla kullanılabileceği gibi, başka bilgi sistemlerinin entegrasyonuna da açıktır.

Kullanıcıların kendi bilgi sistemlerini ÜTS’ye entegre etmek için öncelikle ÜTS arayüzlerini kullanarak entegrasyon

anahtarı almaları gerekmektedir. Entegrasyon anahtarı e-imza kullanılarak üretilen bir koddur. Bu kod sistem

token’ı olarak adlandırılmaktadır. Sistem token’ının amacı, ÜTS’ye bildirim göndermek isteyen bilgi sistemlerinin

kimliğini doğrulamak ve yetkilerinin sınırlarını belirlemektir.

Kullanıcı bilgi sistemi, sistem token’ını aldıktan sonra, yapacağı her web servis çağrısının başlık (header) kısmına

utsToken etiketiyle sistem token’ının değerini eklemelidir. Aksi halde, yani sistem token’ının utsToken etiketiyle

REST çağrısının başlık kısmına eklenmediği durumlarda, ÜTS yetki hatası verir ve işlemi tamamlamaz.

Kullanıcılar kendi bilgi sistemlerini ÜTS’ye entegre etmek için kullanacakları sistem token’ını aşağıdaki adımları

izleyerek alabilirler (Bu adımları yapacak olan kullanıcılar, firmalarında / kurumlarında imza yetkilisi rolüne sahip

olmalıdırlar. Kullanıcıların imza yetkilisi rolüne sahip olup olmadığı MERSİS'ten otomatik olarak sorgulanmaktadır.).

1. Yetkili kullanıcı grubundaki bir kullanıcı ile “https://utsuygulama.saglik.gov.tr1” adresinden ÜTS’ye giriş

yapılır. Kullanıcı gerekirse “Hesap Değiştir” bağlantısını kullanarak işlem yapmak istediği kurum / firma ile

ilgili hesaba geçiş yapmalıdır.

2. Kullanıcı, menüden “Kullanıcı Sistem Kullanıcısı Tanımlama İşlemleri” seçeneğini seçer.

3. Kullanıcı, karşısına gelen ekrandaki metni e-imza kullanarak imzalar.

4. ÜTS kullanıcıya sistem token’ı üretir ve kullanıcı bu token’ı kendi bilgi sistemine kopyalar.

NOT: Web servislerin tamamında HTTP request method olarak “POST” metodu kullanılmaktadır.

1 Ürün Hareketleri ve Ürün Geri Çağırma Modülleri ÜTS’nin test ortamında da (https://utstest.saglik.gov.tr) hizmet

vermektedir. Firmalar, deneme yapmak amacıyla test ortamını da kullanabilirler. Test ortamındaki veriler gerçek

ortama aktarılmayacaktır.

Page 20: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

20 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3 WEB SERVİSLER

3.1 HAREKET BİLDİRİM SERVİSLERİ

Tekil ürün hareketleri bakımından değerlendirildiğinde ÜTS, kapalı bir sistemdir. Tekil ürünler Üretim veya İthalat

bildirimiyle beraber Sistem (ÜTS) içerisinde yer almaya başlar. Tekil ürün, Verme ve Alma bildirimleriyle Sistem’de

tanımlı kurumlar/firmalar arasında el değiştirmiş olur. ÜTS’de tanımlı olmayan bir kurum/firmaya tekil ürün

verildiğinde ÜTS’de “Tanımsız Yere Verme Bildirimi” kullanılır. Tekil ürün bu bildirimle beraber Sistem’in dışına

çıkmış olur. Hasta veya tüketiciye ücreti karşılığında veya ücretsiz olarak verilen tekil ürünler için “Tüketiciye Verme

Bildirimi” kullanılır. Tekil ürün “Tüketiciye Verme Bildirimi”yle de Sistem’in dışına çıkmış olur.

Hakkında geri çekme kararı olan tekil ürünlerin hareketleri kısıtlanabilmektedir. Hareketi kısıtlanan tekil ürünler için

özelleşmiş servisler tanımlanmıştır.

Her bir bildirim ayrı bir bölümde açıklanmıştır. Bildirimin çağırılacağı servis adresi ve servis çağırımı ile beraber

gönderilmesi gereken alanlar belirtilmiştir.

Tüm hareket bildirimleri sonucunda servisin döndürdüğü veri yapıları ortaktır. Bu veri yapısı 3.2.1.2 numaralı başlık

altında açıklanmıştır.

3.1.1 Üretim Bildirimi

Üretici, ürettiği tekil ürünlerin her biri için bir Üretim Bildirimi yapar.

3.1.1.1 Üretim Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/uretim/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/uretim/ekle

3.1.1.2 Üretim Bildirimi Veri Alanları

Tablo 1. Üretim Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot takip edilmesi istenen tekil ürünler

için gereklidir.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil takip edilmesi istenen tekil ürünler

için gereklidir.

Page 21: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

21 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Üretim Tarihi URT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay, G: Gün.

Son Kullanma

Tarihi SKT Tarih 13 Hayır

YYYY-AA-GG SS formatındadır. Y: Yıl,

A: Ay, G: Gün, S: Saat.

GS1 ürünler için saat verilmez.

HIBCC ürünlerin özelliğine göre saat ve

gün alanları verilmeyebilir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane üretim

yapıldığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Eşsiz Kimlik UDI Metin - Koşullu

Unique Device Identifier (UDI) ya da

Karekod olarak da bilinen tekil ürünün

Eşsiz Kimliği mevcut ise verilebilir.

Sistem İşlem

Paketi SIP

Liste

(BRK, UNO,

LNO, SNO,

ADT)

- Koşullu

Tekil ürünün sistem işlem paketi olması

ve içinde en az bir tane takip

kapsamında ürün olması durumunda

verilmesi zorunludur.

Liste içinde verilen bilgiler alt tekil

ürünlerin bilgileridir.

Kozmetik Ürün

Seti KUS

Liste

(BRK, UNO,

LNO, SNO,

ADT)

- Koşullu

Tekil ürünün kozmetik ürün seti olması

ve içinde en az bir tane takip

kapsamında ürün olması durumunda

verilmesi zorunludur.

Liste içinde verilen bilgiler alt tekil

ürünlerin bilgileridir.

Page 22: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

22 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Gönüllü Takip

Kapsamı GTK

Tek Seçimli

Liste 5 Hayır

Herhangi bir takip konfigürasyonu

bulunmayan ürünlerin, firmalar

tarafından gönüllü takip edilebilmesi için

gerekli alandır.

Aşağıdaki değerlerden birini alabilir.

TEKIL

LOT

3.1.1.3 Üretim Bildirimi Örnek İstek

Örnek 1 lot takip edilen ürün:

{

"UNO" : "1111111110324",

"LNO" : "250515186001",

"ADT" : 100,

"UDI" : "011111111110324111603021719030210250515186001",

"URT" : "2016-03-02",

"SKT" : "2019-03-02"

}

Örnek 2 tekil takip edilen ürün:

{

"UNO" : "1111111110010",

"SNO" : "KYY012345678999",

"UDI" : "011111111110010111603021719030221KYY012345678999",

"URT" : "2016-03-02",

"SKT" : "2019-03-02"

}

NOT: Tekil takip edilen ürünlerde “ADT” bilgisi “1” girilmelidir veya o alan girilmemelidir.

Örnek 3 tekil takip edilen sistem işlem paketi:

{

"UNO" : "9321502013475",

"SNO" : "112212345678MM9",

"UDI" : "019321502013475111603021719030221112212345678MM9",

"ADT" : 1,

"URT" : "2016-03-02",

Page 23: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

23 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"SKT" : "2019-03-02",

"SIP" : [

{

"UNO" : "2451643000038",

"SNO" : "B8NN12345678999"

},

{

"UNO" : "2451643000007",

"LNO" : "250515186001",

"ADT" : 10

}

]

}

Örnek 4 takip konfigürasyonu bulunmayan tekil ürünü gönüllü tekil bazda takip ederek üretim yapılması:

{

"UNO" : "1111111110010",

"SNO" : "KYY012345678999",

"UDI" : "011111111110010111603021719030221KYY012345678999",

"URT" : "2016-03-02",

"SKT" : "2019-03-02",

"GTK" : "TEKIL"

}

3.1.2 İthalat Bildirimi

İthalatçı, ithal ettiği tekil ürünler için İthalat Bildirimi yapar.

3.1.2.1 İthalat Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ithalat/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ithalat/ekle

3.1.2.2 İthalat Bildirimi Veri Alanları

Tablo 2. İthalat Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Page 24: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

24 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot takip edilmesi istenen tekil ürünler

için gereklidir.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil takip edilmesi istenen tekil ürünler

için gereklidir.

Üretim Tarihi URT Tarih 10 Evet

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

Kozmetik ürünler için ithalat tarihi

verilmişse üretim tarihi verilemeyebilir.

Son Kullanma

Tarihi SKT Tarih 13 Hayır

YYYY-AA-GG SS formatındadır. Y: Yıl,

A: Ay, G: Gün ve S saati ifade

etmektedir.

GS1 ürünler için saat verilmez.

HIBCC ürünlerin özelliğine göre saat ve

gün alanları verilmeyebilir.

İthalat Tarihi ITT Tarih 10 Koşullu

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

Kozmetik ürünler için üretim tarihinin

bilinmediği durumda ithalat tarihi

verilmelidir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane ithal

edildiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Eşsiz Kimlik UDI Metin - Koşullu

Unique Device Identifier (UDI) ya da

Karekod olarak da bilinen tekil ürünün

Eşsiz Kimliği mevcut ise verilebilir.

İthal Edildiği

Ülke IEU Sayı 3 Evet Ülke kodudur. *

Page 25: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

25 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Menşei Ülke MEU Sayı 3 Evet Ülke kodudur. *

Gümrük

Beyanname

Numarası

GBN Metin 16 Hayır -

Sistem İşlem

Paketi SIP

Liste

(BRK, UNO,

LNO, SNO,

ADT)

- Koşullu

Tekil ürünün sistem işlem paketi olması

ve içinde en az bir tane takip

kapsamında ürün olması durumunda

verilmesi zorunludur.

Liste içinde verilen bilgiler alt tekil

ürünlerin bilgileridir.

Kozmetik Ürün

Seti KUS

Liste

(BRK, UNO,

LNO, SNO,

ADT)

- Koşullu

Tekil ürünün kozmetik ürün seti olması

ve içinde en az bir tane takip

kapsamında ürün olması durumunda

verilmesi zorunludur.

Liste içinde verilen bilgiler alt tekil

ürünlerin bilgileridir.

Gönüllü Takip

Kapsamı GTK

Tek Seçimli

Liste 5 Hayır

Herhangi bir takip konfigürasyonu

bulunmayan ürünlerin, firmalar

tarafından gönüllü takip edilebilmesi için

gerekli alandır.

Aşağıdaki değerlerden birini alabilir.

TEKIL

LOT

* Risk Yönetimi ve Kontrol Genel Müdürlüğü’nün yayınladığı kodlar kullanılmaktadır.

3.1.2.3 İthalat Bildirimi Örnek İstek

Örnek 1 lot takip edilen ürün:

{

"UNO" : "1111111110058",

Page 26: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

26 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"LNO" : "250515186001",

"ADT" : 100,

"UDI" : "011111111110058111603021719030210250515186001",

"URT" : "2016-03-02",

"SKT" : "2019-03-02",

"IEU" : "038",

"MEU" : "452",

"GBN" : "15343100IM003176"

}

Örnek 2 tekil takip edilen ürün:

{

"UNO" : "1111111110065",

"SNO" : "KYY012345678999",

"UDI" : "011111111110065111603021719030221KYY012345678999",

"URT" : "2016-03-02",

"SKT" : "2019-03-02",

"IEU" : "716",

"MEU" : "082",

"GBN" : "15343100IM003176"

}

NOT: Tekil takip edilen ürünlerde “ADT” bilgisi “1” girilmelidir veya o alan girilmemelidir.

Örnek 3 tekil takip edilen sistem işlem paketi:

{

"UNO" : "851479856540",

"SNO" : "112212345678MM9",

"UDI" : "01851479856540111603021719030221112212345678MM9",

"ADT" : 1,

"URT" : "2016-03-02",

"SKT" : "2019-03-02",

"IEU" : "400",

"MEU" : "400",

"GBN" : "15343100IM003176",

"SIP" : [

{

"UNO" : "1111111110065",

"SNO" : "KYY012345678999"

Page 27: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

27 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

},

{

"UNO" : "1111111110058",

"LNO" : "250515186001",

"ADT" : 1

}

]

}

Örnek 4 takip konfigürasyonu bulunmayan tekil ürünü gönüllü tekil bazda takip ederek ithalat yapılması:

{

"UNO" : "1111111110065",

"SNO" : "KYY012345678999",

"UDI" : "011111111110065111603021719030221KYY012345678999",

"URT" : "2016-03-02",

"SKT" : "2019-03-02",

"IEU" : "716",

"MEU" : "082",

"GBN" : "15343100IM003176",

"GTK" : "TEKIL"

}

3.1.3 Verme Bildirimi

Kurum/firma kullanıcısı sahip olduğu tekil ürünlerini başka bir kurum/firmaya verdiğinde Verme Bildirimi yapar.

Satış, hibe, iade vb. yöntemler için Verme Bildirimi yapılır.

3.1.3.1 Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/ekle

Tablo 3. Verme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Page 28: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

28 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

verildiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Kurum No KUN Sayı - Evet Tekil ürünün verildiği kurum/firmanın

ÜTS’de tanımlı numarasıdır.

Bedelsiz

Numune BEN

Tek Seçimli

Liste 5 Hayır

Verilen tekil ürünlerin bedelsiz numune

olup olmadığını ifade etmektedir.

Aşağıdaki değerleri alabilir. Varsayılan

değeri HAYIR’dır.

EVET: Evet

HAYIR: Hayır

Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.

Gerçek İşlem

Tarihi GIT Tarih 10 Hayır

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

Boş bırakıldığında default olarak

bildirimin yapıldığı tarih alınır.

3.1.3.2 Verme Bildirimi Örnek İstek

{

"UNO" : "2451643000007",

"LNO" : "250515186001",

"ADT" : 25,

Page 29: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

29 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"KUN" : 7,

"BEN" : "HAYIR",

"BNO" : "123B",

"GIT" : "2018-10-31"

}

3.1.3.3 Eşsiz Kimlik Bilgisi İle Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/ekle/essizKimlik

3.1.3.4 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları

Tablo 4. Eşsiz Kimlik Bilgisi ile Verme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Unique Device Identifier (UDI) ya da

Karekod olarak da bilinen Tekil ürün

eşsiz kimliği (Unique Device Identifier)

ile bildirim yapılmak istendiğinde

verilmesi gerekmektedir.

Adet ADT Sayı - Hayır

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

alındığını ifade etmektedir.

Verilen miktardan daha az sayıda tekil

ürün alındığı durumda kullanılır.

Varsayılan değeri verme bildirimindeki

adet bilgisidir.

Kurum No KUN Sayı - Evet Tekil ürünün verildiği kurum/firmanın

ÜTS’de tanımlı numarasıdır.

Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.

Page 30: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

30 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.3.5 Eşsiz Kimlik Bilgisi ile Verme Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”,

"KUN" : 7,

"ADT" : 5,

"BNO": "123"

}

3.1.4 Alma Bildirimi

Kurum/firma kendisine verilen tekil ürünleri kabul etmek için Alma Bildirimi yapar. Bu bildirimle beraber tekil ürünün

sahipliği alıcı tarafa geçmiş olur.

3.1.4.1 Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/alma/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/alma/ekle

3.1.4.2 Alma Bildirimi Veri Alanları

Tablo 5. Alma Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Verme Bildirim

ID VBI Sayı - Koşullu

Hangi verme bildirimine karşılık olarak

alım yapıldığını ifade eder.

Adet ADT Sayı - Hayır

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

alındığını ifade etmektedir.

Verilen miktardan daha az sayıda tekil

ürün alındığı durumda kullanılır.

Varsayılan değeri verme bildirimindeki

adet bilgisidir.

Page 31: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

31 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Gönderen

Kurum

Numarası

GKK Sayı - Koşullu

Bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Bir kurumda aynı tekil ürün bilgilerine

sahip tekil ürünler için farklı

kurumlardan verme bildirimi yapılmışsa,

hangi kurumdan gelen verme bildirimine

alma bildirimi yapılmak istendiğini

belirtmek için gereklidir.

Eşsiz Kimlik UDI Metin - Koşullu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Ürün Numarası UNO Metin 23 Koşullu

Ürünün ürün numarası/barkod

numarasıdır.

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası verilmelidir.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Page 32: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

32 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.4.3 Alma Bildirimi Örnek İstek

Örnek 1 verme bildirimi ID ile yapılan alma bildirimi isteği:

{

"VBI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29",

"ADT" : 15

}

Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan alma bildirimi isteği:

{

"UNO" : "1111111110324",

"LNO" : "250515186001",

"ADT" : 5,

“GKK" : 10

}

Örnek 3: Verilen tekil ürün bilgilerine uyan birden fazla bildirim bulundu hatası ile ilgili örnek durum:

Alma Bildirimi İsteği:

{

"UNO":"1111111110010",

"LNO":"lot1",

“ADT”: 20

}

Birden Fazla Verme Bildirimi İçeren Alma Bildirimi Cevabı:

{

"MSJ": [{

"MET": "Verilen Tekil Ürün bilgilerine uyan birden fazla bildirim bulundu!",

"KOD": "UTS-H171",

"TIP": "HATA",

"MPA": [],

}],

"VBB": [{

"VBI": "96be8de1-f7d7-11e8-a3a9-f783d4ccac99",

"ADT": 20,

"GKK": 10,

"TRH": "2018-12-04",

"BNO": "B20LOT1"

},

{

"VBI": "a68b5aa1-f7d7-11e8-a3a9-f783d4ccac99",

"ADT": 20,

Page 33: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

33 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"GKK": 10,

"TRH": "2018-12-04",

"BNO": "B10LOT1"

}

],

}

Bildirim İdsi (VBI) Bir Önceki Cevabın VBB Listesinden Alınan İkinci Alma Bildirimi İsteği:

{

"UNO":"1111111110010",

"LNO":"lot1",

"ADT": 20,

"VBI": "96be8de1-f7d7-11e8-a3a9-f783d4ccac99"

}

İkinci Alma Bildirimi Cevabı:

{

"SNC": "15713f21-f7d8-11e8-a3a9-f783d4ccac99",

"MSJ": [

{

"MET": "Bildirim id'si 15713f21-f7d8-11e8-a3a9-f783d4ccac99 olan alma bildirimi yapıldı.",

"KOD": "UTS-B006",

"TIP": "BILGI",

"MPA": ["15713f21-f7d8-11e8-a3a9-f783d4ccac99"],

}],

}

3.1.4.4 Eşsiz Kimlik Bilgisi İle Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/alma/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/alma/ekle/essizKimlik

3.1.4.5 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları

Tablo 6. Eşsiz Kimlik Bilgisi ile Alma Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Page 34: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

34 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Adet ADT Sayı - Hayır

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

alındığını ifade etmektedir.

Verilen miktardan daha az sayıda tekil

ürün alındığı durumda kullanılır.

Varsayılan değeri verme bildirimindeki

adet bilgisidir.

Gönderen

Kurum

Numarası

GKK Sayı - Hayır

Bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Bir kuruma aynı eşsiz kimlikli tekil ürün

için farklı kurumlardan verme bildirimi

yapılmışsa, hangi kurumdan gelen

verme bildirmine alma bildirimi yapılmak

istendiğini belirtmek için gereklidir.

3.1.4.6 Eşsiz Kimlik Bilgisi ile Alma Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”,

"ADT" : 5,

"GKK" : 10

}

3.1.5 ÜTS’de Tanımsız Yere Verme Bildirimi

Kurum/firma ÜTS'de tanımlı olmayan bir firmaya tekil ürün verdiğinde ÜTS’de Tanımsız Yere Verme Bildirimi yapar.

3.1.5.1 ÜTS’de Tanımsız Yere Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/ekle

3.1.5.2 ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları

Tablo 7 . ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları

Page 35: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

35 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

verildiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Bedelsiz

Numune BEN

Tek Seçimli

Liste 5 Hayır

Verilen tekil ürünlerin bedelsiz numune

olup olmadığını ifade etmektedir.

Aşağıdaki değerleri alabilir. Varsayılan

değeri HAYIR’dır.

EVET: Evet

HAYIR: Hayır

Vergi Kimlik No VKN Sayı - Evet ÜTS’de kayıtlı olmayan firmanın vergi

kimlik numarası girilmesi zorunludur.

Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.

3.1.5.3 ÜTS’de Tanımsız Yere Verme Bildirimi Örnek İstek

{

"UNO" : "1111111110058",

"LNO" : "250515186001",

"ADT" : 25,

"VKN" : "1234567890",

"BNO" : "123B",

"BEN" : "HAYIR"

}

Page 36: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

36 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.5.4 Eşsiz Kimlik Bilgisi İle ÜTS’de Tanımsız Yere Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/ekle/essizKimlik

3.1.5.5 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları

Tablo 8. Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

verildiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Bedelsiz

Numune BEN

Tek Seçimli

Liste 5 Hayır

Verilen tekil ürünlerin bedelsiz numune

olup olmadığını ifade etmektedir.

Aşağıdaki değerleri alabilir. Varsayılan

değeri HAYIR’dır.

EVET: Evet

HAYIR: Hayır

Vergi Kimlik No VKN Sayı - Evet ÜTS’de kayıtlı olmayan firmanın vergi

kimlik numarası girilmesi zorunludur.

MERSİS No MEN Sayı - Koşullu

Tekil ürünün MERSİS’te tanımlı bir

firmaya verilmesi durumunda

verilmelidir.

T.C. Kimlik No TKN Sayı - Koşullu

Tekil ürünün ESBİS’te tanımlı bir

firmaya verilmesi durumunda

verilmelidir.

Page 37: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

37 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Meslek Kodu MEK Sayı - Koşullu

Tekil ürünün ESBİS’te tanımlı bir

firmaya verilmesi durumunda

verilmelidir.

Oda Kodu ODK Sayı - Koşullu

Tekil ürünün ESBİS’te tanımlı bir

firmaya verilmesi durumunda

verilmelidir.

Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.

3.1.5.6 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yere Verme Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”,

"ADT" : 5,

"VKN" : "1234567890",

"BNO" : "123B",

"BEN" : "HAYIR"

}

3.1.6 ÜTS’de Tanımsız Yerden İade Alma Bildirimi

Kurum/firma ÜTS'de tanımlı olmayan bir firmaya verdiği tekil ürünlerini iade aldığında ÜTS’de Tanımsız Yerden

İade Alma Bildirimi yapar.

3.1.6.1 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/ekle

3.1.6.2 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları

Tablo 9 .ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları

Page 38: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

38 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

ÜTS’de

Tanımsız Yere

Verme Bildirim

ID

UTI Sayı - Koşullu

ÜTS’de tanımsız yerden iade alma

bildiriminin hangi ÜTS’de tanımsız yere

verme bildirimi için yapıldığını ifade

eder.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

verildiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Eşsiz Kimlik UDI Metin - Koşullu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Ürün Numarası UNO Metin 23 Koşullu

Ürünün ürün numarası/barkod

numarasıdır.

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

iade alma yapılmak istendiğinde ürün

numarası verilmelidir.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

iade alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Page 39: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

39 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

iade alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

3.1.6.3 ÜTS’de Tanımsız Yerden İade Alma Bildirimi Örnek İstek

Örnek 1 ÜTS’de tanımsız yere verme bildirim ID ile yapılan ÜTS’de tanımsız yerden iade alma bildirimi isteği:

{

"UTI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29",

"ADT" : 15

}

Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan ÜTS’de tanımsız yerden iade alma bildirimi isteği:

{

"UNO" : "1111111110324",

"LNO" : "250515186001",

"ADT" : 5

}

3.1.6.4 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Servis Adresi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/ekle/essizKimlik

3.1.6.5 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları

Tablo 10. Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Veri Alanları

Page 40: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

40 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Hayır

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

alındığını ifade etmektedir.

Verilen miktardan daha az sayıda tekil

ürün alındığı durumda kullanılır.

Varsayılan değeri verme bildirimindeki

adet bilgisidir.

3.1.6.6 Eşsiz Kimlik Bilgisi ile ÜTS’de Tanımsız Yerden İade Alma Bildirimi Örnek İstek

{

"UDI" : "0151022222233336111603021719030210A213B1211234",

"ADT" : 5

}

3.1.7 Kullanım Bildirimi

Sağlık kuruluşu/uygulama tesisi tekil ürünü hasta/tüketiciye kullandığında Kullanım Bildirimi yapar.

3.1.7.1 Kullanım Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/ekle

3.1.7.2 Kullanım Bildirimi Veri Alanları

Tablo 11.Kullanım Bildirimi Veri Alanları

Page 41: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

41 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip ve lot takip edilen tekil

ürünler için 1 olarak verilir. Adet

verilmezse 1 olarak kabul edilir.

Hasta Adı HAA Metin 50 Koşullu Kullanırken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

Hasta Soyadı HAS Metin 50 Koşullu Kullanırken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

T.C. Kimlik No TKN Sayı - Koşullu

Kullanırken kimlik numarası gerekli ise

ve Türkiye Cumhuriyeti vatandaşına

kullanılması durumunda verilir. (Takip

konfigürasyonu var ise)

Yabancı Kimlik

No YKN Sayı - Koşullu

Kullanırken kimlik numarası gerekli ise

ve yabancı kimlik numarası sahibi

hastaya kullanılması durumunda verilir.

(Takip konfigürasyonu var ise)

Pasaport No PAN Metin 20 Koşullu

Kullanırken kimlik numarası gerekli ise

ve yabancı kimlik numarası olmayan

yabancı hastaya kullanılması

durumunda verilir. (Takip

konfigürasyonu var ise)

Kullanım Tarihi GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

Page 42: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

42 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Kişi Tanımlayıcı

Numara KTN Sayı - Koşullu

Kullanırken kimlik numarası gerekli ise

ve kişinin T.C..Kimlik No, Yabancı

Kimlik No ya da pasaport numarası

bilinmiyorsa kişiyi tanımlayan bir

numara verilir. (Takip konfigürasyonu

var ise)

Kişi Kimlik Bilgisi

Açıklama Türü TUR

Tek Seçimli

Liste - Koşullu

Kullanırken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

Aşağıdaki değerlerden birini alabilir.

TC_KIMLIK_NUMARASI_VAR

YABANCI_KIMLIK_NUMARASI_VAR

PASAPORT_NUMARASI_VAR

YUPASS_NUMARASI_VAR

YENI_DOGAN

KIMLIGI_BELIRSIZ

DIGER

Kişi Kimlik Bilgisi

Diğer Tür

Açıklaması

DTA Metin 50 Koşullu

Kişi Kimlik Bilgisi Açıklama Türü alanı

değerinin DIGER olması durumunda bu

alan zorunludur.

Serbest metin şeklinde açıklama türü

tanımlanır.

3.1.7.3 Kullanım Bildirimi Örnek İstek

{

"UNO" : "1111111110010",

"SNO" : "KYY012345678999",

"GIT" : "2017-11-22",

"TKN" : "11223344678",

"HAA" : "Ali",

"HAS" : "Yılmaz",

“TUR” : “TC_KIMLIK_NUMARASI_VAR”

}

Page 43: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

43 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.7.4 Eşsiz Kimlik Bilgisi İle Kullanım Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/ekle/essizKimlik

3.1.7.5 Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları

Tablo 12. Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Koşullu

Tekil takip ve lot takip edilen tekil

ürünler için 1 olarak verilir. Adet

verilmezse 1 olarak kabul edilir.

Hasta Adı HAA Metin 50 Koşullu Kullanırken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

Hasta Soyadı HAS Metin 50 Koşullu Kullanırken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

T.C. Kimlik No TKN Sayı - Koşullu

Kullanırken kimlik numarası gerekli ise

ve Türkiye Cumhuriyeti vatandaşına

kullanılması durumunda verilir. (Takip

konfigürasyonu var ise)

Yabancı Kimlik

No YKN Sayı - Koşullu

Kullanırken kimlik numarası gerekli ise

ve yabancı kimlik numarası sahibi

hastaya kullanılması durumunda verilir.

(Takip konfigürasyonu var ise)

Pasaport No PAN Metin 20 Koşullu

Kullanırken kimlik numarası gerekli ise

ve yabancı kimlik numarası olmayan

yabancı hastaya kullanılması

durumunda verilir. (Takip

konfigürasyonu var ise)

Page 44: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

44 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Kullanım Tarihi GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

Kişi Tanımlayıcı

Numara KTN Sayı - Koşullu

Kullanırken kimlik numarası gerekli ise

ve kişinin T.C..Kimlik No, Yabancı

Kimlik No ya da pasaport numarası

bilinmiyorsa kişiyi tanımlayan bir

numara verilir. (Takip konfigürasyonu

var ise)

Kişi Kimlik Bilgisi

Açıklama Türü TUR

Tek Seçimli

Liste - Koşullu

Kullanırken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

Aşağıdaki değerlerden birini alabilir.

TC_KIMLIK_NUMARASI_VAR

YABANCI_KIMLIK_NUMARASI_VAR

PASAPORT_NUMARASI_VAR

YUPASS_NUMARASI_VAR

YENI_DOGAN

KIMLIGI_BELIRSIZ

DIGER

Kişi Kimlik Bilgisi

Diğer Tür

Açıklaması

DTA Metin 50 Koşullu

Kişi Kimlik Bilgisi Açıklama Türü alanı

değerinin DIGER olması durumunda bu

alan zorunludur.

Serbest metin şeklinde açıklama türü

tanımlanır.

3.1.7.6 Eşsiz Kimlik Bilgisi ile Kullanım Bildirimi Örnek İstek

{

"UDI" : "0151022222233336111603021719030210A213B1211234",

"GIT" : "2017-11-22",

"TKN" : "11223344678",

"HAA" : "Ali",

"HAS" : "Yılmaz",

“TUR” : “TC_KIMLIK_NUMARASI_VAR”

Page 45: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

45 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

}

3.1.8 Tüketiciye Verme Bildirimi

Satış yeri, tüketiciye verdiği tekil ürünler için tüketiciye verme bildirimi yapar. Satış, hibe vb. yöntemler için

Tüketiciye Verme Bildirimi yapılır.

NOT: Tüketiciye reçete karşılığı verilen ve SGK’nın geri ödeme kapsamında bulunan optik tekil ürünler için ÜTS’ye

Tüketiciye Verme Bildirimi (veya iptal bildirimi) yapılmayacaktır. Bu durum hâlihazırdaki gibi MEDULA’ya

bildirilecektir.

3.1.8.1 Tüketiciye Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/ekle

3.1.8.2 Tüketiciye Verme Bildirimi Veri Alanları

Tablo 13 .Tüketiciye Verme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane üretim

yapıldığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Page 46: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

46 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Bedelsiz

Numune BEN

Tek Seçimli

Liste 5 Hayır

Verilen tekil ürünlerin bedelsiz numune

olup olmadığını ifade etmektedir.

Aşağıdaki değerleri alabilir. Varsayılan

değeri HAYIR’dır.

EVET: Evet

HAYIR: Hayır

Tüketici Adı TUA Metin 50 Koşullu Satarken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

Tüketici Soyadı TUS Metin 50 Koşullu Satarken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

T.C. Kimlik No TKN Sayı - Koşullu

Satarken kimlik numarası gerekli ise ve

Türkiye Cumhuriyeti vatandaşı ise

verilir. (Takip konfigürasyonu var ise)

Yabancı Kimlik

No YKN Sayı - Koşullu

Satarken kimlik numarası gerekli ise ve

yabancı kimlik numarası sahibi ise

verilir. (Takip konfigürasyonu var ise)

Pasaport No PAN Metin 20 Koşullu

Satarken kimlik numarası gerekli ise ve

yabancı kimlik numarası sahibi değil ise

verilir. (Takip konfigürasyonu var ise)

Tüketiciye

Verme Tarihi GIT Tarih 10 Evet

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

Kişi Tanımlayıcı

Numara KTN Sayı - Koşullu

Satarken kimlik numarası gerekli ise ve

kişinin T.C..Kimlik No, Yabancı Kimlik

No ya da pasaport numarası

bilinmiyorsa kişiyi tanımlayan bir

numara verilir. (Takip konfigürasyonu

var ise)

Page 47: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

47 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Kişi Kimlik Bilgisi

Açıklama Türü TUR

Tek Seçimli

Liste - Koşullu

Satarken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

Aşağıdaki değerlerden birini alabilir.

TC_KIMLIK_NUMARASI_VAR

YABANCI_KIMLIK_NUMARASI_VAR

PASAPORT_NUMARASI_VAR

YUPASS_NUMARASI_VAR

YENI_DOGAN

KIMLIGI_BELIRSIZ

DIGER

Kişi Kimlik Bilgisi

Diğer Tür

Açıklaması

DTA Metin 50 Koşullu

Kişi Kimlik Bilgisi Açıklama Türü alanı

değerinin DIGER olması durumunda bu

alan zorunludur.

Serbest metin şeklinde açıklama türü

tanımlanır.

3.1.8.3 Tüketiciye Verme Bildirimi Örnek İstek

{

"UNO" : "1111111110324",

"LNO" : "250515186001",

"ADT" : 25,

"GIT" : "2017-11-20",

"BEN" : "HAYIR",

"TKN" : "11223344678",

"TUA" : "Ali",

"TUS" : "Yılmaz",

“TUR” : “TC_KIMLIK_NUMARASI_VAR”

}

3.1.8.4 Eşsiz Kimlik Bilgisi İle Tüketiciye Verme Bildirimi Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/ekle/essizKimlik

3.1.8.5 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Bildirimi Veri Alanları

Page 48: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

48 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Tablo 14. Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane üretim

yapıldığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Bedelsiz

Numune BEN

Tek Seçimli

Liste 5 Hayır

Verilen tekil ürünlerin bedelsiz numune

olup olmadığını ifade etmektedir.

Aşağıdaki değerleri alabilir. Varsayılan

değeri HAYIR’dır.

EVET: Evet

HAYIR: Hayır

Tüketici Adı TUA Metin 50 Koşullu Satarken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

Tüketici Soyadı TUS Metin 50 Koşullu Satarken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

T.C. Kimlik No TKN Sayı - Koşullu

Satarken kimlik numarası gerekli ise ve

T.C. Kimlik Numarası var ise verilir.

(Takip konfigürasyonu var ise)

Yabancı Kimlik

No YKN Sayı - Koşullu

Satarken kimlik numarası gerekli ise ve

Yabancı Kimlik No var ise verilir. (Takip

konfigürasyonu var ise)

Page 49: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

49 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Tüketiciye

Verme Tarihi GIT Tarih 10 Evet

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

Kişi Tanımlayıcı

Numara KTN Sayı - Koşullu

Satarken kimlik numarası gerekli ise ve

kişinin T.C..Kimlik No, Yabancı Kimlik

No ya da pasaport numarası

bilinmiyorsa kişiyi tanımlayan bir

numara verilir. (Takip konfigürasyonu

var ise)

Kişi Kimlik Bilgisi

Açıklama Türü TUR

Tek Seçimli

Liste - Koşullu

Satarken kimlik numarası gerekli ise

verilir. (Takip konfigürasyonu var ise)

Aşağıdaki değerlerden birini alabilir.

TC_KIMLIK_NUMARASI_VAR

YABANCI_KIMLIK_NUMARASI_VAR

PASAPORT_NUMARASI_VAR

YUPASS_NUMARASI_VAR

YENI_DOGAN

KIMLIGI_BELIRSIZ

DIGER

Kişi Kimlik Bilgisi

Diğer Tür

Açıklaması

DTA Metin 50 Koşullu

Kişi Kimlik Bilgisi Açıklama Türü alanı

değerinin DIGER olması durumunda bu

alan zorunludur.

Serbest metin şeklinde açıklama türü

tanımlanır.

3.1.8.6 Eşsiz Kimlik Bilgisi ile Tüketiciye Verme Bildirimi Örnek İstek

{

"UDI" : "0151022222233336111603021719030210A213B1211234",

"ADT" : 25,

"GIT" : "2017-11-20",

"BEN" : "HAYIR",

"TKN" : "11223344678",

"TUA" : "Ali",

Page 50: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

50 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"TUS" : "Yılmaz",

“TUR” : “TC_KIMLIK_NUMARASI_VAR”

}

3.1.9 Tüketiciden İade Alma Bildirimi

Kurum/firma, daha önce tüketiciye verdiği tekil ürünü geri alması durumunda Tüketiciden İade Alma Bildirimi yapar.

NOT: Tüketiciye reçete karşılığı verilen ve SGK’nın geri ödeme kapsamında bulunan optik tekil ürünler için ÜTS’ye

Tüketiciden İade Alma Bildirimi (veya iptal bildirimi) yapılmayacaktır. Bu durum hâlihazırdaki gibi MEDULA’ya

bildirilecektir.

3.1.9.1 Tüketiciden İade Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/ekle

3.1.9.2 Tüketiciden İade Alma Bildirimi Veri Alanları

Tablo 15 .Tüketiciden İade Alma Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Tüketiciye

Verme Bildirimi

ID

TID Sayı - Koşullu Hangi tüketiciye verme bildirimi için iade

alımı yapıldığını ifade eder.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane iade

alındığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Tüketiciye Veren

Kurum No VKN Sayı - Koşullu

Tüketiciden iade alma işlemi, tüketiciye

veren kurumdan yapılıyorsa zorunlu

değildir, farklı kurumdan yapılıyorsa

zorunludur.

Page 51: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

51 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Koşullu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Ürün Numarası UNO Metin 23 Koşullu

Ürünün ürün numarası/barkod

numarasıdır.

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

iade alma yapılmak istendiğinde ürün

numarası verilmelidir.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

iade alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

iade alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

3.1.9.3 Tüketiciden İade Alma Bildirimi Örnek İstek

Örnek 1 tüketiciye verme bildirim ID ile yapılan tüketiciden iade alma bildirimi isteği:

{

"TID" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29",

"ADT" : 15

}

Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan tüketiciden iade alma bildirimi isteği:

{

Page 52: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

52 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"UNO" : "1111111110324",

"LNO" : "250515186001",

"ADT" : 5

}

Örnek 3 tüketiciden iade alma bildiriminin farklı kurumdan yapılma istediği:

{

"UNO" : "1111111110324",

"LNO" : "250515186001",

"ADT" : 5,

"VKN" : 7

}

3.1.9.4 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/ekle/essizKimlik

3.1.9.5 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları

Tablo 16. Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Tüketiciye Veren

Kurum No VKN Sayı - Koşullu

Tüketiciden iade alma işlemi, tüketiciye

veren kurumdan yapılıyorsa zorunlu

değildir, farklı kurumdan yapılıyorsa

zorunludur.

Page 53: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

53 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Adet ADT Sayı - Hayır

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

alındığını ifade etmektedir.

Verilen miktardan daha az sayıda tekil

ürün alındığı durumda kullanılır.

Varsayılan değeri verme bildirimindeki

adet bilgisidir.

3.1.9.6 Eşsiz Kimlik Bilgisi ile Tüketiciden İade Alma Bildirimi Örnek İstek

{

"UDI" : "0151022222233336111603021719030210A213B1211234",

"ADT" : 5

}

Eşsiz kimlik bilgisi ile tüketiciden iade alma bildiriminin farklı kurumdan yapılma istediği:

{

"UDI" : "0151022222233336111603021719030210A213B1211234",

"ADT" : 5,

“VKN” : 7

}

3.1.10 Geçici Kullanıma Verme Bildirimi

Kurum/firma, geçici süreliğine bir kişinin kullanımına verdiği tekil ürünler için Geçici Kullanıma Verme Bildirimi

yapar.

3.1.10.1 Geçici Kullanıma Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/ekle

3.1.10.2 Geçici Kullanıma Verme Bildirimi Veri Alanları

Tablo 17 . Geçici Kullanıma Verme Bildirimi Veri Alanları

Page 54: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

54 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane üretim

yapıldığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Tüketici Adı TUA Metin 50 Evet Tekil ürünün verildiği kişinin adıdır.

Tüketici Soyadı TUS Metin 50 Evet Tekil ürünün verildiği kişinin soyadıdır.

T.C. Kimlik No TKN Sayı - Koşullu

Tekil ürünün Türkiye Cumhuriyeti

vatandaşına verilmesi durumunda

verilmesi zorunludur.

Yabancı Kimlik

No YKN Sayı - Koşullu

Tekil ürünün yabancı kimlik numarası

sahibi tüketiciye verilmesi durumunda

verilmesi zorunludur.

Pasaport No PAN Metin 20 Koşullu

Tekil ürünün yabancı kimlik numarası

olmayan yabancı hastaya kullanılması

durumunda verilmesi zorunludur.

Geçici

Kullanıma

Verme Tarihi

GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

Page 55: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

55 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Kişi Tanımlayıcı

Numara KTN Sayı - Koşullu

Tekil ürünün verildiği kişinin T.C..Kimlik

No, Yabancı Kimlik No ya da pasaport

numarası bilinmiyorsa kişiyi tanımlayan

bir numara verilir.

Kişi Kimlik Bilgisi

Açıklama Türü TUR

Tek Seçimli

Liste - Zorunlu

Aşağıdaki değerlerden birini alabilir.

TC_KIMLIK_NUMARASI_VAR

YABANCI_KIMLIK_NUMARASI_VAR

PASAPORT_NUMARASI_VAR

YUPASS_NUMARASI_VAR

YENI_DOGAN

KIMLIGI_BELIRSIZ

DIGER

Kişi Kimlik Bilgisi

Diğer Tür

Açıklaması

DTA Metin 50 Koşullu

Kişi Kimlik Bilgisi Açıklama Türü alanı

değerinin DIGER olması durumunda bu

alan zorunludur.

Serbest metin şeklinde açıklama türü

tanımlanır.

3.1.10.3 Geçici Kullanıma Verme Bildirimi Örnek İstek

{

"UNO" : "1111111110324",

"LNO" : "250515186001",

"ADT" : 25,

"GIT" : "2017-11-22",

"TKN" : "11223344678",

"TUA" : "Ali",

"TUS" : "Yılmaz",

“TUR” : “TC_KIMLIK_NUMARASI_VAR”

}

3.1.10.4 Eşsiz Kimlik Bilgisi İle Geçici Kullanıma Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/ekle/essizKimlik

Page 56: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

56 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.10.5 Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları

Tablo 18. Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane üretim

yapıldığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Tüketici Adı TUA Metin 50 Evet Tekil ürünün verildiği kişinin adıdır.

Tüketici Soyadı TUS Metin 50 Evet Tekil ürünün verildiği kişinin soyadıdır.

T.C. Kimlik No TKN Sayı - Koşullu

Tekil ürünün Türkiye Cumhuriyeti

vatandaşına verilmesi durumunda

verilmesi zorunludur.

Yabancı Kimlik

No YKN Sayı - Koşullu

Tekil ürünün yabancı kimlik numarası

sahibi tüketiciye verilmesi durumunda

verilmesi zorunludur.

Pasaport No PAN Metin 20 Koşullu

Tekil ürünün yabancı kimlik numarası

olmayan yabancı hastaya kullanılması

durumunda verilmesi zorunludur.

Geçici

Kullanıma

Verme Tarihi

GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

Page 57: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

57 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Kişi Tanımlayıcı

Numara KTN Sayı - Koşullu

Tekil ürünün verildiği kişinin T.C..Kimlik

No, Yabancı Kimlik No ya da pasaport

numarası bilinmiyorsa kişiyi tanımlayan

bir numara verilir.

Kişi Kimlik Bilgisi

Açıklama Türü TUR

Tek Seçimli

Liste - Zorunlu

Aşağıdaki değerlerden birini alabilir.

TC_KIMLIK_NUMARASI_VAR

YABANCI_KIMLIK_NUMARASI_VAR

PASAPORT_NUMARASI_VAR

YUPASS_NUMARASI_VAR

YENI_DOGAN

KIMLIGI_BELIRSIZ

DIGER

Kişi Kimlik Bilgisi

Diğer Tür

Açıklaması

DTA Metin 50 Koşullu

Kişi Kimlik Bilgisi Açıklama Türü alanı

değerinin DIGER olması durumunda bu

alan zorunludur.

Serbest metin şeklinde açıklama türü

tanımlanır.

3.1.10.6 Eşsiz Kimlik Bilgisi ile Geçici Kullanıma Verme Bildirimi Örnek İstek

{

"UDI" : "0151022222233336111603021719030210A213B1211234",

"ADT" : 25,

"GIT" : "2017-11-22",

"TKN" : "11223344678",

"TUA" : "Ali",

"TUS" : "Yılmaz",

“TUR” : “TC_KIMLIK_NUMARASI_VAR”

}

3.1.11 Kullanımdan Alma Bildirimi

Kurum/firma, geçici süreliğine hasta/tüketicinin kullanımına verdiği tekil ürünleri geri aldığında Kullanımdan Alma

Bildirimi yapar.

Page 58: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

58 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.11.1 Kullanımdan Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/ekle

3.1.11.2 Kullanımdan Alma Bildirimi Veri Alanları

Tablo 19 . Kullanımdan Alma Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Geçici

Kullanıma

Verme Bildirim

ID

GKI Sayı - Evet

Kullanımdan alma işleminin hangi geçici

kullanıma verme bildirimi için yapıldığını

ifade eder.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane üretim

yapıldığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Eşsiz Kimlik UDI Metin - Koşullu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Ürün Numarası UNO Metin 23 Koşullu

Ürünün ürün numarası/barkod

numarasıdır.

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

iade alma yapılmak istendiğinde ürün

numarası verilmelidir.

Page 59: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

59 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Lot/Batch

Numarası LNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

iade alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

iade alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

3.1.11.3 Kullanımdan Alma Bildirimi Örnek İstek

Örnek 1 geçici kullanıma verme bildirim ID ile yapılan kullanımdan alma bildirimi isteği:

{

"GKI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29",

"ADT" : 15

}

Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan kullanımdan alma bildirimi isteği:

{

"UNO" : "1111111110324",

"LNO" : "250515186001",

"ADT" : 5

}

3.1.11.4 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/ekle/essizKimlik

3.1.11.5 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları

Tablo 20 . Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Veri Alanları

Page 60: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

60 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Hayır

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

alındığını ifade etmektedir.

Verilen miktardan daha az sayıda tekil

ürün alındığı durumda kullanılır.

Varsayılan değeri verme bildirimindeki

adet bilgisidir.

3.1.11.6 Eşsiz Kimlik Bilgisi ile Kullanımdan Alma Bildirimi Örnek İstek

{

"UDI" : "0151022222233336111603021719030210A213B1211234",

"ADT" : 5

}

3.1.12 Yeniden İşleme Bildirimi

Kurum/firma ÜTS’de tanımlı tekil ürünü başka bir tekil ürünün üretiminde hammadde olarak kullanması durumunda

yeniden işleme bildirimi yapar.

3.1.12.1 Yeniden İşleme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/ekle

3.1.12.2 Yeniden İşleme Bildirimi Veri Alanları

Tablo 21. Yeniden İşleme Bildirimi Veri Alanları

Page 61: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

61 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane yeniden

işleme yapıldığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

3.1.12.3 Yeniden İşleme Bildirimi Örnek İstek

{

"UNO" : "2451643000007",

"LNO" : "250515186001",

"ADT" : 25

}

3.1.12.4 Eşsiz Kimlik Bilgisi İle Yeniden İşleme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/ekle/essizKimlik

3.1.12.5 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları

Tablo 22. Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Page 62: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

62 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

kullanıldığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

3.1.12.6 Eşsiz Kimlik Bilgisi ile Yeniden İşleme Bildirimi Örnek İstek

{

"UDI" : "0151022222233336111603021719030210A213B1211234",

"ADT" : 25

}

3.1.13 İhracat Bildirimi

İhracatçı, ihraç ettiği tekil ürünler için İhracat Bildirimi yapar.

3.1.13.1 İhracat Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/ekle

3.1.13.2 İhracat Bildirimi Veri Alanları

Tablo 23 . İhracat Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Page 63: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

63 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane ihraç

edildiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Bedelsiz

Numune BEN

Tek Seçimli

Liste 5 Hayır

Verilen tekil ürünlerin bedelsiz numune

olup olmadığını ifade etmektedir.

Aşağıdaki değerleri alabilir. Varsayılan

değeri HAYIR’dır.

EVET: Evet

HAYIR: Hayır

Gümrük

Beyanname

Numarası

GBN Metin 16 Evet -

3.1.13.3 İhracat Bildirimi Örnek İstek

{

"UNO" : "2451643000007",

"LNO" : "250515186001",

"ADT" : 25,

"GBN" : "15343100IM003176",

"BEN" : "HAYIR"

}

3.1.13.4 Eşsiz Kimlik Bilgisi İle İhracat Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/ekle/essizKimlik

3.1.13.5 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları

Tablo 24. Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Veri Alanları

Page 64: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

64 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

kullanıldığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Bedelsiz

Numune BEN

Tek Seçimli

Liste 5 Hayır

Verilen tekil ürünlerin bedelsiz numune

olup olmadığını ifade etmektedir.

Aşağıdaki değerleri alabilir. Varsayılan

değeri HAYIR’dır.

EVET: Evet

HAYIR: Hayır

Gümrük

Beyanname

Numarası

GBN Metin 16 Evet -

3.1.13.6 Eşsiz Kimlik Bilgisi ile İhracat Bildirimi Örnek İstek

{

"UDI" : "0151022222233336111603021719030210A213B1211234",

"ADT" : 25,

"GBN" : "15343100IM003176",

"BEN" : "HAYIR"

}

3.1.14 Mahrecine İade Etme Bildirimi

İthalatçı, ithal ettiği tekil ürünü iade ettiğinde Mahrecine İade Bildirimi yapar.

3.1.14.1 Mahrecine İade Etme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/ekle

Page 65: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

65 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.14.2 Mahrecine İade Etme Bildirimi Veri Alanları

Tablo 25 . Mahrecine İade Etme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

mahrecine iade edildiğini ifade

etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Gümrük

Beyanname

Numarası

GBN Metin 16 Evet -

3.1.14.3 Mahrecine İade Etme Bildirimi Örnek İstek

{

"UNO" : "1111111110058",

"LNO" : "250515186001",

"ADT" : 25,

"GBN" : "15343100IM003176"

}

3.1.14.4 Eşsiz Kimlik Bilgisi İle Mahrecine İade Etme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/ekle/essizKimlik

3.1.14.5 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları

Tablo 26. Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Veri Alanları

Page 66: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

66 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

mahrecine iade edildiğini ifade

etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Gümrük

Beyanname

Numarası

GBN Metin 16 Evet -

3.1.14.6 Eşsiz Kimlik Bilgisi ile Mahrecine İade Etme Bildirimi Örnek İstek

{

"UDI" : "0151022222233336111603021719030210A213B1211234",

"ADT" : 25,

"GBN" : "15343100IM003176"

}

3.1.15 HEK / Zayiat Bildirimi

Kurum/firma, ekonomik ömrünü tamamlayan veya zayi olan tekil ürünleri için HEK / Zayiat bildirimi yapar. HEK

ifadesi Hurda / Enkaz / Köhne kelimelerinin kısaltmasıdır.

3.1.15.1 HEK / Zayiat Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/ekle

3.1.15.2 HEK / Zayiat Bildirimi Veri Alanları

Tablo 27 .HEK / Zayiat Bildirimi Veri Alanları

Page 67: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

67 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane HEK /

Zayiat yapıldığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Türü TUR Metin 20 Evet

Aşağıdaki değerlerden birini alabilir.

HEK: HEK

DOGAL_AFET: Doğal Afet

YANGIN: Yangın

CALINMA: Çalınma

DIGER: Diğer

Diğer Tür

Açıklaması DTA Metin 50 Koşullu

Türü alanının değeri Diğer olması

durumunda bu alan zorunludur.

Serbest metin şeklinde gerekçe

tanımlanır.

3.1.15.3 HEK / Zayiat Bildirimi Örnek İstek

{

"UNO" : "2451643000007",

"LNO" : "250515186001",

"ADT" : 25,

"TUR" : "DOGAL_AFET"

}

Page 68: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

68 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.15.4 Eşsiz Kimlik Bilgisi İle HEK / Zayiat Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/ekle/essizKimlik

3.1.15.5 Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları

Tablo 28. Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane HEK /

Zayiat yapıldığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Türü TUR Metin 20 Evet

Aşağıdaki değerlerden birini alabilir.

HEK: HEK

DOGAL_AFET: Doğal Afet

YANGIN: Yangın

CALINMA: Çalınma

DIGER: Diğer

Diğer Tür

Açıklaması DTA Metin 50 Koşullu

Türü alanının değeri Diğer olması

durumunda bu alan zorunludur.

Serbest metin şeklinde gerekçe

tanımlanır.

3.1.15.6 Eşsiz Kimlik Bilgisi ile HEK / Zayiat Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”,

"ADT" : 25,

"TUR" : "DOGAL_AFET"

}

Page 69: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

69 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.16 Geri Çekme Verme Bildirimi

Kurum/firma, geri çekme kapsamındaki tekil ürünleri başka bir kurum/firmaya verdiğinde Geri Çekme Verme

Bildirimi yapar.

3.1.16.1 Geri Çekme Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/ekle

3.1.16.2 Geri Çekme Verme Bildirimi Veri Alanları

Tablo 29. Geri Çekme Verme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

verildiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Kurum No KUN Sayı - Evet Tekil ürünün verildiği kurum/firmanın

ÜTS’de tanımlı numarasıdır.

Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.

3.1.16.3 Geri Çekme Verme Bildirimi Örnek İstek

{

"UNO" : "2451643000007",

"LNO" : "250515186001",

"ADT" : 25,

"KUN" : 7,

"BNO" : "123B"

Page 70: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

70 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

}

3.1.16.4 Eşsiz Kimlik Bilgisi İle Geri Çekme Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/ekle/essizKimlik

3.1.16.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları

Tablo 30. Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

verildiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Kurum No KUN Sayı - Evet Tekil ürünün verildiği kurum/firmanın

ÜTS’de tanımlı numarasıdır.

Belge Numarası BNO Metin 50 Evet Fatura ve/veya İrsaliye numarasıdır.

3.1.16.6 Eşsiz Kimlik Bilgisi ile Geri Çekme Verme Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”,

"ADT" : 25,

"KUN" : 7,

"BNO" : "123B"

}

3.1.17 Geri Çekme Alma Bildirimi

Kurum/firma, geri çekme kapsamında kendisine verilen tekil ürünleri kabul etmek için Geri Çekme Alma Bildirimi

yapar.

Page 71: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

71 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.17.1 Geri Çekme Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/ekle

3.1.17.2 Geri Çekme Alma Bildirimi Veri Alanları

Tablo 31. Geri Çekme Alma Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Geri Çekme

Verme Bildirim

ID

GVI Metin 36 Evet Hangi verme bildirimi için alım

yapıldığını ifade eder.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

alındığını ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Gönderen

Kurum

Numarası

GKK Sayı - Koşullu

Bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Bir kurumda aynı tekil ürün bilgilerine

sahip tekil ürünler için farklı

kurumlardan verme bildirimi yapılmışsa,

hangi kurumdan gelen verme bildirimine

alma bildirimi yapılmak istendiğini

belirtmek için gereklidir.

Eşsiz Kimlik UDI Metin - Koşullu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Page 72: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

72 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Koşullu

Ürünün ürün numarası/barkod

numarasıdır.

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası verilmelidir.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

3.1.17.3 Geri Çekme Alma Bildirimi Örnek İstek

Örnek 1 geri çekme verme bildirim ID ile yapılan geri çekme alma bildirimi isteği:

{

"GVI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29",

"ADT" : 15

}

Örnek 2 ürün no, lot/batch no ve seri/sıra no ve seri/sıra no ile yapılan geri çekme alma bildirimi isteği:

{

"UNO" : "1111111110324",

"LNO" : "250515186001",

"ADT" : 5,

“GKK” : 10

}

Page 73: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

73 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.17.4 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/ekle/essizKimlik

3.1.17.5 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları

Tablo 32. Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Hayır

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

alındığını ifade etmektedir.

Verilen miktardan daha az sayıda tekil

ürün alındığı durumda kullanılır.

Varsayılan değeri verme bildirimindeki

adet bilgisidir.

Gönderen

Kurum

Numarası

GKK Sayı - Hayır

Bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Bir kuruma aynı eşsiz kimlikli tekil ürün

için farklı kurumlardan verme bildirimi

yapılmışsa, hangi kurumdan gelen

verme bildirimine alma bildirimi

yapılmak istendiğini belirtmek için

gereklidir.

3.1.17.3 Eşsiz Kimlik Bilgisi ile Geri Çekme Alma Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”,

"ADT" : 5,

"GKK" : 10

}

Page 74: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

74 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.18 Islah / Düzeltici Faaliyet Bildirimi

Kurum/firma, uygunsuz veya teknik düzenlemeye aykırı olduğu için geri çekilen tekil ürünlerdeki gerekli

düzenlemeyi yaptığında Islah Bildirimi yapar.

3.1.18.1 Islah / Düzeltici Faaliyet Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/ekle

3.1.18.2 Islah / Düzeltici Faaliyet Bildirimi Veri Alanları

Tablo 33 .Islah / Düzeltici Faaliyet Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane ıslah

ettiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Kurum

Numarası KUN Sayı - Koşullu

Üretici/İthalatçı’nın tekil ürünü kendi

üzerine almadan bulunduğu kurumda

ıslah / düzeltici faaliyet gerçekleştirmesi

durumunda verilir.

3.1.18.3 Islah / Düzeltici Faaliyet Bildirimi Örnek İstek

{

"UNO" : "2451643000007",

"LNO" : "250515186001",

"ADT" : 25,

Page 75: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

75 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

“UDI” : “0151022222233336111603021719030210A213B1211234”

}

3.1.18.4 Eşsiz Kimlik Bilgisi İle Islah / Düzeltici Faaliyet Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/ekle/essizKimlik

3.1.18.5 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları

Tablo 34. Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane ıslah

ettiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Kurum

Numarası KUN Sayı - Koşullu

Üretici/İthalatçı’nın tekil ürünü kendi

üzerine almadan bulunduğu kurumda

ıslah / düzeltici faaliyet gerçekleştirmesi

durumunda verilir.

3.1.18.6 Eşsiz Kimlik Bilgisi ile Islah / Düzeltici Faaliyet Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”,

"ADT" : 25

}

3.1.19 İmha / Bertaraf Bildirimi

Kurum/firma, tekil ürünleri herhangi bir gerekçeyle imha ettiğinde İmha / Bertaraf Bildirimi yapar.

3.1.19.1 İmha / Bertaraf Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/ekle

Page 76: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

76 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.19.2 İmha / Bertaraf Bildirimi Veri Alanları

Tablo 35 . İmha / Bertaraf Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane imha

ettiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Gerekçe GRK Tek Seçimli

Liste 50 Evet

Aşağıdaki değerlerden birini alabilir.

KURUM_KARARI: Kurum Kararı

GONULLU_GERI_CEKME:

Gönüllü Geri Çekme

SON_KULLANMA_TARIHI_GEC

MIS: Son Kullanma Tarihi

Geçmiş

SAHTE_KACAK: Sahte Kaçak

TASIMA_VE_SAKLAMA_KOSUL

LARI_BOZULMUS: Taşıma ve

Saklama Koşulları Bozulmuş

HASTANIN_VUCUDUNDAN_CIK

ARILMIS: Hastanın

Vücudundan Çıkarılmış

DIGER: Diğer

Page 77: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

77 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Diğer Gerekçe

Açıklaması DGA Metin 50 Koşullu

Gerekçe alanının değerinin Diğer

olması durumunda verilmesi zorunludur.

İmha/Bertaraf

Belge Numarası BNO Metin 50 Evet

İmha/Bertaraf bildirimi yaparken

girilmesi gereken belge numarasıdır.

3.1.19.3 İmha / Bertaraf Bildirimi Örnek İstek

{

"UNO" : "2451643000007",

"LNO" : "250515186001",

"ADT" : 25,

"GRK" : "TASIMA_VE_SAKLAMA_KOSULLARI_BOZULMUS",

"BNO" : "123B"

}

3.1.19.4 Eşsiz Kimlik Bilgisi İle İmha / Bertaraf Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/ekle/essizKimlik

3.1.19.5 Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları

Tablo 36. Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Page 78: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

78 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane imha

ettiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Gerekçe GRK Tek Seçimli

Liste 50 Evet

Aşağıdaki değerlerden birini alabilir.

KURUM_KARARI: Kurum Kararı

GONULLU_GERI_CEKME:

Gönüllü Geri Çekme

SON_KULLANMA_TARIHI_GEC

MIS: Son Kullanma Tarihi

Geçmiş

SAHTE_KACAK: Sahte Kaçak

TASIMA_VE_SAKLAMA_KOSUL

LARI_BOZULMUS: Taşıma ve

Saklama Koşulları Bozulmuş

HASTANIN_VUCUDUNDAN_CIK

ARILMIS: Hastanın

Vücudundan Çıkarılmış

DIGER: Diğer

Diğer Gerekçe

Açıklaması DGA Metin 50 Koşullu

Gerekçe alanının değerinin Diğer

olması durumunda verilmesi zorunludur.

İmha/Bertaraf

Belge Numarası BNO Metin 50 Evet

İmha/Bertaraf bildirimi yaparken

girilmesi gereken belge numarasıdır.

3.1.19.6 Eşsiz Kimlik Bilgisi ile İmha / Bertaraf Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”,

"ADT" : 25,

Page 79: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

79 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"GRK" : "TASIMA_VE_SAKLAMA_KOSULLARI_BOZULMUS",

"BNO" : "123B"

}

3.1.20 Hastanın Vücudundan Çıkarma Bildirimi

Hakkında geri çekme kararı olan, miadı dolmuş veya görevini tamamlamış tıbbi cihazların tüketiciden geri alınması

durumunda Hastadan Geri Toplatma Bildirimi yapılır.

3.1.20.1 Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/ekle

3.1.20.2 Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları

Tablo 37 . Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Hasta Adı HAA Metin 50 Koşullu Kullanırken kimlik numarası gerekli olan

ürün için verilmesi zorunludur.

Hasta Soyadı HAS Metin 50 Koşullu Kullanırken kimlik numarası gerekli olan

ürün için verilmesi zorunludur.

Page 80: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

80 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

T.C. Kimlik No TKN Sayı - Koşullu

Kullanırken kimlik numarası gerekli olan

ürünün Türkiye Cumhuriyeti

vatandaşına kullanılması durumunda

verilmesi zorunludur.

Yabancı Kimlik

No YKN Sayı - Koşullu

Kullanırken kimlik numarası gerekli olan

ürünün yabancı kimlik numarası sahibi

hastaya kullanılması durumunda

verilmesi zorunludur.

Pasaport No PAN Metin 20 Koşullu

Kullanırken kimlik numarası gerekli olan

ürünün yabancı kimlik numarası

olmayan yabancı hastaya kullanılması

durumunda verilmesi zorunludur.

Gerekçe GRK Tek Seçimli

Liste - Evet

Aşağıdaki değerlerden birini alabilir.

DOKU_UYUMSUZLUGU

GERI_CAGIRMA

KULLANIM_OMRUNU_DOLDUR

MASI

REVIZYON

DIGER

Diğer Gerekçe

Açıklaması DGA Metin 50 Koşullu

Gerekçe alanının değerinin Diğer

olması durumunda verilmesi zorunludur.

Hastanın

Vücudundan

Çıkarma Tarihi

GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

Kişi Tanımlayıcı

Numara KTN Sayı - Koşullu

Kullanırken kimlik numarası gerekli olan

ürünün T.C..Kimlik No, Yabancı Kimlik

No ya da pasaport numarası

bilinmeyen hastaya kullanılması

durumunda kişiyi tanımlayıcı bir numara

verilmesi zorunludur.

Page 81: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

81 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Kişi Kimlik Bilgisi

Açıklama Türü TUR

Tek Seçimli

Liste - Zorunlu

Aşağıdaki değerlerden birini alabilir.

TC_KIMLIK_NUMARASI_VAR

YABANCI_KIMLIK_NUMARASI_

VAR

PASAPORT_NUMARASI_VAR

YUPASS_NUMARASI_VAR

YENI_DOGAN

KIMLIGI_BELIRSIZ

DIGER

Kişi Kimlik Bilgisi

Diğer Tür

Açıklaması

DTA Metin 50 Koşullu

Kişi Kimlik Bilgisi Açıklama Türü alanı

değerinin DIGER olması durumunda bu

alan zorunludur.

Serbest metin şeklinde açıklama türü

tanımlanır.

3.1.20.3 Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek

{

"UNO" : "1111111110010",

"SNO" : "KYY012345678999",

"GIT" : "2017-11-22",

"TKN" : "11223344678",

"HAA" : "Ali",

"HAS" : "Yılmaz",

"GRK" : "DOKU_UYUMSUZLUGU",

“TUR” : “TC_KIMLIK_NUMARASI_VAR”

}

3.1.20.4 Eşsiz Kimlik Bilgisi İle Hastanın Vücudundan Çıkarma Bildirimi Servis Adresi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/ekle/essizKimlik

3.1.20.5 Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları

Tablo 38. Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Veri Alanları

Page 82: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

82 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Hasta Adı HAA Metin 50 Koşullu Kullanırken kimlik numarası gerekli olan

ürün için verilmesi zorunludur.

Hasta Soyadı HAS Metin 50 Koşullu Kullanırken kimlik numarası gerekli olan

ürün için verilmesi zorunludur.

T.C. Kimlik No TKN Sayı - Koşullu

Kullanırken kimlik numarası gerekli olan

ürünün Türkiye Cumhuriyeti

vatandaşına kullanılması durumunda

verilmesi zorunludur.

Yabancı Kimlik

No YKN Sayı - Koşullu

Kullanırken kimlik numarası gerekli olan

ürünün yabancı kimlik numarası sahibi

hastaya kullanılması durumunda

verilmesi zorunludur.

Pasaport No PAN Metin 20 Koşullu

Kullanırken kimlik numarası gerekli olan

ürünün yabancı kimlik numarası

olmayan yabancı hastaya kullanılması

durumunda verilmesi zorunludur.

Gerekçe GRK Tek Seçimli

Liste - Evet

Aşağıdaki değerlerden birini alabilir.

DOKU_UYUMSUZLUGU

GERI_CAGIRMA

KULLANIM_OMRUNU_DOLDUR

MASI

REVIZYON

DIGER

Diğer Gerekçe

Açıklaması DGA Metin 50 Koşullu

Gerekçe alanının değerinin Diğer

olması durumunda verilmesi zorunludur.

Page 83: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

83 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Hastanın

Vücudundan

Çıkarma Tarihi

GIT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

Kişi Tanımlayıcı

Numara KTN Sayı - Koşullu

Kullanırken kimlik numarası gerekli olan

ürünün T.C..Kimlik No, Yabancı Kimlik

No ya da pasaport numarası

bilinmeyen hastaya kullanılması

durumunda kişiyi tanımlayıcı bir numara

verilmesi zorunludur.

Kişi Kimlik Bilgisi

Açıklama Türü TUR

Tek Seçimli

Liste - Zorunlu

Aşağıdaki değerlerden birini alabilir.

TC_KIMLIK_NUMARASI_VAR

YABANCI_KIMLIK_NUMARASI_VAR

PASAPORT_NUMARASI_VAR

YUPASS_NUMARASI_VAR

YENI_DOGAN

KIMLIGI_BELIRSIZ

DIGER

Kişi Kimlik Bilgisi

Diğer Tür

Açıklaması

DTA Metin 50 Koşullu

Kişi Kimlik Bilgisi Açıklama Türü alanı

değerinin DIGER olması durumunda bu

alan zorunludur.

Serbest metin şeklinde açıklama türü

tanımlanır.

3.1.20.6 Eşsiz Kimlik Bilgisi ile Hastanın Vücudundan Çıkarma Bildirimi Örnek İstek

{

"UDI" : "3456",

"GIT" : "2017-11-22",

"TKN" : "11223344678",

"HAA" : "Ali",

"HAS" : "Yılmaz",

"GRK" : "DOKU_UYUMSUZLUGU",

“TUR” : “TC_KIMLIK_NUMARASI_VAR”

}

Page 84: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

84 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.21 Ödünç Verme Bildirimi

Kurum/Firma sahip olduğu tıbbi cihaz için hastaneye geçici hizmete verdiğinde Ödünç Verme Bildirimi yapar.

Sadece tekil bazlı takip edilen ürünler için Ödünç Verme Bildirimi yapılır.

3.1.21.1 Ödünç Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/ekle

3.1.21.2 Ödünç Verme Bildirimi Veri Alanları

Tablo 39 . Ödünç Verme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane ıslah

ettiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Kurum

Numarası KUN Sayı - Evet

Tekil ürünün ödünç verildiği

kurum/firmanın ÜTS’de tanımlı

numarasıdır.

Ödünç Verme

Tarihi GIT Tarih 10 Evet

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

3.1.21.3 Ödünç Verme Bildirimi Örnek İstek

{

"UNO" : "1111111110010",

"SNO" : "KYY012345678999",

Page 85: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

85 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"GIT" : "2017-11-22",

"KUN" : 7

}

3.1.21.4 Eşsiz Kimlik Bilgisi İle Ödünç Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/ekle/essizKimlik

3.1.21.5 Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Veri Alanları

Tablo 40. Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane ıslah

ettiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Kurum

Numarası KUN Sayı - Evet

Tekil ürünün ödünç verildiği

kurum/firmanın ÜTS’de tanımlı

numarasıdır.

Ödünç Verme

Tarihi GIT Tarih 10 Evet

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay ve G: Günü ifade etmektedir.

3.1.21.6 Eşsiz Kimlik Bilgisi ile Ödünç Verme Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”,

"GIT" : "2017-11-22",

"KUN" : 7

}

Page 86: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

86 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.22 Ödünç Alma Bildirimi

Kurum/firma kendisine ödünç verilen tekil ürünü kabul etmek için Ödünç Alma Bildirimi yapar.

3.1.22.1 Ödünç Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/ekle

3.1.22.2 Ödünç Alma Bildirimi Veri Alanları

Tablo 41. Ödünç Alma Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ödünç Verme

Bildirim ID VBI Sayı - Evet

Hangi ödünç verme bildirimine karşılık

olarak ödünç alma yapıldığını ifade

eder.

Adet ADT Sayı - Hayır Bu bildirim sadece tekil bazlı ürünler için

yapıldığından, adet bilgisi verilmez.

Gönderen

Kurum

Numarası

GKK Sayı - Koşullu

Bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Bir kurumda aynı tekil ürün bilgilerine

sahip tekil ürünler için farklı

kurumlardan verme bildirimi yapılmışsa,

hangi kurumdan gelen verme bildirimine

alma bildirimi yapılmak istendiğini

belirtmek için gereklidir.

Eşsiz Kimlik UDI Metin - Koşullu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Ürün Numarası UNO Metin 23 Koşullu

Ürünün ürün numarası/barkod

numarasıdır.

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası verilmelidir.

Page 87: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

87 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Lot/Batch

Numarası LNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

3.1.22.3 Ödünç Alma Bildirimi Örnek İstek

Örnek 1 ödünç verme bildirim ID ile yapılan ödünç alma bildirimi isteği:

{

"VBI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29"

}

Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan ödünç alma bildirimi isteği:

{

"UNO" : "1111111110324",

"SNO" : "KYY012345678999"

}

3.1.22.4 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/ekle/essizKimlik

3.1.22.5 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Veri Alanları

Tablo 42. Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Veri Alanları

Page 88: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

88 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Hayır

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

alındığını ifade etmektedir.

Verilen miktardan daha az sayıda tekil

ürün alındığı durumda kullanılır.

Varsayılan değeri verme bildirimindeki

adet bilgisidir.

Gönderen

Kurum

Numarası

GKK Sayı - Hayır

Bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Bir kuruma aynı eşsiz kimlikli tekil ürün

için farklı kurumlardan verme bildirimi

yapılmışsa, hangi kurumdan gelen

verme bildirmine alma bildirimi yapılmak

istendiğini belirtmek için gereklidir.

3.1.22.6 Eşsiz Kimlik Bilgisi ile Ödünç Alma Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”

}

3.1.23 Ödünç Geri Verme Bildirimi

Hastanenin, Kurum/Firma’dan ödünç aldığı tıbbi cihazı, Kurum/Firma’ya geri verdiğinde Ödünç Geri Verme Bildirimi

yapar. Sadece tekil bazlı takip edilen ürünler için Ödünç Geri Verme Bildirimi yapılır.

3.1.23.1 Ödünç Geri Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/ekle

Page 89: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

89 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.23.2 Ödünç Geri Verme Bildirimi Veri Alanları

Tablo 43. Ödünç Geri Verme Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane ıslah

ettiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

3.1.23.3 Ödünç Geri Verme Bildirimi Örnek İstek

{

"UNO" : "1111111110010",

"SNO" : "KYY012345678999"

}

3.1.23.4 Eşsiz Kimlik Bilgisi İle Ödünç Geri Verme Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/ekle/essizKimlik

3.1.23.5 Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Veri Alanları

Tablo 44. Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Veri Alanları

Page 90: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

90 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Tekil ürün eşsiz kimliği (Unique Device

Identifier) ile bildirim yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Koşullu

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane ıslah

ettiğini ifade etmektedir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

3.1.23.6 Eşsiz Kimlik Bilgisi ile Ödünç Geri Verme Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”

}

3.1.24 Ödünç Geri Alma Bildirimi

Kurum/firma kendisine ödünç geri verilen tekil ürünü kabul etmek için Ödünç Geri Alma Bildirimi yapar.

3.1.24.1 Ödünç Geri Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriAlma/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriAlma/ekle

3.1.24.2 Ödünç Geri Alma Bildirimi Veri Alanları

Tablo 45. Ödünç Geri Alma Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ödünç Geri

Verme Bildirim

ID

VBI Sayı - Evet

Hangi ödünç geri verme bildirimine

karşılık olarak ödünç geri alma

yapıldığını ifade eder.

Adet ADT Sayı - Hayır Bu bildirim sadece tekil bazlı ürünler için

yapıldığından, adet bilgisi verilmez.

Page 91: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

91 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Gönderen

Kurum

Numarası

GKK Sayı - Koşullu

Bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Bir kurumda aynı tekil ürün bilgilerine

sahip tekil ürünler için farklı

kurumlardan verme bildirimi yapılmışsa,

hangi kurumdan gelen verme bildirimine

alma bildirimi yapılmak istendiğini

belirtmek için gereklidir.

Eşsiz Kimlik UDI Metin - Koşullu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Ürün Numarası UNO Metin 23 Koşullu

Ürünün ürün numarası/barkod

numarasıdır.

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası verilmelidir.

Lot/Batch

Numarası LNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 20 Koşullu

Bildirim kodu veya eşsiz kimlik

verilmediği takdirde tekil ürün bilgileri ile

alma yapılmak istendiğinde ürün

numarası ile beraber verilmelidir.

Tekil bazda takip edilen ürünler için

verilmesi zorunludur.

Page 92: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

92 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.1.24.3 Ödünç Geri Alma Bildirimi Örnek İstek

Örnek 1 ödünç geri verme bildirim ID ile yapılan ödünç geri alma bildirimi isteği:

{

"VBI" : "5d59e861-0ecc-11e7-a708-f52ed20ddd29"

}

Örnek 2 ürün no, lot/batch no ve seri/sıra no ile yapılan ödünç geri alma bildirimi isteği:

{

"UNO" : "1111111110010",

"SNO" : "KYY012345678999"

}

3.1.24.4 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriAlma/ekle/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriAlma/ekle/essizKimlik

3.1.24.5 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Veri Alanları

Tablo 46. Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Eşsiz Kimlik UDI Metin - Zorunlu

Bildirim kodu verilmediği durumda tekil

ürün eşsiz kimliği (Unique Device

Identifier) ile alma bildirimi yapılmak

istendiğinde verilmesi gerekmektedir.

Adet ADT Sayı - Hayır

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

alındığını ifade etmektedir.

Verilen miktardan daha az sayıda tekil

ürün alındığı durumda kullanılır.

Varsayılan değeri verme bildirimindeki

adet bilgisidir.

Page 93: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

93 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Gönderen

Kurum

Numarası

GKK Sayı - Hayır

Bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Bir kuruma aynı eşsiz kimlikli tekil ürün

için farklı kurumlardan verme bildirimi

yapılmışsa, hangi kurumdan gelen

verme bildirmine alma bildirimi yapılmak

istendiğini belirtmek için gereklidir.

3.1.24.6 Eşsiz Kimlik Bilgisi ile Ödünç Geri Alma Bildirimi Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”

}

3.1.25 Envanter Bildirimi

Sağlık hizmet sunucuları, envantere almak istediği ürünler için bir Envanter Bildirimi yapar.

3.1.25.1 Envanter Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/envanter/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/envanter/ekle

3.1.25.2 Envanter Bildirimi Veri Alanları

Tablo 47. Envanter Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Üretici/İthalatçı

Firma No UIK Sayı - Evet

Ürünün üretici/ithalatçı kurum

numarasıdır.

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu Tekil ürünün lot/batch numarasıdır.

Page 94: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

94 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Seri/Sıra

Numarası SNO Metin 20 Evet Tekil ürünün seri/sıra numarasıdır.

Envanter Tarihi ENT Tarih 10 Evet YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay, G: Gün.

Son Kalibrasyon

Tarihi SKT Tarih 10 Hayır

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay, G: Gün.

Son Bakım

Tarihi SBT Tarih 10 Hayır

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay, G: Gün.

3.1.25.3 Envanter Bildirimi Örnek İstek

{

"UIK" : "2081250",

"UNO" : "9321502013475",

“LNO” : “4356”,

"SNO" : "112212345678MM9",

"ENT" : "2018-08-05",

"SKT" : "2018-11-05",

"SBT" : "2018-12-05"

}

3.1.26 Stok Bildirimi

Sağlık hizmet sunucuları dışındaki kurumlar, stok yapmak istediği ürünler için Stok Bildirimi yapar.

3.1.26.1 Stok Bildirimi Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/stok/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/stok/ekle

3.1.26.2 Stok Bildirimi Veri Alanları

Tablo 48. Stok Bildirimi Veri Alanları

Page 95: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

95 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Üretici/İthalatçı

Firma No UIK Sayı - Evet

Ürünün üretici/ithalatçı kurum

numarasıdır.

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 20 Koşullu Tekil ürünün lot/batch numarasıdır.

Seri/Sıra

Numarası SNO Metin 20 Evet Tekil ürünün seri/sıra numarasıdır.

Adet ADT Sayı - Hayır

Tekil takip edilen ürünler için verilmez.

Lot bazında takip edilen ürünler için

aynı lot/seri/batch’ten kaç tane

alındığını ifade etmektedir.

Üretim Tarihi URT Tarih 10 Evet

Ürünün üretim tarihi girilmelidir.

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay, G: Gün.

Son Kullanma

Tarihi SKT Tarih 10 Hayır

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay, G: Gün.

3.1.26.3 Stok Bildirimi Örnek İstek

Örnek 1 lot ürün:

{

"UIK" : "2081250",

"UNO" : "9321502013475",

“LNO” : “4356”,

“ADT”: 100,

"URT" : "2018-11-05",

"SKT" : "2018-12-05"

}

Örnek 2 tekil takip ürün:

{

"UIK" : "2081250",

"UNO" : "9321502013475",

Page 96: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

96 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

“SNO” : “4356”,

"URT" : "2018-11-05",

"SKT" : "2018-12-05"

}

3.2 İPTAL BİLDİRİMLERİ

Kurum/firma, hatalı yaptığı bildirimi iptal etmek için iptal bildirimi yapar. Her bir bildirime karşılık farklı iptal bildirimleri

vardır. Tüm iptal bildirimlerinin aldığı parametre tipleri ve dönüş veri yapıları aynıdır.

Not: Alma ve Geri Çekme Alma bildirimlerine karşılık olarak iptal bildirimi yoktur.

3.2.1 İptal Bildirimleri Servis Adresleri

Tablo 49. İptal Bildirimleri Servis Adresleri

İptal Bildirim Adı Servis Adresi

Üretim İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/uretim/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/uretim/iptal

İthalat İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ithalat/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ithalat/iptal

Verme İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/iptal

ÜTS’de Tanımsız Yere Verme İptal Bildirimi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/iptal

Test Ortamı:

https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYereVerme/iptal

ÜTS’de Tanımsız Yerden İade Alma İptal

Bildirimi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/iptal

Test Ortamı:

https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/utsdeTanimsizYerdenIadeAlma/iptal

Kullanım İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanim/iptal

Tüketiciye Vermeyi İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketiciyeVerme/iptal

Tüketiciden İade Alma İptal Bildirimi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/tuketicidenIadeAlma/iptal

Page 97: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

97 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

İptal Bildirim Adı Servis Adresi

Geçici Kullanıma Verme İptal Bildirimi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geciciKullanimaVerme/iptal

Kullanımdan Alma İptal Bildirimi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/kullanimdanAlma/iptal

Yeniden İşleme İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/yenidenIsleme/iptal

İhracat İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ihracat/iptal

Mahrecine İade Etme İptal Bildirimi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/mahrecineIadeEtme/iptal

HEK / Zayiat İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hekZayiat/iptal

Geri Çekme Verme İptal Bildirimi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeVerme/iptal

Islah / Düzeltici Faaliyet İptal Bildirimi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/islahDuzelticiFaaliyet/iptal

İmha / Bertaraf İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/imhaBertaraf/iptal

Hastanın Vücudundan Çıkarma İptal Bildirimi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/iptal

Test Ortamı:

https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/hastaninVucudundanCikarma/iptal

Ödünç Verme İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncVerme/iptal

Ödünç Geri Verme İptal Bildirimi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncGeriVerme/iptal

Page 98: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

98 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

İptal Bildirim Adı Servis Adresi

Envanter İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/envanter/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/envanter/iptal

Stok İptal Bildirimi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/stok/iptal

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/stok/iptal

3.2.1.1 İptal Bildirimi Veri Alanları

Tablo 50. İptal Bildirimi Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Bildirim ID BID Metin - Evet İptal edilmek istenen bildirimin tekil

tanımlayıcısıdır.

3.2.1.2 İptal Bildirimleri Örnek İstek

{

"BID" : "d273e5e1-0dfc-11e7-a653-f52ed20ddd29"

}

3.3 BİLDİRİM CEVABI

Tüm hareket bildirimleri için dönülen cevabın veri yapısı ortaktır.

3.3.1 Bildirim Cevabı Veri Alanları

Tablo 51. Bildirim Cevabı Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Metin 36 Yapılan bildirimin ID’sidir.

Mesaj Listesi MSJ Liste

(TIP, MET, KOD, MPA)

- Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Page 99: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

99 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4 SORGULAMA SERVİSLERİ

3.4.1 Tekil Ürün Sorgula

Kurum/firma üzerindeki tekil ürünleri sorgular.

3.4.1.1 Tekil Ürün Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/sorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/sorgula

3.4.1.2 Tekil Ürün Sorgula İstek Veri Alanları

Tablo 52. Tekil Ürün Sorgula İstek Veri Alanları

Adı JSON

Kodu

Veri

Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

Mu? Açıklama

Ürün

Numarası UNO Metin 23

Zorunlu Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası LNO Metin 36

Koşullu Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Seri/Sıra

Numarası SNO Metin 36

Koşullu Seri bazda takip edilen ürünler için verilmesi

zorunludur.

Page 100: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

100 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.1.3 Tekil Ürün Sorgula Cevap Veri Alanları

Tablo 53. Tekil Ürün Sorgula Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC

Liste

(UTP, UNO, LNO, SNO, ADT, URT, SKT, ITT, UIK, UAK, SKG, KKG, UDI, MME)

- İşlemin başarılı olması durumunda döndürülür.

Ürün Tipi SNC.

UTP Metin 20

Aşağıdaki değerlerden birini alabilir

TIBBI_CIHAZ: Tıbbi Cihaz

KOZMETIK_URUN: Kozmetik Ürün

Ürün Numarası SNC.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

SNC.

LNO Metin 20

Seri/Sıra

Numarası

SNC.

SNO Metin 20

Adet SNC.

ADT Sayı -

Üretim Tarihi SNC.

URT Tarih 8

Son Kullanma

Tarihi

SNC.

SKT Tarih 10

Ithalat Tarihi SNC.

ITT Tarih 10

Page 101: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

101 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Üretici/ İthalatçı

Kurum

Numarası

SNC.

UIK Sayı - Tekil ürünü üreten/ithal eden kurumun numarasıdır.

Ürün Ağacı

Konfigürasyonu

SNC.

UAK Metin -

Tekil ürünün sahip olduğu takip konfigürasyonudur.

Aşağıdaki değerlerden birini alabilir.

TEKIL

LOT

Satarken Kimlik

Numarası

Gerekli Mi?

SNC.

SKG Metin -

Aşağıdaki değerlerden birini alabilir.

True

False

Kullanırken

Kimlik Numarası

Gerekli Mi?

SNC.

KKG Metin -

Aşağıdaki değerlerden birini alabilir.

True

False

Eşsiz Kimlik

Numarası

SNC.

UDI Metin - Tekil ürünün eşsiz kimlik bilgisidir.

Marka Model

Etiket

SNC.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Page 102: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

102 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.1.4 Tekil Ürün Sorgula Örnek İstek

{

"UNO" : "1111111110027",

"LNO" : "250515186001",

"SAN" : 0

}

3.4.1.5 Eşsiz Kimlik Bilgisi ile Tekil Ürün Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/sorgula/essizKimlik

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/sorgula/essizKimlik

3.4.1.6 Eşsiz Kimlik İle Tekil Ürün Sorgula İstek Veri Alanları

Tablo 54. Eşsiz Kimlik ile Tekil Ürün Sorgula İstek Veri Alanları

Adı

JSON

Kodu

Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Eşsiz Kimlik UDI

Metin Eşsiz kimlik ile tekil ürün sorgulamak için

zorunludur.

3.4.1.7 Eşsiz Kimlik İle Tekil Ürün Sorgula Örnek İstek

{

“UDI” : “0151022222233336111603021719030210A213B1211234”

}

3.4.2 Üretici/İthalatçı Tekil Ürün Sorgula

Kurum/firma sahipliğe göre tekil ürünleri sorgular.

3.4.2.1 Üretici/İthalatçı Tekil Ürün Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/uretici/sorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/uretici/sorgula

Page 103: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

103 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.2.2 Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları

Tablo 53. ‘deki istek veri alanlarından hiçbiri girdi olarak verilmezse, sorgulama sonucunda kurumun sahip olduğu

en fazla 10 tane kayıt cevap olarak döner. Bu istek veri alanlarından sadece ürün numarası kıstas olarak verilirse;

verilen ürün numarasına sahip olan tekil ürünlerden en fazla 10 kayıt cevap olarak döner. Belirli bir seri numarasına

veya lot numarasına göre sorgulama yapılması için ürün numarasına ek olarak seri numarası (tekil takip edilen

ürünler için) veya lot numarası (lot takip edilen ürünler için) verilmesi gerekmektedir.

Tablo 55. Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası LNO Metin 20

Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Seri/Sıra

Numarası SNO Metin 20

Tekil bazda takip edilen ürünler için verilmesi

zorunludur.

Sayfa Numarası SAN Sayı -

Sorgu sonucunda en fazla 10 tane kayıt

döndürülmektedir. Bu alan hangi sıradaki 10’luk

sonucun döndürülmesi gerektiğini ifade eder.

3.4.2.3 Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları

Tablo 56. Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC

Liste

(UTP, UNO, LNO, SNO, ADT, URT, SKT, ITT, KUN, UIK,

KUU, MME)

- İşlemin başarılı olması durumunda döndürülür.

Ürün Tipi SNC.

UTP Metin 20

Aşağıdaki değerlerden birini alabilir

TIBBI_CIHAZ: Tıbbi Cihaz

KOZMETIK_URUN: Kozmetik Ürün

Page 104: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

104 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Numarası SNC.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

SNC.

LNO Metin 20

Seri/Sıra

Numarası

SNC.

SNO Metin 20

Adet SNC.

ADT Sayı -

Üretim Tarihi SNC.

URT Tarih 8

Son Kullanma

Tarihi

SNC.

SKT Tarih 10

İthalat Tarihi SNC.

ITT Tarih 10

Kurum

Numarası

SNC.

KUN Sayı - Ürünün sahibi olan kurumun numarasıdır.

Üretici/İthalatçı

Kurum

Numarası

SNC.

UIK Sayı - Tekil ürünü üreten/ithal eden kurumun numarasıdır.

Kurum Unvan SNC.

KUU Sayı -

Tekil ürünün sahibinin ÜTS’de tanımlı kurum

numarasıdır.

Marka Model

Etiket

SNC.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Page 105: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

105 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.2.4 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek

{

"UNO" : "1111111110027",

"LNO" : "250515186001",

"SAN" : 0

}

3.4.3 Üretici/İthalatçı Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)

Kurum/firma sahipliğe göre tekil ürünleri sorgular.

3.4.3.1 Üretici/İthalatçı Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/uretici/sorgula/offset

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/uretici/sorgula/offset

3.4.3.2 Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 57. Üretici/İthalatçı Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Page 106: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

106 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Lot/Batch

Numarası LNO Metin 20

Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Seri/Sıra

Numarası SNO Metin 20

Tekil bazda takip edilen ürünler için verilmesi

zorunludur.

Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.

Hiçbir değer verilmezse kabul edilen değeri 10’dur.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

3.4.3.3 Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 58. Üretici/İthalatçı Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Nesne

(LST, OFF) -

LST, OFF parametrelerinden oluşan nesnedir.

İşlemin başarılı olması durumunda döndürülür.

Liste LST

Liste

(UTP, UNO, LNO, SNO, ADT, URT, SKT, ITT, KUN, UIK,

KUU, MME)

- UTP, UNO, LNO, SNO, ADT, URT, SKT, ITT, KUN,

UIK, KUU, MME parametrelerinden oluşan listedir.

Ürün Tipi LST.

UTP Metin 20

Aşağıdaki değerlerden birini alabilir

TIBBI_CIHAZ: Tıbbi Cihaz

KOZMETIK_URUN: Kozmetik Ürün

Ürün Numarası LST.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

LST.

LNO Metin 20

Page 107: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

107 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Seri/Sıra

Numarası

LST.

SNO Metin 20

Adet LST.

ADT Sayı -

Üretim Tarihi LST.

URT Tarih 8

Son Kullanma

Tarihi

LST.

SKT Tarih 10

İthalat Tarihi LST.

ITT Tarih 10

Kurum

Numarası

LST.

KUN Sayı - Ürünün sahibi olan kurumun numarasıdır.

Üretici/İthalatçı

Kurum

Numarası

LST.

UIK Sayı - Tekil ürünü üreten/ithal eden kurumun numarasıdır.

Kurum Unvan LST.

KUU Sayı -

Tekil ürünün sahibinin ÜTS’de tanımlı kurum

numarasıdır.

Marka Model

Etiket

LST.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Page 108: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

108 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.3.4 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)

{

"UNO" : "1111111110027",

"SNO" : "250515186001",

"ADT" : 5

}

Gelen Cevap Yapısı :

{

"SNC": {

"LST": [

{ .. }, { .. }

],

"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"

},

"MSJ": null

}

3.4.3.5 Üretici/İthalatçı Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile)

Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki

kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.

{

"UNO" : "1111111110027",

"SNO" : "250515186001",

"ADT" : 5,

“OFF”: “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”

Page 109: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

109 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

}

3.4.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula

Kurum/firma sistem dışına çıkan tekil ürünleri ve bu tekil ürünlere yapılan bildirimleri sorgular.

3.4.4.1 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Servis Adresi

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ureticiIthalatci/tekilUrun/sistemDisinaCikan/sorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ureticiIthalatci/tekilUrun/sistemDisinaCikan/sorgula

3.4.4.2 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları

Tablo 59. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası LNO Metin 20

Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Seri/Sıra

Numarası SNO Metin 20

Tekil bazda takip edilen ürünler için verilmesi

zorunludur.

Sayfa Numarası SAN Sayı -

Sorgu sonucunda en fazla 10 tane kayıt

döndürülmektedir. Bu alan hangi sıradaki 10’luk

sonucun döndürülmesi gerektiğini ifade eder.

3.4.4.3 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları

Tablo 60. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları

Page 110: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

110 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC

Liste

(BID, UNO, LNO, SNO, ADT, GKK, KUN, BNO, BZA, BTI,

BDR, BEN, UIK, GIT,

BKU, DKU)

- İşlemin başarılı olması durumunda döndürülür.

Bildirim ID SNC.

BID Metin 36 Bildirimin bildirim kodudur.

Ürün Numarası SNC.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

SNC.

LNO Metin 20

Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Seri/Sıra

Numarası

SNC.

SNO Metin 20

Tekil bazda takip edilen ürünler için verilmesi

zorunludur.

Adet SNC.

ADT Sayı - Tekil ürün adedidir.

Kurum No SNC.

GKK Sayı - Bildirimi yapan kurum numarasıdır.

Diğer Kurum No SNC.

KUN Sayı - Tekil ürünün verildiği kurum numarasıdır.

Belge No SNC.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Zamanı SNC.

BZA Tarih 10 Bildirim zamanıdır.

Page 111: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

111 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Bildirim Tipi SNC.

BTI Metin -

Bildirimin tipidir. Aşağıdaki değeri alabilir.

TUKETICIYE_VERME

TUKETICIDEN_IADE_ALMA_IPTAL

KULLANIM

IHRACAT

HEK_ZAYIAT

IMHA_BERTARAF

MAHRECINE_IADE_ETME

YENIDEN_ISLEME

UTSDE_TANIMSIZ_YERE_VERME

UTSDE_TANIMSIZ_YERDEN_IADE_ALMA_I

PTAL

HASTANIN_VUCUDUNDAN_CIKARMA

Bildirim Durumu SNC.

BDR Metin -

Aşağıdaki değerlerden birini alabilir:

AKTIF

PASIF

IPTAL

KULLANIMDAN_ALINDI

VERILDI

ALINDI

TUKETICIDEN ALINDI

UTSDE_TANIMSIZ_YERDEN_IADE_ALINDI

GECICI_VERME_ALINDI

Bedelsiz

Numune

SNC.

BEN Boolean -

Tekil ürünlerin bedelsiz numune olup olmadığını

ifade etmektedir. Değer “true” ise bedelsiz numune,

“false” ise bedelsiz numune değildir.

Üretici/İthalatçı

Kurum No

SNC.

UIK Sayı -

Tekil ürünün üreticisinin/ithalatçısının ÜTS’de

tanımlı kurum numarasıdır.

Page 112: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

112 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Gerçek İşlem

Tarihi

SNC.

GIT Tarih 10

Bu tarih 5 tane bildirimde dönmektedir:

Tüketiciye Verme Bildiriminde, tekil ürünün

"Tüketiciye Verme Tarihi"

Kullanım Bildiriminde, tekil ürünün “Kullanım

Tarihi”

Ödünç Verme Bildiriminde, tekil ürünü “Ödünç

Verme Tarihi”

Geçici Kullanıma Verme Bildiriminde, tekil

ürünü “Geçici Kullanıma Verme Tarihi”

Hastanın Vücudundan Çıkarma Bildiriminde,

tekil ürünü “Hastanın Vücudundan Çıkarma

Tarihi”

olarak dönmektedir.

Bildiren Kurum

Unvan

SNC.

BKU Sayı - Bildirimi yapan kurumun unvanıdır.

Diğer Kurum

Unvan

SNC.

DKU Sayı - Bildirimin yapıldığı kurumun unvanıdır.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Page 113: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

113 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.4.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek

{

"UNO" : " 1111111110010",

"LNO" : "250515186001",

"SAN" : 0

}

3.4.5 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)

Kurum/firma sistem dışına çıkan tekil ürünleri ve bu tekil ürünlere yapılan bildirimleri sorgular.

3.4.5.1 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi

ile)

Gerçek Ortam:

https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/ureticiIthalatci/tekilUrun/sistemDisinaCikan/sorgula/offset

Test Ortamı:

https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/ureticiIthalatci/tekilUrun/sistemDisinaCikan/sorgula/offset

3.4.5.2 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı

Parametresi ile)

Tablo 61. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası LNO Metin 20

Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Seri/Sıra

Numarası SNO Metin 20

Tekil bazda takip edilen ürünler için verilmesi

zorunludur.

Page 114: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

114 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.

Hiçbir değer verilmezse kabul edilen değeri 10’dur.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

3.4.5.3 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı

Parametresi ile)

Tablo 62. Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Nesne

(LST, OFF) -

LST, OFF parametrelerinden oluşan nesnedir.

İşlemin başarılı olması durumunda döndürülür.

Liste LST

Liste

(BID, UNO, LNO, SNO, ADT, GKK, KUN, BNO, BZA, BTI,

BDR, BEN, UIK, GIT,

BKU, DKU)

-

BID, UNO, LNO, SNO, ADT, GKK, KUN, BNO,

BZA, BTI, BDR, BEN, UIK, GIT, BKU, DKU

parametrelerini içeren listedir.

Bildirim ID LST.

BID Metin 36 Bildirimin bildirim kodudur.

Ürün Numarası LST.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

LST.

LNO Metin 20

Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Seri/Sıra

Numarası

LST.

SNO Metin 20

Tekil bazda takip edilen ürünler için verilmesi

zorunludur.

Page 115: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

115 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Adet LST.

ADT Sayı - Tekil ürün adedidir.

Kurum No LST.

GKK Sayı - Bildirimi yapan kurum numarasıdır.

Diğer Kurum No LST.

KUN Sayı - Tekil ürünün verildiği kurum numarasıdır.

Belge No LST.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Zamanı LST.

BZA Tarih 10 Bildirim zamanıdır.

Bildirim Tipi LST.

BTI Metin -

Bildirimin tipidir. Aşağıdaki değeri alabilir.

TUKETICIYE_VERME

TUKETICIDEN_IADE_ALMA_IPTAL

KULLANIM

IHRACAT

HEK_ZAYIAT

IMHA_BERTARAF

MAHRECINE_IADE_ETME

YENIDEN_ISLEME

UTSDE_TANIMSIZ_YERE_VERME

UTSDE_TANIMSIZ_YERDEN_IADE_ALMA_I

PTAL

HASTANIN_VUCUDUNDAN_CIKARMA

Page 116: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

116 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Bildirim Durumu LST.

BDR Metin -

Aşağıdaki değerlerden birini alabilir:

AKTIF

PASIF

IPTAL

KULLANIMDAN_ALINDI

VERILDI

ALINDI

TUKETICIDEN ALINDI

UTSDE_TANIMSIZ_YERDEN_IADE_ALINDI

GECICI_VERME_ALINDI

Bedelsiz

Numune

LST.

BEN Boolean -

Tekil ürünlerin bedelsiz numune olup olmadığını

ifade etmektedir. Değer “true” ise bedelsiz numune,

“false” ise bedelsiz numune değildir.

Üretici/İthalatçı

Kurum No

LST.

UIK Sayı -

Tekil ürünün üreticisinin/ithalatçısının ÜTS’de

tanımlı kurum numarasıdır.

Gerçek İşlem

Tarihi

LST.

GIT Tarih 10

Bu tarih 5 tane bildirimde dönmektedir:

Tüketiciye Verme Bildiriminde, tekil ürünün

"Tüketiciye Verme Tarihi"

Kullanım Bildiriminde, tekil ürünün “Kullanım

Tarihi”

Ödünç Verme Bildiriminde, tekil ürünü “Ödünç

Verme Tarihi”

Geçici Kullanıma Verme Bildiriminde, tekil

ürünü “Geçici Kullanıma Verme Tarihi”

Hastanın Vücudundan Çıkarma Bildiriminde,

tekil ürünü “Hastanın Vücudundan Çıkarma

Tarihi”

olarak dönmektedir.

Bildiren Kurum

Unvan

LST.

BKU Sayı - Bildirimi yapan kurumun unvanıdır.

Diğer Kurum

Unvan

LST.

DKU Sayı - Bildirimin yapıldığı kurumun unvanıdır.

Page 117: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

117 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.5.4 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi

ADT) ile)

{

"UNO" : " 1111111110010",

"SNO" : "250515186001",

"ADT" : 5

}

Gelen Cevap Yapısı :

{

"SNC": {

"LST": [

{ .. }, { .. }

],

"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"

Page 118: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

118 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

},

"MSJ": null

}

3.4.5.5 Üretici/İthalatçı Sistemin Dışına Çıkmış Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF)

ile)

Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki

kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.

{

"UNO" : "1111111110010",

"SNO" : "250515186001",

"ADT" : 5,

“OFF”: “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”

}

3.4.6 Askıdaki Tekil Ürün Sorgula

Kurum/firmanın verme bildirimi yapıp, karşı kurum/firmanın alma bildirimi yapmadığı tekil ürünleri sorgular.

3.4.6.1 Askıdaki Tekil Ürün Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/askidakiler

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/askidakiler

3.4.6.2 Askıdaki Tekil Ürün Sorgula İstek Veri Alanları

Tablo 63. Askıdaki Tekil Ürün Sorgula İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Gönderilen

Kurum No KUN Sayı -

Tekil ürünün verildiği kurum/firmanın ÜTS’de tanımlı

numarasıdır.

Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası LNO Metin 20

Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Seri/Sıra

Numarası SNO Metin 20

Tekil bazda takip edilen ürünler için verilmesi

zorunludur.

Page 119: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

119 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sayfa Numarası SAN Sayı -

Sorgu sonucunda en fazla 10 tane kayıt

döndürülmektedir. Bu alan hangi sıradaki 10’luk

sonucun döndürülmesi gerektiğini ifade eder.

Tablo 61. ‘deki istek veri alanlarından hiçbiri girdi olarak verilmezse, sorgulama sonucunda askıda olan tekil

ürünlerden fazla 10 tane kayıt cevap olarak döner. Bu istek veri alanlarından sadece ürün numarası kıstas olarak

verilirse; verilen ürün numarasına sahip olan askıdaki tekil ürünlerden en fazla 10 kayıt cevap olarak döner. Belirli

bir seri numarasına veya lot numarasına göre sorgulama yapılması için ürün numarasına ek olarak seri numarası

(tekil takip edilen ürünler için) veya lot numarası (lot takip edilen ürünler için) verilmesi gerekmektedir. Tekil ürünün

gönderildiği kuruma göre sorgulanması isteniyorsa ürün numarası, ve seri veya lot numarasına ek olarak tekil

ürünün gönderildiği kurumun da verilmesi gerekmektedir.

3.4.6.3 Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları

Tablo 64. Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC

Liste

(UNO, LNO, SNO, BRK, BNO, KUN, ADT, BID, BTI, BZA,

AKU, MME)

- İşlemin başarılı olması durumunda döndürülür.

Ürün Numarası SNC.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

SNC.

LNO Metin 20

Seri/Sıra

Numarası

SNC.

SNO Metin 20

Belge Numarası SNC.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Page 120: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

120 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Gönderilen

Kurum No

SNC.

KUN Sayı -

Tekil ürünün verildiği kurum/firmanın ÜTS’de tanımlı

numarasıdır.

Adet SNC.

ADT Sayı -

Bildirim Kodu SNC.

BID Metin 36 Verme bildiriminin bildirim kodudur.

Bildirim Tipi SNC.

BTI Metin -

Bildirimin tipidir. Aşağıdaki değerlerden birini alabilir:

VERME

GECICI_VERME

GERI_CEKME_VERME

Bildirim Zamanı SNC.

BZA Tarih 19

YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:

Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.

Alan Kurum

Unvan

SNC.

AKU Metin - Tekil ürünün verildiği kurumun unvanıdır.

Marka Model

Etiket

SNC.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Page 121: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

121 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.6.4 Askıdaki Tekil Ürün Sorgula Örnek İstek

{

"KUN" : 7,

"UNO" : "1111111110027",

"LNO" : "250515186001",

"SAN" : 0

}

3.4.7 Askıdaki Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)

Kurum/firmanın verme bildirimi yapıp, karşı kurum/firmanın alma bildirimi yapmadığı tekil ürünleri sorgular.

3.4.7.1 Askıdaki Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/askidakiler/offset

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/askidakiler/offset

3.4.7.2 Askıdaki Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 65. Askıdaki Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Gönderilen

Kurum No KUN Sayı -

Tekil ürünün verildiği kurum/firmanın ÜTS’de tanımlı

numarasıdır.

Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası LNO Metin 20

Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Seri/Sıra

Numarası SNO Metin 20

Tekil bazda takip edilen ürünler için verilmesi

zorunludur.

Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.

Hiçbir değer verilmezse kabul edilen değeri 10’dur.

Page 122: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

122 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

3.4.7.3 Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 66. Askıdaki Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Nesne

(LST, OFF) -

LST, OFF parametrelerinden oluşan nesnedir.

İşlemin başarılı olması durumunda döndürülür.

Liste LST

Liste

(UNO, LNO, SNO, BRK, BNO, KUN, ADT, BID, BTI, BZA,

AKU, MME)

- UNO, LNO, SNO, BRK, BNO, KUN, ADT, BID, BTI, BZA, AKU, MME parametrelerinden oluşan listedir.

Ürün Numarası LST.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

LST.

LNO Metin 20

Seri/Sıra

Numarası

LST.

SNO Metin 20

Belge Numarası LST.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Gönderilen

Kurum No

LST.

KUN Sayı -

Tekil ürünün verildiği kurum/firmanın ÜTS’de tanımlı

numarasıdır.

Adet LST.

ADT Sayı -

Bildirim Kodu LST.

BID Metin 36 Verme bildiriminin bildirim kodudur.

Page 123: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

123 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Bildirim Tipi LST.

BTI Metin -

Bildirimin tipidir. Aşağıdaki değerlerden birini alabilir:

VERME

GECICI_VERME

GERI_CEKME_VERME

Bildirim Zamanı LST.

BZA Tarih 19

YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:

Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.

Alan Kurum

Unvan

LST.

AKU Metin - Tekil ürünün verildiği kurumun unvanıdır.

Marka Model

Etiket

LST.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.7.4 Askıdaki Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)

{

"KUN" : 7,

"UNO" : "1111111110027",

Page 124: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

124 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"LNO" : "250515186001",

"ADT" : 5

}

Gelen Cevap Yapısı :

{

"SNC": {

"LST": [

{ .. }, { .. }

],

"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"

},

"MSJ": null

}

3.4.7.5 Askıdaki Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile)

{

"UNO" : "1111111110027", "LNO" : "250515186001", "ADT" : 5, “OFF”: “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”

}

3.4.8 Ödünç Alınan Tekil Ürün Sorgula

Kurum/firma üzerindeki ödünç alma bildirimi yaptığı tekil ürünleri sorgular.

3.4.8.1 Ödünç Alınan Tekil Ürün Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/lokasyon/sorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/lokasyon/sorgula

3.4.8.2 Ödünç Alınan Tekil Ürün Sorgula İstek Veri Alanları

Tablo 67. Ödünç Alınan Tekil Ürün Sorgula İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası LNO Metin 20

Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Page 125: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

125 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Seri/Sıra

Numarası SNO Metin 20

Tekil bazda takip edilen ürünler için verilmesi

zorunludur.

Sayfa Numarası SAN Sayı -

Sorgu sonucunda en fazla 10 tane kayıt

döndürülmektedir. Bu alan hangi sıradaki 10’luk

sonucun döndürülmesi gerektiğini ifade eder.

Tablo 65‘ deki istek veri alanlarından hiçbiri girdi olarak verilmezse, sorgulama sonucunda ödünç alınan tekil

ürünlerden fazla 10 tane kayıt cevap olarak döner. Bu istek veri alanlarından sadece ürün numarası kıstas olarak

verilirse; verilen ürün numarasına sahip olan tekil ürünlerden en fazla 10 kayıt cevap olarak döner. Belirli bir seri

numarasına veya lot numarasına göre sorgulama yapılması için ürün numarasına ek olarak seri numarası (tekil

takip edilen ürünler için) veya lot numarası (lot takip edilen ürünler için) verilmesi gerekmektedir.

3.4.8.3 Ödünç Alınan Tekil Ürün Sorgula Cevap Veri Alanları

Tablo 68. Ödünç Alınan Tekil Ürün Sorgula Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC

Liste

(UTP, UNO, LNO, SNO, ADT, URT, SKT, ITT, UIK, UAK, SKG, KKG, UDI, UIK,

MME)

- İşlemin başarılı olması durumunda döndürülür.

Ürün Tipi SNC.

UTP Metin 20

Aşağıdaki değerlerden birini alabilir

TIBBI_CIHAZ: Tıbbi Cihaz

KOZMETIK_URUN: Kozmetik Ürün

Ürün Numarası SNC.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

SNC.

LNO Metin 20

Page 126: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

126 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Seri/Sıra

Numarası

SNC.

SNO Metin 20

Adet SNC.

ADT Sayı -

Üretim Tarihi SNC.

URT Tarih 8

Son Kullanma

Tarihi

SNC.

SKT Tarih 10

Ithalat Tarihi SNC.

ITT Tarih 10

Üretici/ İthalatçı

Kurum

Numarası

SNC.

UIK Sayı - Tekil ürünü üreten/ithal eden kurumun numarasıdır.

Ürün Ağacı

Konfigürasyonu

SNC.

UAK Metin -

Tekil ürünün sahip olduğu takip konfigürasyonudur.

Aşağıdaki değerlerden birini alabilir.

TEKIL

LOT

Satarken Kimlik

Numarası

Gerekli Mi?

SNC.

SKG Metin -

Aşağıdaki değerlerden birini alabilir.

True

False

Kullanırken

Kimlik Numarası

Gerekli Mi?

SNC.

KKG Metin -

Aşağıdaki değerlerden birini alabilir.

True

False

Eşsiz Kimlik

Numarası

SNC.

UDI Metin -

Marka Model

Etiket

SNC.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Page 127: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

127 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Üretici/İthalatçı

Kurum No

SNC.

UIK Sayı -

Tekil ürünün üreticisinin/ithalatçısının ÜTS’de

tanımlı kurum numarasıdır.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.8.4 Ödünç Alınan Tekil Ürün Sorgula Örnek İstek

{

"UNO" : "1111111110010",

"SNO" : "KYY012345678999",

"SAN" : 0

}

3.4.9 Bildirim Sorgula

Kurum/firmanın yapmış olduğu bildirimleri sorgular.

3.4.9.1 Bildirim Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/sorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/sorgula

3.4.9.2 Bildirim Sorgula İstek Veri Alanları

Tablo 69. Bildirim Sorgula İstek Veri Alanları

Page 128: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

128 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası LNO Metin 36

Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Seri/Sıra

Numarası SNO Metin 36

Tekil bazda takip edilen ürünler için verilmesi

zorunludur.

Sayfa Numarası SAN Sayı -

Sorgu sonucunda en fazla 10 tane kayıt

döndürülmektedir. Bu alan hangi sıradaki 10’luk

sonucun döndürülmesi gerektiğini ifade eder.

Tablo 67. ‘deki istek veri alanlarından hiçbiri girdi olarak verilmezse, sorgulama sonucunda kurumun yaptığı

bildirimlerden en fazla 10 tane kayıt cevap olarak döner. Bu istek veri alanlarından sadece ürün numarası kıstas

olarak verilirse; verilen ürün numarasına sahip olan bildirimlerden en fazla 10 kayıt cevap olarak döner. Belirli bir

seri numarasına veya lot numarasına göre sorgulama yapılması için ürün numarasına ek olarak seri numarası (tekil

takip edilen ürünler için) veya lot numarası (lot takip edilen ürünler için) verilmesi gerekmektedir.

3.4.9.3 Bildirim Sorgula Cevap Veri Alanları

Tablo 70. Bildirim Sorgula Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC

Liste

(BTI, UNO, LNO, SNO, ADT, BNO, BDR, BID, BZA, GKK, KUN, BEN, UIK, GIT,

BKU, DKU, AAD)

- İşlemin başarılı olması durumunda döndürülür.

Page 129: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

129 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Tipi SNC.

BTI Metin -

Aşağıdaki değerlerden birini alabilir

alma

gecici-kullanima-verme

gecici-kullanima-verme-iptal

odunc-alma

odunc-verme

odunc-verme-iptal

geri-cekme-alma

geri-cekme-verme

geri-cekme-verme-iptal

hastanin-vucudundan-cikarma

hastanin-vucudundan-cikarma-iptal

hek-zayiat

hek-zayiat-iptal

ihracat

ihracat-iptal

imha-bertaraf

imha-bertaraf-iptal

islah-duzeltici-faaliyet

islah-duzeltici-faaliyet-iptal

ithalat

ithalat-iptal

kullanim

kullanim-iptal

kullanimdan-alma

kullanimdan-alma-iptal

mahrecine-iade-etme

mahrecine-iade-etme-iptal

tuketiciden-iade-alma

tuketiciden-iade-alma-iptal

tuketiciye-verme

tuketiciye-verme-iptal

Page 130: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

130 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Tipi SNC.

BTI Metin -

uretim

uretim-iptal

utsde-tanimsiz-yere-verme

utsde-tanimsiz-yere-verme-iptal

utsde-tanimsiz-yerden-iade-alma

utsde-tanimsiz-yerden-iade-alma-iptal

verme

verme-iptal

yeniden-isleme

yeniden-isleme-iptal

Ürün Numarası SNC.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

SNC.

LNO Metin 20

Seri/Sıra

Numarası

SNC.

SNO Metin 20

Adet SNC.

ADT Sayı -

Belge numarası SNC.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Durumu SNC.

BDR Metin -

Aşağıdaki değerlerden birini alabilir:

AKTIF

PASIF

IPTAL

KULLANIMDAN_ALINDI

VERILDI

ALINDI

TUKETICIDEN ALINDI

UTSDE_TANIMSIZ_YERDEN_IADE_ALINDI

GECICI_VERME_ALINDI

Page 131: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

131 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Bildirim Kodu SNC.

BID Metin 36 Bildirimin bildirim kodudur.

Bildirim Zamanı SNC.

BZA Tarih 19

YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A: Ay,

G: Gün, S: Saat, D:Dakika ve s: Saniye.

Bildiren Kurum

No

SNC.

GKK Sayı -

Bildirimi yapan kurumun ÜTS’de tanımlı kurum

numarasıdır.

Diğer Kurum No SNC.

KUN Sayı -

Bildirimin yapıldığı ÜTS’de tanımlı diğer kurumun

numarasıdır.

Bedelsiz

Numune

SNC.

BEN Boolean -

Tekil ürünlerin bedelsiz numune olup olmadığını

ifade etmektedir. Değer “true” ise bedelsiz numune,

“false” ise bedelsiz numune değildir.

Üretici/İthalatçı

Kurum No

SNC.

UIK Sayı -

Tekil ürünün üreticisinin/ithalatçısının ÜTS’de tanımlı

kurum numarasıdır.

Gerçek İşlem

Tarihi

SNC.

GIT Tarih 10

Bu tarih 5 tane bildirimde dönmektedir:

Tüketiciye Verme Bildiriminde, tekil ürünün

"Tüketiciye Verme Tarihi"

Kullanım Bildiriminde, tekil ürünün“Kullanım

Tarihi”

Ödünç Verme Bildiriminde, tekil ürünü “Ödünç

Verme Tarihi”

Geçici Kullanıma Verme Bildiriminde, tekil

ürünü “Geçici Kullanıma Verme Tarihi”

Hastanın Vücudundan Çıkarma Bildiriminde,

tekil ürünü“Hastanın Vücudundan Çıkarma

Tarihi”

olarak dönmektedir.

Bildiren Kurum

Unvan

SNC.

BKU Sayı - Bildirimi yapan kurumun unvanıdır.

Diğer Kurum

Unvan

SNC.

DKU Sayı - Bildirimin yapıldığı kurumun unvanıdır.

Page 132: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

132 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Alınan Adet SNC.

AAD Sayı -

Verilen bir tekil ürünün kaç adedinin alındığı

bilgisidir.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.9.4 Bildirim Sorgula Örnek İstek

{

"UNO" : "1111111110010",

"SNO" : "KYY012345678999",

"SAN" : 0

}

3.4.10 Bildirim Sorgula (Kayıt Sayısı Parametresi ile)

Kurum/firmanın yapmış olduğu bildirimleri sorgular.

3.4.10.1 Bildirim Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/sorgula/offset

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/sorgula/offset

3.4.10.2 Bildirim Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 71. Bildirim Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Page 133: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

133 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Numarası UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası LNO Metin 36

Lot bazında takip edilen ürünler için verilmesi

zorunludur.

Seri/Sıra

Numarası SNO Metin 36

Tekil bazda takip edilen ürünler için verilmesi

zorunludur.

Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.

Hiçbir değer verilmezse kabul edilen değeri 10’dur.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

3.4.10.3 Bildirim Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 72. Bildirim Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Nesne

(LST, OFF) -

LST, OFF parametrelerinden oluşan nesnedir.

İşlemin başarılı olması durumunda döndürülür.

Liste LST

Liste

(BTI, UNO, LNO, SNO, ADT, BNO, BDR, BID, BZA, GKK, KUN, BEN, UIK, GIT,

BKU, DKU, AAD)

-

BTI, UNO, LNO, SNO, ADT, BNO, BDR, BID, BZA,

GKK, KUN, BEN, UIK, GIT, BKU, DKU, AAD

parametrelerinden oluşan listedir.

Page 134: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

134 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Tipi LST.

BTI Metin -

Aşağıdaki değerlerden birini alabilir

alma

gecici-kullanima-verme

gecici-kullanima-verme-iptal

odunc-alma

odunc-verme

odunc-verme-iptal

geri-cekme-alma

geri-cekme-verme

geri-cekme-verme-iptal

hastanin-vucudundan-cikarma

hastanin-vucudundan-cikarma-iptal

hek-zayiat

hek-zayiat-iptal

ihracat

ihracat-iptal

imha-bertaraf

imha-bertaraf-iptal

islah-duzeltici-faaliyet

islah-duzeltici-faaliyet-iptal

ithalat

ithalat-iptal

kullanim

kullanim-iptal

kullanimdan-alma

kullanimdan-alma-iptal

mahrecine-iade-etme

mahrecine-iade-etme-iptal

tuketiciden-iade-alma

tuketiciden-iade-alma-iptal

tuketiciye-verme

tuketiciye-verme-iptal

Page 135: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

135 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Tipi LST.

BTI Metin -

uretim

uretim-iptal

utsde-tanimsiz-yere-verme

utsde-tanimsiz-yere-verme-iptal

utsde-tanimsiz-yerden-iade-alma

utsde-tanimsiz-yerden-iade-alma-iptal

verme

verme-iptal

yeniden-isleme

yeniden-isleme-iptal

Ürün Numarası LST.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

LST.

LNO Metin 20

Seri/Sıra

Numarası

LST.

SNO Metin 20

Adet LST.

ADT Sayı -

Belge numarası LST.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Durumu LST.

BDR Metin -

Aşağıdaki değerlerden birini alabilir:

AKTIF

PASIF

IPTAL

KULLANIMDAN_ALINDI

VERILDI

ALINDI

TUKETICIDEN ALINDI

UTSDE_TANIMSIZ_YERDEN_IADE_ALINDI

GECICI_VERME_ALINDI

Page 136: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

136 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Bildirim Kodu LST.

BID Metin 36 Bildirimin bildirim kodudur.

Bildirim Zamanı LST.

BZA Tarih 19

YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A: Ay,

G: Gün, S: Saat, D:Dakika ve s: Saniye.

Bildiren Kurum

No

LST.

GKK Sayı -

Bildirimi yapan kurumun ÜTS’de tanımlı kurum

numarasıdır.

Diğer Kurum No LST.

KUN Sayı -

Bildirimin yapıldığı ÜTS’de tanımlı diğer kurumun

numarasıdır.

Bedelsiz

Numune

LST.

BEN Boolean -

Tekil ürünlerin bedelsiz numune olup olmadığını

ifade etmektedir. Değer “true” ise bedelsiz numune,

“false” ise bedelsiz numune değildir.

Üretici/İthalatçı

Kurum No

LST.

UIK Sayı -

Tekil ürünün üreticisinin/ithalatçısının ÜTS’de tanımlı

kurum numarasıdır.

Gerçek İşlem

Tarihi

LST.

GIT Tarih 10

Bu tarih 5 tane bildirimde dönmektedir:

Tüketiciye Verme Bildiriminde, tekil ürünün

"Tüketiciye Verme Tarihi"

Kullanım Bildiriminde, tekil ürünün“Kullanım

Tarihi”

Ödünç Verme Bildiriminde, tekil ürünü “Ödünç

Verme Tarihi”

Geçici Kullanıma Verme Bildiriminde, tekil

ürünü “Geçici Kullanıma Verme Tarihi”

Hastanın Vücudundan Çıkarma Bildiriminde,

tekil ürünü“Hastanın Vücudundan Çıkarma

Tarihi”

olarak dönmektedir.

Bildiren Kurum

Unvan

LST.

BKU Sayı - Bildirimi yapan kurumun unvanıdır.

Diğer Kurum

Unvan

LST.

DKU Sayı - Bildirimin yapıldığı kurumun unvanıdır.

Page 137: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

137 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Alınan Adet LST.

AAD Sayı -

Verilen bir tekil ürünün kaç adedinin alındığı

bilgisidir.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.10.4 Bildirim Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)

{

"UNO" : "1111111110010",

"SNO" : "KYY012345678999",

"ADT" : 5

}

Gelen Cevap Yapısı :

{

"SNC": {

"LST": [

{ .. }, { .. }

],

Page 138: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

138 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"

},

"MSJ": null

}

3.4.10.5 Bildirim Sorgula Örnek İstek (Offset Parametresi (OFF) ile)

Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki

kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.

{

"UNO" : "1111111110010",

"SNO" : "KYY012345678999",

"ADT" : 5,

“OFF”: “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”

}

3.4.11 Kabul Edilecek Tekil Ürün Sorgula

Kurum/firma kendisine yapılan verme bildirimlerini sorgular.

3.4.11.1 Kabul Edilecek Tekil Ürün Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula

3.4.11.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları

Tablo 73. Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Gönderen

Kurum Kodu GKK Sayı -

Verme bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Sayfa Numarası SAN Sayı -

Sorgu sonucunda en fazla 10 tane kayıt

döndürülmektedir. Bu alan hangi sıradaki 10’luk

sonucun döndürülmesi gerektiğini ifade eder.

3.4.11.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları

Tablo 74. Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları

Page 139: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

139 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC

Liste

(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,

GKU, MME)

- İşlemin başarılı olması durumunda döndürülür.

Gönderen

Kurum Kodu

SNC.

GKK Sayı -

Verme bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Ürün Numarası SNC.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

SNC.

LNO Metin 20

Seri/Sıra

Numarası

SNC.

SNO Metin 20

Adet SNC.

ADT Sayı -

Bildirim Kodu SNC.

BID Metin 36 Bildirimin bildirim kodudur.

Belge Numarası SNC.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Zamanı SNC.

BZA Tarih 19

YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:

Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.

Bildirim Tipi SNC.

BTI Metin

Bildirimin tipidir. Aşağıdaki değeri alabilir.

VERME

Üretici/İthalatçı

Kurum

Numarası

SNC.

UIK Sayı -

Tekil ürünü üreten/ithal eden kurumun ÜTS’de

tanımlı numarasıdır.

Gönderen

Kurum Unvan

SNC.

GKU Sayı - Verme bildirimi yapan kurumun unvanıdır.

Page 140: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

140 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Marka Model

Etiket

SNC.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.11.4 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek

{

"GKK" : 7,

"SAN" : 0

}

3.4.12 Kabul Edilecek Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)

Kurum/firma kendisine yapılan verme bildirimlerini sorgular.

3.4.12.1 Kabul Edilecek Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula/offset

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula/offset

Page 141: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

141 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.12.2 Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 75. Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Gönderen

Kurum Kodu GKK Sayı -

Verme bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.

Hiçbir değer verilmezse kabul edilen değeri 10’dur.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

3.4.12.3 Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 76. Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Nesne

(LST, OFF) -

LST, OFF parametrelerinden oluşan nesnedir.

İşlemin başarılı olması durumunda döndürülür.

Liste LST

Liste

(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,

GKU, MME)

- GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI,

UIK, GKU, MME parametrelerinden oluşan listedir.

Gönderen

Kurum Kodu

LST.

GKK Sayı -

Verme bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Ürün Numarası LST.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

LST.

LNO Metin 20

Page 142: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

142 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Seri/Sıra

Numarası

LST.

SNO Metin 20

Adet LST.

ADT Sayı -

Bildirim Kodu LST.

BID Metin 36 Bildirimin bildirim kodudur.

Belge Numarası LST.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Zamanı LST.

BZA Tarih 19

YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:

Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.

Bildirim Tipi LST.

BTI Metin

Bildirimin tipidir. Aşağıdaki değeri alabilir.

VERME

Üretici/İthalatçı

Kurum

Numarası

LST.

UIK Sayı -

Tekil ürünü üreten/ithal eden kurumun ÜTS’de

tanımlı numarasıdır.

Gönderen

Kurum Unvan

LST.

GKU Sayı - Verme bildirimi yapan kurumun unvanıdır.

Marka Model

Etiket

LST.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Page 143: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

143 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.12.4 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)

{

"GKK" : 7,

"ADT" : 5

}

Gelen Cevap Yapısı :

{

"SNC": {

"LST": [

{ .. }, { .. }

],

"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"

},

"MSJ": null

}

3.4.12.5 Kabul Edilecek Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile)

Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki

kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.

{

"GKK" : 7,

"ADT" : 5,

“OFF” : “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”

}

Page 144: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

144 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.13 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula

Kurum/Firma kendisine yapılan verme bildirimlerini tekil ürün bilgilerini girerek sorgular.

3.4.13.1 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula/tekilUrun/offset

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/alma/bekleyenler/sorgula/tekilUrun/offset

3.4.13.2 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları

Tablo 77. Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

Mu? Açıklama

Ürün Numarası UNO Metin 23 Zorunlu Ürünün ürün numarası/barkod

numarasıdır.

Lot/Batch

Numarası LNO Metin 36 Koşullu

Lot bazında takip edilen ürünler için

verilmesi zorunludur.

Seri/Sıra

Numarası SNO Metin 36 Koşullu

Seri bazda takip edilen ürünler için

verilmesi zorunludur.

Adet ADT Sayı 500

Sorgu sonucu getirilmesi istenen

kayıt sayısıdır. Hiçbir değer

verilmezse kabul edilen değeri

10’dur.

Sayfa OFF Metin -

Sorgulama başlangıç offset

adresidir. Offset adres bilgisi önceki

sorgulama sonucunda verilir.

3.4.13.3 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları

Page 145: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

145 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Tablo 78. Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Nesne

(LST, OFF) -

LST, OFF parametrelerinden oluşan nesnedir.

İşlemin başarılı olması durumunda döndürülür.

Liste LST

Liste

(GKK, UNO, LNO, SNO, ADT, BID, BNO, BTI,

GIT)

- GKK, UNO, LNO, SNO, ADT, BID, BNO, BTI, GIT

parametrelerinden oluşan listedir.

Gönderen

Kurum Kodu

LST.

GKK Sayı -

Verme bildirimi yapan kurumun ÜTS’de tanımlı

numarasıdır.

Ürün Numarası LST.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

LST.

LNO Metin 20 Tekil ürünün lot/batch numarasıdır.

Seri/Sıra

Numarası

LST.

SNO Metin 20 Tekil ürünün seri/sıra numarasıdır.

Adet LST.

ADT Sayı - Verme bildirimi yapılan tekil ürünün adedidir.

Bildirim Kodu LST.

BID Metin 36 Bildirimin bildirim kodudur.

Belge Numarası LST.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Tipi LST.

BTI Metin

Bildirimin tipidir. Aşağıdaki değeri alabilir.

VERME

Gerçek İşlem

Tarihi

LST.

GIT Tarih 19

Verme işleminin gerçekte hangi tarihte yapıldığını

belirten alandır. YYYY-AA-GG formatındadır. Y: Yıl,

A: Ay, G: Gün

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

Page 146: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

146 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.13.4 Tekil Ürün Bilgileri ile Kabul Edilecek Tekil Ürün Sorgula Örnek İstek ve Cevap

Örnek istek:

{

"UNO":"01111111110010",

"LNO":"lot1",

"ADT": 10

}

Yukarıdaki isteğe dönen cevap

{

"SNC": {

"LST": [

{

"UNO": "01111111110010",

"LNO": "lot1",

"ADT": 18,

"BID": "b74e5e21-14ea-11e9-bd4d-b52780f367db",

"GKK": 2,

Page 147: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

147 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"BNO": "Belge3",

"BTI": "VERME",

"GIT": "2019-01-10"

},

{

"UNO": "01111111110010",

"LNO": "lot1",

"ADT": 15,

"BID": "95847721-14ea-11e9-bd4d-b52780f367db",

"GKK": 10,

"BNO": "belgeNo1",

"BTI": "VERME",

"GIT": "2019-01-04"

}

],

"OFF": null

},

"MSJ": null

}

3.4.14 Ödünç Alınacak Tekil Ürün Sorgula

Kurum/firma kendisine yapılan ödünç verme bildirimlerini sorgular.

3.4.14.1 Ödünç Alınacak Tekil Ürün Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/bekleyenler/sorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/bekleyenler/sorgula

3.4.14.2 Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları

Tablo 79. Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Gönderen

Kurum Kodu GKK Sayı -

Ödünç verme bildirimi yapan kurumun ÜTS’de

tanımlı numarasıdır.

Sayfa Numarası SAN Sayı -

Sorgu sonucunda en fazla 10 tane kayıt

döndürülmektedir. Bu alan hangi sıradaki 10’luk

sonucun döndürülmesi gerektiğini ifade eder.

Page 148: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

148 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.14.3 Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları

Tablo 80. Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC

Liste

(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,

GKU, MME, GIT)

- İşlemin başarılı olması durumunda döndürülür.

Gönderen

Kurum Kodu

SNC.

GKK Sayı -

Ödünç verme bildirimi yapan kurumun ÜTS’de

tanımlı numarasıdır.

Ürün Numarası SNC.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

SNC.

LNO Metin 20

Seri/Sıra

Numarası

SNC.

SNO Metin 20

Adet SNC.

ADT Sayı -

Bildirim Kodu SNC.

BID Metin 36 Bildirimin bildirim kodudur.

Belge Numarası SNC.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Zamanı SNC.

BZA Tarih 19

YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:

Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.

Bildirim Tipi SNC.

BTI Metin

Bildirimin tipidir. Aşağıdaki değeri alabilir.

ODUNC_VERME

Page 149: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

149 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Üretici/İthalatçı

Kurum

Numarası

SNC.

UIK Sayı -

Tekil ürünü üreten/ithal eden kurumun ÜTS’de

tanımlı numarasıdır.

Gönderen

Kurum Unvan

SNC.

GKU Sayı - Ödünç verme bildirimi yapan kurumun unvanıdır.

Marka Model

Etiket

SNC.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Gerçek İşlem

Tarihi

SNC.

GIT Tarih 10

Bu tarih 5 tane bildirimde dönmektedir:

Tüketiciye Verme Bildiriminde, tekil ürünün

"Tüketiciye Verme Tarihi"

Kullanım Bildiriminde, tekil ürünün “Kullanım

Tarihi”

Ödünç Verme Bildiriminde, tekil ürünü “Ödünç

Verme Tarihi”

Geçici Kullanıma Verme Bildiriminde, tekil

ürünü “Geçici Kullanıma Verme Tarihi”

Hastanın Vücudundan Çıkarma Bildiriminde,

tekil ürünü“ Hastanın Vücudundan Çıkarma

Tarihi”

olarak dönmektedir.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Page 150: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

150 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.14.4 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek

{

"GKK" : 7,

"SAN" : 0

}

3.4.15 Ödünç Alınacak Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)

Kurum/firma kendisine yapılan ödünç verme bildirimlerini sorgular.

3.4.15.1 Ödünç Alınacak Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/bekleyenler/sorgula/offset

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/oduncAlma/bekleyenler/sorgula/offset

3.4.15.2 Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 81. Ödünç Alınacak Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Gönderen

Kurum Kodu GKK Sayı -

Ödünç verme bildirimi yapan kurumun ÜTS’de

tanımlı numarasıdır.

Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.

Hiçbir değer verilmezse kabul edilen değeri 10’dur.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

Page 151: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

151 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.15.3 Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 82. Ödünç Alınacak Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Nesne

(LST, OFF) -

LST, OFF parametrelerinden oluşan nesnedir.

İşlemin başarılı olması durumunda döndürülür.

Liste LST

Liste

(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,

GKU, MME, GIT)

-

GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI,

UIK, GKU, MME, GIT parametrelerinden oluşan

listedir.

Gönderen

Kurum Kodu

LST.

GKK Sayı -

Ödünç verme bildirimi yapan kurumun ÜTS’de

tanımlı numarasıdır.

Ürün Numarası LST.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

LST.

LNO Metin 20

Seri/Sıra

Numarası

LST.

SNO Metin 20

Adet LST.

ADT Sayı -

Bildirim Kodu LST.

BID Metin 36 Bildirimin bildirim kodudur.

Belge Numarası LST.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Zamanı LST.

BZA Tarih 19

YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:

Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.

Bildirim Tipi LST.

BTI Metin

Bildirimin tipidir. Aşağıdaki değeri alabilir.

ODUNC_VERME

Page 152: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

152 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Üretici/İthalatçı

Kurum

Numarası

LST.

UIK Sayı -

Tekil ürünü üreten/ithal eden kurumun ÜTS’de

tanımlı numarasıdır.

Gönderen

Kurum Unvan

LST.

GKU Sayı - Ödünç verme bildirimi yapan kurumun unvanıdır.

Marka Model

Etiket

LST.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Gerçek İşlem

Tarihi

LST.

GIT Tarih 10

Bu tarih 5 tane bildirimde dönmektedir:

Tüketiciye Verme Bildiriminde, tekil ürünün

"Tüketiciye Verme Tarihi"

Kullanım Bildiriminde, tekil ürünün “Kullanım

Tarihi”

Ödünç Verme Bildiriminde, tekil ürünü “Ödünç

Verme Tarihi”

Geçici Kullanıma Verme Bildiriminde, tekil

ürünü “Geçici Kullanıma Verme Tarihi”

Hastanın Vücudundan Çıkarma Bildiriminde,

tekil ürünü“ Hastanın Vücudundan Çıkarma

Tarihi”

olarak dönmektedir.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Page 153: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

153 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.15.4 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek (Kayıt Sayısı Parametresi (ADT) ile)

{

"GKK" : 7,

"ADT" : 5

}

Gelen Cevap Yapısı :

{

"SNC": {

"LST": [

{ .. }, { .. }

],

"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"

},

"MSJ": null

}

3.4.15.5 Ödünç Alınacak Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile)

Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki

kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.

{

"GKK" : 7,

"ADT" : 5,

“OFF” : “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”

}

Page 154: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

154 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.16 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula

Kurum/firma kendisine yapılan geri çekme verme bildirimlerini sorgular.

3.4.16.1 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/bekleyenler

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/bekleyenler

3.4.16.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları

Tablo 83. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Gönderen

Kurum Kodu GKK Sayı -

Geri çekme verme bildirimi yapan kurumun ÜTS’de

tanımlı numarasıdır.

Sayfa Numarası SAN Sayı -

Sorgu sonucunda en fazla 10 tane kayıt

döndürülmektedir. Bu alan hangi sıradaki 10’luk

sonucun döndürülmesi gerektiğini ifade eder.

3.4.16.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları

Tablo 84. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC

Liste

(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,

GKU, MME)

- İşlemin başarılı olması durumunda döndürülür.

Gönderen

Kurum Kodu

SNC.

GKK Sayı -

Geri çekme verme bildirimi yapan kurumun ÜTS’de

tanımlı numarasıdır.

Ürün Numarası SNC.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Page 155: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

155 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Lot/Batch

Numarası

SNC.

LNO Metin 20

Seri/Sıra

Numarası

SNC.

SNO Metin 20

Adet SNC.

ADT Sayı -

Bildirim Kodu SNC.

BID Metin 36 Bildirimin bildirim kodudur.

Belge Numarası SNC.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Zamanı SNC.

BZA Tarih 19

YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:

Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.

Bildirim Tipi SNC.

BTI Metin

Bildirimin tipidir. Aşağıdaki değeri alabilir.

GERI_CEKME_VERME

Üretici/İthalatçı

Kurum

Numarası

SNC.

UIK Sayı -

Tekil ürünü üreten/ithal eden kurumun ÜTS’de

tanımlı numarasıdır.

Gönderen

Kurum Unvan

SNC.

GKU Sayı -

Geri Çekme Verme bildirimi yapan kurumun

unvanıdır.

Marka Model

Etiket

SNC.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Page 156: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

156 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.16.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula

{

"GKK" : 7,

"SAN" : 0

}

3.4.17 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula (Kayıt Sayısı Parametresi ile)

Kurum/firma kendisine yapılan geri çekme verme bildirimlerini sorgular.

3.4.17.1 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Servis Adresi (Kayıt Sayısı Parametresi ile)

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/bekleyenler/offset

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/geriCekmeAlma/bekleyenler/offset

3.4.17.2 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 85. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula İstek Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Gönderen

Kurum Kodu GKK Sayı -

Geri çekme verme bildirimi yapan kurumun ÜTS’de

tanımlı numarasıdır.

Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.

Hiçbir değer verilmezse kabul edilen değeri 10’dur.

Page 157: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

157 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

3.4.17.3 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Tablo 86. Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Cevap Veri Alanları (Kayıt Sayısı Parametresi ile)

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Nesne

(LST, OFF) -

LST, OFF parametrelerinden oluşan nesnedir.

İşlemin başarılı olması durumunda döndürülür.

Liste LST

Liste

(GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI, UIK,

GKU, MME)

- GKK, UNO, LNO, SNO, ADT, BID, BNO, BZA, BTI,

UIK, GKU, MME parametrelerinden oluşan listedir.

Gönderen

Kurum Kodu

LST.

GKK Sayı -

Geri çekme verme bildirimi yapan kurumun ÜTS’de

tanımlı numarasıdır.

Ürün Numarası LST.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

LST.

LNO Metin 20

Seri/Sıra

Numarası

LST.

SNO Metin 20

Adet LST.

ADT Sayı -

Bildirim Kodu LST.

BID Metin 36 Bildirimin bildirim kodudur.

Page 158: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

158 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Belge Numarası LST.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Zamanı LST.

BZA Tarih 19

YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:

Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.

Bildirim Tipi LST.

BTI Metin

Bildirimin tipidir. Aşağıdaki değeri alabilir.

GERI_CEKME_VERME

Üretici/İthalatçı

Kurum

Numarası

LST.

UIK Sayı -

Tekil ürünü üreten/ithal eden kurumun ÜTS’de

tanımlı numarasıdır.

Gönderen

Kurum Unvan

LST.

GKU Sayı -

Geri Çekme Verme bildirimi yapan kurumun

unvanıdır.

Marka Model

Etiket

LST.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

Page 159: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

159 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.17.4 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula (Kayıt Sayısı Parametresi (ADT) ile)

{

"GKK" : 7,

"ADT" : 5

}

Gelen Cevap Yapısı :

{

"SNC": {

"LST": [

{ .. }, { .. }

],

"OFF": "001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004"

},

"MSJ": null

}

3.4.17.5 Kabul Edilecek Geri Çekilmiş Tekil Ürün Sorgula Örnek İstek (Offset Parametresi (OFF) ile)

Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki

kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.

{

"GKK" : 7,

"ADT" : 5,

“OFF” : “001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”

}

3.4.18 Tekil Ürünün Kaynağını Sorgula

Kurum/firma tekil ürünün “TİTUBB”da kayıtlı olup olmadığını sorgular.

3.4.18.1 Tekil Ürünün Kaynağını Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/tekilUrun/kaynak/sorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/tekilUrun/kaynak/sorgula

3.4.18.2 Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları

Tablo 87. Tekil Ürünün Kaynağını Sorgula İstek Veri Alanları

Page 160: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

160 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 23 Evet Ürünün ürün numarası/barkod numarasıdır.

Seri/Sıra

Numarası SNO Metin 20 Evet Tekil ürünün seri/sıra numarasıdır.

3.4.18.3 Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları

Tablo 88. Tekil Ürünün Kaynağını Sorgula Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Nesne

(UNO, SNO, TTB)

- İşlemin başarılı olması durumunda döndürülür.

Ürün Numarası SNC.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Seri/Sıra

Numarası

SNC.

SNO Metin 20 Tekil ürünün seri/sıra numarasıdır.

TİTUBB’da

kayıtlı mı?

SNC.

TTB Boolean -

Sorgulanan tekil ürün TİTUBB’da kayıtlı ise “true”,

TİTUBB’da kayıtlı değil ise “false” döner.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Page 161: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

161 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.18.4 Tekil Ürünün Kaynağını Sorgula Örnek İstek

{

"UNO" : “1111111110010”,

"SNO" : “123”

}

3.4.19 Bildirim ve Tekil Ürün Detay Sorgula

Bildirimin ve bildirim yapılmış tekil ürünün detayını sorgular.

3.4.19.1 Bildirim ve Tekil Ürün Detay Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/detay/sorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/detay/sorgula

3.4.19.2 Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları

Tablo 89. Bildirim ve Tekil Ürün Detay Sorgula İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Bildirim ID BID Metin 36 Evet Bildirimin ID’sidir.

3.4.19.3 Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları

Tablo 90. Bildirim ve Tekil Ürün Detay Sorgula Cevap Veri Alanları

Page 162: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

162 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Bildirim bildirim

Nesne

(BID, DBI, BDR, BTI, BZA, GBN, GKK, KUN, BNO, BEN, HZT, HDA, IBG, HVG, DGA, VKN, GIT, BKU, DKU, AAD,

BKT)

-

Bildirim ID bildirim.BID Metin 36 Bildirimin ID’sidir.

Diğer Bildirim ID bildirim.DBI Metin 36 Alma yapılan bildirimlerin verme bildirimi id’si,

iptal bildirimlerinin iptal edilmiş bildirimin id’sidir.

Billdirim Durumu bildirim.BDR Metin -

Bildirimin durumudur, aşağıdaki değerleri alır.

AKTIF,

PASIF,

IPTAL,

KULLANIMDAN_ALINDI,

VERILDI,

ALINDI,

TUKETICIDEN_IADE_ALINDI,

UTSDE_TANIMSIZ_YERDEN_IADE_ALINDI,

ODUNC_VERME_ALINDI,

ODUNC_GERI_VERME_ALINDI.

Page 163: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

163 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Bildirim Tipi bildirim.BTI Metin

Bildirimin tipidir, aşağıdaki değerleri alır.

ALMA,

GECICI_KULLANIMA_VERME,

GECICI_KULLANIMA_VERME_IPTAL,

GERI_CEKME_ALMA,

GERI_CEKME_VERME,

GERI_CEKME_VERME_IPTAL,

ENVANTER,

ENVANTER_IPTAL,

HASTANIN_VUCUDUNDAN_CIKARMA,

HASTANIN_VUCUDUNDAN_CIKARMA_IPTAL,

HEK_ZAYIAT,

HEK_ZAYIAT_IPTAL,

IHRACAT,

IHRACAT_IPTAL,

IMHA_BERTARAF,

IMHA_BERTARAF_IPTAL,

ISLAH_DUZELTICI_FAALIYET,

ISLAH_DUZELTICI_FAALIYET_IPTAL,

ITHALAT,

ITHALAT_IPTAL,

KULLANIM,

KULLANIM_IPTAL,

KULLANIMDAN_ALMA,

KULLANIMDAN_ALMA_IPTAL,

MAHRECINE_IADE_ETME,

MAHRECINE_IADE_ETME_IPTAL,

ODUNC_ALMA,

ODUNC_GERI_ALMA,

Page 164: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

164 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

ODUNC_GERI_VERME,

ODUNC_GERI_VERME_IPTAL,

ODUNC_VERME,

ODUNC_VERME_IPTAL,

STOK,

STOK_IPTAL,

TUKETICIYE_VERME,

TUKETICIYE_VERME_IPTAL,

TUKETICIDEN_IADE_ALMA,

TUKETICIDEN_IADE_ALMA_IPTAL,

URETIM,

URETIM_IPTAL,

UTSDE_TANIMSIZ_YERE_VERME,

UTSDE_TANIMSIZ_YERE_VERME_IPTAL,

UTSDE_TANIMSIZ_YERDEN_IADE_ALMA,

UTSDE_TANIMSIZ_YERDEN_IADE_ALMA_IP

TAL,

VERME,

VERME_IPTAL,

YENIDEN_ISLEME,

YENIDEN_ISLEME_IPTAL.

Bildirim Zamanı bildirim.BZA Tarih YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:

Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.

Gümrük

Beyanname No bildirim.GBN Metin

İthalat ve mahrecine iade etme bildirimlerinde

verilen gümrük beyanname numarasıdır.

Gönderen

Kurum No bildirim.GKK Sayı

Verme bildirimlerinde gönderen kurumun

ÜTS’de kayıtlı numarasıdır.

Page 165: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

165 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Diğer Kurum No bildirim.KUN Sayı Verme yapılan kurumun ÜTS’de tanımlı

numarasıdır.

Belge No bildirim.BNO Metin 50 Verme bildirimlerinde verilen fatura ve/veya

İrsaliye numarasıdır.

Bedelsiz

Numune bildirim.BEN Metin

Tekil ürünlerin bedelsiz numune olup olmadığını

ifade etmektedir. Değer “true” ise bedelsiz

numune, “false” ise bedelsiz numune değildir.

Hek/Zayiat Türü bildirim.HZT Metin

Hek/Zayiat bildirimlerinde Hek/Zayiat türüdür.

Aşağıdaki değerleri alır.

HEK,

DOGAL_AFET,

YANGIN,

CALINMA,

DIGER.

Hek/Zayiat Diğer

Tür Açıklama bildirim.HDA Metin

Hek/Zayiat türü DIGER seçilirse, girilmesi

gereken açıklamadır.

İmha/Bertaraf

Gerekçesi bildirim.IBG Metin

İmha/Bertaraf bildirimlerinde İmha/Bertaraf

gerekçesidir. Aşağıdaki değerleri alır.

KURUM_KARARI,

GONULLU_GERI_CEKME,

SON_KULLANMA_TARIHI_GECMIS,

SAHTE_KACAK,

TASIMA_VE_SAKLAMA_KOSULLARI_BOZUL

MUS,

HASTANIN_VUCUDUNDAN_CIKARILMIS,

DIGER.

Page 166: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

166 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Hasta

Vücudundan

Çıkarma

Gerekçesi

bildirim.HVG Metin

Hasta vücudundan çıkarma bildirimlerindeki

gerekçelerdir, aşağıdaki değerleri alır.

DOKU_UYUMSUZLUGU,

GERI_CAGIRMA,

KULLANIM_OMRUNU_DOLDURMASI,

REVIZYON,

DIGER.

Diger Gerekçe

Açıklama bildirim. DGA Metin

Hasta vücudundan çıkarma bildirimlerindeki

gerekçe DIGER seçilmişse, girilmesi gereken

açıklamadır.

Vergi Kimlik No bildirim.VKN Metin

ÜTS’de kayıtlı olmayan firmanın vergi kimlik

numarası girilmesi zorunludur. ÜTS’de tanımsız

yere verme bildirimlerinde verilir.

Gerçek İşlem

Tarihi bildirim.GIT Tarih 10

Bu tarih 5 tane bildirimde dönmektedir:

Tüketiciye Verme Bildiriminde, tekil ürünün

"Tüketiciye Verme Tarihi"

Kullanım Bildiriminde, tekil ürünün

“Kullanım Tarihi”

Ödünç Verme Bildiriminde, tekil ürünü

“Ödünç Verme Tarihi”

Geçici Kullanıma Verme Bildiriminde, tekil

ürünü “Geçici Kullanıma Verme Tarihi”

Hastanın Vücudundan Çıkarma

Bildiriminde, tekil ürünü “Hastanın

Vücudundan Çıkarma Tarihi”

olarak dönmektedir.

Bildiren Kurum

Ünvan bildirim. BKU Metin Bildirim yapan kurumun unvanıdır.

Diğer Kurum

Ünvan bildirim. DKU Metin

Verme bildirimlerinde, verme yapılan kurumun

unvanıdır.

Page 167: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

167 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Alınan Adet bildirim. AAD Sayı Alma bildirimlerinde alınan adettir.

Bildirim Yapan

Kurum Tipi bildirim. BKT Metin

Bildirimi yapan kurum tipidir, aşağıdaki değerleri

alır.

KENDISI,

TITCK,

SGK,

Tekil Ürün tekilUrun

Nesne

(UNO, SNO, LNO, MME, SKT, ITT, UTP, UIK, UAK, SKG, KKG, UDI, SIP,

SET)

-

Ürün Numarası tekilUrun.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Seri/Sıra

Numarası

tekilUrun.

SNO Metin 20 Tekil ürünün seri/sıra numarasıdır.

Lot/Batch

Numarası

tekilUrun.

LNO Metin 20 Tekil ürünün lot/batch numarasıdır.

Marka Model

Etiket

tekilUrun.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Üretim Tarihi tekilUrun.

URT Tarih 10

Tekil ürünün üretim tarihidir. YYYY-AA-GG

formatındadır. Y: Yıl, A: Ay, G: Gün.

Son Kullanma

Tarihi

tekilUrun.

SKT Tarih 12

Tekil ürünün son kullanma tarihidir. YYYY-AA-

GG SS formatındadır. Y: Yıl, A: Ay, G: Gün, S:

Saat.

İthalat Tarihi tekilUrun.

ITT Tarih 10

Tekil ürünün ithalat tarihidir. YYYY-AA-GG

formatındadır. Y: Yıl, A: Ay, G: Gün.

Page 168: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

168 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Türü tekilUrun.

UTP Metin

Ürünün türüdür, aşağıdaki değerleri alır.

TIBBI_CIHAZ,

KOZMETIK_URUN.

Üretici/İthalatçı

Kurum No

tekilUrun.

UIK Sayı

Tekil ürünün üretici/ithalatçı kurumunun ÜTS’de

kayıtlı numarasıdır.

Takip Kapsamı tekilUrun.

UAK Metin

Tekil ürünün takip kapsamıdır, aşağıdaki

değerleri alır.

TEKIL,

LOT,

GONULLU_TEKIL,

GONULLU_LOT.

Satarken Kimlik

No Gerekli Mi

tekilUrun.

SKG Metin

Aşağıdaki değerlerden birini alabilir.

true,

false

Kullanırken

Kimlik No

Gerekli Mi

tekilUrun.

KKG Metin

Aşağıdaki değerlerden birini alabilir.

true,

false

Eşsiz Kimlik tekilUrun.

UDI Metin Tekil ürünün eşsiz kimliğidir.

Sip İçerisindeki

Tekil Ürünler

tekilUrun.

SIP

Liste

(UAK,

UNO, LNO,

SNO, ADT)

Sip içerisindeki tekil ürün bilgileridir.

Set İçerisindeki

Tekil Ürünler

tekilUrun.

SET

Liste

(UAK,

UNO, LNO,

SNO, ADT)

Set içerisindeki tekil ürün bilgileridir.

Page 169: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

169 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.19.4 Bildirim ve Tekil Ürün Detay Sorgula Örnek İstek

{

"BID" : “48fr34c1-d3c3-11e7-97f7-8faf3772521f”

}

3.4.19.5 Bildirim ve Tekil Ürün Detay Sorgula Örnek Cevap

NOT : Boş olan parametreler, cevapta dönmemektedir.

{

"bildirim": {

"UNO": "09934239006763",

"LNO": "1",

"SNO": "48",

"ADT": 1,

"BID": "48fr34c1-d3c3-11e7-97f7-8faf3772521f",

"BDR": "AKTIF",

"BTI": "URETIM",

"BZA": "2017-11-28 01:35:35",

"GKK": 10,

"BKT": "KENDISI"

},

"tekilUrun": {

"UNO": "08680239006763",

"LNO": "1",

"SNO": "0000001548",

"MME": "ATASUN - YOK - ATASUN STD INC STD PKT +04.25:-01.00:65 Gözlük Camı",

"URT": "2017-04-14",

"UTP": "TIBBI_CIHAZ",

"UIK": 2667269130265,

"UAK": "TEKIL",

"SKG": false,

"KKG": false

}

}

Page 170: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

170 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.20 Eksik Alma Bildirimi

Eksik alma bildirimi, bir kurum, başka bir kuruma lot bazında takip edilen ürünlerden verme yaptığı zaman ve

karşıdaki kurumun verilen ürün adedinden daha az miktarını aldığı zaman gerçekleşir. Örneğin, A kurumu B

kurumuna 40 adet C ürününden vermiştir, ve B kurumu verilen ürünlerden 30 tanesini almıştır. A kurumuna B

kurumunun ürünleri eksik aldığına dair hatırlatma(notification) gider ve aynı zamanda bu bildirimler bir sorgu ile

görüntülenebilir.

3.4.20.1 Eksik Alma Bildirimlerini Görüntüle

3.4.20.1.1 Eksik Alma Bildirimlerini Görüntüle Servis Adresleri

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/eksikAlma/sorgula/offset

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/eksikAlma/sorgula/offset

3.4.20.1.2 Eksik Alma Bildirimlerini Görüntüle İstek Veri Alanları

Tablo 91. Eksik Alma Bildirimlerini Görüntüle İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Adet ADT Sayı 500 Sorgu sonucu getirilmesi istenen kayıt sayısıdır.

Hiçbir değer verilmezse kabul edilen değeri 10’dur.

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

3.4.20.1.3 Eksik Alma Bildirimi Sorgula Cevap Veri Alanları

Tablo 92. Eksik Alma Bildirimi Sorgula Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Nesne

(LST, OFF) -

LST, OFF parametrelerinden oluşan nesnedir.

İşlemin başarılı olması durumunda döndürülür.

Liste LST

Liste

(UNO, LNO, ADT, MME, BID, KUN, BNO, BZA, BTI, DKU,

AAD, GDR)

- UNO, LNO, ADT, MME, BID, KUN, BNO, BZA, BTI,

DKU, AAD, GDR parametrelerinden oluşan listedir.

Page 171: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

171 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Numarası LST.

UNO Metin 23 Ürünün ürün numarası/barkod numarasıdır.

Lot/Batch

Numarası

LST.

LNO Metin 20

Seri/Sıra

Numarası

LST.

SNO Metin 20

Adet LST.

ADT Sayı - Verilen ürünün adedi

Marka Model

Etiket

LST.

MME Metin - Ürünün Marka – Model – Etiket adıdır.

Bildirim Kodu LST.

BID Metin 36 Bildirimin bildirim kodudur.

Diğer Kurum No LST.

KUN Sayı -

Verne bildirimin yapıldığı ÜTS’de tanımlı diğer

kurumun numarasıdır.

Belge Numarası LST.

BNO Metin 50 Fatura ve/veya İrsaliye numarasıdır.

Bildirim Zamanı LST.

BZA Tarih 19

YYYY-AA-GG SS:DD:ss formatındadır. Y: Yıl, A:

Ay, G: Gün, S: Saat, D:Dakika ve s: Saniye.

Bildirim Tipi LST.

BTI Metin

Bildirimin tipidir. Aşağıdaki değeri alabilir.

ALMA

GERI_CEKME_ALMA

Diğer Kurum

Unvan

LST.

DKU Sayı - Verme bildirimin yapıldığı kurumun unvanıdır.

Alınan Adet LST.

ADD Sayı - Verme yapılan kurumun aldığı adet

Page 172: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

172 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Görülme

Durumu

LST.

GDR Metin -

Bildirimin görülüp görülmediğini belirtir. Aşağıdaki

değerleri alabilir:

GORULMEDI

GORULDU

Sayfa OFF Metin - Sorgulama başlangıç offset adresidir. Offset adres

bilgisi önceki sorgulama sonucunda verilir.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.4.20.1.4 Eksik Alma Bildirimi Sorgula Örnek İstek

Yukarıdaki örnekte gelen "OFF" değeri, sonraki kayıtları listelemek için kullanılacak başlangıç adresidir. Sonraki

kayıtları listelemek için oluşturulacak yeni istek örneği aşağıda gösterilmiştir.

{

"ADT":10,

"OFF":“001e001000120010932fd8314c4911e8a7d0a72e64a3b944f07ffffffdf07ffffffd6687d8d33ae39eb1df45faeb75e1c2370004”

}

Page 173: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

173 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.4.20.2 Eksik Alma Bildiriminin Görülme Durumunu Güncelle

Bildirimlerin görülme durumları güncellenebilir. Bu bildirimin görülmesini engellemez, yalnızca hangi bildirimlerin

işlenip işlenmediğini işaretlemek içindir.

3.4.20.2.1 Eksik Alma Bildiriminin Görülme Durumunu Güncelle Servis Adresleri

Gerçek Ortam: https:/utsuygulama.saglik.gov.tr/UTS/uh/rest/bildirim/verme/eksikAlma/gorulmeDurumunuGuncelle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/bildirim/verme/eksikAlma/gorulmeDurumunuGuncelle

3.4.20.2.2 Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Veri Alanları

Tablo 93. Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Bildirim Kodu BID Metin 36 Bildirim durumu güncellenmek istenen bildirimin

bildirim kodu

Görülme

Durumu GDR Metin -

Bildirim durumu. Alabileceği değerler:

GORULDU

GORULMEDI

3.4.20.2.3 Eksik Alma Bildirimi Görülme Durumunu Güncelle Cevap Veri Alanları

Tablo 94. Eksik Alma Bildirimi Görülme Durumunu Güncelle İstek Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Metin - null döner, kullanılmamaktadır.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Bilgilendirme mesajıdır.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli bilgi mesaj metnidir.

Page 174: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

174 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi - İşlenen bildirimin bildirim kodunu içerir.

3.4.20.2.4 Eksik Alma Bildirimi Görülme Durumunu Güncelle Örnek İstek

{

"BID": "def610f1-075a-11e9-a5c1-6d0bfaf9a6ef",

"GDR": "GORULMEDI"

}

3.5 PAKET TRANSFER SİSTEMİ (PTS) SERVİSLERİ

3.5.1 Paket Ekle

Kurum/firma bu servisi kullanarak paket oluşturur. Kurum daha önce aynı isimde paket tanımlanmışsa, eski paket

silinir ve yeni paket bu paketin yerini alır.

3.5.1.1 Paket Ekle Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/paket/ekle

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/paket/ekle

3.5.1.2 Paket Ekle İstek Veri Alanları

Tablo 95. Paket Ekle İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Paket

Numarası PNO Metin 255 Evet Eklenecek paketin, paket numarasıdır.

Page 175: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

175 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Paket Tipi TIP Tek Seçimli

Liste 1 Hayır

Eklenecek paketin tipini ifade

etmektedir. Aşağıdaki değerleri alabilir.

P: Palet

C: Kargo

S: Shrink

Alıcı Kurum

Numarası KNO Sayı - Evet

Tanımlanan paketin alıcısı olan kurumun

ÜTS’de tanımlı numarasıdır.

Paket Listesi PLI

Liste

(PNO, TIP, KNO, PLI,

TUL)

- Hayır Tanımlanan paketin içerdiği paket listesi

Tekil Ürün

Listesi TUL

Liste

(UNO,

SNO, LNO,

ADT, UDI)

- Hayır Tanımlanan paketin içerdiği tekil ürün

listesi

Ürün Numarası TUL.

UNO Metin - Hayır

Paketin içerdiği tekil ürünün ürün

numarası

Seri/Sıra

Numarası

TUL.

SNO Metin - Hayır

Paketin içerdiği tekil ürünün seri/sıra

numarası

Lot/Batch

Numarası

TUL.

LNO Metin - Hayır

Paketin içerdiği tekil ürünün lot/batch

numarası

Adet TUL.

ADT Sayı - Hayır Paketin içerdiği tekil ürünün adet bilgisi

Eşsiz kimlik TUL.

UDI Metin - Hayır Paketin içerdiği tekil ürünün eşsiz kimliği

3.5.1.3 Paket Ekle Cevap Veri Alanları

Tablo 96. Paket Ekle Cevap Veri Alanları

Page 176: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

176 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Metin - Eklenen paket numarasıdır. İşlemin başarılı olması

durumunda döndürülür.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.5.1.4 Paket Ekle Örnek İstek

{

"PNO":"paket1",

"KNO" : 7,

"TIP" : "P",

"TUL " : [

{

"UNO ":"urunNo",

"SNO ":"seriNo1",

"LNO ":"lotNo1",

"UDI" : "890b7",

"ADT ":1

}

],

"PLI ":[

Page 177: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

177 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

{

"PNO ":"paket2",

"KNO" : 7,

"TIP" : "P",

"TUL ":[

{

"UNO ":"urunNo2",

"SNO ":"seriNo2",

"LNO ":"lotNo2",

"UDI" : "99",

"ADT ":100

}

]

}

]

}

3.5.2 Paket Sil

Kurum kendi oluşturduğu paketi siler.

3.5.2.1 Paket Sil Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/paket/sil

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/paket/sil

3.5.2.2 Paket Sil İstek Veri Alanları

Tablo 97. Paket Sil İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Paket

Numarası PNO Metin 255 Evet Silinecek paketin, paket numarasıdır.

3.5.2.3 Paket Sil Cevap Veri Alanları

Tablo 98. Paket Sil Cevap Veri Alanları

Page 178: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

178 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Metin - Silinen paket numarasıdır. İşlemin başarılı olması

durumunda döndürülür.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.5.2.4 Paket Sil Örnek İstek

{

"PNO":"paket1"

}

3.5.3 Paket Getir

Kurum tarafından eklenen sistem paketlerinin içeriğini görmek için kullanılır.

3.5.3.1 Paket Getir Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/paket/getir

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/paket/getir

3.5.3.2 Paket Getir İstek Veri Alanları

Tablo 99. Paket Getir İstek Veri Alanları

Page 179: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

179 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Paket

Numarası PNO Metin 255 Evet

İçeriği gösterilecek paketin, paket

numarasıdır.

3.5.3.3 Paket Getir Cevap Veri Alanları

Tablo 100. Paket Getir Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Liste -

Paket Numarası SNC

.PNO Metin 255 İçeriği gösterilecek paketin, paket numarasıdır.

Paket Tipi SNC

.TIP

Tek Seçimli

Liste 1

İçeriği gösterilecek paketin tipini ifade etmektedir.

Aşağıdaki değerleri alabilir.

P: Palet

C: Kargo

S: Shrink

Alıcı Kurum

Numarası

SNC

.KNO Sayı -

İçeriği gösterilecek paketin alıcısı olan kurumun

ÜTS’de tanımlı numarasıdır.

Paketi Oluşturan

Kurum Numarası

SNC.

OKN Sayı -

Paketi oluşturan kurumun ÜTS’de tanımlı

numarasıdır.

Paket Listesi SNC

.PLI

Liste

(PNO, TIP, KNO, PLI,

TUL)

- İçeriği gösterilecek paketin içerdiği paket listesi

Tekil Ürün

Listesi

SNC.

TUL

Liste

(UNO, SNO,

LNO, ADT,

UDI)

- İçeriği gösterilecek paketin içerdiği tekil ürün listesi

Page 180: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

180 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Numarası TUL.

UNO Metin - Paketin içerdiği tekil ürünün ürün numarası

Seri/Sıra

Numarası

TUL.

SNO Metin - Paketin içerdiği tekil ürünün seri/sıra numarası

Lot/Batch

Numarası

TUL.

LNO Metin - Paketin içerdiği tekil ürünün lot/batch numarası

Adet TUL.

ADT Sayı - Paketin içerdiği tekil ürünün adet bilgisi

Eşsiz kimlik TUL.

UDI Metin - Paketin içerdiği tekil ürünün eşsiz kimliği

3.5.3.4 Paket Getir Örnek İstek

{

"PNO":"paket1"

}

3.5.4 Kuruma Gelen Paketi Okundu İşaretle

Kuruma gelen paketi okundu olarak işaretlemek için bu servis kullanılır. Okundu işaretlenen paketler sorgu

sonuçlarında filtrelenebilir (bkz. 3.5.6 Kuruma Gelen Paketleri Sorgula).

3.5.4.1 Kuruma Gelen Paketi Okundu İşaretle Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/oku

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/oku

3.5.4.2 Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları

Tablo 101. Kuruma Gelen Paketi Okundu İşaretle İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Paket

Numarası PNO Metin 255 Evet

Okundu işaretlenecek paketin, paket

numarasıdır.

Page 181: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

181 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Gönderen

Kurum

Numarası

KNO Sayı - Evet Sistem paketini gönderen kurumun

ÜTS’de tanımlı numarasıdır.

3.5.4.3 Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları

Tablo 102. Kuruma Gelen Paketi Okundu İşaretle Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC Metin - Okundu işaretlenen paket numarasıdır. İşlemin

başarılı olması durumunda döndürülür.

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve Mesaj

Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.5.4.4 Kuruma Gelen Paketi Okundu İşaretle Örnek İstek

{

"PNO":"paket1",

"KNO":7

}

Page 182: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

182 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.5.5 Kuruma Gelen Paketi Getir

Kuruma gelen paketlerin içeriğini görmek için kullanılır.

3.5.5.1 Kuruma Gelen Paketi Getir Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/getir

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/getir

3.5.5.2 Kuruma Gelen Paketi Getir İstek Veri Alanları

Tablo 103. Kuruma Gelen Paketi Getir İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Paket

Numarası PNO Metin 255 Evet

İçeriği getirilecek paketin, paket

numarasıdır.

Gönderen

Kurum

Numarası

KNO Sayı - Evet Sistem paketini gönderen kurumun

ÜTS’de tanımlı numarasıdır.

3.5.5.3 Kuruma Gelen Paketi Getir Cevap Veri Alanları

Tablo 104. Kuruma Gelen Paketi Getir Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Paket Numarası PNO Metin 255 İçeriği gösterilecek paketin, paket numarasıdır.

Paket Tipi TIP Tek Seçimli

Liste 1

İçeriği gösterilecek paketin tipini ifade etmektedir.

Aşağıdaki değerleri alabilir.

P: Palet

C: Kargo

S: Shrink

Alıcı Kurum

Numarası KNO Sayı -

İçeriği gösterilecek paketin alıcısı olan kurumun

ÜTS’de tanımlı numarasıdır.

Page 183: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

183 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Paket Listesi PLI

Liste

(PNO, TIP, KNO, PLI,

TUL)

- İçeriği gösterilecek paketin içerdiği paket listesi

Tekil Ürün

Listesi TUL

Liste

(UNO, SNO,

LNO, ADT,

UDI)

- İçeriği gösterilecek paketin içerdiği tekil ürün listesi

Ürün Numarası TUL.

UNO Metin - Paketin içerdiği tekil ürünün ürün numarası

Seri/Sıra

Numarası

TUL.

SNO Metin - Paketin içerdiği tekil ürünün seri/sıra numarası

Lot/Batch

Numarası

TUL.

LNO Metin - Paketin içerdiği tekil ürünün lot/batch numarası

Adet TUL.

ADT Sayı - Paketin içerdiği tekil ürünün adet bilgisi

Eşsiz kimlik TUL.

UDI Metin - Paketin içerdiği tekil ürünün eşsiz kimliği

3.5.5.4 Kuruma Gelen Paketi Getir Örnek İstek

{

"PNO":"paket1",

"KNO":7

}

3.5.6 Kuruma Gelen Paketleri Sorgula

Kuruma gelen sistem paketlerini sorgulamak için bu servis kullanılır.

3.5.6.1 Kuruma Gelen Paketleri Sorgula Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/sorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS/uh/rest/pts/gelenPaket/sorgula

Page 184: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

184 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.5.6.2 Kuruma Gelen Paketleri Sorgula İstek Veri Alanları

Tablo 105. Kuruma Gelen Paketleri Sorgula İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

En Küçük Tarih EKT Tarih 10 Hayır

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay, G: Gün.

Varsayılan değer 10 gün öncesidir.

En Büyük Tarih EBT Tarih 10 Hayır

YYYY-AA-GG formatındadır. Y: Yıl, A:

Ay, G: Gün.

Varsayılan değer içerisinde bulunan

gündür. En küçük tarihten, en fazla 10

gün ileride olabilir.

Okundu Bilgisi OKB Tek Seçimli

Liste 7 Hayır

Paketin okunma durumu bilgisidir.

Aşağıdaki değerleri alabilir.

AKTIF,

ASKIDA,

OKUNDU,

SILINDI

Varsayılan değer AKTIF’tir.

Kurum

Numarası KNO Sayı - Hayır

Paketi oluşturan kurumun ÜTS’de

tanımlı numarası

3.5.6.3 Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları

Tablo 106. Kuruma Gelen Paketleri Sorgula Cevap Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç SNC

Liste

(PNO, KNO,

OKB, TRH)

- Sorgu sonucu dönen paket listesi

Page 185: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

185 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Paket Numarası SNC.

PNO Metin - Sistem paketi numarası

Kurum Numarası SNC.

KNO Sayı - Paketi oluşturan kurumun ÜTS’de tanımlı numarası

Okundu Bilgisi SNC.

OKB

Tek Seçimli

Liste -

Paketin okunup okunmadığı bilgisi

true: okundu

false: okunmadı

Oluşturulma

Tarihi

SNC.

TRH Tarih - Paketin oluşturulma tarihi

Mesaj Listesi MSJ

Liste

(TIP, MET,

KOD, MPA)

-

Hata alınması durumunda döndürülür.

Mesaj Tipi, Mesaj Metni, Mesaj Kodu ve

Mesaj Parametrelerinden oluşan listedir.

Mesaj Tipi MSJ.

TIP Metin 5

Mesajın tipidir. Aşağıdaki değerlerden birini alabilir.

BILGI

UYARI

HATA

Mesaj Metni MSJ.

MET Metin 255 İnsanların okumasına elverişli hata mesaj metnidir.

Mesaj Kodu MSJ.

KOD Sayı -

Bilgi sistemleri tarafından işlemeye elverişli mesaj

kodudur.

Mesaj

Parametreleri

MSJ.

MPA

Parametre

Listesi -

Genellikle metin olmakla birlikte sayı veya tarih

tipinde parametreler de döndürülebilmektedir.

3.5.6.4 Kuruma Gelen Paketleri Sorgula Örnek İstek

{

"EKT" : "2016-10-25",

"EBT" : "2016-10-29",

"OKB" : “AKTIF”,

"KNO" : 7

Page 186: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

186 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

}

3.6 FİRMA SORGULAMA SERVİSİ

Firmaların MERSİS numarası, vergi numarası, ÇKYS numarası ve/ya firma unvanı ile firma tanımlayıcı numarası

içeren firma bilgilerini sorgulamasını sağlayan servistir.

3.6.1 Firma Sorgulama Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/rest/kurum/firmaSorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS/rest/kurum/firmaSorgula

3.6.2 Firma Sorgulama Servisi Veri Alanları

Tablo 107. Firma Sorgulama Servisi İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

MERSİS

Numarası MRS Metin 16 Hayır Firmanın MERSİS Numarası

Vergi Numarası VRG Metin 10-11 Hayır Firmanın ÜTS Vergi Numarası

Unvan UNV Metin Hayır Firmanın ÜTS Firma Unvanı

Firma No KRN Sayı Hayır Firmanın ÜTS Firma Numarası

ÇKYS No CKY Metin 20 Hayır Firmanın ÇKYS Numarası

MRS, VRG, CKY parametrelerinden en az biri zorunludur.

En fazla 20 kayıt listelenir.

Tablo 108. Firma Sorgulama Servisi Sonuç Veri Alanları

Page 187: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

187 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

MERSİS

Numarası MRS Metin 16 Firmanın MERSİS Numarası

Firma

Tanımlayıcı No KRN Metin 13 Firmanın ÜTS Tanımlayıcı Numarası

Unvan GAD Metin 674 Firmanın ÜTS Firma Unvanı

Firma Durumu DRM Metin AKTIF/PASIF

Vergi No VRG Sayı 10-11 Firmanın Vergi Numarası

3.6.3 Firma Sorgulama Servisi Örnek İstek

Örnek servis çağrısı:

İstek

{

" VRG " : " 9999999999",

}

Sonuç

[{

" KRN ": firma tanımlayıcı numarası (Long),

" GAD ": firma unvanı (String)

" DRM ": firma durumu (AKTIF/PASIF),

" MRS ": firma Mersis numarası (String)

" VRG ": firma vergi numarası (String)

}]

3.7 ÜRÜN SORGULAMA SERVİSİ

Birincil ürün numarası ve üretici ÜTS firma numarası ile ürün bilgilerini sorgulamasını sağlayan servistir.

Page 188: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

188 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

3.7.1 Ürün Sorgulama Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/rest/tibbiCihaz/urunSorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS//rest/tibbiCihaz/urunSorgula

3.7.2 Ürün Sorgulama Servisi Veri Alanları

Birincil ürün numarası ürün bilgilerini sorgulamasını sağlayan servistir.

Tablo 109. Ürün Sorgulama Servisi İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Ürün Numarası UNO Metin 100 Evet Sorgulanacak ürünün birincil ürün

numarası

Tablo 110. Ürün Sorgulama Servisi Sonuç Veri Alanları

Adı JSON Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Sonuç sonuc Sayı 1 (ürün bulundu) / 0 (ürün bulunmadı)

Sonuç

Mesajı sonucMesaji Metin Ürün bulundu / Ürün bulunamadı

Ürün Listesi urunDetayLi

st Liste Girilen barkod numaralı ürün listesi

Tablo 111. Ürün Sorgulama Servisi Ürün Sonuç Veri Alanları

Adı JSON Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Birincil Ürün

Numarası

birincilUrunNumara

si Metin

Marka Adı markaAdi Metin

Page 189: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

189 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Versiyon/

Model versiyonModel Metin

Etiket Adı etiketAdi Metin

Ürün Tipi urunTipi Metin

TIBBI_CIHAZ,

SISTEM_ISLEM_PAKETI,

ISMARLAMA_TIBBI_CIHAZ

Referans/Kat

alog No referansKatalogNo Metin

İthal/İmal

Bilgisi ithalImalBilgisi Metin ITHAL, IMAL

Kayıt Durum kayitDurumu Metin KAYITLI, REDDEDILDI, SILINDI

Kayıt Durumu

Başlangıç

Tarihi

durumBaslangicTar

ihi Taih

Mevcut kayıt durumun ne zaman

başladığını gösterir.

Sınıf sinif Metin

SINIF_I_DIGER, SINIF_I_S,

SINIF_I_M, SINIF_II_A, SINIF_II_B,

SINIF_III, EK_II_LISTE_A,

EK_II_LISTE_B,

KISISEL_TEST_CIHAZLARI,

IVD_DIGER

Tek

Kullanımlık

tekKullanimlik Metin EVET, HAYIR

Lateks

İçeriyor mu latexIceriyor Metin EVET, HAYIR, BILINMIYOR

MRG Uyumlu

mu mrgUyumlu Metin

Steril

Paketlendi mi sterilPaketlendi Metin EVET, HAYIR

Page 190: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

190 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Her

Kullanımda

Sterilizasyon

Gerekiyor mu

herKullanimdaSteril

izasyonGerekli Metin EVET, HAYIR

İyonize

Radyasyon

İçeriyor mu

iyonizeRadyasyonI

cerir Metin EVET, HAYIR

DEHP

İçeriyor mu dehpIceriyor Metin EVET, HAYIR, BILINMIYOR

Nanomateryal

İçeriyor mu

nanomateryalIceriy

or Metin EVET, HAYIR

Sınırlı

Kullanım

Sayısı Var mı

sinirliKullanimSayis

iVar Metin EVET, HAYIR

Sınırlı

Kullanım

Sayısı

sinirliKullanimSayis

i Sayı

Raf Ömrü Var

mı rafOmruVar Metin EVET, HAYIR

Raf Ömrü rafOmru Sayı

Ek3

Kapsamında

Satılabilir mi

ek3KapsamindaMi Metin

EVET, HAYIR (Tıbbi Cihaz Satış

Yönetmeliği EK3 göre ruhsatsız

satılabilir mi?)

Kalibrasyona

Tabi mi kalibrasyonaTabiMi Metin EVET, HAYIR

Kalibrasyon

Periyodu

kalibrasyonPeriyod

u Sayı Ay bazında kalibrasyon periyodu

Bakıma Tabi

mi bakimaTabiMi Metin EVET, HAYIR

Page 191: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

191 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı JSON Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Bakım

Periyodu bakimPeriyodu Sayı Ay bazında bakım periyodu

Takip

Durumu takipDurumu Metin Takip Ediliyor / Takip Edilmiyor

Üretici Firma üreticiFirma Metin Üretici firma no – firma adı

Branş Kodu

Türü bransTurKodu Sayı Ürüne ait branş tür kodu

GMDN Kodu gmdnKodu Sayı Ürüne ait GMDN kodu

SUT Kodu sutKodu Metin

3.7.3 Ürün Sorgulama Servisi Örnek İstek

Örnek servis çağrısı:

İstek

{

"UNO" : "048327885764"

}

Sonuç

{

"sonuc": 0,

"sonucMesaji": "Ürün bulundu.",

"urunDetayList": [

{

"ureticiFirma": "10 - Erdil Medikal Ltd. Şti. (Optisyenlik Müessesesi)",

"birincilUrunNumarasi": "1111111110317",

"markaAdi": "Örnek Marka",

"versiyonModel": "XXX-Q1",

"etiketAdi": "Görüntüleme",

"urunTipi": "TIBBI_CIHAZ",

"referansKatalogNo": null,

"ithalImalBilgisi": "IMAL",

"kayitDurumu": "KAYITLI",

Page 192: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

192 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"durumBaslangicTarihi": "22/12/2017",

"sinif": "SINIF_III",

"tekKullanimlik": "HAYIR",

"latexIceriyor": "HAYIR",

"mrgUyumlu": "MR_GUVENLI_DEGIL",

"sterilPaketlendi": "HAYIR",

"herKullanimdaSterilizasyonGerekli": "HAYIR",

"iyonizeRadyasyonIcerir": "HAYIR",

"dehpIceriyor": "HAYIR",

"nanomateryalIceriyor": "HAYIR",

"sinirliKullanimSayisiVar": "HAYIR",

"sinirliKullanimSayisi": null,

"rafOmruVar": "HAYIR",

"rafOmru": null,

"ek3KapsamindaMi": "HAYIR",

"bransKodu": "81",

"bransTurKodu": "81",

"gmdnKodu": "30857",

"takipDurumu": "Takip Ediliyor",

"kalibrasyonaTabiMi": "Hayır",

"kalibrasyonPeriyodu": null,

"bakimaTabiMi": "Hayır",

"bakimPeriyodu": null,

“sutKodu”: null

}

]

}

3.8 BÜTÜN ÜRÜNLERİ SORGULAMA SERVİSİ

Firmaların kendi ürünlerini çoklu olarak sorgulamalarını sağlayan servistir.

3.8.1 Bütün Ürünleri Sorgulama Servis Adresi

Gerçek Ortam: https://utsuygulama.saglik.gov.tr/UTS/rest/tibbiCihaz/tibbiCihazSorgula

Test Ortamı: https://utstest.saglik.gov.tr/UTS//rest/tibbiCihaz/tibbiCihazSorgula

3.8.2 Bütün Ürünleri Sorgulama Servisi Veri Alanları

Birincil ürün numarası ürün bilgilerini sorgulamasını sağlayan servistir.

Page 193: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

193 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Tablo 112. Bütün Ürünleri Sorgulama Servisi İstek Veri Alanları

Adı JSON

Kodu Veri Tipi

En Fazla

Uzunluk

(Karakter)

Zorunlu

mu? Açıklama

Sayfa

Büyüklüğü

sayfaBuyu

klugu Sayı 1-250 Evet Bir sayfada kaç ürün geleceğini belirtir.

Sayfa İndeksi sayfaInde

ksi Sayı Evet

Hangi sayfadaki ürünlerin getirileceğini

belirtir.

Başlangıç Tarihi baslangic

Tarihi Tarih Hayır

dd/MM/yyyy formatında veri kabul

etmektedir. Bu tarihten sonra değişen

ürün bilgilerinin filtrelenmesinde

kullanılır.

Bitiş Tarihi bitisTarihi Tarih Hayır

dd/MM/yyyy formatında veri kabul

etmektedir. Bu tarihten önce değişen

ürün bilgilerinin filtrelenmesinde

kullanılır.

Tablo 113. Bütün Ürünleri Sorgulama Servisi Sonuç Veri Alanları

Adı Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Listesi urunDetayList İstek kriterlerine uyan ürünlerin listesi

Tablo 114. Bütün Ürünleri Sorgulama Servisi Ürün Sonuç Veri Alanları

Adı Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Ürün Sınıfı sinif

Takip Durumu takipDurumu Takip Ediliyor, Takip Edilmiyor

Page 194: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

194 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

Adı Veri Tipi

En Fazla

Uzunluk

(Karakter)

Açıklama

Birincil Ürün

Numarası birincilUrunNumarasi

Ürün Tipi urunTipi TIBBI_CIHAZ, SISTEM_ISLEM_PAKETI,

ISMARLAMA_TIBBI_CIHAZ

Durum durum KAYITLI, REDDEDILDI

Durum

Başlangıç Tarihi durumBaslagicTarihi

Ürün hangi tarihten itibaren verilen durumda

olduğunu belirtir.

Marka Adı markaAdi

Etiket Adı etiketAdi

Versiyon/ Model versiyonModel

Referans/Katalo

g No katalogNo

İthal İmal Bilgisi ithalImalBilgisi ITHAL, IMAL

Güncellenme

Tarihi guncellenmeTarihi

dd/MM/yyyy formatında ürünün en son güncellenme

tarihini belirtir.

3.8.3 Bütün Ürünleri Sorgulama Servisi Örnek İstek

Örnek servis çağrısı:

İstek

{

"sayfaBuyuklugu": "250",

"sayfaIndeksi": "0",

"baslangicTarihi": "01/01/2018"

}

Sonuç

[

{

“sinif”: “SINIF_I_DIGER”,

“takipDurumu”: “Takip Ediliyor”,

Page 195: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

195 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

"birincilUrunNumarasi": "55655444444",

"urunTipi": "TIBBI_CIHAZ",

"durum": "KAYITLI",

"durumBaslangicTarihi": "24/05/2018",

"markaAdi": "Bir Tıbbi Cihaz 2",

"etiketAdi": "kafatası protezi",

"versiyonModel": "XXX-Q1",

"katalogNo": null,

"ithalImalBilgisi": "ITHAL",

"guncellenmeTarihi": "24/05/2018"

}

]

Page 196: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

196 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

4 EKLER

4.1 EK-A SERVİS MESAJLARI

Tablo 115. Servis Mesajları

Mesaj Kodu Mesaj Açıklaması

UTS-H001 Kullanılabilir miktar yeterli değil.

UTS-H002 Tekil Ürün bulunamadı.

UTS-H003 Geri Çekme Verme Bildirimi bulunamadı.

UTS-H004 Geri Çekme Verme (Paket) Bildirimi bulunamadı.

UTS-H005 Kurum sadece kendine ait bildirimleri iptal edebilir.

UTS-H006 Aynı lot numarasına sahip tekil ürünlerin üretim tarihleri farklı olamaz.

UTS-H007 Son kullanma tarihi formatı uygun değildir.

UTS-H008 Alınan adet, verme bildiriminde gönderilen adetten fazla olamaz.

UTS-H009 Bu tekil ürün şuan askıdadır. Yeni bir bildirim yapılamaz.

UTS-H010 Bildirim Aktif olmalıdır.

UTS-H011 İlgili işlem için stokta yeteri kadar ürün bulunmamaktadır.

UTS-H012 Bildirim yapan kurum aktif olmalıdır.

UTS-H013 İlgili bildirimin yapılabilmesi için ürünün eşsiz kimliği olmalıdır.

UTS-H014 Girilen eşsiz kimliği değerine göre ürün sistemde bulunmamaktadır.

UTS-H015 Firma tipi seçeneklerinden ESBİS veya MERNİS bilgilerinden biri girilmelidir.

UTS-H016 İlgili ürün için daha önceden bildirilmiş bir Geçici Kullanıma Verme Bildirimi bulunmamaktadır.

UTS-H017 Bu tekil ürün şuan geçici kullanıma verilmiştir. Yeni bir bildirim yapılamaz.

UTS-H018 Geri Toplatılmış Tekil Ürün için bildirim yapılamaz.

UTS-H019 İmal ürünler için İthalat Bildirimi yapılamaz.

UTS-H020 İthal ürünler için Üretim Bildirimi yapılamaz.

UTS-H021 Bir kurumda aynı numaraya sahip iki paket bulunamaz.

UTS-H022 Adet sıfırdan büyük olmalıdır.

UTS-H023 MERNİS doğrulaması başarısız.

UTS-H024 Satarken tüketici kimlik bilgisi gereklidir.

Page 197: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

197 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

UTS-H025 Girilen seri numarası daha önce tanımlanmıştır.

UTS-H026 Lot numarası boş olamaz.

UTS-H027 Sınırlı sayıda kullanılan tıbbi cihazın sınırlı kullanım sayısı olmalıdır.

UTS-H028 Son kullanma tarihi, üretim tarihinden sonra olmalıdır.

UTS-H029 Son kullanma tarihi, bugünden önce olamaz.

UTS-H030 Tekil ürün üzerinde başka bildirim olduğu için bu bildirim yapılamaz.

UTS-H031 Ürün aktif olmalıdır.

UTS-H032 Ürünün belgeleri üretim tarihinde geçerli olmalıdır.

UTS-H033 Verme bildirimindeki gönderilen adet sıfırdan büyük olmalıdır.

UTS-H034 Verme bildirimi yetkili olunan kuruma ait değildir. Başka bir kuruma yapılmıştır.

UTS-H035 Geri çekme verme bildirimi yetkili olunan kuruma ait değildir. Başka bir kuruma yapılmıştır.

UTS-H036 Tekil ürün geri çekme askı durumunda olmalıdır.

UTS-H037 Verme bildirimi veritabanında bulunmamaktadır.

UTS-H038 Paket bildirimi veritabanında bulunmamaktadır.

UTS-H039 Kullanım sayısı yeterli değil.

UTS-H040 Kozmetik ürünler için kullanım bildirimi yapılamaz.

UTS-H041 Parametreler eksik.

UTS-H042 Kurum aktif değildir.

UTS-H043 Ürün veritabanında bulunmamaktadır.

UTS-H044 Ürün bulunamadı.

UTS-H045 Ürün takip edilmemektedir.

UTS-H046 Raf ömrü dolan ürün için bildirim yapılamaz.

UTS-H047 Askıdaki ürünler için bildirim yapılamaz.

UTS-H048 Geçici kullanıma verilmiş ürün için bildirim yapılamaz.

UTS-H049 Aktif olmayan Tekil Ürün için bildirim yapılamaz.

UTS-H050 Tekil Ürün son kullanma tarihi geçmemiş olmalıdır.

UTS-H051 Tekil ürünün son kullanma tarihi geçmiştir.

UTS-H052 Yapılan istek için gönderilen parametreler eksiktir.

Page 198: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

198 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

UTS-H053 İptal edilmek istenen bildirim veritabanında bulunmamaktadır.

UTS-H054 Tekil ürün kurumunuz bünyesinde değildir.

UTS-H055 Bildirim iptal süresi dolmuştur. Bildirim iptal edilemez.

UTS-H056 Bildirim veri tabanında bulunmamaktadır.

UTS-H057 Lot takipte adet bilgisi boş olamaz.

UTS-H058 HEK Zayiat türü Diğer ise Diğer Açıklama alanı doldurulmalıdır.

UTS-H059 Hastanın vücudundan çıkarma bildiriminde gerekçe Diğer ise Diğer Gerekçe Açıklaması alanı

doldurulmalıdır.

UTS-H060 Üretim tarihi bugünden sonra olamaz.

UTS-H061 Üretim tarihi, bildirimin yapıldığı tarihten raf ömrü kadar geri gidebilir.

UTS-H062 Adet bilgisi boş olamaz.

UTS-H063 Seri numarası boş olamaz.

UTS-H064 Lot adedi sıfırdan büyük olmalıdır.

UTS-H065 Lot adedi girilmelidir.

UTS-H066 Hasta kimlik numarası girilmiş olmalıdır.

UTS-H067 Kullanım sayısı sınırsız olan ürünler için kullanım bildirimi yapılamaz.

UTS-H068 Üretim tarihi bildirim tarihinden ileride olmaz.

UTS-H069 Üretim tarihi raf ömründen geride olamaz.

UTS-H070 Bildirim adeti sıfırdan küçük veya boş olamaz.

UTS-H071 Bildirimi yapan kurum aktif olmalıdır.

UTS-H072 İthal edilen ülke ile ürün bağlantılı değildir.

UTS-H073 Menşei ülke ile ürün bağlantılı değildir.

UTS-H074 İlgili ürün için daha önceden bildirilmiş bir Tüketiciye Verme Bildirimi bulunmamaktadır.

UTS-H075 Tüketiciye verme bildiriminde iade alınan adet tüketiciye verilen adetten fazla olamaz.

UTS-H076 Tüketiciden İade Alma bildiriminde iade alınan adet sıfırdan büyük olmalıdır.

UTS-H077 Toplam tekil ürün adedinden fazla pakete eklenemez.

UTS-H078 Tekil ürün adeti sıfırdan büyük olmalıdır.

UTS-H079 Bildirimin yapılması için Geri Çekme tanımlanmış olmalıdır.

Page 199: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

199 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

UTS-H080 Geri Çekme sebebi "Güvensiz" olamaz.

UTS-H081 Bu tekil ürün şuan geri çekme askıdadır. Yeni bir bildirim yapılamaz.

UTS-H082 Verilen kurum sistemde bulunamadı.

UTS-H083 Paket sistemde bulunamadı.

UTS-H084 Paket veren kurumda değil.

UTS-H085 Paket mahrecine iade etme bildirimini yapan kurumda değil.

UTS-H086 Bildirim türü hatalıdır.

UTS-H087 Konfigürasyon türü tekil takip olan ürünler için girilen adet 1 veya boş olmalıdır.

UTS-H088 Bildirim yapılabilmesi için paketin aktif olması gerekmektedir.

UTS-H089 Gönderilen bildirim kodu paket verme bildirimine ait değildir.

UTS-H090 Verilen kurum sistemde mevcut değil.

UTS-H091 Tekil ürün tüketicide veya kullanımda olmalıdır.

UTS-H092 {0} seri numaralı tekil ürünler başka bir paket içinde yer almaktadır. Tekil bazlı takip edilen

tekil ürünler sadece tek paket içinde yer alabilir.

UTS-H093 Ürün geri çekildiği için bildirim gerçekleştirilemez.

UTS-H094 Tekil ürün geri çekildiği için bildirim gerçekleştirilemez.

UTS-H095 Ismarlama tıbbi cihaz sadece üründeki kişiye verilebilir.

UTS-H096 Firma güvensiz ürünü kendisi geri çekemez.

UTS-H097 Sistem işlem paketindeki alt ürünlerinin miktarları yeterli değildir.

UTS-H098 Sistem işlem paketindeki lot bazlı takip edilen ürünler için adet girilmemiştir.

UTS-H099 Tekil ürün kurumda değil ya da kurum üretici yada ithalatçı değildir.

UTS-H100 Kozmetik ürün setindeki alt ürünlerinin miktarları yeterli değildir.

UTS-H101 Kozmetik ürün setindeki lot bazlı takip edilen ürünler için adet girilmemiştir.

UTS-H102 Ismarlama tıbbi cihazlar için geçici kullanıma verme bildirimi yapılamaz.

UTS-H103 Ismarlama tıbbi cihazlar için ÜTS’de tanımsız yere verme bildirimi yapılamaz.

UTS-H104 Ismarlama tıbbi cihazlar için yeniden işleme bildirimi yapılamaz.

UTS-H105 Diğer kurum aktif olmalıdır.

UTS-H106 Diğer kurum numarası eksiktir.

Page 200: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

200 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

UTS-H107 Sistem işlem paketinde tekil takip edilen ürün/ürünler başka bir sistem işlem paketi içerisinde

eklenmiştir.

UTS-H108 Firma kendisine verme bildirimi yapamaz.

UTS-H109 Firma kendisine geri çekme verme bildirimi yapamaz.

UTS-H110 Kozmetik ürün setindeki tekil takip edilen ürün/ürünler başka bir kozmetik ürün seti içerisinde

eklenmiştir.

UTS-H111 Bu firma ÜTS'de tanımlıdır. ÜTS'de tanımlı firmalara ÜTS'de Tanımsız Yere Verme bildirimi

yapılamaz. Verme bildirimi yapılabilir.

UTS-H112 Paket içeriğindeki tüm bildirimler başarısız oldu. Paket bildirimi eklenemedi.

UTS-H113 Paket numarasını paketi oluşturan kurumdan başkası güncelleyemez.

UTS-H114 İmal ürünler için mahrecine iade bildirimi yapılamaz.

UTS-H115 Alma bildirimi yapılmış verme bildirimi iptal edilemez.

UTS-H116 İthal edildiği ülke kodu geçerli değildir.

UTS-H117 Kullanımdan alma bildirimi yapılmış bildirim için iptal bildirimi yapılamaz.

UTS-H118 SİP içindeki tekil ürünler için geri çekme kararı verilmiş olamaz.

UTS-H119 SİP içindeki tekil ürünler için güvensiz geri çekme kararı verilmiş olamaz.

UTS-H120 SİP içindeki tekil ürünlerin son kullanma tarihi geçmiş ya da raf ömrü dolmuş olamaz.

UTS-H121 SİP içine aynı tekil ürünün farklı lotları eklenemez.

UTS-H122 Paket askıda olduğu için silme işlemi yapılamaz.

UTS-H123 Paket geri çekme askıda olduğu için silme işlemi yapılamaz.

UTS-H124 SİP tanımına göre içindeki tekil ürünler eksik.

UTS-H125 Hastanın vücudundan çıkarma gerekçesinin Geri Çağırma seçilebilmesi için ürün geri

çekilmiş olmalıdır.

UTS-H126 Bu paket şuan askıdadır. Yeni bir bildirim yapılamaz.

UTS-H127 İthalat tarihi, üretim tarihinden sonra olmalıdır.

UTS-H128 İthalat tarihi raf ömründen geride olamaz.

UTS-H129 Üretim veya ithalat tarihlerinden en az biri girilmiş olmalıdır.

UTS-H130 İthalat tarihi bildirim tarihinden ileride olmaz.

UTS-H131 Son kullanma tarihi, üretim ve ithalat tarihinden sonra olmalıdır.

Page 201: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

201 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

UTS-H132 ÜTS’de tanımsız yere verme bildiriminde iade alınan adet verilen adetten fazla olamaz.

UTS-H133 İlgili ürün için daha önceden ÜTS’de tanımsız yere verme bildirimi bulunmamaktadır.

UTS-H134 Tekil ürün sadece bildirim yapılan kuruma iade edilebilir.

UTS-H135 Sadece askıdaki tekil ürünler için alma bildirimi yapılabilir.

UTS-H136 Tekil ürün hastanın vücudundan çıkartıldığı için bu bildirim yapılamaz.

UTS-H137 Pakete sadece kurum üzerindeki paketler eklenebilir.

UTS-H138 Pakete sadece kurum üzerindeki tekil ürünler eklenebilir.

UTS-H139 İlgili işlem için stokta yeteri kadar ürün bulunmamaktadır. Stokta {0} adet tekil ürün

bulunmaktadır.

UTS-H140 Kozmetik ürünler için geçici kullanıma verme bildirimi yapılamaz.

UTS-H141 Lot bazında takip edilen ürünler için seri/sıra numarası verilemez.

UTS-H144 Paket içerisine, paketin içerisinde olduğu paket koyulamaz.

UTS-H145 Güncellenmek istenen paket kurum üzerinde olmalıdır.

UTS-H146 Tıbbi Cihazlar Kozmetik firmasına verilemez.

UTS-H147 Tıbbi Cihazlar için Üretim tarihi girilmesi zorunludur.

UTS-H148 Kozmetik ürünler için hastanın vücudundan çıkarma bildirimi yapılamaz.

UTS-H149 Paket sadece bildirim yapılan kuruma iade edilebilir.

UTS-H150 Pasif kurumlar ödünç verme bildirimi yapamaz.

UTS-H151 Firma kendisine verme bildirimi yapamaz.

UTS-H152 Tıbbi Cihazlar için kozmetik firmasına ödünç verme bildirimi yapılamaz.

UTS-H153 Kozmetik ürünler için ödünç verme bildirimi yapılamaz.

UTS-H154 Lot bazında takip edilen tıbbi cihazlar için ödünç verme bildirimi yapılamaz.

UTS-H155 Ödünç Verme Askıdaki ürünler için bildirim yapılamaz.

UTS-H156 Ödünç Alma bildirimi yapılmış ödünç verme bildirimi iptal edilemez.

UTS-H157 Kozmetik ürünler için ödünç alma bildirimi yapılamaz.

UTS-H158 Lot bazında takip edilen tıbbi cihazlar için ödünç alma bildirimi yapılamaz.

UTS-H159 Paketler için ödünç alma bildirimi yapılamaz.

UTS-H160 Bu tekil ürün şuan tüketicidedir. Yeni bir bildirim yapılamaz.

Page 202: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

202 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

UTS-H161 Ismarlama tıbbi cihaz bildirimleri henüz başlamamıştır

UTS-H162 Kozmetik ürün seti bildirimleri henüz başlamamıştır

UTS-H163 Sistem işlem paketi bildirimleri henüz başlamamıştır

UTS-H164 Kimlik bilgileri girilmelidir.

UTS-H165 Seri numarası karakter sayısı hatalıdır.

UTS-H166 Lot numarası karakter sayısı hatalıdır.

UTS-H168 İade edilmek istenen bildirim veri tabanında bulunmamaktadır.

UTS-H169 Paket numarası daha önce tanımlanmıştır.

UTS-H170 Verilen Tekil Ürün bilgilerine uyan bildirim bulunamadı!

UTS-H171 Verilen Tekil Ürün bilgilerine uyan birden fazla bildirim bulundu!

UTS-H172 Okundu olarak işaretlenecek sistem paketi kuruma gelmiş olmalıdır.

UTS-H173 Yedi emin kararı bulunan tekil ürünler hareket ettirilemez

UTS-H174 Silinecek paket başka paket içinde olduğu için silinemez

UTS-H175 Girilen paket numarası mevcut olduğu için aynı paket eklenemez

UTS-H176 Paket içine eklenmek istenen paket önceden eklendiği için tekrar eklenemez

UTS-H177 Paket içine kendisi eklenemez

UTS-H178 SET tanımına göre içindeki tekil ürünler eksik

UTS-H179 ÜTS’de tanımsız yerden iade almada, iade alınan adet sıfırdan büyük olmalıdır

UTS-H180 Ödünç geri verme askıdaki ürünler için bildirim yapılamaz

UTS-H181 Verilen kurum tekil ürünün sahibi olmalıdır

UTS-H182 Tekil ürün önceden ödünç verilmiş olamaz

UTS-H183 Verilen eşsiz kimlikli ürün sistemde yoktur

UTS-H184 İptal edilmek istenen bildirime ait paket başka paket içinde olduğu için bildirim iptal edilemez

UTS-H185 Silinecek paket üzerinde bildirim olduğu için paket silinemez

UTS-H186 Aktif olmayan paket güncellenemez

UTS-H187 Vergi kimlik no girilmelidir

UTS-H188 Firma VEDOP’ta tanımlı değildir

Page 203: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

203 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

UTS-H189 Tekil ürün bildirim yapılan kurumda değildir. Tekil ürün kurum numarası : {0} ve unvanı : {1}

olan kurumdadır.

UTS-H190 Tekil ürünün adet bilgisi ile ilgili sorun tespit edildiği için hareket bildirimleri dondurulmuştur.

İdare ile iletişime geçiniz.

UTS-H191 Aynı lot numarası ile farklı eşsiz kimlikli ürün üretilemez / ithal edilemez.

UTS-H192 Paket içindeki tüm tekil ürün bildirimleri başarısız olduğu için paket bildirimi

gerçekleştirilememiştir.

UTS-H193 Tüketiciye Verme Bildirimini yapan kurum SGK olduğu için, bu bildirimi yapan kurum da SGK

olmalıdır.

UTS-H194 Tüketiciye Verme Bildirimini yapan kurum SGK olmadığı için, bu bildirimi yapan kurum SGK

olamaz.

UTS-H195 Tüketiciden iade alan kurum, tüketiciye verme bildirimi yapan kurum ile aynı vergi noya sahip

olmalıdır.

UTS-H196 Kozmetik Ürünler Tıbbi Cihaz firmasına verilemez.

UTS-H197 Tüketiciye verme tarihi bugünden sonra olamaz.

UTS-H198 Hastanın vücudundan çıkarma tarihi bugünden sonra olamaz.

UTS-H199 Kullanım tarihi bugünden sonra olamaz.

UTS-H200 {0} tarihi {1} tarihinden önce olamaz.

UTS-H201 Geçici kullanıma verme tarihi bugünden sonra olamaz.

UTS-H202 Ödünç verme tarihi bugünden sonra olamaz.

UTS-H203 Tekil ürün ÜTS dışındadır.

UTS-H204 Üretim / İthalat tarihinde geçerli konfigürasyon olduğu için gönüllü takip yapılamaz.

UTS-H205 Silinecek paket aktif olmalıdır.

UTS-H206 Bildirim TİTCK tarafından yapılmamıştır.

UTS-H207 Alt paket bulunamadı.

UTS-H208 Tekil ürünün eşsiz kimliği bulunduğu için, bu sorgulama eşsiz kimlik ile sorgula tarafında

yapılmalıdır. ( Tekil ürünün eşsiz kimliği : {0} )

UTS-H209 Kişi kimlik bilgisi türü Diğer ise Diğer Açıklama alanı doldurulmalıdır.

UTS-H210 Bildirim tarihi bugünden sonra olamaz.

UTS-H222 Kullanım bildirimi için adet 1 olmalıdır.

Page 204: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

204 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

UTS-H223 Ismarlama tıbbi cihazlar LOT ya da GÖNÜLLÜ LOT olarak takip edilemez.

UTS-H224 Alt tekil ürünlerin üretim tarihi, SIP/SET'in üretim tarihinden ileride olamaz.

UTS-H225 Alt tekil ürünlerin üretim/ithalat tarihi, SET üretim/ithalat tarihinden ileride olamaz.

UTS-H226 SET içine aynı tekil ürünün farklı lotları eklenemez.

UTS-H227 SIP/SET içine aynı tekil ürün eklenemez.

UTS-H228 Alt tekil ürünlerde tekil takip edilen tekil ürün bulunduğu için SIP/SET tekil takip edilmektedir.

Takip konfigürasyonu Gönüllü Lot seçilemez.

UTS-H231 Iade alınan tekil ürün olduğu için bildirim iptal edilemez.

UTS-H232 Başkasına ait tekil ürünler için kullanımdan alma bildirimi yapılamaz.

UTS-H233 Son kullanma tarihi, ithalat tarihinden sonra olmalıdır.

UTS-H234 Verilen paket numarasına ait paket bulunamadı.

UTS-H235 Vergi numarasi, gümrük beyanname belgesinde bulunan vergi numarasi ile uyumlu değildir.

UTS-H236 Gümrük beyanname bilgisi daha önce kaydedilmiştir.

UTS-H237 Girilen beyanname ve kalem numarasına ait gümrük beyanname bilgisi bulunamamıştır.

UTS-H238 Gümrük beyanname bilgisi girilen ürün ithal olmalıdır.

UTS-H239 Gümrük beyannamesi başka kurum tarafından eklenmiştir.

UTS-H240 İthal edilemek istenen ürün için tanımlı gümrük beyannamesi bulunamadı.

UTS-H241 Yeterli gümrük kotası bulunmamaktadır.

UTS-H242 Envanter tarihi bugünden sonra olamaz.

UTS-H243 Üretici/İthalatçı kurum aktif olmalıdır.

UTS-H244 Üretici/İthalatçı kurum ÜTS'de bulunmamaktadır.

UTS-H245 Ürün envanter ürünü değildir.

UTS-H246 Ürün türü tıbbi cihaz olmalıdır.

UTS-H247 Menşei ülkesi Türkiye olan ürünler için ithalat bildirimi yapılamaz.

UTS-H248 Eksik alma bildirimi yetkili olunan kuruma ait değildir. Başka bir kuruma yapılmıştır.

UTS-H249 Stok tarihi bugünden sonra olamaz.

UTS-H250 Aynı lot numarasına sahip tekil ürünlerin stok veya üretim tarihleri farklı olamaz.

UTS-H251 Son kullanma tarihi stok tarihinden önce olamaz.

Page 205: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

205 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

UTS-H252 Üretici/İthalatçı kurum ile bildirim yapan kurum arasında bayilik ilişkisi olmalıdır.

UTS-H253 Kurum kendi üzerinden stok bildirimi yapamaz.

UTS-H254 Kurum kendi üzerinden envanter bildirimi yapamaz.

UTS-H255 Kurumdaki aynı ürün ve lot/batch numaralı tekil ürünün stok tarihinde, aynı ürün ve lot/batch

numaralı farklı üretim tarihli tekil ürün alınamaz.

UTS-H256 Kullanım bildiriminde tüketici bilgisi girilmemiş olduğu için kullanım kilitleme yapılamaz.

UTS-H257

Aynı lot numaralı tekil ürünün ÜTS''ye giriş tarihleri aynı olmalıdır. Daha önce yapılan

(üretim/ithalat/stok) bildirim(ler)inde, tekil ürünün sisteme giriş (üretim/ithalat) tarihi (yıl-ay-

gün) : {0}

UTS-B001 Yeniden işleme iptal bildirimi yapıldı.

UTS-B002 İthalat bildirimi yapıldı.

UTS-B003 İhracat bildirimi yapıldı.

UTS-B004 Kullanım bildirimi yapıldı.

UTS-B005 Geçici kullanıma verme bildirimi yapıldı.

UTS-B006 Alma bildirimi yapıldı.

UTS-B007 Geri çekme alma bildirimi yapıldı.

UTS-B008 Geri çekme alma (paket) bildirimi yapıldı.

UTS-B009 Geçici kullanıma verme iptal bildirimi yapıldı.

UTS-B010 Hastanın vücudundan çıkarma bildirimi yapıldı.

UTS-B011 Hastanın vücudundan çıkarma iptal bildirimi yapıldı.

UTS-B012 {0} numaralı paket eklendi.

UTS-B013 {0} numaralı paket güncellendi.

UTS-B014 {0} numaralı paket silindi.

UTS-B015 İthalat iptal bildirimi yapıldı.

UTS-B016 ÜTS'de tanımsız yere verme bildirimi yapıldı.

UTS-B017 ÜTS'de tanımsız yere verme iptal bildirimi yapıldı.

UTS-B018 Kullanım iptal bildirimi yapıldı.

UTS-B019 Kullanımdan alma bildirimi yapıldı.

UTS-B020 Kullanımdan alma iptal bildirimi yapıldı.

Page 206: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

206 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

UTS-B021 Tüketiciye vermeyi iptal bildirimi yapıldı.

UTS-B022 Üretim iptal bildirimi yapıldı.

UTS-B023 Tüketiciye verme bildirimi yapıldı.

UTS-B024 Üretim bildirimi yapıldı.

UTS-B025 Verme iptal bildirimi yapıldı.

UTS-B026 Yeniden işleme bildirimi yapıldı.

UTS-B027 Verme bildirimi yapıldı.

UTS-B028 Mahrecine iade etme bildirimi yapıldı.

UTS-B029 Mahrecine iade etme iptal bildirimi yapıldı.

UTS-B030 HEK/Zayiat bildirimi yapıldı.

UTS-B031 HEK/Zayiat iptal bildirimi yapıldı.

UTS-B032 İhracat iptal bildirimi yapıldı.

UTS-B033 Geri çekme verme bildirimi yapıldı.

UTS-B034 Tüketiciden iade alma bildirimi yapıldı.

UTS-B035 İmha/Bertaraf bildirimi yapıldı.

UTS-B036 İmha/Bertaraf iptal bildirimi yapıldı.

UTS-B037 Islah/Düzeltici faaliyet bildirimi yapıldı.

UTS-B038 Islah/Düzeltici faaliyet iptal bildirimi yapıldı.

UTS-B039 Tüketiciden iade alma iptal bildirimi yapıldı.

UTS-B040 Geri çekme verme iptal bildirimi yapıldı.

UTS-B041 Verme (paket) bildirimi yapıldı.

UTS-B042 Mahrecine iade etme (paket) bildirimi yapıldı.

UTS-B043 Verme (paket) iptal bildirimi yapıldı.

UTS-B044 Geri çekme verme (paket) bildirimi yapıldı.

UTS-B045 Alma (paket) bildirimi yapıldı.

UTS-B046 İhracat (paket) bildirimi yapıldı.

UTS-B047 ÜTS'de tanımsız yere verme (paket) bildirimi yapıldı.

UTS-B048 ÜTS'de tanımsız yere verme (paket) iptal bildirimi yapıldı.

Page 207: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

207 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

UTS-B049 İhracat (paket) iptal bildirimi yapıldı.

UTS-B050 Mahrecine iade etme (paket) iptal bildirimi yapıldı.

UTS-B051 Geri çekme verme (paket) iptal bildirimi yapıldı.

UTS-B052 ÜTS’de tanımsız yerden iade alma bildirimi yapıldı.

UTS-B053 ÜTS’de tanımsız yerden iade alma iptal bildirimi yapıldı.

UTS-B054 ÜTS'de tanımsız yerden iade alma (paket) bildirimi yapıldı.

UTS-B055 ÜTS'de tanımsız yerden iade alma (paket) iptal bildirimi yapıldı.

UTS-B056 Ödünç verme bildirimi yapıldı.

UTS-B057 Ödünç verme iptal bildirimi yapıldı.

UTS-B058 Ödünç alma bildirimi yapıldı.

UTS-B059 Tüketiciye verme bildirimi yapılabilir.

UTS-B060 {0} nolu sistem paketi okundu olarak işaretlendi.

UTS-B061 Ödünç geri alma bildirimi yapıldı.

UTS-B062 Sorgulanan tekil ürün TİTUBB''da kayıtlıdır.

UTS-B063 Sorgulanan tekil ürün TİTUBB''da kayıtlı değildir.

UTS-B066 Gümrük beyanname bilgisi kaydedildi.

UTS-B067 Gümrük beyanname bilgisi silindi.

UTS-B068 Envanter bildirimi yapıldı.

UTS-B069 Envanter iptal bildirimi yapıldı.

UTS-B070 Seçilen bildirimin görüldü durumu güncellendi.

UTS-B071 Stok bildirimi yapıldı.

UTS-B072 Stok iptal bildirimi yapıldı.

UTS-U001 Tekil ürün geri çekilmiştir.

UTS-U002 Ürün geri çekilmiştir.

UTS-U003 Geri çekilmemiş tekil ürünler paketten çıkarılmıştır.

UTS-U004 Uyarı: {0} nolu paket içindeki {1} tekil ürün için {2} hatası nedeniyle bildirim yapılamamıştır.

UTS-U005 Uyarı: {0} nolu paket içindeki {1} tekil ürün ve {2} numaralı bildirim için {3} hatası nedeniyle

bildirim yapılamamıştır.

Page 208: TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI · TASNİF DIŞI TÜBİTAK – BİLGEM – YTE ÜTS PROJESİ TAKİP VE İZLEME WEB SERVİS TANIMLARI DOKÜMANI TASNİF DIŞI Rev

TASNİF DIŞI

TÜBİTAK – BİLGEM – YTE

ÜTS PROJESİ

TAKİP VE İZLEME WEB SERVİS

TANIMLARI DOKÜMANI

TASNİF DIŞI Rev. No: 31 Tarih: 13.01.2016

208 / 208 UTS-PRJ-TakipVeIzlemeWebServisTanimlariDokumani

TÜBİTAK – BİLGEM – YTE