Ana içeriğe geç

1. Genel Bakış

Yurtiçi Dağıtım API Entegrasyonu​

Horoz Lojistik Yurtiçi Dağıtım API Entegrasyonu; Horoz Lojistik’in anlaşmalı satıcılarının, anlaşmalı satıcılarının kullandığı E-Ticaret platformlarının ürettiği veya sattığı ürünlerin ve üçüncü parti entegratör firmalarının ilgili satıcıların siparişlerine istinaden Horoz Lojistik Yurtiçi Dağıtım API üzerinden Horoz Lojistiğe yapılan bildirimlerle sipariş oluşturulması, siparişin iptal edilmesi, oluşturulan siparişin barkod etiketinin alınması, barkod etiketinin iptal edilmesi gibi operasyonel işlemlerin yapılmasına olanak sağlayan entegrasyondur.

Adres Bilgileri​

İstemci uygulamalar aşağıdaki rest servis adresini kullanarak ilgili servise bağlanabilirler:

Güvenlik ve Kullanıcı Doğrulama İşlemleri​

İstemcilerin Horoz Lojistik Yurtiçi Dağıtım Entegrasyon Webservisine erişim sağlayabilmesi için, servis sağlayıcı taraf olan Horoz Lojistik’in sistem biriminin ilgili istemcinin IP adreslerine izin vermesi gerekmektedir.

Horoz Lojistik Yurtiçi Dağıtım Entegrasyon Webservisi içinde bulunan web servis metotlarında istemci doğrulama ve tanıma işlemi her web servis metodunun başlık parametresi olarak beklenen processKey değerinin web servis metoduna geçilmesi ile sağlanmaktadır. Söz konusu processKey bilgisi istemci tarafı ile Horoz Lojistik tarafından paylaşılacaktır.

Horoz Lojistik Yurtiçi Dağıtım Entegrasyonuna ilk defa entegre olacak istemcinin bu bilgiyi elde edebilmesi için istemcinin Horoz Lojistik tarafındaki satış temsilcisi ile irtibata geçerek, gerekli anlaşma prosedürlerini yerine getirmesi, istemciye ait cari kartlarının Horoz Lojistik müşteri temsilcileri tarafından Horoz Lojistik sisteminde oluşturularak bu cari karta ait firma kodu ve firma unvanı bilgilerinin Horoz entegrasyon birimi ile paylaşılması gerekmektedir. Bu süreçler ilgili istemcinin Horoz Lojistik satış temsilcisi ve müşteri temsilcisi üzerinden ilerletilerek entegrasyon sürecine başlanabilir.

Horoz Yurtiçi Dağıtım Entegrasyonuna entegre olmak isteyen istemciler, Horoz Lojistik sisteminde cari kartları aktif edildikten sonra, statik olmak koşulu ile IP adresi bilgilerini yada IP adresi aralıkları bilgilerini aşağıda (Horoz Lojistik Yurtiçi Dağıtım Entegrasyon Talep Formu) paylaşılan formattaki tablo halinde hazır hale getirerek entegrasyon@horoz.com.tr adresine iletebilirler.

Horoz Lojistik Yurtiçi Dağıtım Entegrasyonuna entegre olmak için ilerletilen süreçte Horoz Lojistik sisteminde IP yetkilendirmesi yapılmamış yada IP yetkilendirmesi yapılmış ama istemci tarafında Horoz Lojistik Yurtiçi Dağıtım Entegrasyonu Webservisine ait port bilgisine yetki verilmemiş istemcilerin web servis bünyesindeki metotlardan birine erişim denemelerinde Connection reset by peer hatası almaları olasıdır. Bu hatanın giderilmesi ve testlerin başlaması için aşağıdaki adımların takip edilmesi gerekmektedir.

  • Horoz Lojistik Yurtiçi Dağıtım Entegrasyonu Web servisine veri gönderimi yapacak istemci sunucusuna ait IP adresini https://whatismyipaddress.com/tr/ip-im adresine giriş yaparak öğrenebilir. Akabinde, ilgili sunucunun IP adresi Horoz Lojistik ile paylaşılarak, IP adresinin Horoz Lojistik tarafında beyaz listeye alınması gerekmektedir.

  • İstemci tarafında, Horoz Lojistik Yurtiçi Dağıtım Entegrasyonu Web servisinin bulunduğu sunucuya erişim için IP ve/veya port kısıtlamaları var ise, bu kısıtlamaların kaldırılması için istemci tarafında Horoz Lojistik Yurtiçi Dağıtım Entegrasyonu Web servisinin bulunduğu sunucunun IP ve/veya port bilgilerine yetki verilmesi gerekmektedir.

  • Horoz Lojistik Yurtiçi Dağıtım Entegrasyon Web servisine entegre olacak istemcinin kendi sunucusunda Horoz Lojistik Yurtiçi Dağıtım Entegrasyon Web servisi için yetkilendirmesi gereken port 7801 şeklindedir.

  • Horoz Lojistik sunucularına ait IP adres bloklarını öğrenmek için entegrasyon@horoz.com.tr adresine mail gönderebilirsiniz.

Horoz Lojistik Yurtiçi Dağıtım Entegrasyon Talep Form Örneği:

AlanÖrnekAçıklama
FİRMA ADIFİRMA ADI A.Ş.IP adresi tanımlanacak firmanın adı
PROJE YETKİLİSİAD SOYAD, AD1 SOYAD1IP adresi tanımlanacak firmanın proje yetkilisi
IT YETKİLİSİAD SOYAD, AD2 SOYAD2IP adresi tanımlanacak firmanın yetkilisi
YETKİLİ EMAİL ADRESLERİad.soyad@mail.comIP adresi tanımlanacak firmada ENTEGRASYON/SİSTEM yetkili mail adresleri
YETKİLİ TELEFON NUMARASI02121234567IP adresi tanımlanacak firmada yetkili kişilerin telefon numaraları
TEST SİSTEMİ IP ADRESİ BİLGİLERİ175.176.177.178- 175.176.177.180 (Aralık) veya 174.175.176.177 (sabit IP)Firmanın çıkış yaptığı veya Entegrasyon sunucularının sabit IP adresleri (Dış dünyaya bağlantı kurduğu IP adresi)
CANLI SİSTEM IP ADRESİ BİLGİLERİ175.176.177.178- 175.176.177.180 (Aralık) veya 174.175.176.177 (sabit IP)Firmanın çıkış yaptığı veya Entegrasyon sunucularının sabit IP adresleri (Dış dünyaya bağlantı kurduğu IP adresi)