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

Başarılı yanıt, TR UBL 1.2 standardında tam fatura XML belgesidir (UBL ad alanları, kalem detayları, vergi alt toplamları ve imza bloğu dahil). Gerçek çıktının karmaşıklığı nedeniyle kısaltılmış örnek verilmemektedir; yanıt doğrudan eFatura->eFaturaUblOlusturTR1_2() çıktısıdır.

Hata Durumları

Durum Yanıt
Geçersiz veya bilinmeyen musNo (WUID decode sonrası) <response><errorNo>1</errorNo><error>Hatalı müşteri numarası</error></response>
Fatura bulunamadı Boş yanıt

Ö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.