API - Delivery

Інформація для власників сайтів

Використовуючи наш API, ви зможете на своєму сайті:

- оформляти квитанції (ТТН) і отримувати назад їх номер;
- отримувати трекінг (рух) вантажу по квитанції;
- дізнаватися повну інформацію по вже створеній квитанції;
- виконувати розрахунок вартості відправки вантажу;
- виводити довідкову інформацію по містах, в яких працює Делівері, і складах, які там є.

Інформація для програмістів

Реалізувати все, що написано в розділі для власників можна, завантаживши документацію (кнопка нижче) і ознайомившись з методами.

Якщо для роботи вам потрібна тільки довідкова інформація (списки міст, складів та інше), то методами можна користуватися прямо зараз, без попередньої підготовки. Для всього іншого - необхідна реєстрація на сайті Делівері.

Важливо! Деякі функції в документації мають позначку "Метод вимагає авторизації", а деякі "Метод вимагає авторизації через API". Для другого випадку вам необхідно згенерувати API-ключі (кнопка нижче), а для першого - просто авторизуватися доступними в документації способами.

Відзначимо, що функції для роботи з квитанціями вимагають ключів, тому краще не зволікати з цим питанням.

Щоб створити АРІ ключі перейдіть за посиланням

Інформація для програмістів

JavaScript

PHP


        var apiKey = 'CDBFE2D5-BF02-4C0D-B7D6-5CF277761C50';
        var apiSecretKey = '6c131f01b99dfac3529d0cd68b1d6649';
        
        var getHMAC = function (key, timestamp) {
            var hash = CryptoJS.HmacSHA1(key + timestamp, apiSecretKey);
            return hash.toString();
        };

        var data = {
                "culture": "ru-RU",
                "flSave": "false",
                "debugMode": "true",
                "receiptsList": [
                    {
                        "senderid": "CDBFE2D5-BF02-4C0D-B7D6-5CF277761C50",
                        "areasSendId": "4577d856-322b-e311-8b0d-00155d037960",
                        "areasResiveId": "16617df3-a42a-e311-8b0d-00155d037960",
                        "warehouseSendId": "5f2af375-5d70-e211-9ce1-00155d012a15",
                        "warehouseResiveId": "bdff546c-cb16-e211-89ed-00155d053b5d",
                        "dateSend": "2018-02-20T00:00:00",
                        "deliveryScheme": 0,
                        "posibleResiverReceipt_1": "ee5df311-6565-44d5-84f6-14875aa3e208",
                        "posibleResiverReceipt_2": "",
                        "posibleResiverReceipt_3": "",
                        "posibleResiverReceipt_4": "",
                        "currency": 100000000,
                        "InsuranceValue": 5000,
                        "payerInsuranceId": "1aa70d22-1209-e511-b3b5-000d3a200160",
                        "payerType": 1,
                        "paymentType": 0,
                        "paymentTypeInsuranse": 0,
                        "deliveryAddressId": "",
                        "deliveryContactName": "",
                        "deliveryContactPhone": "",
                        "DeliveryComment": "",
                        "ReturnDocuments": false,
                        "climbingToFloor": 0,
                        "CustomsCost": 0,
                        "CustomsCurrency": 100000000,
                        "CustomsDocuments": false,
                        "CustomsDescriptions": "",
                        "cashOnDeliveryType": 2,
                        "CashOnDeliveryValuta": 100000000,
                        "CashOnDeliveryValue": 5000,
                        "CashOnDeliveryCardId": "",
                        "CashOnDeliveryWarehouseId": "5f2af375-5d70-e211-9ce1-00155d012a15",
                        "CashOnDeliverySenderFullName": "Семёнов Семён Семёнович",
                        "CashOnDeliverySenderPhone": "0958888888",
                        "CashOnDeliveryRasschSchetId": "",
                        "CashOnDeliveryReceiverFullName": "Петров Пётр Петрович",
                        "CashOnDeliveryReceiverPhone": "0671234567",
                        "parentNumber": "",
                        "CashOnDeliveryDescription": "Описание",
                        "CashOnDeliveryPayerAccountId": "ee5df311-6565-44d5-84f6-14875aa3e208",
                        "pickUpDate": "",
                        "pickUpContactName": "",
                        "pickUpContactPhone": "",
                        "pickUpAddressId": "",
                        "descentFromFloor": 0,
                        "category": [
                            {
                                "categoryId": "00000000-0000-0000-0000-000000000000",
                                "cargoCategoryId": "f506d03b-9e36-e311-8b0d-00155d037960",
                                "countPlace": 1,
                                "helf": 1,
                                "size": 0.3,
                                "isEconom": false,
                                "PartnerNumber": "\"\""
                            }
                        ]
                    }
                ]
            };

        $.ajax({
            url: 'https://www.delivery-auto.com/api/v4/Public/PostCreateReceipts',
            type: "POST",
            data: data,
            dataType: 'json',
            beforeSend: function (request) {
                request.setRequestHeader('HMACAuthorization', 'amx ' + apiKey + ':' + timestamp + ':' + getHMAC(apiKey, timestamp));
            },
            success: function (data) {
                debugger;
                if (data.status == true) {
                    debugger;
                }
            },
            error: alert('error');
        });

    
        public string getHMAC(string publicKey, TimeSpan timestamp, string secretKey) {
            string message = publicKey + timestamp.Milliseconds.ToString();
            System.Text.ASCIIEncoding encoding = new System.Text.ASCIIEncoding();
            HMACSHA1 hmacsha1 = new HMACSHA1(encoding.GetBytes(secretKey));
            byte[] hashmessage = hmacsha1.ComputeHash(encoding.GetBytes(message));
            return ByteToString(hashmessage);
        }
        
        public static string ByteToString(byte[] buff)
        {
            string sbinary = "";
            for (int i = 0; i < buff.Length; i++)
            {
                sbinary += buff[i].ToString("X2"); // hex format
            }
            return (sbinary);
        }
        public ActionResult TestJSApi()
        {
            string dataString = @"{
                "culture": "ru-RU",
                "flSave": "false",
                "debugMode": "true",
                "receiptsList": [
                    {
                        "senderid": "CDBFE2D5-BF02-4C0D-B7D6-5CF277761C50",
                        "areasSendId": "4577d856-322b-e311-8b0d-00155d037960",
                        "areasResiveId": "16617df3-a42a-e311-8b0d-00155d037960",
                        "warehouseSendId": "5f2af375-5d70-e211-9ce1-00155d012a15",
                        "warehouseResiveId": "bdff546c-cb16-e211-89ed-00155d053b5d",
                        "dateSend": "2018-02-20T00:00:00",
                        "deliveryScheme": 0,
                        "posibleResiverReceipt_1": "ee5df311-6565-44d5-84f6-14875aa3e208",
                        "posibleResiverReceipt_2": "",
                        "posibleResiverReceipt_3": "",
                        "posibleResiverReceipt_4": "",
                        "currency": 100000000,
                        "InsuranceValue": 5000,
                        "payerInsuranceId": "1aa70d22-1209-e511-b3b5-000d3a200160",
                        "payerType": 1,
                        "paymentType": 0,
                        "paymentTypeInsuranse": 0,
                        "deliveryAddressId": "",
                        "deliveryContactName": "",
                        "deliveryContactPhone": "",
                        "DeliveryComment": "",
                        "ReturnDocuments": false,
                        "climbingToFloor": 0,
                        "CustomsCost": 0,
                        "CustomsCurrency": 100000000,
                        "CustomsDocuments": false,
                        "CustomsDescriptions": "",
                        "cashOnDeliveryType": 2,
                        "CashOnDeliveryValuta": 100000000,
                        "CashOnDeliveryValue": 5000,
                        "CashOnDeliveryCardId": "",
                        "CashOnDeliveryWarehouseId": "5f2af375-5d70-e211-9ce1-00155d012a15",
                        "CashOnDeliverySenderFullName": "Семёнов Семён Семёнович",
                        "CashOnDeliverySenderPhone": "0958888888",
                        "CashOnDeliveryRasschSchetId": "",
                        "CashOnDeliveryReceiverFullName": "Петров Пётр Петрович",
                        "CashOnDeliveryReceiverPhone": "0671234567",
                        "parentNumber": "",
                        "CashOnDeliveryDescription": "Описание",
                        "CashOnDeliveryPayerAccountId": "ee5df311-6565-44d5-84f6-14875aa3e208",
                        "pickUpDate": "",
                        "pickUpContactName": "",
                        "pickUpContactPhone": "",
                        "pickUpAddressId": "",
                        "descentFromFloor": 0,
                        "category": [
                            {
                                "categoryId": "00000000-0000-0000-0000-000000000000",
                                "cargoCategoryId": "f506d03b-9e36-e311-8b0d-00155d037960",
                                "countPlace": 1,
                                "helf": 1,
                                "size": 0.3,
                                "isEconom": false,
                                "PartnerNumber": "\"\""
                            }
                        ]
                    }
                ]
            }";
            var apiKey = "CDBFE2D5-BF02-4C0D-B7D6-5CF277761C50";
            var apiSecretKey = "6c131f01b99dfac3529d0cd68b1d6649";
            DateTime myDate1 = new DateTime(1970, 1, 9, 0, 0, 00);
            DateTime myDate2 = DateTime.Now;
            var timestamp = myDate2.Subtract(myDate1);
            var HMAC = getHMAC(apiKey, timestamp, apiSecretKey);
            var request = (HttpWebRequest)WebRequest.Create("https://www.delivery-auto.com/api/v4/Public/PostCreateReceipts");
            var data = System.Text.Encoding.UTF8.GetBytes(dataString);
            request.Method = "POST";
            request.ContentType = "text/json";
            request.ContentLength = data.Length;
            request.Headers["HMACAuthorization"] = string.Format("amx {0}:{1}:{2}", apiKey, timestamp.Milliseconds.ToString(), HMAC);
            using (var stream = request.GetRequestStream())
            {
                stream.Write(data, 0, data.Length);
            }
            var response = (HttpWebResponse)request.GetResponse();
            var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();

    
        /*Приклад взаємодії з Delivery API (PHP)  by SNENKO web development*/


        class DeliveyAutoApi
        {
            protected $public_key;
            protected $secret_key;
            public $culture = 'ru-RU';//en-US, ru-RU, uk-UA

            function __construct($culture = '', $public_key = '', $secret_key = '')
            {
                if (!empty($culture)):
                    $this->culture = $culture;
                endif;
                if (!empty($public_key)):
                    $this->public_key = 'your_key';
                endif;
                if (!empty($secret_key)):
                    $this->secret_key = "your_key";
                endif;
            }

            function send($part)  //you custom params here
            {
                $url = 'https://www.delivery-auto.com/api/v4/Public/PostReceiptCalculate';
                $data = array(
                'culture' => $this->culture,
                'areasSendId' => $part['city_sender'],
                'areasResiveId' => $part['city_incoming'],
                'warehouseSendId' => $part['warehouse_sender'],
                'warehouseResiveId' => $part['warehouse_incoming'],
                'InsuranceValue' => 1000000,
                'CashOnDeliveryValue' =>  5000,
                'dateSend' => $part['sending_date'],
                'deliveryScheme' => 2,
                'category' => [[
                    'categoryId' =>  "00000000-0000-0000-0000-000000000000",
                    'countPlace' =>  1,
                    'helf' =>  $part['weight'],
                    'size'=>  0.1
                ]],
                'dopUslugaClassificator' => [[
                    'dopUsluga' => [
                        'uslugaId' => "2b4247c9-be8c-e211-be60-00155d037919",
                        'count' => 1
                    ]
                ]]
                );

                return curl_POST($url, $data);
            }
            
            function curl_POST($url, $data)
            {
                $curl = curl_init();

                curl_setopt($curl, CURLOPT_URL, $url);
                curl_setopt($curl, CURLOPT_RETURNTRANSFER,true);
                curl_setopt($curl, CURLOPT_POST, true);
                curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
                $result = curl_exec($curl);
                curl_close($curl);

                return json_decode($result);
            }
        }

Перевірка

Метод запросу:

Get

Post

API-ключ:

Нi

Так

Публічний ключ:

Секретний ключ:

Адреса методу:

https://www.delivery-auto.com/api/v4/Public/

Вхідні параметри в форматі JSON:

Вихідні параметри:

Щось в перевірці пішло не так?

Надіслати розробнику вхідні дані?

Завантажити документацію

Яка вартість страхування вантажу?

При оцінюванні вантажу:
до 1 999, 99 грн — 15 грн;
від 2 000 грн до 4 999, 99 грн — 0,75%;
від 5 000 грн до 149 999, 99 грн — 0,45%;
від 150 000 грн та вище — 0,65%;
1,05% від заявленої вартості — з урахуванням військових ризиків по всій території Країни;
1,05% від заявленої вартості — в обов'язковому порядку при відправленні вантажу в/з представництв Компанії у м. Слов'янськ, Краматорськ, Дружківка Донецькій області, м. Ізюм та Балаклея Харківської області, Сумську область, а також представництв в містах, діяльність яких буде відновлюватися і де відстань до лінії активних бойових дій буде менше 50 км. (незалежно від наявності підписаного генерального договору страхування з клієнтом).

Як змінити місто прибуття вантажу?

1) Змінити місто прибуття вантажу може відправник в мобільному додатку https://www.youtube.com/channel/UC2ZxuQoIjvHGl2yR4FeS8qQ; 2) Змінити місто прибуття вантажу може відправник або одержувач, склавши лист-заяву на переадресацію. Зразок листа-заяви .
Якщо змінити місто прибуття бажає фізична особа, до листа необхідно додати копію 1-2 сторінки паспорта. Якщо змінити місто прибуття бажає юридична особа, лист необхідно написати на фірмовому бланку і завірити печаткою підприємства.

Як змінити отримувача вантажу?

Змінити одержувача відправник може: 1) в мобільному додатку https://www.youtube.com/channel/UC2ZxuQoIjvHGl2yR4FeS8qQ; 2) в особистому кабінеті
3) через письмову заяву. Для зміни одержувача в квитанції відправнику необхідно надіслати лист-переадресацію (кольорову фотокопію листа) по електронній пошті на склад прибуття або електронну пошту office@delivery-auto.com.ua. Якщо лист-переадресацію пише фіз. особа, необхідно докласти 1-2 сторінки паспорта відправника. Зразок листа
Звертаємо Вашу увагу, що в квитанції при відправці вантажу можна вказати до 4х одержувачів.

Як дізнатися чи прибув вантаж?

1. На нашому сайті ви зможете дізнатися статус відправленого вантажу, для чого необхідно скористатися формою «Глобальний пошук квитанції або інформації» або в Особистому кабінеті чи у мобільному застосунку.
2. Очікуйте смс-повідомлення про доставку вашого вантажу в пункт призначення за номером телефону, зазначеним у квитанції.
3. У чат-боті у Viber або Telegram.

Як можна отримати компенсацію?

Вам необхідно звернутися до співробітника складу отримання для складання акту приймання вантажу (багажу) за кількістю та якістю, надати документи, що підтверджують вартість вантажу. Протягом 14 календарних днів з моменту надання клієнтом повного пакету документів проводиться службове розслідування, про результати якого ви отримаєте повідомлення на Ваш телефон та в Особистому кабінеті.
Якщо вантаж був застрахований, необхідно також заповнити заяву до страхової компанії. Зразок заяви ви знайдете на нашому сайті за посиланням

Компанія

Клієнтам

Вартість

Документи

Зв'язок та підтримка

Гаряча лінія

Замовити забір/доставку

Для розробників

Інформація для власників сайтів

Інформація для програмістів

Інформація для програмістів

Перевірка

Запитати

Часті запитання

Яка вартість страхування вантажу?

Як можна отримати знижку?

Як змінити місто прибуття вантажу?

Як змінити отримувача вантажу?

Як дізнатися чи прибув вантаж?

Як можна отримати компенсацію?

Як повинен бути упакований вантаж?

Інформація для власників сайтів

Інформація для програмістів

Інформація для програмістів

Перевірка

Запитати

Часті запитання

Яка вартість страхування вантажу?

Як можна отримати знижку?

Як змінити місто прибуття вантажу?

Як змінити отримувача вантажу?

Як дізнатися чи прибув вантаж?

Як можна отримати компенсацію?

Як повинен бути упакований вантаж?

Графік роботи Гарячої лінії

Ознайомитися з тарифною сіткою по Україні

Підписка на новини

Ваша заявка успішно відправлена!

Ваша заявка успішно відправлена!

Ваша заявка не відправлена

Повідомлення надіслано

Переказ на реквізити клієнта

У місті відправлення

У місті відправлення

У місті отримання

У місті отримання

Ваша заявка успішно
відправлена!

Ваша заявка успішно
відправлена!