Заказать бесплатный звонок
Удобное время для звонка
Получить предложение
Ф.И.О.:
E-mail*:
Выберите услугу:
Среднее кол-во заказов в месяц:
Номер телефона:
Комментарий:
Служба качества
Как к Вам обращаться?*:
Контактный телефон или E-mail*:
Комментарий:
Курьерская фирма «Профессионал»: удобная,
оперативная и качественная доставка
грузов и документов
Заказать услуги
Заказать звонок
Звоните нам: c 9.30 до 18.30 Пн-Пт:
+7 (812) 454-05-11
Нам важно быть максимально удобными
для наших клиентов
Запрос коммерческого предложения
Звоните нам: c 9.30 до 18.30 Пн-Пт:
+7 (812)454-05-11
Заказать звонок
Калькулятор стоимости
Личный кабинет
Отследить
Прайс-лист
Скачать договор
Пункты выдачи
Служба качества
Главная > Интеграция вашего интернет-магазина с личным кабинетом

Интеграция вашего интернет-магазина с личным кабинетом

Что такое API-интеграция к личному кабинету?

API-интеграция - это web - сервис для автоматизированного добавления заявок на доставку и забор в личный кабинет пользователя.

API-интеграция дает возможность нашим клиентам создавать приложения, напрямую взаимодействующие со своей учетной записью в личном кабинете. 

Это удобно для автоматизации процесса приема заявок на доставку и забор.

 

Как происходит обмен данными?

Обмен данными происходит с сервером, который расположен по адресу http://lk.pro-cour.ru/xml/, в формате XML.

Существующие методы (methodName):

Аутентификация:

Для успешной аутентификации необходимо чтобы был прописано доменное имя сайта или IP-адреса с которых выполянются запросы в разрешенных. Данные можно отправить на e-mail службы тех.поддержки. 

Пример запроса на аутентификацию:

<?xml version="1.0" encoding="utf-8"?>
<methodCall>
       <methodName>auth</methodName>
       <params>
                <uid>UserID</uid>
       </params>
</methodCall>
  •  UserID  - обязательное поле - уникальный идентификатор пользователя. Выдается администратором по запросу

 Пример ответа на аутентификацию:

<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
        <params>
                 <status>Ok or Error</status>
                 <statusMsg>Error Message</statusMsg>
                 <session>session_id</session>
         </params>
</methodResponse>
  • status - результат выполнения запроса на аутентификацию;
  • statusMsg - сообщение об ошибке, поле появляется при ошибке выполнения запроса;
  • session - идентификатор созданной сессии. Время жизни сессии 5 минут. Все методы, кроме аутентификации, требуют живой сессии 

Добавление заявок:

<?xml version="1.0" encoding="utf-8"?>
<methodCall>
        <methodName>request</methodName>
        <session>session_id</session>
        <params>
                  <delivery>
                         <item>
                                 <date>Date</date>
                                 <time1>After Time</time1>
                                 <time2>Before Time</time2>
                                 <company>Company</company>
                                 <sms>Sms</sms>
			         <fio>Fio</fio>
                                 <phone>Phone</phone>
                                 <city>CityID</city>
                                 <address>Address</address>
                                 <number>Number</number>
                                 <comment>Comment</comment>
                                 <summa>Sum</summa>
                                 <weight>Weight</weight>
                                 <point>Point_ID</point>
<post>int</post>
<postindex>Index</postindex>
<postprice>PostPrice</postprice>
<number>Number</number>
<comment>Comment</comment>
<summa>Sum</summa>
<weight>Weight</weight> <places>Places</places>
<partial>Partial</partial>
</item> <item> ...... </item> </delivery> <export> <item> <date>Date</date> <fio>Fio</fio> <phone>Phone</phone> <address>Address</address> <list>List</list> <comment>Comment</comment> </item> <item> ...... </item> </export> </params> </methodCall>

Общие поля для заявок на доставку и забор:

  • Date - обязательное поле - дата заявки в формате ДД.ММ.ГГГГ
  • Fio - обязательное поле - ФИО получателя/отправителя
  • Phone - обязательное поле - Номер телефона отправителя/получателя
  • Sms - включение sms оповещения. 1- включено, 0 - выключено (по умолчанию)
  • Address  - обязательное поле - Адрес получателя/отправителя
  • Comment - комментарий к заявке

Поля для заявок на доставку:

  • After Time - начальное значение временного интервала доставки
  • Before Time - конечное значение временного интервала доставки
  • Временной интервал должен быть в диапазоне от 11 до 21 и не может быть менее 3х часов.
  • Company - название компании получателя
  • CityID - уникальный номер города доставки. Получить можно через API с помощью метода запрос списка городов. Заполняется также при получении списка точек самовывозов
  • Number - Ваш номер заявки
  • Sum - сумма наложенного платежа
  • Weight - Вес в килограммах
  • Partial - Частичный выкуп/товар на выбор ( 1, "true", "да" - услуга выбрана)
  • Point_ID - идентификатор точки самовывоза
  • post - при добавлении доставки через "Почту" значение должно быть "1"
  • postindex - почтовый индекс, при отправке через "Почту" обязательный параметр
  • postprice - объявленная ценность, заполняется если "Наложенный платеж" равен 0р.

Поля для заявки на забор:

  • List - список товаров к забору

Ответ на добавление заявок:

<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
        <params>
                 <status>Ok or Error</status>
                 <statusMsg>Error Message</statusMsg>
                 <delivery>
                           <item>ID or Errors</item>
                           <item>...</item>
                 </delivery>
                 <export>
                           <item>...</item>
                           <item>...</item>
                 </export>
         </params>
</methodResponse>
  • status - результат выполнения запроса на аутентификацию;
  • statusMsg - сообщение об ошибке, поле появляется при ошибке выполнения запроса;
  • delivery - список заявок на доставку с результатом выполнения.
  • export - список заявок на забор с результатом выполнения.

В случае успешного добавления заявки в элементе item будет содержаться цифровой номер заявки в нашей системе, иначе сокращенное описание ошибки добавления заявки

Получение статуса:

Запрос статуса:

<?xml version="1.0" encoding="utf-8"?>
<methodCall>
         <methodName>status</methodName>
         <session>session_id</session>
         <params>
                  <delivery>
                                <item>ID</item>
                                <item>ID</item>
                   </delivery>
                   <export>
                                <item>ID</item>
                                <item>ID</item>
                  </export>
        </params>
</methodCall>

ID - уникальные номера заявок в нашей системе, возвращаемые в добавлении заявок.

 

Ответ на запрос статуса:

<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
         <params>
                 <status>Ok or Error</status>
                 <statusMsg>Error Message</statusMsg>
                 <delivery>
                        <item>
                                <id>ID</id>
                                <status>Message</status>
                                <date>Date</date>
                                <get_money>Get_Money</get_money>
                                <comment>Comment</comment>
                        </item>
                        <item>
                                ......
                        </item>
                 </delivery>
                 <export>
                        <item>
                                <id>ID</id>
                                <status>Message</status>
                                <date>Date</date>
                                <get_money>Get_Money</get_money>
                                <comment>Comment</comment>
                        </item>
                        <item>
                                ......
                        </item>
                 </export>
        </params>
</methodResponse>
  • id - уникальный номер заявки
  • status - статус выполнения заявки
  • date - дата выполнения
  • get_money - денежная сумма, взятая с получателя
  • comment - комментарий к выполненой заявке.
  • post - трекномер для отслеживания с помощью сервиса "Почты России".

Получение списка регионов:

Запрос списка регионов:

<?xml version="1.0" encoding="utf-8"?>
<methodCall>
       <methodName>regions</methodName>
       <session>session_id</session>
</methodCall>

 

Ответ на запрос регионов:

<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
         <params>
                 <status>Ok</status>
                 <regions>
                         <item>
                                 <id>RegionID</id>
                                 <name>RegionName</name>
                         </item>
                         <item>
                                 ......
                         </item>
                 </regions>
         </params>
</methodResponse>
  • RegionId - уникальный номер региона. Необходим для запроса городов в данном регионе
  • RegionName - название региона

Получение списка городов в регионе:

Запрос списка городов для региона:

<?xml version="1.0" encoding="utf-8"?>
<methodCall>
        <methodName>cities</methodName>
        <session>session_id</session>
        <params>
                <region>RegionID</region>
        </params>
</methodCall>
  •  RegionId - уникальный номер региона. 

Ответ на запрос городов:

<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
        <params>
                <status>Ok</status>
                <cities>
                        <item>
                                <id>CityId</id>
                                <name>CityName</name>
                        </item> 
                        <item>
                                ......
                        </item>
                </cities>
        </params>
</methodResponse>
  • CityId - уникальный номер города. Необходим для добавления заявок на доставку.
  • CityName - название города

 

Получение списка точек самовывоза

  Запрос списка точек самовывоза:

<?xml version="1.0" encoding="utf-8"?>
<methodCall>
       <methodName>points</methodName>
       <session>session_id</session>
</methodCall>

Ответ на запрос списка точек самовывоза:

<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
       <params>
             <status>Ok</status>
             <points>
                  <item>
                          <id>PointID</id>
                          <city>CityID</city>
                          <name>PointName</name>
                          <address>PointAddress</address>
                          <work>PointWork</work>
                          <time>PointTime</time>
                          <phone>PointPhone</phone>
                 </item>
                 <item>
                          ...
                 </item>
             </points>
       </params>
</methodResponse>
  • PointID - уникальный идентификатор точки самовывоза
  • CityID - уникальный идентификатор города, в котором расположена точка самовывоза
  • PointName - название точки самовывоза
  • PointAddress - адрес точки самовывоза
  • PointWork - время работы точки самовывоза
  • PointTime - срок доставки в данную точку самовывоза
  • PointPhone - контактный телефон точки самовывоза
  • price - стоимость доставки текстовой строкой
  • max_weight - максимальный вес, принимаемый данным ПВЗ
  • price2kg - стоимость доставки до 2 кг
  • price5kg - стоимость доставки до 5 кг 
  • price10kg - стоимость доставки до 10 кг
  • price15kg  - стоимость доставки до 15 кг
  • price30kg  - стоимость доставки до 30 кг
  • partials -  частичный выкуп (Да-1/Нет-0)

 

По вопросам звоните по тел.: 454-05-11 вашему менеджеру.

E-mail: тех.поддержки: widow.maker@mail.ru