ონვეის API დოკუმენტაცია

მიმდინარე დოკუმენტის მეშვეობით შეძლებთ ონვეისთან API ინტეგრაციას. დოკუმენტში მოცემულია მონაცემები, რომელსაც ონვეი იყენებს საქმიანობის განსახორციელებლად. თითოეულ ასეთ მონაცემს ახლავს განმარტება და ასევე ინფორმაცია - სავალდებულოა თუ არა.

სისტემასთან დასაკავშირებლად დაგჭირდებათ: API Username და API Key, რასაც ონვეის წარმომადგენელი გიგზავნით.

შეკვეთის დამატება

$data=array(

'username'=>'',

'key'=>'',

'from_city'=>'', // გამგზავნის ქალაქი სიტყვიერად (სავალდებულო) , აიდის გადმოცემის შემთხვევაში from_city_id

'from_name'=>'', // გამგზავნის სახელი, გვარი (სავალდებულო)

'from_phone'=>'', // გამგზავნის ტელეფონი (სავალდებულო)

'from_address'=>'', // გამგზავნის მისამართი (სავალდებულო)

'from_company'=>'', // გამგზავნი კომპანია (სავალდებულოა იურიდიული პირის შემთხვევაში)

'to_city'=>'', // მიმღების ქალაქი სიტყვიერად (სავალდებულო), აიდის გადმოცემის შემთხვევაში to_city_id

'to_name'=>'', // მიმღების სახელი, გვარი (სავალდებულო)

'to_phone'=>'', // მიმღების ტელეფონი (სავალდებულო)

'to_address'=>'', // მიმღების მისამართი (სავალდებულო)

'to_company'=>'', // მიმღების კომპანია (სავალდებულოა იურიდიული პირის შემთხვევაში)

'services'=>array(8,9), //დამატებით სერვისები (8=>დოკუმენტის უკან მიწოდება, 9=>დასურათება, 11=> ცნობის დამზადება )

'payment'=>3, // გადახდის მეთოდი (1=>ნაღდი, 3=>ინვოისით გადახდა, 4=>ტერმინალით გადახდა ) (სავალდებულოა )

'payer'=>2, // გადამხდელი მხარე (1=>გამგზავნი, 2=>მიმღები, 3=>შემკვეთი) (სავალდებულოა)

'spo'=>0, // 0,1 (ძირითადად არ სჭირდებათ კომპანიებს)

'order_price'=>0, // ნივთების საფასური (გამოაგზავნეთ მაშინ, როდესაც თანხა უნდა ავიღოთ მომხმარებლისგან)

'weight'=>1, //წონა (სავალდებულო)

'quantity'=>1, //რაოდენობა (სავალდებულო)

'service_level'=>1, // მომსახურების დონე (1=>სტანდარტი) (სავალდებულო)

'order_number'=>'', //შეკვეთის ნომერი (ამას თუ გამოაყოლებთ, მომხმარებელი თრექინგითაც და შეკვეთის ნომრითაც მოიძიებს ჩვენს საიტზე ინფორმაციას)

'order_detail'=>'', //კომენტარი

'invoice_amount'=>'', (თუ დაზღვევით არ სარგებლობთ, არ გჭირდებათ)

'brittle'=>'', //მტვრევადი 0,1

'receiver_shipprice_pay'=>0 //იხდის მიმღები 0,1 (როცა გამოყენებულია Ნივთის ღირებულების კურიერთან გადახდა (COD) და გსურთ, რომ შიპინგის ფასი ნივთების საფასურს დაემატოს. ამ შემთხვევაში საკურიეროს გადამხდელი იქნება მიმღები)

‘additional_information’=>’’ //დამატებითი ინფორმაცია

);

$data_string=json_encode($data);

$ch = curl_init('https://onway.ge/index.php?route=api/order/add);

curl_setopt_array($ch, array(

CURLOPT_POST => true,

CURLOPT_POSTFIELDS => $data_string,

CURLOPT_RETURNTRANSFER => true,

CURLOPT_HTTPHEADER => array('Content-Type:application/json', 'Content-Length: ' . strlen($data_string)))

);

$server_output = curl_exec($ch);

curl_close ($ch);

print_r($server_output);

აღება/ჩაბარების თარიღები

$data=array(

'username'=>'',

'key'=>'',

'from_city_id'=>2 , // გამგზავნი ქალაქის / რეგიონის აიდი

'to_city_id'=>1, // მიმღები ქალაქის / რეგიონის აიდი

);

$data_string=json_encode($data);

$ch = curl_init('https://onway.ge/index.php?route=api/order/datesinfo');

curl_setopt_array($ch, array(

CURLOPT_POST => true,

CURLOPT_SSL_VERIFYHOST=>0,

CURLOPT_SSL_VERIFYPEER=>0,

CURLOPT_POSTFIELDS => $data_string,

CURLOPT_RETURNTRANSFER => true,

//CURLOPT_HEADER => true,

CURLOPT_HTTPHEADER => array('Content-Type:application/json', 'Content-Length: ' . strlen($data_string)))

);

$server_output = curl_exec($ch);

if (curl_errno($ch)) {

$error_msg = curl_error($ch);

echo $error_msg;

}

curl_close ($ch);

print_r($server_output);

ქალაქები/რეგიონები

https://onway.ge/index.php?route=api/order/regions

შეკვეთის გაუქმება / შეცვლა

https://onway.ge/index.php?route=api/order/edit

გადმოეცემა იგივე დატა რასაც აგზავნით დამატების დროს

ემატება ველი tracking (ონვეის თრექინგის ნომერი )

გაუქმების შემთხვევაში ემატება ველი order_status_id => 47

სტატუსები

order_status_id and name

1 - ასაღები

18 - აღებული

19 -საწყობში

21 - გატანილი ჩასაბარებლად

22 - ჩაბარებული

32 - ელოდება ვიზირებას

34 - არ ჩაბარდა

37 - გაფორმებული

38 - აღების გაუქმება

39 - მიღების გაუქმება

40 - ფილიალიდან გაცემა

41 - უბრუნდება გამგზავნს

42 - გაგზავნილი ფილიალში

43 - არ ჩაბარდა/დასრულებული

44 - ხელმეორედ გატანა

45 - აღებული ხელშეკრულება

46 - ხელშეკრულების დაბრუნება

47 - შეკვეთის გაუქმება

48 - დასრულებული

49 - ფილიალში მიღება

50 - გაცვლა

51 - დაყოვნებული

გადახდის პოლიტიკა

მონაცემების გამოგზავნისას გაითვალისწინეთ თქვენი კომპანიის ფინანსური პოლიტიკა: ვინ იხდის გადაზიდვის ღირებულებას (მომხმარებელი თუ კომპანია) და რა ფორმით. ამ ნაწილში შეგიძლიათ ონვეის წარმომადგენელთან გაიაროთ კონსულტაცია.

უნდა შეირჩეს ამ ორის კომბინაცია: გადახდის მეთოდი და გადამხდელი მხარე. თავის მხრივ, გადახდის მეთოდი შეიძლება იყოს: ნაღდი, ტერმინალით, ინვოისით. გადამხდელი მხარე შეიძლება იყოს: გამგზავნი, მიმღები, შემკვეთი.
კომბინაციები:

COD გარეშე გადახდის მეთოდი/გადამხდელი მხარე: