İ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.
Bu metod belirtilen tarihler arasındaki ve belirtilen durumdaki satışları görüntülemek için kullanılır.
İ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ı:KopyalaapiKey: String Uygulamanızın anahtarı. sign: String Uygulamanın o anki isteğinin imzası. time: long O anki zaman. withData: Boolean true: Listelenen ürünler tüm bilgileri ile birlikte listelenir. false: Sadece satış kodları listelenir. byStatus: String Durum parametresi(filtresi) S: Kargo Yapılacaklar C: Onay Bekleyenler P: Para transferleri O: Tamamlananlar V: Aktif Satışlar I: İptali beklenenler R: İptal olanlar / İade konumunda olanlar byUser: String Kullanıcı filtresi. orderBy: String Sıralama filtresi P: Satış koduna göre sıralama C: Satış fiyatına göre sıralama A: Son harekete göre sıralama 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. startDate: String Başlangıç tarihi. endDate: String Bitiş tarihi. 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.
<sale:getSalesByDateRange>
<apiKey>BVFMj7BXV5fEEuVh8KEAgMAeJMRNDJY6</apiKey>
<sign>911220D6AC85518590CE70D8FFFBF4E3</sign>
<time>1586254267097</time>
i<withData>true</withData>
<byStatus>R</byStatus>
i<byUser></byUser>
i<orderBy>P</orderBy>
i<orderType>A</orderType>
<startDate>01/09/2021 00:00:00</startDate>
<endDate>30/09/2021 23:59:00</endDate>
<pageNumber>1</pageNumber>
<pageSize>1</pageSize>
i<lang>tr</lang>
</sale:getSalesByDateRange>
saleCount: Int Dönen işlem sayısı. saleCode: String Satış kodu. status: String İşlemin bulunduğu statünün açıklaması. statusCode: String İşlemin bulunduğu statü. productId: Int Ürün tekil anahtarı. productTitle: String Ürün başlığı. price: String Ürün fiyatı. cargoPayment: String Kargo ücretini hangi tarafın ödeyeceğini belirtir. cargoCode: String Grup Gönderi Kodu(GGK). amount: Int Adet. endDate: String Ürün bitiş tarihi. thumbImageLink: String Ürün fotoğrafı. lastActionDate: String Son hareket tarihi. buyerInfo: orderBuyerInfoType Alıcı bilgileri. username: String Kulanıcı adı. name: String Adı. surname: String Soyadı. phone: String Telefon numarası. mobilePhone: String Cep telefonu numarası. email: String E-mail adresi. (Bu alanın dönmesi için Müşteri Hizmetleri üzerinden e-fatura mükellefi olan satıcılar talep oluşturmalıdır.) address: String Adres. district: String İlçe. city: String İl. zipCode: Int Posta kodu. invoiceInfo: aleInvoiceType (Sadece alıcı fatura bilgilerini doldurduğunda döner.) Alıcının fatura bilgileri. fullname: String Ad soyad. address: String Adres. district: String İlçe. cityCode: Int Şehir kodu. zipCode: Int Posta kodu. phoneNumber: String Telefon numarası. companyTitle: String Şirket ünvanı. tcCertificate: String Tc kimlik no/ Vergi no. taxOffice: String Vergi Dairesi Adı taxNumber: String Vergi Kimlik Numarası variantId: Long Varyanta ait tekil anahtar. itemId: String Satışa konulan ürünün entegrasyon yapan firma tarafındaki takip kodu. 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.
<sale:getSalesByDateRangeResponse xmlns:sale="http://sale.individual.ws.listingapi.gg.com">
<return>
<ackCode>success</ackCode>
<responseTime>07/04/2020 13:54:03</responseTime>
<timeElapsed>83 ms</timeElapsed>
<saleCount>1</saleCount>
<sales>
<sale>
<saleCode>SC123456789</saleCode>
<status>Satıcının kargo bilgilerini sisteme girmesi bekleniyor</status>
<statusCode>STATUS_WAITING_CARGO_INFO</statusCode>
<productId>123456789</productId>
<productTitle>__ggtest Deneme API Ürünü</productTitle>
<price>2899.0</price>
<cargoPayment>Satıcı Öder</cargoPayment>
<cargoCode>GGK12345678</cargoCode>
<amount>1</amount>
<endDate>27/09/2022 08:42:01</endDate>
<buyerInfo>
<username>GittiGidiyor</username>
<name>Gitti</name>
<surname>Gidiyor</surname>
<phone>850-2523229</phone>
<mobilePhone>850-2523229</mobilePhone>
<email>api.destek@gittigidiyor.com</email>
<address>My Office İş Mrkz., Çiğdem Sk., No: 1/14, 34746 Barbaros Mah., Ataşehir, İstanbul</address>
<district>Ataşehir</district>
<city>İstanbul</city>
<zipCode>34746</zipCode>
</buyerInfo>
<thumbImageLink>https://mcdn201.gittigidiyor.net/123456/tn9/123456789_tn9_0.jpg</thumbImageLink>
<lastActionDate>29/09/2021 23:50:00</lastActionDate>
<variantId>0</variantId>
<moneyDate>29/09/2021 23:49:44</moneyDate>
<itemId>12345678</itemId>
<shippingInfo>
<shippingFirmName>yurtici</shippingFirmName>
<combinedShipping>N</combinedShipping>
<shippingPaymentType>SELLER</shippingPaymentType>
<cargoCode>SC123456789</cargoCode>
<shippingExpireDate>08/10/2021 23:49:44</shippingExpireDate>
</shippingInfo>
</sale>
</sales>
<nextPageAvailable>true</nextPageAvailable>
</return>
</sale:getSalesByDateRangeResponse>
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,
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 Kodu | Mesaj | Çözüm |
129 | rowCount parametresi 100 den büyük olamaz | pageSize parametresine 1-100 arasında bir değer girişi yapabilirsiniz. |
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. S: Kargo Yapılacaklar | C: Onay Bekleyenler | P: Para transferleri | O: Tamamlananlar | V: Aktif Satışlar | I: İptali beklenenler | R: İptal olanlar / İade konumunda olanlar. |
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. |
780 | Geçersiz başlama tarihi. Lütfen kontrol edip tekrar deneyiniz | startDate parametesi içerisinde gönderdiğiniz tarih bilgisi boş veya hatalı olabilir. Tarih bilgisi (Y-m-d H:i:s) şekinde olmalıdır. Girdiğiniz değeri kontrol ederek tekrar deneyiniz. |
781 | Geçersiz bitiş tarihi. Lütfen kontrol edip tekrar deneyiniz. | endDate parametesi içerisinde gönderdiğiniz tarih bilgisi boş veya hatalı olabilir.Tarih bilgisi (Y-m-d H:i:s) şekinde olmalıdır Girdiğiniz değeri kontrol ederek tekrar deneyiniz. |
782 | Başlangıç tarihi bitiş tarihinden sonra olamaz. | startDate parametesi içinde gönderdiğiniz tarih endDate içinde yer alan tarihten sonra olmaması gerekmektedir. Girdiğiniz değeri kontrol ederek tekrar deneyebilirsiniz. |
1072 | Sayfa numarası birden küçük veya boş olamaz. | pageNumber parametresi birden küçük veya boş gönderilmemeldidir. Girdiğiniz bilgiyi kontrol ediniz. |
1073 | Sayfa boyutu birden küçük veya boş olamaz. | pageSize kısmı 1 den küçük ve boş gönderilmemelidir. Girdiğiniz değeri kontrol ederek tekrar deneyebilirsiniz. |
API ile ürün listeleyen kullanıcılarımız için önemli bir güncelleme yayına alındı. Yeni güncelleme ile birlikte API üzerinde Sabit Fiyat (format = F) tipli ürün girişi kaldırılmıştır. Listelemeler için Mağaza (format = S) tipi tercih edilmelidir.
Product ServiceÜrünlere toplu AGT (Aynı Gün Teslimat) özelliği eklenebilmesi için yeni bir metot yayına alındı. Yayınlanan metoda bu link üzerinden ulaşabilirsiniz.
*Aynı Gün Teslimat Sözleşme'sine sahip olunması gerekmektedir.
Satılmadan kapanan ürünleri yeniden listelemek için kullanılan relistProducts metodunda güncelleme yapıldı. Stoğu 1'den az olan ürünler artık Aktif Satışlar'a alınamayacak ve uyarı dönecektir. Metoda bu link üzerinden ulaşabilirsiniz.
Product ServiceKategori servisinde kategori koduna ait minumum ve maximum kargolama sürelerini de takip edebileceğiniz bir güncelleme yayına alındı. Servis bilgilerine bu linkte yer alan Category Service başlığı altından ulaşabilirsiniz.
Category ServiceFiyat ve stok güncelleyen metotların statü kontrolü kaldırıldı. Yayınlanan güncelleme ile beraber aşağıda yer alan metotları Aktif Satışlar, Listelemeye Hazır Ürünler, Satılanlar ve Satılmayanlar alanında bulunan ürünler için kullanabilirsiniz.
updateProductSales
updatePrice
updatePriceByPercentage
updateStock
updateVariantStock
API ile ürün listeleyen kullanıcılarımız için önemli bir güncelleme yayına alındı. Yeni güncelleme ile birlikte artık API üzerinden para transferleri ve bakiye detaylarınızı takip edebilirsiniz.
Takip yapabilmeniz için ihtiyacınız olan dört farklı metot bilgilerine bu linkte yer alan Accounting Service başlığı altından ulaşabilirsiniz.
GittiGidiyor'a ürün eklemek için yeni bir metot yayına alındı. Bu metodu GittiGidiyor üzerinde ürün kaydetmek ve aynı zamanda listelenen ürünü Aktif Satışlar'a almak için kullanabilirsiniz. Metot bilgilerine bu link üzerinden ulaşabilirsiniz.
Product ServiceÜrün kaydetme servisinde aynı gün kargo seçeneği için yeni bir güncelleme yayına alındı. Güncelleme ile beraber artık aynı gün kargo yapılabilmesi için sipariş saati olarak 10:00-17:00 (beforeTime) saat aralığı seçilebilir hale getirildi.
Product Service