Toplama Noktaları Seçimi - selectCollectionPoints()

Toplama Noktaları Seçimi

Horoz Lojistik E-İhracat Entegrasyonu üzerinde bulunan selectCollectionPoints() metodu, Horoz’a gönderilen siparişler içerisinde alım tipinin Kendisi Getirecek olması durumunda ürünün getirileceği toplama adresinin tespit edilmesi için hazırlanmıştır. Sipariş içerisinde bulunan bilgiler istek alana geçilerek ilgili sipariş için hangi toplama noktasına ürünün getirileceği tespit edilebilir. selectCollectionPoints() metodu ile ilgili önemli bilgiler ve dikkat edilmesi gerekenler liste halinde aşağıda istemcilerin bilgisine sunulmuştur.

• selectCollectionPoints() metodu POST yöntem ile JSON formatta veri alan, bir RESFtul web servis metodudur.

• selectCollectionPoints() metodu ile Horoz Lojistik sisteminde alım tipinin Kendisi Getirecek olması durumunda ürünün getirileceği toplama adresinin tespit edilmesi işlemi yaparken, bilgiler metodun body kısmına JSON veri tipinde geçilmelidir. İstemciye ait processKey bilgisi metodun header kısmına parametre tipinde geçilmelidir. selectCollectionPoints() metodu ile yapılan gönderim UTF-8 olarak encode edilerek Horoz Lojistik E-İhracat Entegrasyonu Web servisine iletilmelidir.

• selectCollectionPoints() metodu, alım tipi Kendisi Getirecek (receptionType: itWillBring) olan siparişlerin, sipariş girişinden önce istemci tarafından çağırılarak ürünlerin getirilmesi gereken toplama adresine ait bilgileri istemciye döner.

• selectCollectionPoints() metodu parametre olarak; recipientCountryName, paymentMethod, recepientType, transportType değerlerini JSON formatta POST method olarak alır.

• İlgili metot bunun karşılığında responseCode ve responseMessage bilgilerini istemciye dönerek kayıt işleminin başarı/başarısızlık durumunu collectionPointId, address, country, city, county, postCode, officialPerson, phone, email bilgilerini dönerek sipariş oluştururken bilgileri kullanılması gereken toplama noktasını istemciye bildirir.

• selectCollectionPoints() metodu request içerisinde gönderilen bilgilere ve bu bilgilerin uygunluğuna istinaden istemciye her zaman uygun olan bir toplama noktasına ait bilgileri döner.

---

POST selectCollectionPoints()

ENDPOINT

http://b2btest.horoz.com.tr:7801/eexport_test/v1/selectCollectionPoints

Parametre Açıklamaları & Kuralları

Aşağıdaki tabloda selectCollectionPoints() işleminin giriş ve çıkış parametreleri ve bu parametrelerin tür ve formatları listelenmiştir.

Alanlar

Parametre	Açıklama	Veri Tipi	Uzunluk	Alan Yeri	Zorunluluk
processKey	İstemci için tanımlanan processKey bilgisi	string	100	Header	Zorunlu
recipientCountryName	Alıcı ülke adı	string	100	inBody Request	Zorunlu
paymentMethod	Ödeme tipi (transportType airWay olduğu durumda zorunlu)	string	50	inBody Request	Zorunlu
recipientType	Alıcı tipi (transportType airWay olduğu durumda zorunlu)	string	50	inBody Request	Zorunlu
transportType	Taşıma tipi	string	50	inBody Request	Zorunlu

Örnek İstek

  {
    "recipientCountryName": "ALMANYA",
    "paymentMethod": "economy",
    "recipientType": "B2C",
    "transportType": "airWay"
  }

Örnek Cevap

  {
    "response": {
      "responseCode": "STA-100",
      "responseMessage": "ISLEM BASARILI",
      "selectCollectionPoints": {
        "collectionPoints": [
          {
            "collectionPointId": 3,
            "address": "İKİTELLİ CAD. NO:18-20A ATATÜRK MAHALLESİ 34307 KÜÇÜKÇEKMECE İSTANBUL / TÜRKİYE",
            "country": "TÜRKİYE",
            "city": "İSTANBUL",
            "county": "KÜÇÜKÇEKMECE",
            "postCode": "34290",
            "officialPerson": "AHMET MÜCAHİT KARDAŞ",
            "phone": "05300722706",
            "email": "mucahit@cargomda.com"
          }
        ]
      }
    }
  }

selectCollectionPoints() metodu içerisinde beklenen enum değerler için aşağıda detaylı bilgi verilmiştir.

ENUM ALAN	ALAN ADI	Açıklama
paymentMethod	Ödeme tip	economy, express değerlerinden seçim için uygun olan değer geçilerek ödeme tipi bildirilebilir. (economy : ekonomi, express: ekspres)
recipientType	Alıcı tipi	B2B, B2C değerlerinden seçim için uygun olan değer geçilerek alıcı tipi bildirilebilir.
transportType	Taşıma tipi	road, airWay değerlerinden seçim için uygun olan değer geçilerek taşıma tipi bildirilebilir. (road : kara, airWay : hava)

---

Servis Cevapları

Servise ait başarılı/başarısız servis cevaplarına buradan erişebilirsiniz.