Skip to main content

1. Overview

Domestic Distribution API Integration​

Horoz Logistics Domestic Distribution API Integration is the integration that enables the performance of operational processes such as creation of orders, cancellation of orders, receipt of barcode labels for an order created and cancellation of the barcode label by means of the notifications made to Horoz Logistics through the Horoz Logistics Domestic Distribution API as based on the orders of the respective merchants of the third party integrator companies and with respect to the products manufactured/produced by the in-network merchants of Horoz Logistics and the E-Commerce platforms used by the in-network merchants.

Security and User Authentication Processes​

In order for the clients to access the Horoz Logistics Domestic Distribution Cargo Tracking Integration Web Service, it is required that the IP addresses of the respective client are authorized by the system unit of Horoz Logistics which is the service provider party. In the web service methods, available in the Horoz Logistics Domestic Distribution Cargo Tracking Integration Web Service, client authentication and identification process is ensured by entering the processKey value, expected as the header parameter of each web service method to the web service method. Such processKey details will be shared with the client side by Horoz Logistics.

In order for a client that will be integrated into the Horoz Logistics Domestic Distribution Cargo Tracking Integration for the first time to obtain such details, the client must contact the sales representative of Horoz Logistics, and fulfill the necessary agreement procedures, and the the current cards of the client must be created in the Horoz Logistics system by Horoz Logistics customer representatives, and the company code and the company trade name details pertaining to such card current card must be shared with the Horoz integration unit. The integration process may be initiated by running such processes through the Horoz Logistics sales representative and customer representative of the relevant client.

Any client that wishes to be integrated into Horoz Domestic Distribution Cargo Tracking Integration may send their IP address details or IP address range details to entegrasyon@horoz.com.tr by making such details available in the table in the format shared below (Horoz Logistics Domestic Distribution Cargo Tracking Integration Request Form) after their current cards are activated in the Horoz Logistics system. During the course of the process, for the purpose of integrating into Horoz Logistics Domestic Distribution Cargo Tracking Integration, it is possible that any client that has not been IP authorized in the Horoz Logistics system or for which an IP authorization has been made but the port details of the Horoz Logistics Domestic Distribution Cargo Tracking Integration Web Service have not been authorized on the client side may receive a Connection reset by peer. The following steps must be followed in order to eliminate such error and start the tests.

  • Any client that will receive data from the Horoz Logistics Domestic Distribution Cargo Tracking Integration Web Service may find out the IP address of its server by logging into https://whatismyipaddress.com/tr/ip-im Subsequently, the IP address of the relevant server must be shared with Horoz Logistics, and the IP address must be whitelisted by Horoz Logistics.

  • In case of any IP and/or port restriction on the client side to access the server, where the Horoz Logistics Domestic Distribution Cargo Tracking Integration Web service is available, the IP and/or port details of the server, where the Horoz Logistics Domestic Distribution Integration Web service is available, must be authorized on the client side to remove such restrictions.

  • The port that is required to be authorized by the client that will be integrated into the Horoz Logistics Domestic Distribution Integration Web service for the Horoz Logistics Domestic Distribution Integration Web service on its own server is 7801.

  • You can send an e-mail to entegrasyon@horoz.com.tr for finding out the IP address blocks of Horoz Logistics servers.

Horoz Logistics Integration Request Form Example:

FieldExampleDescription
COMPANY NAMECOMPANY NAME A.S. (INC.)The trade name of the company for which an IP address will be identified
PROJECT EXECUTIVEFULL NAME, NAME1 SURNAME1The project executive of the company for which an IP address will be identified
IT OFFICIALFULL NAME, NAME2 SURNAME2The authorized person of the company for which an IP address will be identified
E-MAIL ADDRESSES OF THE AUTHORIZED PERSON(S)name.surname@mail.comThe e-mail addresses of the authorized person for INTEGRATION/SYSTEM within the company for which an IP address will be identified
TELEPHONE NUMBER OF THE AUTHORIZED PERSON02121234567The telephone numbers of the authorized persons within the company for which an IP address will be identified
TEST SYSTEM IP ADDRESS DETAILS175.176.177.178- 175.176.177.180 (Range) or 174.175.176.177 (static IP)The static IP addresses through which the company performs output, or the static IP addresses of the Integration servers (IP address through which it is connected to the external world)
LIVE SYSTEM IP ADDRESS DETAILS175.176.177.178- 175.176.177.180 (Range) or 174.175.176.177 (static IP)The static IP addresses through which the company performs output, or the static IP addresses of the Integration servers (IP address through which it is connected to the external world)