Duyurular

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) yöntemi kullanılır ve kurumsal servis katmanında işlem yapıldığı için servislere erişim esnasında uygulama anahtarı (apiKey), istek imzası (sign) ve o anki zaman değeri (timestamp) yollanarak istek (request) başına doğrulama gerçekleşir. Role ve Key bilgilerinize Api Anahtarları sayfanızdan ulaşabilirsiniz. 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

Sözleşmeli kargolar için parametreler > shippingInfo:

deliveryOption: String
   Kargolama yöntemi.
   REGULAR: Normal gönderi
   SAME_DAY_DELIVERY: Aynı gün teslimat.
shippingFirmName: String
   Sözleşmeli kargo adı.
shippingFirmId: Int
   Sözleşmeli kargoya ait numara.
combinedShipping: String
   Birlikte gönderilmesi gereken siparişler varsa (combined) 'Y' döner yoksa 'N' döner.
shippingPaymentType: shippingPaymentType
   Kargo ücreti tipi.
   BUYER: Alıcı kapıda öder.
   SELLER: Satıcı kargo firmasına öder. 
   PAY_IN_THE_BASKET: Alıcı sepette ödedi.
   PLATFORM: GG öder. (Satıcı GittiGidiyor'a Öder)
cargoCode: String
   Birlikte gönderilmesi gereken (combined) siparişleri kargoya vermek için kullanılacak kod bu alanda dönülecektir.
shippingNotice: String
   Sadece birlikte gönderilmesi gereken siparişlerde döner. Combined bildirimi.
combinedSaleCodes: String
   Birlikte gönderilmesi gereken siparişlere ait satış kodları.
shippingExpireDate: String
   Kargolama bitiş tarihi.

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.
Ö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 gönderilmesi gereken tek ürün varsa 'shippingInfo' aşağıdaki bilgileri döner.

<shippingInfo>
   <deliveryOption>SAME_DAY_DELIVERY</deliveryOption>
   <shippingFirmName>JETIZZ</shippingFirmName>
   <shippingFirmId>25</shippingFirmId>
   <combinedShipping>N</combinedShipping>
   <shippingPaymentType>PAY_IN_THE_BASKET</shippingPaymentType>
   <cargoCode>SC115713918</cargoCode>
   <shippingExpireDate>25/12/2020 23:59:59</shippingExpireDate>
</shippingInfo>

Birlikte gönderilmesi gereken siparişler varsa shippingInfo aşağıdaki bilgileri döner. 

<shippingInfo>
   <deliveryOption>SAME_DAY_DELIVERY</deliveryOption>
   <shippingFirmName>JETIZZ</shippingFirmName>
   <shippingFirmId>25</shippingFirmId>
   <combinedShipping>Y</combinedShipping>
   <shippingPaymentType>PAY_IN_THE_BASKET</shippingPaymentType>
   <cargoCode>GGK90307978</cargoCode>
   <shippingNotice>SC115713830,SC115713831 siparişlerini GGK90307978 kargo kodu ile birlikte göndermelisiniz.</shippingNotice>
   <combinedSaleCodes>
      <saleCode>SC115713830</saleCode>
      <saleCode>SC115713831</saleCode>
   </combinedSaleCodes>
   <shippingExpireDate>25/12/2020 23:59:59</shippingExpireDate>
</shippingInfo>

deliveryOption: 
SAME_DAY_DELIVERY dönerse aynı gün teslimat,
REGULAR dönerse normal gönderidir.

shippingPaymentType:
BUYER ise alıcı kargo firmasına öder,
SELLER ise satıcı kargo firmasına öder,
PAY_IN_THE_BASKET ise alıcı sepette ödedi,
PLATFORM ise GG öder (Satıcı GittiGidiyor'a Öder).

Servis Güncellemeleri