Импорт покупателей на сайт - XML файл

На данной странице описана структура содержимого XML файла, использующегося для импорта покупателей на сайт на платформе komiz.io из системы бухгалтерского учета, например «1C».

Ниже приведен сокращенный пример файла имеющего описываемый формат (полный пример приведен далее).

	<?xml version="1.0" encoding="utf-8"?>
	<users amount="2">                          <!-- Содержит теги покупателей -->
		<user asId="12345678">                  <!-- Содержит информацию об одном покупателе -->
			<login>user1</login>                <!-- Одно из полей покупателя -->
			...
		</user>
		<user asId="87654321">
			...
		</user>
	</users>

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

Данные в файле содержатся в кодировке UTF-8.

Ниже перечислены основные особенности структуры файла.

• Коренным тегом XML документа является users. Он является контейнером списка покупателей, каждому из которых соответствует дочерний тег user.
• Тег user в дочерних тегах и атрибутах содержит информацию о самом покупателе.

ОБРАТИТЕ ВНИМАНИЕ!

• Все атрибуты тегов должны обязательно присутствовать.
• Большинство тегов могут отсутствовать. Исключением коренной тег users. Если необязательного тега не передается, то соответствующее ему данное либо не изменяется (при существовании покупателя в базе данных сайта), либо заполняется «пустым значением» (в случае отсутствия покупателя в базе данных сайта).
• Нужно учесть, что количество повторяемых тегов варьируется относительно количества отображаемых ими «сущностей». Например, количество тегов user равно количеству покупателей в данном файле (т.е. может быть равным нулю).

Ниже приведен перечень всех XML тегов, используемых в описываемом файле, с указанием инструкций по их использованию. Теги перечислены в алфавитном порядке.

<?xml version="1.0" encoding="utf-8"?>
<users amount="1">
	<user asId="test3">
		<deleteKey>0</deleteKey>
		<email>a1234567@site.com</email>
		<passwordHash>ef797c8118f02dfb649607dd5d3f8c7623048c9c063d532cc95c5ed7a898a64f</passwordHash>
		<telephone>0987654321</telephone>
		<login>some_user</login>
		<firstName>Иван</firstName>
		<middleName>Васильевич</middleName>
		<lastName>Бунша</lastName>
		<description>Создан пользователем ПУ</description>
		<additionalField name="Описание">Данный пользователь используется для тестирования работы магазина нашими операторами</additionalField>
		<activeKey>1</activeKey>
	</user>
</users>