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.

getPagedSales

Satıcı konumundaki kullanıcı bu servis aracılığı ile GittiGidiyor Bana Özel sayfasında yer alan "Sattıklarım" bölümünde sunulan bilgilerin tamamını elde edebilir, bilgileri filtreleyebilir ve sıralayabilir.

İ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 getPagedSales(String apiKey, String sign, long time, int pageSize, int pageNumber, boolean withData, String byStatus, String byUser, String orderBy, String orderType, String lang);
İstek Parametreleri:Kopyala
apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    O anki zaman.
pageNumber: int
    Kaçıncı sayfadan başlayacak?
pageSize: int
    Kaç kayıt listelenecek?
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.
withData: boolean
    true: Listelenen ürünler tüm bilgileri ile birlikte listelenir.
    false: Sadece ürün numaraları listelenir.
byUser: String
    Kullanıcı filtresi.
orderBy: String
    Sıralama filtresi

    P: Ürün numarasına göre sıralama
    C: Satış fiyatına göre sıralama
    A: Son harekete göre sıralama
byStatus: String
    Durum parametresi(filtresi)

    P: Ödeme Beklediklerim
    S: Kargo Yapılacaklar
    C: Onay Bekleyenler
    T: Para Transferleri
    R: İade Konumunda Olanlar
    O: Tamamlananlar
orderType: String
    İstekte bulunduktan sonra dönen cevapların ID'lerinin artan ya da azalan sırada dönmesini sağlar.

    orderType=A ise artarak,
    orderType=D ise azalarak dönüş yapılır.
Örnek İstek:Kopyala
<sale:getPagedSales>
   <apiKey>VKdTa9fGHt5ESTfkBfnutwSDNZVV8b9H</apiKey>
   <sign>81D8741AE8268766BDCAED5F264FC3E4</sign>
   <time>1588140066265</time>
   i<withData>false</withData>
   <byStatus>R</byStatus>
   i<byUser></byUser>
   i<orderBy>A</orderBy>
   i<orderType>A</orderType>
   <pageNumber>1</pageNumber>
   <pageSize>10</pageSize>
   i<lang>tr</lang>
</sale:getPagedSales>
Sonuç Parametreleri:Kopyala
nextPageAvailable: Integer
    nextPageAvailable
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
   NEXT_DAY_DELIVERY: Ertesi 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:getPagedSalesResponse xmlns:sale="http://sale.individual.ws.listingapi.gg.com">
   <return>
      <ackCode>success</ackCode>
      <responseTime>29/04/2020 09:01:23</responseTime>
      <timeElapsed>26 ms</timeElapsed>
      <saleCount>3</saleCount>
      <sales>
         <sale>
            <saleCode>SC93982702</saleCode>
         </sale>
         <sale>
            <saleCode>SC89856810</saleCode>
         </sale>
         <sale>
            <saleCode>SC89927255</saleCode>
         </sale>
      </sales>
      <nextPageAvailable>false</nextPageAvailable>
   </return>
</sale:getPagedSalesResponse>

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

<shippingInfo>
   ii<deliveryOption>SAME_DAY_DELIVERY</deliveryOption>
   <shippingFirmName>JETIZZ</shippingFirmName>
   i<shippingFirmId>25</shippingFirmId>
   <combinedShipping>N</combinedShipping>
   i<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>
   ii<deliveryOption>SAME_DAY_DELIVERY</deliveryOption>
   <shippingFirmName>JETIZZ</shippingFirmName>
   i<shippingFirmId>25</shippingFirmId>
   <combinedShipping>Y</combinedShipping>
   i<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,
NEXT_DAY_DELIVERY dönerse ertesi 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).
Hata Mesajları:Kopyala
Hata KoduMesajÇözüm
134 Lütfen sıralamak için P (ürünId ye göre) - C (satış fiyatına göre) - A (son harekete göre) parametrelerinden birini kullanınız giriniz. orderBy alanı için hatalı veya geçersiz parametre girişi yapılmış olabilir. Sıralamak için P (ürünId ye göre) - C (satış fiyatına göre) - A (son harekete göre) parametrelerinden birini kullanabilirsiniz.
146 Ödeme bekleyenler için (T) | Kargo yapılacaklar için (V) | Onay bekleyenler için (P) | Para transferleri için (A) | İade konumundakiler için (S) | Tamamlananlar için (R) parametresini girmelisiniz. byStatüs alanı için hatalı veya geçersiz parametre girişi yapılmış olabilir. Ödeme bekleyenler için (P) | Kargo yapılacaklar için (S) | Onay bekleyenler için (C) | Para transferleri için (T) | İade konumundakiler için (R) | Tamamlananlar için (O) parametresini girmelisiniz.
147 Lütfen azalan sırada listelemek için (D) | artan sırada listemek için (A) kullanınız. orderType alanı için hatalı veya geçersiz parametre girişi yapılmış olabilir. Azalan sırada listelemek için (D) | artan sırada listemek için (A) kullanınız.
1072 Sayfa numarası birden küçük veya boş olamaz pageNumber parametresi birden küçük veya boş gönderilmemelidir. Girdiğiniz bilgiyi kontrol ediniz.

Servis Güncellemeleri