Fatura Gönder

Bu metod ile mağazanızın siparişlerinize ait faturaları yüklemenize olanak tanır.

Endpoint Bilgileri

  • URL: https://ws.pttavm.com:93/service.svc HTTP/1.1
  • HTTP Metodu: POST
  • Content-Type: text/xml;charset=UTF-8
  • Content-Length: 1621
  • SOAPAction: http://tempuri.org/IService/SaveInvoince
  • Host: ws.pttavm.com:93

Dikkat Edilmesi Gereken Kurallar

  • SiparisKontrolListesi ve SiparisKontrolListesiV2 metotlarının döndürdüğü sipariş detaylarında bulunan lineItemId (Mağazanın Siparişteki Ürün Kaydı) gönderilmelidir.
  • Eğer siparişte birden fazla line varsa bu lineItemId'leri bir dizi formatında gönderilmelidir. Örneğin PTT-örnek-010123 numaralı siparişin 1266416 (Kedi Kumu) ve 1266417 (Kedi Maması) ürünlerini içerdiğini varsayalım. Burada 1266416 ve 1266417 ID'leri "lineItemId" anahtarı altında gönderilmelidir.
  • Faturanın yüklendiği bir URL varsa, bu URL esas alınacaktır; aksi takdirde aşağıdaki madde geçerlidir.
    Yüklenecek faturanın .pdf formatında olması gerekmektedir. İlgili PDF'in Base64 formatına çevrilerek 'içerik' alanına eksiksiz olarak gönderilmesi gerekmektedir.

Örnek Servis İsteği


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:SaveInvoince>
         <!--Optional:-->
         <tem:lineItemId>
            <!--Merchant sepet kodu her siparişin bir idsi vardır. buda sipariş id ye denk gelen sepetid
           lineitem değeri olabilir.   :-->
            <arr:int>189355237</arr:int>
         </tem:lineItemId>
         <!--Optional:-->
         <tem:orderId>PTT-123123-123123</tem:orderId>
         <!--Optional:-->
         <tem:content></tem:content>
         <tem:url><![CDATA[https://pttavm.com/web/ngn/doc/printout?rc=1&id=5123AE7640AE415AB2F32ADFAD02DD9A&tp=BFCE0FAA8EA123D29DFD211A5DAA43FC]]></tem:url>
      </tem:SaveInvoince>
   </soapenv:Body>
</soapenv:Envelope>

Örnek Servis Cevabı


<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
   <s:Header>
      <ActivityId CorrelationId="2d9f9cb4-cdb4-4398-83d5-0669a3747e4b" xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">00000000-0000-0000-0000-000000000000</ActivityId>
      <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <u:Timestamp u:Id="_0">
            <u:Created>2025-04-29T12:07:15.499Z</u:Created>
            <u:Expires>2025-04-29T12:12:15.499Z</u:Expires>
         </u:Timestamp>
      </o:Security>
   </s:Header>
   <s:Body>
      <SaveInvoinceResponse xmlns="http://tempuri.org/">
         <SaveInvoinceResult xmlns:a="http://schemas.datacontract.org/2004/07/ePttAVMService" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:Error_Message>işlem gerçekleştirilmiştir.</a:Error_Message>
            <a:Success>false</a:Success>
         </SaveInvoinceResult>
      </SaveInvoinceResponse>
   </s:Body>
</s:Envelope>
Parametre Tür Açıklama
lineItemId int Mağazadan gelen siparişteki ürün ID'lerini içerir.
arr:int int Siparişlerin line bazlı benzersiz sayısıdır. (En az bir veri girişi gereklidir!)
orderId string Sipariş numarası
content string Faturanın Base64 verilerini .pdf formatında içerir. (İsteğe bağlı)
Error_Message string Hata mesajı
Success boolean İşlem durum bilgisi