Интеграция через API

Материал из DELIVERYCRM WIKI
Перейти к навигации Перейти к поиску

Описание метода добавления треков

URL: http://apilr2.r-lab.biz/addtrack.ashx Формат передачи данных: JSON Метод: POST Внимание! Если сервис не доступен, попробуйте повторить попытку запроса через 5 минут. Если проблема сохраняется, попробуйте резервный адрес http://api-r-lab-b.1gb.ru В случае если сервис не доступен более 20 минут, обратитесь в нашу техническую поддержку.

Пример контейнера с данными запроса:

  {
  "trackingUserId":1,
  "trackingRequestKey":"8e093b01b18e3272a7d615704cc1502a",
  "testMode":false,
  "trackingData":[{
        "trackingUserClientPhone":"79160000000",
        "trackingUserClientTrack":"19527937484546",
        "trackingUserClientEmail":"support@r-lab.biz",
        "trackingUserClientName":"Дмитрий",
        "trackingUserClientItemCost":123.45,
        "sendToUserEmailFullTracking":false,
        "sendToAdminEmailFullTracking":false,
        "trackingUserClientOrderNumber":"4321",
        "trackingUserClientDescription":""
     },
     {"trackingUserClientPhone":"79150000000",
        "trackingUserClientTrack":"63010828068631",
        "trackingUserClientEmail":"support@r-lab.biz",
        "trackingUserClientName":"Василий",
        "trackingUserClientItemCost":623.12,
        "sendToUserEmailFullTracking":false,
        "sendToAdminEmailFullTracking":false,
        "trackingUserClientOrderNumber":"4331",
        "trackingUserClientDescription":""
        "trackingUserClientDeliveryServiceId":0
     }]
   }
Описание свойств контейнера запроса:
Свойство Тип Описание Значение может быть пустым
trackingUserId integer id пользователя нет
trackingRequestKey string md5 hash запроса ( id пользователя :все номера треков без разделитей:ключ пользователя). Пример: 1:1952793748454663010828068631:3c6e0b8a9c15224a8228b9a98ca1531d нет
testMode boolean В тестовом режиме (true) трекинг номера не добавляются в базу, происходит только проверка запроса нет
trackingData JSON array Содержит массив с трекинг номерами и данными клиента нет
trackingUserClientPhone string Номер мобильного телефона клиента в федеральном формате. Пример: 79160000000. Если SMS отправлять не нужно, указывайте номер 79000000000 нет
trackingUserClientTrack string Трекинг номер почтового отправления нет
trackingUserClientEmail string E-Mail клиента (если значение пустое, оповещения на e-mail отправляться не будут) да
trackingUserClientName string Имя или ФИО клиента да
trackingUserClientItemCost decimal Стоимость товаров да (может быть нулем)
sendToAdminEmailFullTracking boolean Если значение свойства true, то при каждом изменении статуса почтового отправления на e-mail администратора магазина (указанный при регистрации в http://www.отследить-посылку.рф) будет отправлять письмо с информацией о статусе. нет
sendToUserEmailFullTracking boolean Если значение свойства true, то при каждом изменении статуса почтового отправления на e-mail клиента магазина будет отправляться так же письмо с информацией о статусе. нет
trackingUserClientOrderNumber string Номер заказа (максимальная длина 40 символов) нет
trackingUserClientDescription string Любые другие данные, например название товара или название магазина (если через один аккаунт отправляются оповещения от разных магазинов). Максимальная длина 200 символов. нет
trackingUserClientDeliveryServiceId Integer ID службы доставки. Данный параметр определяет, к какой службе доставки отнести трек. нет
Список значений trackingUserClientDeliveryServiceId (жирным выделены службы, поддерживаемые в настоящее время)
Почта России 0
TopDelivery 1
СПСР 2
Boxberry 3
PickPoint 4
Shop-Logistics 5
Деловые линии 6
СДЭК 7
DPD 8
Экспресс.Ру 9
ПЭК 10
КСЭ 11
Dimex 12
УкрПочта 13
Почта Казахстана 15
Нова Пошта 16

Примеры ответов от сервера:

{"resultState":0,"resultInfo":"Данные успешно добавлены в базу","resultData":null}
{"resultState":1," resultInfo ":"Часть данных добавлены в базу, ошибок 2","resultData":null}
{"resultState":2," resultInfo ":"Некорректный ключ запроса в trackingRequestKey","resultData":null}

Свойство Тип Описание
resultState interger Код результата операции.

0 - данные успешно добавлены. 1 - данные частично добавлены (причина описана в resultInfo). 2 - ошибка, данные не добавлены (причина описана в resultInfo).

resultInfo string В этом свойстве возвращается описание ошибки или общая информация
resultData JSON array Может содержать массив с данными (например, информацию по запрошенным трекам)

Описание метода удаления треков

Метод: удаление треков из системы, максимум 100 треков в одном запроса. Используется в случае, если по треку приходят некорректные смс. Удаленные треки считаются оплаченными.

URL: http://apilr2.r-lab.biz/deltrack.ashx
Формат передачи данных: JSON
Метод: POST
Пример контейнера с данными запроса:

  {
"trackingUserId":1,
"trackingRequestKey":"8e093b01b18e3272a7d615704cc1502a",
"testMode":false,
"trackingData":[{
"trackingUserClientPhone":"",
"trackingUserClientTrack":"19527937484546",
"trackingUserClientEmail":"",
"trackingUserClientName":"",
"trackingUserClientItemCost":0,
"sendToUserEmailFullTracking":false,
"sendToAdminEmailFullTracking":false
},
{"trackingUserClientPhone":"",
"trackingUserClientTrack":"63010828068631",
"trackingUserClientEmail":"",
"trackingUserClientName":"",
"trackingUserClientItemCost":0,
"sendToUserEmailFullTracking":false,
"sendToAdminEmailFullTracking":false
""trackingUserClientDeliveryServiceId":0
}]
}

В данном методе, в контейнере должно быть заполнено только одно свойство trackingUserClientTrack, остальные поля можно оставить пустыми.

Описание свойств контейнера запроса:
Свойство Тип Описание Значение может быть пустым
trackingUserId integer id пользователя нет
trackingRequestKey string md5 hash запроса ( id пользователя :все номера треков без разделитей:ключ пользователя). Пример: 1:1952793748454663010828068631:3c6e0b8a9c15224a8228b9a98ca1531d нет
testMode boolean В тестовом режиме (true) трекинг номера не добавляются в базу, происходит только проверка запроса нет
trackingData JSON array Содержит массив с трекинг номерами и данными клиента нет
trackingUserClientPhone string Номер мобильного телефона клиента в федеральном формате. Пример: 79160000000. Если SMS отправлять не нужно, указывайте номер 79000000000 В данном методе да
trackingUserClientTrack string Трекинг номер почтового отправления нет
trackingUserClientEmail string E-Mail клиента (если значение пустое, оповещения на e-mail отправляться не будут) да
trackingUserClientName string Имя или ФИО клиента да
trackingUserClientItemCost decimal Стоимость товаров да (может быть нулем)
sendToAdminEmailFullTracking boolean Если значение свойства true, то при каждом изменении статуса почтового отправления на e-mail администратора магазина (указанный при регистрации в http://www.отследить-посылку.рф) будет отправлять письмо с информацией о статусе. нет
sendToUserEmailFullTracking boolean Если значение свойства true, то при каждом изменении статуса почтового отправления на e-mail клиента магазина будет отправляться так же письмо с информацией о статусе. нет
trackingUserClientDeliveryServiceId Integer ID службы доставки. Данный параметр определяет, к какой службе доставки отнести трек. нет

Примеры ответов от сервера:
{"resultState":0,"resultInfo":"Треки успешно удалены из базы","resultData":null}
{"resultState":1," resultInfo ":"Часть треков удалены, ошибок 1","resultData":null}
{"resultState":2," resultInfo ":"Некорректный ключ запроса в trackingRequestKey","resultData":null}

Свойство Тип Описание
resultState interger Код результата операции.

0 –треки удалены из системы 1 – запрос выполнен частично, см. resultInfo. 2 – ошибка в запросе (причина описана в resultInfo).

resultInfo string В этом свойстве возвращается описание ошибки или общая информация
resultData JSON array Массив с данными (информациz по запрошенным трекам)

Описание метода Запроса информации по трекам

Метод: получение информации по трекинг-кодам (которые загружены в системе), максимум 100 треков в одном запроса. ver. 04.12.2014
URL: http://apilr2.r-lab.biz/gettrackinfo.ashx
Формат передачи данных: JSON
Метод: POST
Пример контейнера с данными запроса:

   {
   "trackingUserId":1,
   "trackingRequestKey":"8e093b01b18e3272a7d615704cc1502a",
   "testMode":false,
   "trackingData":[{
   "trackingUserClientPhone":"",
   "trackingUserClientTrack":"19527937484546",
   "trackingUserClientEmail":"",
   "trackingUserClientName":"",
   "trackingUserClientItemCost":0,
   "sendToUserEmailFullTracking":false,
   "sendToAdminEmailFullTracking":false
   },
   {"trackingUserClientPhone":"",
   "trackingUserClientTrack":"63010828068631",
   "trackingUserClientEmail":"",
   "trackingUserClientName":"",
   "trackingUserClientItemCost":0,
   "sendToUserEmailFullTracking":false,
   "sendToAdminEmailFullTracking":false
   }]
   }

В данном методе, в контейнере должно быть заполнено только одно свойство trackingUserClientTrack, остальные поля можно оставить пустыми.

Описание свойств контейнера запроса:
Свойство Тип Описание Значение может быть пустым
trackingUserId integer id пользователя нет
trackingRequestKey string md5 hash запроса ( id пользователя :все номера треков без разделитей:ключ пользователя). Пример: 1:1952793748454663010828068631:3c6e0b8a9c15224a8228b9a98ca1531d нет
testMode boolean В тестовом режиме (true) трекинг номера не добавляются в базу, происходит только проверка запроса нет
trackingData JSON array Содержит массив с трекинг номерами и данными клиента нет
trackingUserClientPhone string Номер мобильного телефона клиента в федеральном формате. Пример: 79160000000. Если SMS отправлять не нужно, указывайте номер 79000000000 В данном методе да
trackingUserClientTrack string Трекинг номер почтового отправления нет
trackingUserClientEmail string E-Mail клиента (если значение пустое, оповещения на e-mail отправляться не будут) да
trackingUserClientName string Имя или ФИО клиента да
trackingUserClientItemCost decimal Стоимость товаров да (может быть нулем)
sendToAdminEmailFullTracking boolean Если значение свойства true, то при каждом изменении статуса почтового отправления на e-mail администратора магазина (указанный при регистрации в http://www.отследить-посылку.рф) будет отправлять письмо с информацией о статусе. нет
sendToUserEmailFullTracking boolean Если значение свойства true, то при каждом изменении статуса почтового отправления на e-mail клиента магазина будет отправляться так же письмо с информацией о статусе. нет
trackingUserClientDeliveryServiceId Integer ID службы доставки. Данный параметр определяет, к какой службе доставки отнести трек. нет