Anonim

Kurumsal

Servisler

Sale Service

İstekte bulunan kurumsal kullanıcının bu servis ile gerçekleştirebileceği işlemler şunlardır: Bireysel GittiGidiyor hesabındaki satış bilgilerini listeleme ve sıralama, satış için puan ve yorum girme, girilen yoruma cevap verme.

getSale

Bu servis ile satıcı, satış kodunu girmek suretiyle mevcut satışın alıcı bilgileri,ürün ücreti ve ürün stok kodu vb. bilgileri elde eder.

İzin Hakları: Bu metodda kullanıcıların güvenliği için http protokolünün temel doğrulama (basic authentication) metodu kullanılır. Bu doğrulama için gerekli bilgileri Api Anahtarları sayfanızdan kontrol edebilirsiniz. Web servis çağırımlarında kullanıcılar kendi kullanıcı adlarını ve role passwordlerini kullanmalıdırlar. Ayrıca, kurumsal servis katmanında işlem yapılır ise -servislere erişim esnasında- diğer katmanlarda olduğu gibi uygulama anahtarı, istek imzası ve o anki zaman değeri yollanarak istek (request) başına doğrulama gerçekleşir. Erişim: WSDL Adresi:https://dev.gittigidiyor.com:8443/listingapi/ws/IndividualSaleService?wsdl Servis Metot İmzası:Kopyala
SaleServiceResponse getSale(String apiKey, String sign, long time, long saleCode, String lang);
İstek Parametreleri:Kopyala
apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    Oİşlemi gerçekleştirdiğiniz zaman.
saleCode: long
    Satış kodu.
lang: String
    Olası bir hata anında dönen hata mesajının dilini belirtmek için kullanılır.

    Hata mesajı lang=tr ise Türkçe,
    lang=en ise İngilizce olarak çıkar.
Örnek İstek:Kopyala
<sale:getSale>
   <apiKey>ueYeyn9fGV3xmXuZSm9gVzJCPwEE6NTn</apiKey>
   <sign>49e213d36c7fbc6f72cc13660ab7fe14</sign>
   <time>1289310048227</time>
   <saleCode>325479960001</saleCode>
   <lang>tr</lang>
</sale:getSale>
Sonuç Parametreleri:Kopyala
sales: List
    Satış detay bilgisi, ayrıca bkz: SaleType

Aynı gün teslimat parametreleri:
deliveryOption: String
   Aynı gün teslim olacak siparişlerde 'SAME_DAY_DELIVERY' olacaktır.
shippingFirmName: String
   Aynı gün teslimat yapacak firma adı.
shippingFirmId: Int
   Aynı gün teslimat için kargo firmasının ID'si. Ulak için 24 kullanılacaktır. (Sözleşmeli kargo firmalarına Cargo Service > getCargoCompany metodu ile ulaşabilirsiniz.)
combinedShipping: String
   Siparişle birlikte gönderilmesi gereken başka aynı gün teslimatlı siparişler varsa (birlikte gönderim) 'Y' döner.
cargoCode: String
   Birlikte gönderilen siparişleri kargoya vermek için kullanılacak kod bu alanda dönülecektir.

statusCode açıklamaları:
STATUS_WAITING_CARGO_INFO : Satıcının kargo bilgilerini girmesi bekleniyor.
STATUS_WAITING_APPROVAL : Satıcı kargo bilgilerini girdi. Alıcının onay vermesi bekleniyor.
STATUS_APPROVED : İşlem alıcı ya da GG tarafından otomatik onaylandı.
STATUS_FRAUD_REPORTED : Alıcı üründe sorun yaşadığını bildirdi.
STATUS_GIVEN_BACK_PRODUCT : Alıcı ürünü iade etti ve iade kargo bilgilerini girdi. Satıcının iade onayı vermesi bekleniyor.
STATUS_GIVEN_BACK_PAYMENT : İşlem iptal ile sonuçlandı. Alıcıya para iadesi yapıldı.
STATUS_PROVISION_CC_CHECK : Alıcının yaptığı ödeme güvenliği için kotrol ediliyor.
STATUS_EARLY_CANCEL_REQUESTED : Alıcı kargolanmamış ürün için iptal talep etti.
STATUS_EARLY_CANCEL_ACCEPTED : Satıcı alıcının kargolanmamış ürün için iptal talebini kabul etti.
STATUS_INSTANT_REFUNDED : İşlem hızlı iade kapsamında iptal edildi.
STATUS_COOLING_OFF_PERIOD_REQUESTED : Alıcı onaylanmış işlemde sorun bildirdi.
STATUS_COOLING_OFF_PERIOD_SHIPPING_SENT_BACK : Alıcı onaylanmış için iade kargo bilgisi bildirdi.
STATUS_COOLING_OFF_PERIOD_SELLER_APPROVED : Satıcı onaylanmış işlemde iade ürünün kendisine geldiğini onayladı.
STATUS_COOLING_OFF_PERIOD_SELLER_CHARGEBACK_CLAIM : Satıcı onaylanmış işlemde iade işlemine onay verdi ya da işlem GG tarafından otomatik iptal edildi.
STATUS_INSTANT_REFUND_AFTER_SHIPPING_WAITING_APPROVAL : Alıcı hızlı iade talep etti.
STATUS_INSTANT_REFUND_AFTER_SHIPPING : İşlem için hızlı iade talebi onaylandı. Ürün bedeli iade edilecek.

Alıcı sepette öder parametreleri:
deliveryOption: String
    Alıcı Sepette Öder olacak siparişlerde 'REGULAR' olacaktır.
shippingFirmName: String
    Gönderim yapacak firma adı.
shippingFirmId: Int
   Alıcı Sepette Öder için kargo firmasının ID'si. Yurtiçi Kargo için 1 olacaktır. (Sözleşmeli kargo firmalarına Cargo Service > getCargoCompany metodu ile ulaşabilirsiniz.)
combinedShipping: String
   Siparişle birlikte gönderilmesi gereken başka Alıcı Sepette Öder'li siparişler varsa (birlikte gönderim) 'Y' döner.
cargoCode: String
   Birlikte gönderilen siparişleri kargoya vermek için kullanılacak kod bu alanda dönülecektir.
Örnek Sonuç:Kopyala
<sale:getSaleResponse xmlns:sale="http://sale.individual.ws.listingapi.gg.com">
   <return>
      <ackCode>success</ackCode>
      <responseTime>09/11/2010 15:46:51</responseTime>
      <timeElapsed>1 ms</timeElapsed>
      <sales>
         <sale>
            <saleCode>325479960001</saleCode>
            <status>Alıcı ürüne onay verdi</status>
            <productId>32547996</productId>
            <productTitle>Fotograf makinesi için çanta</productTitle>
            <price>1.0</price>
            <cargoPayment>Alıcı Öder</cargoPayment>
            <amount>1</amount>
            <endDate>09/11/2010 15:30:08</endDate>
            <buyerInfo>
               <username>test_user2</username>
               <name>Mehmet</name>
               <surname>Yılmaz</surname>
               <phone>212 3456435</phone>
               <address>Eski Üsküdar Yolu Cad. Çayıryolu Sok. No:1 Partaş Center K:16</address>
               <district></district>
               <city>İstanbul</city>
               <zipCode />
            </buyerInfo>
            <thumbImageLink>http://mcdn01.gittigidiyor.net/3254/tn9/32547996_tn9_0.jpg</thumbImageLink>
            <lastActionDate>09/11/2010 15:38:55</lastActionDate>
         </sale>
      </sales>
   </return>
</sale:getSaleResponse>

Siparişte Aynı Gün Teslimat'lı gönderilmesi gereken tek ürün varsa 'shippingInfo' aşağıdaki bilgileri döner.

<shippingInfo>
   <deliveryOption>SAME_DAY_DELIVERY</deliveryOption>
   <shippingFirmName>ULAK</shippingFirmName>
   <shippingFirmId>24</shippingFirmId>
</shippingInfo>

Siparişle birlikte gönderilmesi gereken başka Aynı Gün Teslimat'lı siparişler varsa (birlikte gönderim durumu) shippingInfo aşağıdaki bilgileri döner.

<shippingInfo>
   <deliveryOption>SAME_DAY_DELIVERY</deliveryOption>
   <shippingFirmName>ULAK</shippingFirmName>
   <shippingFirmId>24</shippingFirmId>
   <combinedShipping>Y</combinedShipping>
   <cargoCode>GGK25800084</cargoCode>
   <combinedSaleCodes>
      <saleCode>SC18014254</saleCode>
      <saleCode>SC18031613</saleCode>
   </combinedSaleCodes>
</shippingInfo>

Siparişte Alıcı Sepette Öder'li gönderilmesi gereken tek ürün varsa 'shippingInfo' aşağıdaki bilgileri döner.

<shippingInfo>
   <deliveryOption>REGULAR</deliveryOption>
   <shippingFirmName>Yurtiçi Kargo</shippingFirmName>
   <shippingFirmId>1</shippingFirmId>
</shippingInfo>

Siparişle birlikte gönderilmesi gereken başka Alıcı Sepette Öder'li siparişler varsa (birlikte gönderim durumu) shippingInfo aşağıdaki bilgileri döner.

<shippingInfo>
   <deliveryOption>REGULAR</deliveryOption>
   <shippingFirmName>Yurtiçi Kargo</shippingFirmName>
   <shippingFirmId>1</shippingFirmId>
   <combinedShipping>Y</combinedShipping>
   <cargoCode>GGK25800084</cargoCode>
   <combinedSaleCodes>
      <saleCode>SC18014254</saleCode>
      <saleCode>SC18031613</saleCode>
   </combinedSaleCodes>
</shippingInfo>