1C
Widgets
Delivery-comany's API
Deliveri provides its customers with tools that will allow us
to integrate our capabilities into your site.
to integrate our capabilities into your site.
Information for site owners
Using our API, you can on your website:
- issue receipts (TTN) and get their number back;
- receive tracking (movement) of cargo on receipt;
- to recognize full info on the already established receipts;
- produce a calculation of the cost of sending the goods;
- display reference information for the cities in which Deliveri works, and the warehouses that are there.
Information for programmers
To implement everything that is written in the section for owners, you can download the documentation (button below) and get acquainted with the methods.
If for work you only need reference information (lists of cities, warehouses, etc.), then methods can use right now, without any preliminary preparation. For everything else, you need registration on Deliveri's website.
Important! Some functions in the documentation are marked as "Method requires authorization", and some "Method requires authorization via API". For the second case, you need to generate the API keys (the button below), and for the first one - to simply authorize the methods available in the documentation.
Note that the functions for working with receipts require keys, so it's better not to postpone this issue for a long time.
JavaScript
C#
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 не работают с PHP.
Данный пример взят из рабочих кодов наших клиентов.
Будем признательны если найдёте ошибки и укажете нам.*/
private function authorization_in_header(){
private publickey = "CDBFE2D5-BF02-4C0D-B7D6-5CF277761C50";
private secretkey = "6c131f01b99dfac3529d0cd68b1d6649";
$timestamp = time();
$my_sign = $this->hmac_sha1($this->secretkey, $this->publickey . $timestamp);
$header = array("HMACAuthorization: amx $this->publickey:$timestamp:$my_sign");
return $header;
}
private function hmac_sha1($key, $data){
// Adjust key to exactly 64 bytes
if (strlen($key) > 64) {
$key = str_pad(sha1($key, true), 64, chr(0));
}
if (strlen($key) < 64) {
$key = str_pad($key, 64, chr(0));
}
// Outter and Inner pad
$opad = str_repeat(chr(0x5C), 64);
$ipad = str_repeat(chr(0x36), 64);
// Xor key with opad & ipad
for ($i = 0; $i < strlen($key); $i++) {
$opad[$i] = $opad[$i] ^ $key[$i];
$ipad[$i] = $ipad[$i] ^ $key[$i];
}
return sha1($opad.sha1($ipad.$data, true));
}
function send(){
$post = new stdClass();
$post->culture = "ru-RU"; //Культура
$post->flSave = true; //Флаг сохраниния
$post->debugMode = true; //Флаг режима дебага
$post->receiptsList = array();
$post->receiptsList[0] = new stdClass();
$post->receiptsList[0]->areasSendId = "4577d856-322b-e311-8b0d-00155d037960"; //Город отправки
$post->receiptsList[0]->areasResiveId = "16617df3-a42a-e311-8b0d-00155d037960"; //Город получения
$post->receiptsList[0]->warehouseSendId = "5f2af375-5d70-e211-9ce1-00155d012a15"; //Склад отправки
$post->receiptsList[0]->warehouseResiveId = "bdff546c-cb16-e211-89ed-00155d053b5d"; //Склад получения
$post->receiptsList[0]->senderId = "CDBFE2D5-BF02-4C0D-B7D6-5CF277761C50"; //Id отправтеля
$post->receiptsList[0]->dateSend = date("Y-m-d", time()+(24*60*60))."T00:00:00"; //Дата отправки
$post->receiptsList[0]->deliveryScheme = 0; //Схема доставки 0- Склад-склад, 1- Двери двери, 2- Склад-двери, 3- Двери-склад
$post->receiptsList[0]->receiverName = "Семёнов Семён Семёнович"; //Получатель
$post->receiptsList[0]->receiverPhone = "0501234567"; //Телефон получателя
$post->receiptsList[0]->receiverType = false; //Телефон получателя
$post->receiptsList[0]->currency = 100000000; //Валюта квитанции
$post->receiptsList[0]->payerType = 1; //Тип плательщика 0-отправитель, 1-полуатель
$post->receiptsList[0]->paymentType = 0; //Тип оплаты 1-безнал., 0-нал.
$post->receiptsList[0]->InsuranceValue = 5000.0; //Застрахованная стоимость груза
$post->receiptsList[0]->payerInsuranceId = "1aa70d22-1209-e511-b3b5-000d3a200160"; //плательщик страховки
$post->receiptsList[0]->paymentTypeInsuranse = 0; //Тип оплаты 1-безнал., 0-нал.
$post->receiptsList[0]->cashOnDeliveryType = 2, //Тип наложенного платежа 0-плетажна карта, 1-расчетый счет, 2-наличными
$post->receiptsList[0]->CashOnDeliveryValuta = 100000000, //Валюта наложенного платежа
$post->receiptsList[0]->CashOnDeliveryValue = 5000.0, //Сумма наложенного платежа
$post->receiptsList[0]->CashOnDeliveryCardId = "", //Id платежной карты
$post->receiptsList[0]->CashOnDeliveryPayerAccountId = "ee5df311-6565-44d5-84f6-14875aa3e208" //плательщик наложенного платежа
$post->receiptsList[0]->CashOnDeliveryRasschSchetId = "", //Id расчетного счета
$post->receiptsList[0]->CashOnDeliveryDescription = "Описание", //Описание наложенного платежа
$post->receiptsList[0]->CashOnDeliveryWarehouseId = "5f2af375-5d70-e211-9ce1-00155d012a15", //Склад выплаты наложенного платежа
$post->receiptsList[0]->CashOnDeliverySenderFullName = "Семёнов Семён Семёнович",//Ф.И.О. получателя наложенного платежа
$post->receiptsList[0]->CashOnDeliverySenderPhone = "0958888888",//Телефон получателя наложенного платежа
$post->receiptsList[0]->CashOnDeliveryReceiverFullName = "Петров Петр Петрович",//Ф.И.О. плательщика наложенного платежа
$post->receiptsList[0]->CashOnDeliveryReceiverPhone = "0671234567",//Телефон плательщика наложенного платежа
$post->receiptsList[0]->pickUpDate = "", //Дата забора
$post->receiptsList[0]->pickUpContactName = ""; //контактное лицо для забора
$post->receiptsList[0]->pickUpContactPhone = ""; //Контактный телефон для забора
$post->receiptsList[0]->pickUpAddressId = "", //Адрес забора
$post->receiptsList[0]->category = array();
$post->receiptsList[0]->category['categoryId'] = "00000000-0000-0000-0000-000000000000"; //Категория тарифа
$post->receiptsList[0]->category['cargoCategoryId'] = "f506d03b-9e36-e311-8b0d-00155d037960"; //Категория отправляемого груза
$post->receiptsList[0]->category['countPlace'] = 1; //Количество мест
$post->receiptsList[0]->category['helf'] = 1.0; //Вес
$post->receiptsList[0]->category['size'] = 1.0; //Объем
$post->receiptsList[0]->category['isEconom'] = true, //Экономная, но более долгая доставка
$post->receiptsList[0]->category['PartnerNumber'] = "" //Номер декларации партнера
$post = json_encode($post, JSON_UNESCAPED_UNICODE);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.delivery-auto.com/api/v4/Public/PostCreateReceipts");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_HTTPHEADER, $this->authorization_in_header());
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
$this->otvet = curl_exec($ch);
$this->info = curl_getinfo($ch);
curl_close($ch); unset($ch);
pre($this->otvet);
}
Request method:
API-key:
Input parameters:
Public key:
Secret key:
Method Address:
https://www.delivery-auto.com/api/v4/Public/
Input parameters in JSON format:
Output parameters:
Something to check went wrong?
Send the original data to the developer?
If you have any questions in the course of the work - ask them to the Delivery company developers by filling in the contact form.
You can also use the form if there were errors that you want to inform us about, or you have suggestions for improving the service. Or write to developer - SBabiy@delivery-auto.com.ua
Send