REST API nedir?
İTS'ye toplu bildirim gönderen yazılımlar, İTS'nin web servisleriyle konuşur. Eski SOAP servisleri 08.07.2022'de kapandı. 11.07.2022'den beri servisler REST mimarisiyle https://its2.saglik.gov.tr adresinden sunuluyor. Test ortamı https://itstest2.saglik.gov.tr adresindedir.
Nasıl çalışır?
- İstekler JSON biçiminde, HTTP POST ile gönderilir.
- Her istekte, token servisinden alınan access token Bearer olarak taşınır.
- Başarılı bir bildirimde İTS bir bildirim numarası (notificationId) ve her ürün için bir sonuç kodu döndürür; 00000 başarı demektir.
- Hata durumunda beş haneli bir hata kodu ve açıklama mesajı döner. Kodların anlamı için hata kodları sayfamıza bakabilirsiniz.
Servis grupları
Servisleri kabaca şöyle gruplayabiliriz:
- Tedarik zinciri: Üretim, Satış, Satış İptal, Mal Alım, Mal İade, Mal Devir, İhracat, Deaktivasyon ve iptalleri
- Eczane ve geri ödeme: Eczane Satış, satış sorgulama servisleri
- Hastane: Hastane Sarf ve Tekil Sarf
- Özel ürünler: serum, radyofarmasötik ve tanıtım numunesi servisleri
- Referans: ilaç, paydaş, ülke ve cevap kodu listeleri, Durum Sorgulama
- PTS: paket gönderme, alma ve sorgulama
Performans ve kota
Kılavuz toplu kontrolü önerir. Transfer servisleri gönderilen ürünleri zaten kendi içinde doğruladığı için, transferden önce ayrıca Ürün Doğrulama servisini çağırmak gereksizdir ve performansı düşürür. Kota aşıldığında 30001 (Kota Değeri Aşılmıştır) hatası alınır.
Tracey ve REST API
Tracey, İTS web servisleriyle entegre çalışır; bildirimleriniz bu servisler üzerinden gönderilir. Token, istek biçimi ve sonuç kodları gibi teknik ayrıntılarla sizin uğraşmanız gerekmez.