Уважаемые клиенты, представляем Вашему вниманию новый функционал сайта. Открытое API (Программный интерфейс), реализованный по протоколу SOAP.
Этот интерфейс позволит Вам передать нам заказы из Ваших программ учета, типа 1с, либо с сайтов напрямую, без участия человека.
В данный момент поддерживаются следующие методы

• запрос доступного остатка и цены позиции
• добавление\изменение\удаление товара из корзины
• просмотр содержимого корзины
• очистка корзины
• отправка заказ из корзины

Получить всю номенклатуру в формате XML(стандартный YML), Вы можете по ссылке

https://topavenue.ru/cms/yml.php?api=jhyt87_HG6tRfcc_hd_sdw8&opt=1&login={login}&password=MD5({password})

Где необходимо
{login} - заменить на Ваш логин в системе
MD5({password}) - заменить на Ваш пароль в системе, зашифрованный в MD5 hash

В данном файле содержатся все позиции номенклатуры, а атрибут id тэга offer - это уникальный код (ID) товара в нашей БД. Используя этот код, Вы сможете сделать запрос к нашему API

Спецификация и примеры реализации в среде разработки PHP

На PHP в первую очередь стоит инициализировать переменную SoapClient

$client = new SoapClient("https://topavenue.ru/cms/soap/service.php?wsdl", array("trace" => 1, "encoding"=>"ISO-8859-1"));

Запрос остатка и цены товара

метод - item

После инициализации  создаем тело запроса к интерфейсу. Сначала Вам необходимо создать массив с запросом авторизации. Логин и пароль и это логин и пароль, которым Вы пользуетесь, при авторизации на сайте.

$auth = array(
   "login" => "Ваш логин от ЛК",
   "password" => "Ваш пароль от ЛК"
);

Спецификация массива авторизации

Далее создаете массив запроса остатка интересующей Вас позиции, куда в параметр auth помещаете запрос авторизации, а в параметр itemId помещаете код интересующего Вас товара

$parItem = array(
   "auth" => $auth,
   "itemid" => 535
);

Спецификация запроса

 Ответом на такой запрос будет следующий массив данных

stdClass Object
(
   [msg] => остаток позиции 535
   [state] => 1
   [stock] => ***
   [price] => 14.85
   [price_qty] => Array
      (
         [0] => stdClass Object
            (
               [qty] => 6
               [price] => 45.18
            )
         [1] => stdClass Object
            (
               [qty] => 12
               [price] => 15.74
            )
      )
)

Спецификация ответа

Спецификация массива price_qty

В зависимости от результат выполнения запроса параметр state может принимать значения 0 - ошибка (см. информационное сообщение) и 1 - успех

Добавление товара в корзину (правка, удаление)

метод - cart

Для работы с корзиной необходимо отправить следующий запрос

$par = array( 
   "auth" => $auth, 
   "items" => $items
);

Где auth - это запрос авторизации, см. выше, а items массив интересующих товаров, которые Вы хотите положить в корзину

$items = array(
   array(
      "id" => 382, 
      "qty" => 2, 
      "cartid" => "100"
   ),
   array(
      "id" => 10, 
      "qty" => 10,
      "cartid" => "100"
   ),
   array(
      "id" => 356,
      "qty" => 1, 
      "cartid" => "100"
   ),
);

спецификация запроса

Спецификация массива items

Ответом на такой запрос будет следующий массив

stdClass Object
( 
   [msg] => корзина пользователя --- обновлена
   [state] => 1
   [sum] => 11445.35
   [cartitems] => Array(
      [0] => stdClass Object
      (
         [itemId] => 10
         [cid] => 100
         [qty] => 10
         [qtyWas] => 10
         [avaiErr] => 0
         [price] => 186.73
      )
      [1] => stdClass Object
      (
         [itemId] => 356
         [cid] => 100
         [qty] => 1
         [qtyWas] => 1
         [avaiErr] => 0
         [price] => 790.85
      )
      [2] => stdClass Object
      (
         [itemId] => 382
         [cid] => 100
         [qty] => 2
         [qtyWas] => 2
         [avaiErr] => 0
         [price] => 4393.6
      )
   )
)

спецификация ответа

Спецификация массива cartItems

Содержимое корзины

метод - getCart

Для просмотра содержимого корзины Вам необходимо передать следующий запрос

$cartids = array( 
   array("id" => "101")
);
$parGetCart = array(
   "auth" => $auth,
   "cartids" => $cartids
);

Спецификация запроса

Спецификация массива cartids

Ответом на этот запрос будет следующий массив данных

stdClass Object
(
   [msg] => содержимое корзины
   [state] => 1
   [sum] => 11445.35
   [cartitems] => Array
   (
      [0] => stdClass Object
      (
         [itemId] => 10
         [cid] => 100
         [qty] => 10
         [qtyWas] => 10
         [avaiErr] => 0
         [price] => 186.73
      )
      [1] => stdClass Object
      (
         [itemId] => 356
         [cid] => 100
         [qty] => 1
         [qtyWas] => 1
         [avaiErr] => 0
         [price] => 790.85
      )
      [2] => stdClass Object
      (
         [itemId] => 382
         [cid] => 100
         [qty] => 2
         [qtyWas] => 2
         [avaiErr] => 0
         [price] => 4393.6
      )
   )
)

Спецификация ответа

Спецефикация массива items

Очистка корзины

метод - clearCart

В этом методе запрос полность аналогичен запросу из метода Содержимое корзины (getCart)

Спецификация ответа

Отправка заказа из корзины

метод - sendCart

Для того, чтобы отправить нам заказ из корзины, Вам необходимо выполнить следующий запрос

$parOrder = array(
   "auth" => $auth,
   "cartid" => "100", 
   "cuscont" => array(
      "name" => "имя", 
	  "phone" => "телефон",
	  "mail" => "почта",
   ),
   "address" => array(
      "index" => "индекс",
	  "city" => "Город",
	  "street" => "Улица",
	  "house" => "номер дома",
	  "korp" => "корпус" 
	  "pod" => "подъезд",
	  "etazh" => "этаж",
	  "domo" => "домофон",
	  "flat" => "квартира\офис",
   ),
   "ordPar" => array(
      "tk" => 0,
	  "punkt" => 0,
	  "delNames" => 0,
	  "delType" => 18,
	  "payType" => 7,
	  "self" => 1,
	  "timeDel" => 1,
	  "delDate" => "31.10.2017",
	  "comm" => "комментарий" 
   ),
);

Спецификация запоса

Спецификация массива cuscont

Спецификация массива address

Спецификация массива ordPar

После того, как Вы собрали массив запроса, можете вызвать метод

try {
   $response = $client->sendCart($parOrder);
   echo "

";
   print_r($response);
   echo "

"; } catch(SoapFault $sf){ print_r($sf); }

Ответом на этот запрос будет следующий массив данных

stdClass Object
(
    [msg] => заказ успешно сформирован
    [state] => 1
    [ordernum] => ***
)

спецификация ответа

Если у Вас возникнут какие-либо вопросы и предложения по работе нашего API, просьба писать на почту info@topavenue.ru