Обновите ваш браузер

Похоже, что ваш браузер больше не поддерживается. Обновите ваш браузер, чтобы сделать поиск более чувствительным и безопасным.


Используйте один из этих браузеров:

ItellaItella

Инструкция по автоматическому обмену данными (ENG)

Информация и помощь
Инструкция по автоматическому обмену данными (ENG)
Категория: Инструкции

Открыть список пунктов назначения

Можно получать разные типы пунктов назначения для интеграций.

Field NameDescriptionData type
СтранаКод страны (EE или FI)Цепочка
ТипТип пункта назначения:
APT = посылочный терминал (по умолчанию)
PO = почтовое отделение
Цепочка
ФильтрДополнительная фильтрация:
Экспресс = посылочные терминалы в Эстонии с возможностью экспресс-доставки
Цепочка

ПОЛУЧИТЬ ЗАПРОС

Посылочные терминалы EE

http://iseteenindus.smartpost.ee/api/?request=destinations&country=EE&type=APT

Посылочные терминалы EE с возможностью экспресс-доставки

http://iseteenindus.smartpost.ee/api/?request=destinations&country=EE&type=APT&filter=express

Посылочные терминалы FI

http://iseteenindus.smartpost.ee/api/?request=destinations&country=FI&type=APT

Почтовые отделения FI

http://iseteenindus.smartpost.ee/api/?request=destinations&country=FI&type=PO

ОТВЕТ

Field NameDescriptionData type
ID_местаID посылочного терминала — использовать только для пунктов назначения EE!Номер
ИмяНазвание пункта назначенияЦепочка
ГородГород в пункте назначенияЦепочка
АдресАдрес получателяЦепочка
СтранаКод страны получателяЦепочка
Почтовый индексПочтовый индекс пункта назначенияЦепочка
Код маршрутизацииКод маршрутизации в пункте назначенияЦепочка
ДоступностьПериод, в течение которого место открытоЦепочка
ОписаниеКраткое описание местаЦепочка
Шир.ШиротаНомер
Дол.ДолготаНомер
<destinations>
	<item>
		<place_id>number</place_id>
		<name>string</name>
		<city>string</city>
		<address>string</address>
		<country>string</country>
		<postalcode>string</postalcode>
		<routingcode>string</routingcode>
		<availability>string</availability>
		<description>string</description>
		<lat>number</lat>
		<lng>number</lng>
	</item>
	<item>
 		…
	</item>
</destinations>

Получить список времени посещения курьерами (только посылочные терминалы EE)

ПОЛУЧИТЬ ЗАПРОС

Время посещения курьерами всех посылочных терминалов EE

http://iseteenindus.smartpost.ee/api/?request=courier

Время посещения курьерами посылочных терминалов EE с возможностью экспресс-доставки

http://iseteenindus.smartpost.ee/api/?request=courier&type=express

ОТВЕТ

Field NameDescriptionData type
ID_местаID посылочного терминалаНомер
ДеньНомер дня (1= понедельник)Номер
В Время
Из Время
Экспресс_в Время
Экспресс_из Время
<destinations>
	<item>
		<place_id>Number</place_id>
		<day>Number</day>
		<in>Time</in>
		<out>Time</out>
		<express_in>Time</express_in>
		<express_out>Time</express_out>
	</item>
	<item>
		…
	</item>
</destinations>

Сохранить данные поставки

АУТЕНТИФИКАЦИЯ

Информация об аутентификации бизнес-клиента — все запросы (кроме пунктов назначения) требуют добавления информации об аутентификации в данные POST.

Field NameDescriptionData typeErrors on
ПользовательИмя пользователяЦепочкаНеизвестный пользователь
ПарольПароль пользователяЦепочкаИмя пользователя и пароль не совпадают

ОБЩЕЕ

Информация о поставке. Если графа «Штрихкод» не заполнена, штрихкод будет назначен автоматически. При отправке без услуги кода дверцы размер ячейки не учитывается, поскольку сортировочная станция добавляет соответствующий размер для каждой посылки. Размер ячейки следует добавить только при отправке с услугой кода дверцы.

Field NameDescriptionData typeErrors on
ШтрихкодШтрихкод поставкиЦепочкаДубликат; неправильный формат
СсылкаСсылочный номер клиентаЦепочка 
СодержаниеСодержание поставкиЦепочка 
Старший заказШтрихкод старшего заказа (если поставка содержит несколько посылок)ЦепочкаНеизвестный штрихкод (создайте старший заказ перед созданием младших заказов)
ВесВес поставкиНомерНеизвестный пользователь
РазмерРазмер ячейки (5–8 или 11)
11 — размер XS
5 — размер S
6 — размер M
7 — размер L
8 — размер XL
НомерНеизвестный размер

ОТПРАВИТЕЛЬ

Следующие графы следует заполнить при отправке с использованием услуги кода дверцы.

Field NameDescriptionData typeErrors on
ИмяИмя отправителяЦепочка 
ТелефонТелефонный номер отправителяЦепочка 
Эл. почтаАдрес эл. почты отправителяЦепочкаНеправильный формат
НаличныеСумма, которую должен заплатить отправитель перед отправкой посылкиНомерНеправильный формат
СчетИдентификатор счета бизнес-клиентаНомер 

ПОЛУЧАТЕЛЬ

Информация о получателе.

Field NameDescriptionData typeErrors on
ИмяИмя получателяЦепочка 
ТелефонТелефонный номер получателяЦепочка 
Эл. почтаАдрес эл. почты получателяЦепочкаНеправильный формат
НаличныеСумма, которую должен заплатить получатель перед получением посылкиНомерУслуга недоступна; неправильный формат
ID-кодID-код получателя; нужен если требуется ID-валидация.НомерНеправильный формат

ПУНКТ НАЗНАЧЕНИЯ

Посылки можно отправлять с использованием 3 разных конфигураций:

— при отправке посылки в посылочный терминал EE следует заполнить «ID_места»;
— при отправке посылки в посылочный терминал FI или почтовое отделение FI следует заполнить «Почтовый индекс» и «Код маршрутизации»;
— при отправке посылки с использованием курьерской услуги следует заполнить «Улица», «Дом», «Квартира», «Город», «Страна», «Почтовый индекс», «Подробности» и «Период». Курьерская услуга сейчас доступна только в Эстонии.
— Когда весь адрес введен в графу «Улица», номер дома и/или квартиры выносятся в графы «Дом» и «Квартира», если они не заполнены. Когда графы «Дом» и/или «Квартира» заполнены, их содержание будет добавлено в базу данных вне зависимости от содержания графы «Улица».

Field NameDescriptionData typeErrors on
ID_местаID посылочного терминала в ЭстонииНомерНеизвестный пункт назначения
Почтовый индексПочтовый индекс пункта назначенияЦепочка (15) 
Код маршрутизацииКод маршрутизации в пункте назначенияЦепочка 
УлицаУлица в пункте назначенияЦепочка (50) 
ДомНомер дома в пункте назначенияЦепочка (5) 
КвартираНомер квартиры в пункте назначенияЦепочка (50) 
ГородГород в пункте назначенияЦепочка 
СтранаСтрана в пункте назначенияЦепочка 
ПодробностиДополнительные данные о пункте назначения (например, третий этаж)Цепочка 
ПериодКогда получатель может принять посылку от курьера: 
1 = в любое время;
2 = 09.00–17.00;
3 = 17.00–21.00.
Цифра; по умолчанию 1 

ОГРАНИЧЕННОЕ КОЛИЧЕСТВО (LQ)

В этом разделе описана процедура отправки информации об ограниченном количестве предметов в посылках

Field NameDescriptionData typeErrors on
продуктНазвание продуктаЦепочка 
номер ООНИдентификационный номер по перечню опасных веществ ООНЦелое 
названиеТочное транспортное наименование (ADR)Цепочка 
классКлассификационный номер опасного веществаЦепочка 
вид ярлыкаНомер модели ярлыковЦепочка 
группа упаковкиНомер группы упаковки опасного веществаНумерация: I, II, III 
транспортная категорияТранспортная категория вещества или предметаНумерация: 0, 1, 2, 3, 4 
значениеКоличество опасного вещества в одном продуктеЦелое 
единицаЕдиница измерения количестваг или мл 
вес контейнераВес порожнего контейнера одной единицы (г)Целое 
счетОбщее количество предметовЦелое 

XML-пример одного или нескольких предметов LQ:

…
<lqitems>
	<lqitem>
		<product>String</product>
		<unnumber>Integer</unnumber>
		<name>String</name>
		<class>String</class>
		<labelmodel>String</labelmodel>
		<packinggroup>Enumeration:I,II,III</packinggroup>
		<transportcategory>Enumeration:0,1,2,3,4</transportcategory>
		<amount>
		<value>Integer</value>
		<unit>g or ml</unit>
		</amount>
		<containerweight>Integer</containerweight>
		<count>Integer</count>
	</lqitem>
	<lqitem>
		…
	</lqitem>
	<lqitem>
		…
	</lqitem>
</lqitems>
…

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ

Дополнительные услуги для клиентов Smartpost

Field NameDescriptionData typeErrors on
ЭкспрессУслуга экспресс-доставкиБулеанУслуга недоступна
Проверка IDУстановление личности получателяБулеанУслуга недоступна; не заполнена графа «ID-код» в данных получателя
Проверка возрастаУстановление возраста получателяБулеанУслуга недоступна
Эл. извещениеАдрес эл. почты для отправки (отправителю) извещения о доставкеЦепочкаУслуга недоступна; неправильный формат
Телефонное извещениеТелефонный номер (GSM) для отправки (отправителю) извещения о доставкеЦепочкаУслуга недоступна
Платит получательПолучатель оплатит доставкуБулеанУслуга недоступна

ОТПРАВКА ЗАПРОСА

URL: http://iseteenindus.smartpost.ee/api/?request=shipment

Необязательная графа рапорта может содержать до 5 адресов эл. почты. Если графа заполнена, на указанные адреса эл. почты будет отправлен рапорт. Если указано более 5 адресов эл. почты то система отправит рапорты на 5 адресов и проигнорирует остальные.

<orders>
	<authentication>
		<user>string</user>
		<password>string</password>
	</authentication>
	<report>
		<email>string</email>
		<email>…</email>
	</report>
	<item>
		<barcode>string</barcode>
		<reference>string</reference>
		<content>string</content>
		<orderparent>string</orderparent>
		<weight>number</weight>
		<size>number</size>
		<sender>
			<name>string</name>
			<phone>string</phone>
			<email>string</email>
			<cash>number</cash>
			<account>number</account>
		</sender>
		<recipient>
			<name>string</name>
			<phone>string</phone>
			<email>string</email>
			<cash>number</cash>
			<idcode>number</idcode>
		</recipient>
		<destination>
			<place_id>number</place_id>
			<postalcode>string</postalcode>
			<routingcode>number</routingcode>
			<street>string</street>
			<house>string</house>
			<apartment>string</apartment>
			<city>string</city>
			<country>string</country>
			<details>string</details>
			<timewindow>number</timewindow>
		</destination>
		<lqitems>
			<lqitem>
				<product>String</product>
				<unnumber>Integer</unnumber>
				<name>String</name>
				<class>String</class>
				<labelmodel>String</labelmodel>
				<packinggroup>I,II,III</packinggroup>
				<transportcategory>0,1,2,3,4</transportcategory>
				<amount>
					<value>Integer</value>
					<unit>g or ml</unit>
				</amount>
				<containerweight>Integer</containerweight>
				<count>Integer</count>
			</lqitem>
			<lqitem>
				…
			</lqitem>
		</lqitems>
		<additionalservices>
			<express>boolean</express>
			<idcheck>boolean</idcheck>
			<agecheck>boolean</agecheck>
			<notifyemail>string</notifyemail>
			<notifyphone>string</notifyphone>
			<paidbyrecipient>boolean</paidbyrecipient>
		</additionalservices>
	</item>
	<item>
		…
	</item>
</orders>

ОТВЕТ ПРИ УСПЕХЕ

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

Код статуса ответа: 200

<orders>
	<item>
		<barcode>string</barcode>
		<reference>string</reference>
		<sender>
			<doorcode>number</doorcode>
		</sender>
	</item>
	<item>
		…
	</item>
</orders>

ОТВЕТ ПРИ ОШИБКЕ

Если обязательные графы не будут заполнены (или будут введены неправильные типы данных), появится сообщение об ошибке. Если проблемная поставка является частью более крупной партии, ни одна из поставок в партии не будет обработана. XML-ответ будет содержать информацию об ошибках.

Код статуса ответа: 400

<error>
	<item>
		<barcode>string</barcode>
		<reference>string</reference>
		<error>
			<code>number</code>
			<text>string</text>
			<input>string</input>
		</error>
	</item>
	<item>
		…
	</item>
</error>

Ярлыки

Доступно несколько вариантов (A5, A6, A6 по 4 на страницу, A7, A7 по 8 на страницу).

ОБЩЕЕ

Field NameDescriptionData type
ФорматA5
A6
A6-4
A7
A7-8
Цепочка
ШтрихкодШтрихкоды поставокЦепочка

ОТПРАВКА ЗАПРОСА

URL: http://iseteenindus.smartpost.ee/api/?request=labels

<labels>
	<authentication>
		<user>string</user>
		<password>string</password>
	</authentication>
	<format>String</format>
	<barcode>string</barcode>
	<barcode>…</barcode>
</labels>

Отслеживание и контроль

Поставки можно отслеживать индивидуально или в совокупности. Вы можете использовать штрихкод поставки или ссылочный номер для отправки запросов при отслеживании.

ОТПРАВКА ЗАПРОСА

URL: http://iseteenindus.smartpost.ee/api/?request=tracking

<orders>
	<authentication>
		<user>string</user>
		<password>string</password>
	</authentication>
	<item>
		<barcode>string</barcode>
		<reference>string</reference>
	</item>
	<item>
		…
	</item>
</orders>

ОТВЕТ

<orders>
	<item>
		<barcode>string</barcode>
		<reference>string</reference>
		<generated>timestamp</generated>
		<doorsize>number</doorsize>
		<sourcein>timestamp</sourcein>
		<sourceout>timestamp</sourceout>
		<termin>timestamp</termin>
		<termout>timestamp</termout>
		<destinationin>timestamp</destinationin>
		<destinationout>timestamp</destinationout>
		<returnin>timestamp</returnin>
		<returnout>timestamp</returnout>
		<returntermin>timestamp</returntermin>
		<returntermout>timestamp</returntermout>
	</item>
	<item>
		…
	</item>
</orders>

Коды ошибок

000 = нет информации о пункте назначения
001 = нет требуемого ввода (характерное, указано название графы)
002 = штрихкод уже существует
003 = не телефонный номер
004 = не адрес эл. почты
005 = не число
006 = неизвестный пункт назначения (ID_места)
007 = выбрана экспресс-доставка, но эта услуга недоступна в указанном пункте назначения
008 = несколько пунктов назначения
009 = нет периода для курьерской услуги
010 = нет города для курьерской услуги
011 = нет почтового индекса для курьерской услуги
012 = нет адреса для курьерской услуги
013 = выбран наложенный платеж, но услуга недоступна
014 = неправильный размер дверцы
015 = слишком длинная цепочка (предметы LQ)
016 = целое превышает лимиты (предметы LQ)
017 = значения нет в нумерации (предметы LQ)
018 = не активирована услуга отправки с кодом дверцы