hepsiburada developers

hepsiburada developers

Did You Know?

UPS Satıcı Öder Modeli

Bu işlev UPS kargo ile kendi carinizden kargo çıkışı yapmak için uygulanan entegrasyon sürecidir. UPS ile kendi carinizi kullanmak satıcı öder modeline geçmek için öncelikle Satıcı Destek panelinden kayıt açarak başvurunuzun işleme alınması gerekir.

UPS Satıcı öder modeline geçtikten sonra body bilgisinde kendi carinizden çıktığınız trackingcode bilgisini Hepsiburada’ya bildirebilirsiniz.

Test ortamında da canlı ortamda da bu sürece geçiş için kayıt açarak tanımlama yaptırılması gerekir.

API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.

Parametreler(Parameters)

  1. Merchantid (gerekli, guid, b2910839-83b9-4d45-adb6-86bad457edcb) Her satıcının unique bir tanımlayıcısıdır.
  2. Packagenumber (gerekli, string, 0254621) Her paketin unique bir tanımlayıcısıdır.
  3. TrackingCode (gerekli, string, 1ZGEVREK6810512892) Kargo takip kodu bilgisidir.

Canlı Ortam Endpoint (PUT)

				
					https://oms-external.hepsiburada.com/packages/merchantid/{merchantid}/packagenumber/{packagenumber}/trackingcode				
			

SIT Ortam Endpoint (PUT)

				
					https://oms-external-sit.hepsiburada.com/packages/merchantid/{merchantid}/packagenumber/{packagenumber}/trackingcode				
			

Body - Örnek İstek

				
					{ "TrackingCode":"1ZGEVREK6810512892" }				
			

Response

				
					201 Created				
			
NOT
  • Paket oluştuktuktan sonra bu servise istek yapılması gerekmektedir.(Paket bazlı ilerlenmektedir).
  • Update geçildiken sonra paket bozulursa tekrardan tracking code geçişi sağlanmalıdır.
  • Eğer merchant UPS kargo ile satıcı öde tanımı Hepsiburada da yapılmamış ise servise istek gönderildiğinde 409 Conflict hatası alınacak ve açıklamada “Delivery is not a seller pays model, code: 1Zxxxxxxxxxxxxxx” uyarısı gözükecektir.
  • Girilen paket numarası kargoda vs ise bu durumda da uyarı alınacaktır “delivery is not valid, status:shipped”
Hata KoduHata Mesajı
Status Code 400; Tracking Code already exists
Aynı tracking code ile tekrar trackingCode bilgisi iletilmek istendiğinde alınan uyarıdır.
Status Code 400; <> not found in UPS.
Değiştirilmek istenen tracking Code ups tarafında tanımlı bir gönderiye ait değilse dönen uyarıdır.
Status Code 400; Delivery is not available for sellerpays operations.
UPS satıcı öder tanımlı değilse alınan uyarıdır.

Sayfa Başlıkları