Satıcı Adres Noktası Oluşturma - createSellerAddressPoint()

Satıcı Adres Noktası Oluşturma

Horoz Lojistik E-İhracat Entegrasyonu Webservisi üzerinde bulunan createSellerAddressPoint() metodu, sipariş girişinde kullanılacak olan ürünlerin sipariş özelinde adresten alınacak seçimi yapıldığında satıcının hangi noktasından alınacağını belirtmek için kullanılır. Bu iki şekilde kullanılabilir. Horoz Web Portal sistemi üstünden girilebilir ya da istemci tarafından bu metot kullanılarak bu bilgi aktarılabilir. Bu bilginin kullanım ihtiyacı sipariş giriş anında ürünlerin adresten alınması durumunda aktif olacaktır. Buraya girilen seçenekler satıcı tarafından seçim yapılarak ürün alım adresinin nakliyeciye iletilmesi sağlanır. Bu metodun içinde satıcının sahip olduğu çıkış noktalarında sellerAddressPoint bilgisine göre tekillik vardır. sellerAddressPoint bilgisi aynı olan birden fazla kayıt oluşturulamaz. Bu metot içinde kullanılacak satıcı adres ili ve ilçesi bilgileri listCounties metodundaki kayıtlarla oluşturulmalıdır. Bu kayıtlar dışındaki bilgi içeren istekler hata uyarılarıyla sisteme kayıt işlemleri yapılmayacaktır. createSellerAddressPoint() metodu ile ilgili önemli bilgiler ve Horoz sisteminde satıcı adres noktası bilgisi oluşturulurken dikkat edilmesi gerekenler liste halinde aşağıda istemcilerin bilgisine sunulmuştur.

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

• createSellerAddressPoint() metodu ile Horoz sistemine satıcı adres noktası bilgisi gönderimi 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. createSellerAddressPoint() metodu ile yapılan gönderim UTF-8 olarak encode edilerek Horoz Lojistik E-İhracat Entegrasyonu Web servisine iletilmelidir.

• createSellerAddressPoint() metodu, istemcinin Horoz sisteminde sipariş oluşturulacak satıcı çıkış noktalarını Horoz sistemine tanımlamasını sağlayan E-İhracat web servisi metodudur.

• Horoz Lojistijk E-İhracat Entegrasyonuna dahil olacak istemciler için satıcı çıkış noktalarının tanımlamasının, sipariş oluşturma işlemlerinden önce yapılması elzemdir.

• createSellerAddressPoint() metodu parametre olarak; sellerAddressPoint, sellerAddressCity, sellerAddressCounty, sellerAddress, sellerAddressPostCode, sellerAddressPhone1, sellerAddressPhone2,sellerAddressEmailAddress, sellerAddressOfficialPerson değerlerini JSON formatta POST method olarak alır.

• İlgili metot bunun karşılığında sellerAddressPointId, responseCode ve responseMessage bilgilerini istemciye dönerek kayıt işleminin başarı/başarısızlık durumunu bildirir. Çıkış yeri oluşturma metodunun yanıtına, oluşturulan çıkış yeri kaydı için ID eklenmiştir. İlgili ID’nin çıkış yeri güncelleme metodunda kullanılması beklenir.

---

POST createSellerAddressPoint()

ENDPOINT

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

Parametre Açıklamaları & Kuralları

Aşağıdaki tabloda createSellerAddressPoint() 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
sellerAddressPoint	Satıcı çıkış noktası adı	string	30	inBody Request	Zorunlu
sellerAddressCity	Satıcı çıkış noktası şehir	string	100	inBody Request	Zorunlu
sellerAddressCounty	Satıcı çıkış noktası ilçe	string	100	inBody Request	Zorunlu
sellerAddress	Satıcı çıkış noktası adresi	string	500	inBody Request	Zorunlu
sellerAddressPostCode	Satıcı çıkış noktası posta kodu	string	20	inBody Request	Zorunlu
sellerAddressPhone1	Satıcı çıkış noktası telefon1	string	20	inBody Request	Zorunlu
sellerAddressPhone2	Satıcı çıkış noktası telefon2	string	20	inBody Request	Opsiyonel
sellerAddressEmailAddress	Satıcı çıkış noktası email adresi	string	100	inBody Request	Zorunlu
sellerAddressOfficialPerson	Satıcı çıkış noktası yetkili kişi	string	100	inBody Request	Zorunlu

Örnek İstek

  {
    "sellerAddressPoint": "TRAKYA ÇIKIŞ NOKTASI",
    "sellerAddressCity": "EDİRNE",
    "sellerAddressCounty": "MERKEZ",
    "sellerAddress": "SEMİHAAYVERDİ MAHALLESİ, KAYIK SOKAK, NO:42 EDİRNE/MERKEZ",
    "sellerAddressPostCode": "98745",
    "sellerAddressPhone1": "05512698745",
    "sellerAddressPhone2": null,
    "sellerAddressEmailAddress": "trakya@trakya.com",
    "sellerAddressOfficialPerson": "ALİ UÇAR"
  }

Örnek Cevap

  {
    "response": {
      "responseCode": "STA-100",
      "responseMessage": "Basarili",
      "createSellerAddressResponse": [
        {
          "sellerAddressPointId": 123
        }
      ]
    }
  }

---

Servis Cevapları

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