Ana içeriğe geç

getCurrencyXML

Genel Bilgi

Özellik Değer
Endpoint Adı getCurrencyXML
SOAPAction urn:WebticariService#getCurrencyXML
Açıklama Sistemde tanımlı döviz kurları ve para birimlerini XML formatında döner. Fatura, fiyat hesaplama ve diğer finansal işlemlerde kullanılan güncel kur bilgisini sağlar.
Kimlik Doğrulama Gerektirir Hayır

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
kaynak xsd:string Hayır Kur kaynağı (varsayılan: TCMB)

Yanıt Parametreleri

Parametre Tip Açıklama
return xsd:string Döviz kurları ve para birimleri, XML formatında

Yanıt Örneği

<currency>
  <rows>
    <row>
      <CurrencyName>USD</CurrencyName>
      <ForexBuying>32.5000</ForexBuying>
      <ForexSelling>32.7000</ForexSelling>
      <BanknoteBuying>32.4000</BanknoteBuying>
      <BanknoteSelling>32.8000</BanknoteSelling>
    </row>
    <row>
      <CurrencyName>EUR</CurrencyName>
      <ForexBuying>35.1000</ForexBuying>
      <ForexSelling>35.3000</ForexSelling>
      <BanknoteBuying>35.0000</BanknoteBuying>
      <BanknoteSelling>35.4000</BanknoteSelling>
    </row>
  </rows>
</currency>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:getCurrencyXML>
      <kaynak>TCMB</kaynak>
    </tns:getCurrencyXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Token gerektirmez; herhangi bir istemci çağırabilir.
  • kaynak boş bırakılırsa varsayılan olarak TCMB kullanılır.
  • Ana program veritabanından (_db_prog) kur tablosunu sorgular.
  • Alan eşleşmeleri: CurrencyName = doviz_turu, ForexBuying = alis, ForexSelling = satis, BanknoteBuying = efektifalis, BanknoteSelling = efektifsatis.
  • Kurlar Webticari ayarlarından beslendiğinden gerçek zamanlı piyasa kuru değil sistem kurunu yansıtır.
  • Dövizli fatura oluştururken bu endpoint ile güncel kur çekilip importSellingXML veya importBuyingXML'e eklenebilir.
  • Sorgu hatası durumunda: <table><error><mysqlerrno>N</mysqlerrno></error></table>