Ana içeriğe geç

getInvoiceByWUID

Genel Bilgi

Özellik Değer
Endpoint Adı getInvoiceByWUID
SOAPAction urn:WebticariService#getInvoiceByWUID
Açıklama Webticari benzersiz fatura kimliği (WUID) kullanılarak bir faturanın tüm detaylarını getirir. Harici sistemlerin Webticari faturalarına referans vermek için kullandığı WUID ile sorgu yapar.
Kimlik Doğrulama Gerektirir Hayır

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
wuid xsd:string Evet Webticari Unique ID — faturanın benzersiz tanımlayıcısı

Yanıt Parametreleri

Parametre Tip Açıklama
return xsd:string Fatura detaylarını içeren XML string

Yanıt Örneği

<fatura>
  <fs_no>FAT000001</fs_no>
  <fs_tarih>2024-01-15</fs_tarih>
  <fs_cari_kod>C001</fs_cari_kod>
  <fs_cari_adi>Örnek Müşteri A.Ş.</fs_cari_adi>
  <fs_toplam>1180.00</fs_toplam>
  <fs_kdv>180.00</fs_kdv>
  <fs_geneltoplam>1180.00</fs_geneltoplam>
  <fs_wuid>WT-2024-0001-XXXX</fs_wuid>
  <kalemler>
    <kalem>
      <sk_urun_kod>STK001</sk_urun_kod>
      <sk_miktar>10</sk_miktar>
      <sk_fiyat>100.00</sk_fiyat>
      <sk_kdv_oran>18</sk_kdv_oran>
    </kalem>
  </kalemler>
</fatura>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:getInvoiceByWUID>
      <wuid>WT-2024-0001-XXXX</wuid>
    </tns:getInvoiceByWUID>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Token gerektirmez; wuid parametresi sistem tarafından belge::uniqueIdDonustur() ile decode edilir (musNo, donem, gecisNo, belgeId alanlarına ayrışır).
  • Decode edilen musNo ile sistem dahili publicLogin() yapılır; geçersiz musNo durumunda hata döner.
  • Başarılı yanıt olarak TR UBL 1.2 standardında fatura XML içeriği döner.
  • WUID, fatura oluşturulduğunda (örn. importSellingXML yanıtı) döner ve harici sistemde saklanmalıdır.
  • Hem satış hem de alış faturaları WUID ile sorgulanabilir.