Türkiye Kanarya ve Kafes Kuşları Federasyonu BilezikTürk API

Önemli Notlar
• BilezikTurk üzerinde bilezik sorgu ve işlem yapan uygulama.
• Tarım Orman Bakanlığı bilezikleri belge doğrulama gerektirdiği için API'ye dahil değildir.
• SMS gönderim tanımlı olsa bile SMS göndermez.
• API her defasında bir işlem yapar. Çoklu gönderim kabul edilmez.
• Sorgu sonuçları xls formatı ile kullanmaya uygundur. (ctrl-a, ctrl-c, ctrl-v)
• Bilezik çapı 0.00 formatında olmalı. Virgül yerine nokta kullanılmalı. Küsürat hanesi 2 hane olmalı.
• Adet bilgisi, mevcut adet listesine uygun olmalı. Adet 1000'i geçemez.
• Ücret bilgisi BilezikTurk üzerindeki değeri kullanır.
• Hata mesajı almışsanız, işlem gerçekleşmemiştir.
• İşlemlerinizi iFrame içinde yapmanız önerilir. Return point kullanılmamaktadır.
• API normal sonuçlar için ~OK ile bitecektir.
• XML veri POST ile gönderilmelidir.
• Karakter seti UTF-8 Türkçe olmalıdır.
• API için kullanılan URL'e ekleme yapmayınız.
• API adresi: https://www.bilezikturk.com/hangar/response.php

XML Tanım
<?xml version="1.0" encoding="UTF-8" ?>
<paket charset="turkish">
[... yapılacak işlemler ... ]
</paket>

Her İşlem İçin Gerekli Alanlar
Alan	Zorunlu	İşlev
drn	Evet	Dernek Kodu
pwd	Evet	Dernek Başkan Şifresi
isl	Evet	İstenen İşlem (s=sorgu, i=işlem)

Sorgu İçin Gerekli Diğer Alanlar
Alan	Zorunlu	İşlev
uye	Evet	Üye Kodu (0000 formatında)
yil	Hayır	Yıl (boş ise, tümü) (sayısal 4 karakter, örnek:2020)
dnm	Hayır	Dönem (boş ise, tümü) (harf, 1 karakter, örnek:C)

İşlem İçin Gerekli Diğer Alanlar
Alan	Zorunlu	İşlev
uye	Evet	Üye Kodu (0000 formatında)
tod	Evet	Yapılacak İşlem (e=ekle, d=sil, o=dernek onayı, p=dernek onay iptali, r=ödeme alındı, f=ödeme iptali)
ony	Hayır	Onay (0=onaysız, 1=dernek onaylı, varsayılan=0)
odm	Hayır	Ödeme (0=hayır, 1=evet, varsayılan=0)
yil	Evet	Yıl
dnm	Evet	Dönem
bcp	Evet	Bilezik Çapı
adt	Evet	Adet

Örnekler:

Sorgu (0072 üyenin tüm siparişleri)
<?xml version="1.0" encoding="UTF-8" ?>
<paket charset="turkish">
  <param>
   <drn>J007</drn> <pwd>XZH1S7Y94JR5</pwd>
  </param>
  <isl>s</isl>
  <uye>0072</uye>
  <yil></yil>
  <dnm></dnm>
</paket>
Sorgudan Geri Dönen

Ony	Ödm	Üye	Yıl	Dnm	Çap	Adet	Kaçtan Kaça
Evet	Evet	0072	2019	A	2.70	50	1 > 50
Evet	Evet	0072	2019	D	2.70	50	51 > 100
Evet	Evet	0072	2020	A	2.70	50	1 > 50
Evet	Evet	0072	2020	A	2.90	50	51 >100
Evet	Evet	0072	2020	C	2.90	50	101 > 150
Evet	Evet	0072	2020	C	3.20	50	151 > 200
Evet	Evet	0072	2021	B	3.20	50	1 > 50
Hayır	Hayır	0072	2021	C	2.70	50	51 > 100
Hayır	Hayır	0072	2021	C	3.20	50	101 > 150
Hayır	Hayır	0072	2021	C	3.40	50	151 > 200

Sorgu (0072 üye, 2020 C tertip)
<?xml version="1.0" encoding="UTF-8" ?>
<paket charset="turkish">
  <param>
   <drn>J007</drn> <pwd>XZH1S7Y94JR5</pwd>
  </param>
  <isl>s</isl>
  <uye>0072</uye>
  <yil>2020</yil>
  <dnm>C</dnm>
</paket>
Sorgudan Geri Dönen

Ony	Ödm	Üye	Yıl	Dnm	Çap	Adet	Kaçtan Kaça
Evet	Evet	0072	2020	C	2.90	50	101 > 150
Evet	Evet	0072	2020	C	3.20	50	151 > 200

İşlem (0072 üye, 2021C tertip, 2.90 çap, 50 adet ekle)
<?xml version="1.0" encoding="UTF-8" ?>
<paket charset="turkish">
  <param>
   <drn>J007</drn> <pwd>XZH1S7Y94JR5</pwd>
  </param>
  <isl>i</isl>
  <uye>0072</uye>
  <tod>e</tod>
  <ony>1</ony>
  <odm>1</odm>
  <yil>2021</yil>
  <dnm>C</dnm>
  <bcp>2.90</yil>
  <adt>50</adt>
</paket>
Geri Dönen

İşlem	Ony	Ödm	Üye	Yıl	Dnm	Çap	Adet	Kaçtan Kaça
Ekle	Evet	Evet	0072	2021	C	2.90	50	101 > 150
Ekle	Evet	Evet	0044	2021	C	3.40	70	301 > 370

Hata Kod ve Mesajları

Kod	Mesaj
101	XML hatası
102	Dernek kodu hatalı
103	Şifre hatalı
104	Dernek aktif değil
105	İşlem seçimi hatalı
201	Üye bilgisi hatalı (kod hatası, aktif?, üye yok, sipariş verebilir?)
202	Üye Tarım Orman Bakanlığı belgesi girilmemiş.
301	Sorgu boş döndü
302	Açık tertip bulunamadı
303	İşlem istenen tertip açık değil
304	Tertipte bu çap için sipariş mevcut (mevcut siparişi silip, yeniden ekleyiniz.)
305	Bilezik çapı tanımsız
306	Adet tanımsız