Ana içeriğe geç

efaturaGonder

Genel Bilgi

Özellik Değer
Endpoint Adı efaturaGonder
SOAPAction urn:WebticariService#efaturaGonder
Açıklama Daha önce kaydedilmiş bir satış faturasının e-Fatura / e-Arşiv gönderimini başlatır. Fatura st_efatura='E' veya st_earsiv='E' olmalıdır.
Kimlik Doğrulama Gerektirir Evet (token)

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
token xsd:string Evet login ile alınan oturum token'ı
faturaId xsd:string Evet Satış faturasının ID'si (st_id). importSellingXML yanıtındaki server_id değeri kullanılabilir.

Yanıt Parametreleri

Parametre Tip Açıklama
return xsd:string <result> XML'i

result Alanları

Alan Açıklama
durum basarili, hata veya gerekYok
faturaId İstekte gönderilen fatura ID'si
mesaj Hata veya bilgi mesajı (başarılıda boş)

Yanıt Örnekleri

Başarılı:

<result>
  <durum>basarili</durum>
  <faturaId>1234</faturaId>
  <mesaj></mesaj>
</result>

Fatura bulunamadı:

<result>
  <durum>hata</durum>
  <faturaId>1234</faturaId>
  <mesaj>Fatura bulunamadi</mesaj>
</result>

Belge e-fatura/e-arşiv değil:

<result>
  <durum>gerekYok</durum>
  <faturaId>1234</faturaId>
  <mesaj>Belge e-fatura/e-arsiv degil</mesaj>
</result>

Hata Durumları

Durum Yanıt
Geçersiz veya süresi dolmuş token Invalid Token
Fatura bulunamadı durum=hata, mesaj=Fatura bulunamadi
st_efatura ve st_earsiv ikisi de E değil durum=gerekYok
Entegratör gönderim hatası durum=hata, mesaj = entegratör hata metni

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:efaturaGonder>
      <token>TOKEN</token>
      <faturaId>1234</faturaId>
    </tns:efaturaGonder>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • st_earsiv='E' ise e-Arşiv, aksi halde e-Fatura entegratörü kullanılır.
  • Fatura için daha önce efaturadurum kaydı oluşmuşsa (gönderilmişse) tekrar gönderim yapılmaz; bu durumda basarili döner.
  • Gönderim yalnızca serverType = 'W' olan sunucularda çalışır; diğerlerinde işlem yapılmadan basarili döner.
  • importSellingXML ile st_efatura/st_earsiv E gönderilirse gönderim zaten otomatik tetiklenir; bu metot başarısız veya sonradan yapılacak gönderimler içindir.