Пересылка данных в сервисы логистики

Сервис EcommTools открыт для интеграции и поддерживает обмен данными
с другими сервисами для удобства работы своих клиентов!

На данный момент, произведена интеграция со следующими сервисами логистики и аутсорсинга:

QuickPost.ru
RussianPostService.com


Благодаря этой интеграции информация о заказе физического товара автоматически пересылается
в выбранный продавцом сервис и обрабатывается без вмешательства продавца.

Формат передаваемых данных

Метод передачи: POST запрос на ваш обработчик
Формат данных: JSON
Кодировка данных: UTF8

service_idЛогин пользователя в сервисе логистики (куда пересылаются данные)
ecommtools_idЛогин пользователя в сервисе EcommTools
routineМодуль EcommTools, который пересылает данные. Используется для расследования возможных ошибок
orderidУникальный номер заказа
orderstatusСтатус заказа. 1 - предварительный, 2 - оплаченный
timestampСистемная метка времени с начала эпохи
dateДата пересылки данных в формате ДД.ММ.ГГГГ
timeВремя пересылки данных в формате ЧЧ:ММ
emailEmail покупателя
amountСумма заказа
currencyВалюта
ipIP покупателя
paybyМетод оплаты
payby_codeСистемный код метода оплаты.
Открыть список поддерживаемых платежных систем.
nameФИО покупателя
totalweightВес заказа в кг.
shippingcostСтоимость доставки в указанной валюте
courierВыбранный почтовый курьер
countryСтрана
country_codeКод страны в соответствии с ISO 3166
addressАдрес доставки
areaОбласть доставки
cityГород
zipИндекс
streetУлица
buildingДом
aptКвартира
phoneТелефон клиента
item_idsУникальные идентификаторы заказанных товаров через разделитель ";"
item_qtyОбщее количество товаров в заказе
items Массив заказанных товаров в формате:
{
"id":"идентификатор товара",
"title":"название товара",
"cost":"стоимость товара",
"qty":"заказанное количество"
}


sign MD5 подпись запроса. Формат:
$orderid.$email.$amount.$service_id.$service_key


Переменные склеиваются без каких-либо дополнительных символов.
$service_key произвольный ключ, устанавливается самим клиентом в аккаунте EcommTools и в аккаунте сервиса логистики.


Пример пересылаемых данных

{
"service_id":"user123",
"ecommtools_id":"tester",
"routine":"logistics.cgi",
"sign":"90109a978c0907445424136bb9452d31",
"orderstatus":"1",
"orderid":"1102155121399",
"timestamp":"1360598094",
"email":"info@mail.com",
"amount":"33681",
"currency":"RUR",
"payby":"RBKmoney",
"payby_code":"rbkmoney",
"date":"11.02.2013",
"time":"17:54",
"ip":"127.0.0.1",
"name":"иванов иван иванович",
"courier":"Почта России",
"country":"Россия",
"country_code":"RU",
"area":"Московская обл.",
"zip":"100000",
"address":"Ул. Ленина, д. 1, кв. 10.",
"street":"Ленина",
"building":"1",
"apt":"10",
"phone":"+7900123456",
"totalweight":"0.76",
"shippingcost":"0.00",
"item_ids":"dvd;cd;",
"item_qty":"3",
"items":[
	{
	"id":"dvd",
	"title":"Видеокурс",
	"cost":"27901",
	"qty":"2"},
	
	{
	"id":"cd",
	"title":"Аудиозапись курса",
	"cost":"2890",
	"qty":"1"
	}
	]
}


Для тестирования интеграции всего лишь откройте аккаунт в EcommTools,
создайте тестовые заказы и проверьте доставку данных на ваш обработчик.

Возможны ситуации, когда производится повторная пересылка данных по одному заказу.
Это происходит если продавец активировал режим пересылки неподтвержденных заказов.
Информация по таким заказам пересылается сразу после оформления и повторно после подтверждения клиентом.

Настоятельно рекомендуется следить за временными метками (timestamp) в получаемых данных
и приступать к формированию заказу спустя несколько часов, т.к. возможно,
что клиент переоформит заказ и выберет другие товары.

После получения данных и проверки MD5 подписи в переменной "sign", ваш скрипт должен передать ответ сервера HTTP 200 OK,
иначе EcommTools.com будет постоянно передавать на вход вашей программы информацию о заказе.



По вопросам подключения новых сервисов или добавления новых данных к пересылке просьба писать на адрес
info@ecommtools.com



Вернуться к оглавлению руководства пользователя EcommTools