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.