Документация для разработчиков

Файл documents.xml

В файле documents.xml хранится информация о документах.

Элемент XMLЭлемент Владелец XMLОписание
<КоммерческаяИнформация>Нет Главный элемент XML, которому подчинены все остальные. Хранит атрибуты с информацией о пространстве имен, версии схемы («ВерсияСхемы»), даты формирования («ДатаФормирования»), а также служебную информацию.
 
<Контейнер><КоммерческаяИнформация>В каждом контейнере, согласно CommerceML (version=3.1), хранятся все документа конкретного заказа. Например, есть заказ 1, по нему 2 оплаты и одна отгрузка и есть заказ 2, по которому только одна оплата. Тогда в XML у нас получается 2 контейнера: в одном 4 документа (заказ, 2 оплаты и отгрузка), в втором только 2 (оплата и отгрузка).
<Документ><Контейнер>Элемент содержит информацию о документе. Каждый элемент содержит информацию о документе.
<Ид><Документ> Идентификатор документа.
<Номер><Документ> Номер документа сайта.
<Номер1С><Документ> Номер документа учетной системы.
<Дата><Документ> Дата документа с сайта.
<Дата1С><Документ> Дата документа учетной системы.
<ПометкаУдаления><Документ> Признак того, что документ удален.
<ХозОперация><Документ> Признак, определяющий тип документа. Может быть:
  • Заказ товара (заказ)*
  • Счет на оплату
  • Отпуск товара(отгрузка)*
  • Счет-фактура
  • Возврат товара
  • Передача товара на комиссию
  • Возврат комиссионного товара
  • Отчет о продажах комиссионного товара
  • Выплата наличных денег
  • Возврат наличных денег
  • Выплата безналичных денег
  • Возврат безналичных денег
  • Передача прав
  • Прочие
* - только данные операции используются в "1С-Битрикс: Управление сайтом".
<Основание><Документ> Идентификатор документа основания.
<Роль><Документ> Роль. Для документов равно «Продавец».
<Валюта><Документ> Валюта документа.
<Курс><Документ> Курс валюты.
<Сумма><Документ> Сумма документа.
<Контрагенты><Документ> Элемент содержит информацию о покупателях заказа.
<Контрагент><Контрагенты> Элемент содержит информацию о покупателе. Структура элемента такая же, как <Контрагенты> в файле контрагентов contragents.xml.
<Время><Документ> Время создания документа.
<Комментарий><Документ> Комментарий к документу.
<Налоги><Документ> Элемент содержит информацию о налогах, используемых в документе.
<Налог><Налоги> Элемент содержит информацию о налоге, используемом в документе.
<Наименование><Налог> Наименование налога.
<УчтеноВСумме><Налог> Признак того, учтен ли налог в сумме документа.
<Сумма><Налог> Сумма налога.
<Товары><Документ>Элемент содержит информацию о товарах документа.
<Скидки><Скидки>Элемент содержит информацию о скидках.
<Скидка><Скидка>Элемент содержит информацию о скидке.
<Наименование><Скидка>Наименование скидки.
<Сумма><Скидка>Сумма скидки.
<УчтеноВСумме><Скидка>Учтена скидка в сумме или нет.
 
<Товар><Товары> Элемент содержит информацию о заказываемой позиции.
<Ид><Товар> Идентификатор предложения. Если это услуга доставки, тогда идентификатор будет равен «ORDER_DELIVERY», а наименование - «Доставка заказа».
<Наименование><Товар> Наименование товара.
<БазоваяЕдиница><Товар> Наименование базовой единицы товара. У элемента есть атрибуты: «Код», «НаименованиеПолное», «МеждународноеСокращение».
<СтавкиНалогов><Товар> Элемент содержит информацию о налогах товара.
<СтавкаНалога><СтавкиНалогов> Ставка налога.
<Наименование><СтавкаНалога> Наименование налога.
<Ставка><СтавкаНалога> Ставка налога товара.
<ЗначенияРеквизитов><Товар> Элемент содержит дополнительную информацию о товаре.
<ЗначениеРеквизита><ЗначенияРеквизитов> Элемент содержит описание дополнительной информации товара.
<Наименование><ЗначениеРеквизита> Наименование дополнительной информации товара.
<Значение><ЗначениеРеквизита> Значение дополнительной информации товара.
<ЦенаЗаЕдиницу><Товар> Цена за предложение в базовых единицах.
<Количество><Товар> Количество заказываемого предложения.
<Сумма><Товар> Сумма строки предложения.
<Единица><Товар> Наименование единицы измерения.
<Код><Единица> Код единицы измерения.
<НаименованиеПолное><Единица> Полное наименование единицы измерения.
<Коэффициент><Товар> Коэффициент единицы измерения.
<Налоги><Товар> Элемент содержит информацию о налогах, используемыех в заказываемой позиции предложения.
<Налог><Налоги> Элемент содержит информацию о налоге позиции предложения.
<Наименование><Налог> Наименование налога.
<УчтеноВСумме><Налог> Признак того, учтен ли налог в позицию предложения.
<Сумма><Налог> Сумма налога.
<Ставка><Налог> Ставка налога.
<Скидки><Скидки>Элемент содержит информацию о скидках.
<Скидка><Скидка>Элемент содержит информацию о скидке.
<Наименование><Скидка>Наименование скидки.
<Сумма><Скидка>Сумма скидки.
<УчтеноВСумме><Скидка>Учтена скидка в сумме или нет.
 
<ЗначенияРеквизитов><Документ> Элемент содержит дополнительную информацию о документе.
<ЗначениеРеквизита><ЗначенияРеквизитов> Элемент содержит описание дополнительной информации документа.
<Наименование><ЗначениеРеквизита> Наименование дополнительной информации товара. Есть важные предопределенные наименования дополнительной информации заказа:
  • Метод оплаты ИД содержит идентификатор используемой платежной системы.
  • Статуса заказа ИД содержит идентификатор установленного статуса в документе.
  • Сайт содержит наименование сайта.
  • Адрес доставки содержит адрес доставки товара.
  • Доп. реквизит с наименованием Отменен отвечает за то, что был ли документ на сайте отменен.
  • Если документ в учетную систему отгружен, тогда нужно выгружать:
    • «Номер отгрузки по 1С»;
    • «Дата отгрузки по 1С».
    Тогда на сайте установится признак, что документ отгружен.
  • Если документ в учетной системе оплачен, тогда нужно выгружать:
    • «Номер оплаты по 1С»;
    • «Дата оплаты по 1С».
    Тогда на сайте установится признак, что документ оплачен.
<Значение><ЗначениеРеквизита> Значение дополнительной информации документа.

Пример файла

<?xml version="1.0" encoding="UTF-8"?>
<КоммерческаяИнформация xmlns="urn:1C.ru:commerceml_2" xmlns:xs="http://www.w3.org/2001/XMLSchema" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ВерсияСхемы="2.09" ДатаФормирования="2015-06-29T18:27:13" Ид="1">
   <Контейнер>
	<Документ>
		<Ид>142</Ид>
		<НомерВерсии>AAAAEAAAAAA=</НомерВерсии>
		<ПометкаУдаления>false</ПометкаУдаления>
		<Номер>142</Номер>
		<Номер1С>ТДЦУ-000001</Номер1С>
		<Дата>2015-06-29</Дата>
		<Дата1С>2015-06-29</Дата1С>
		<Время>15:39:10</Время>
		<ХозОперация>Заказ товара</ХозОперация>
		<Контрагенты>
			<Контрагент>
				<Ид>4a65ecb6-8b1b-11df-be16-e0cb4ed5f70f</Ид>
				<НомерВерсии>AAAAAQAAAG4=</НомерВерсии>
				<ПометкаУдаления>false</ПометкаУдаления>
				<Наименование>Kikinda (Сербия)</Наименование>
				<ОфициальноеНаименование>Kikinda (Сербия)</ОфициальноеНаименование>
				<Роль>Покупатель</Роль>
				<ИНН/>
				<КПП/>
				<КодПоОКПО/>
				<РасчетныеСчета>
					<РасчетныйСчет>
						<НомерСчета>89000</НомерСчета>
						<Банк>
							<Наименование>ИНГ БАНК (ЕВРАЗИЯ) АО</Наименование>
							<СчетКорреспондентский>30101810500000000222</СчетКорреспондентский>
							<БИК>044525222</БИК>
						</Банк>
						<БанкКорреспондент/>
					</РасчетныйСчет>
					<РасчетныйСчет>
						<НомерСчета>5678999</НомерСчета>
						<Банк>
							<Наименование>"МИЛЛЕНИУМ БАНК" (ЗАО)</Наименование>
							<СчетКорреспондентский>30101810500000000555</СчетКорреспондентский>
							<БИК>044579555</БИК>
						</Банк>
						<БанкКорреспондент/>
					</РасчетныйСчет>
				</РасчетныеСчета>
				<Представители>
					<Представитель>
						<Отношение>Контактное лицо</Отношение>
						<Ид>5018186c-ddb3-11df-aeb7-0015e9b8c48d</Ид>
						<Наименование>Смирнов Олег Иванович</Наименование>
					</Представитель>
				</Представители>
				<Адрес>
					<Представление>Адрес</Представление>
				</Адрес>
			</Контрагент>
		</Контрагенты>
		<Склады>
			<Склад>
				<Ид>6f87e83f-722c-11df-b336-0011955cba6b</Ид>
				<Наименование>Центральный склад</Наименование>
			</Склад>
		</Склады>
		<Валюта>RUB</Валюта>
		<Курс>1.0000</Курс>
		<Сумма>8186.84</Сумма>
		<Роль>Продавец</Роль>
		<Комментарий>[Номер документа на сайте: 142]</Комментарий>
		<Налоги>
			<Налог>
				<Наименование>НДС</Наименование>
				<УчтеноВСумме>false</УчтеноВСумме>
				<Сумма>1248.84</Сумма>
			</Налог>
		</Налоги>
		<ЗначенияРеквизитов>
			<ЗначениеРеквизита>
				<Наименование>Проведен</Наименование>
				<Значение>true</Значение>
			</ЗначениеРеквизита>
			<ЗначениеРеквизита>
				<Наименование>Номер оплаты по 1С</Наименование>
				<Значение>ТДЦУ-000001</Значение>
			</ЗначениеРеквизита>
			<ЗначениеРеквизита>
				<Наименование>Дата оплаты по 1С</Наименование>
				<Значение>2015-06-29T15:39:10</Значение>
			</ЗначениеРеквизита>
			<ЗначениеРеквизита>
				<Наименование>Номер отгрузки по 1С</Наименование>
				<Значение>ТДЦУ-000003</Значение>
			</ЗначениеРеквизита>
			<ЗначениеРеквизита>
				<Наименование>Дата отгрузки по 1С</Наименование>
				<Значение>2015-06-29T17:32:27</Значение>
			</ЗначениеРеквизита>
			<ЗначениеРеквизита>
				<Наименование>Статуса заказа ИД</Наименование>
				<Значение>P</Значение>
			</ЗначениеРеквизита>
		</ЗначенияРеквизитов>
		<Товары>
			<Товар>
				<Ид>cbcf493f-55bc-11d9-848a-00112f43529a</Ид>
				<Наименование>Вентилятор BINATONE ALPINE 160вт, напольный ,</Наименование>
				<СтавкиНалогов>
					<СтавкаНалога>
						<Наименование>НДС</Наименование>
						<Ставка>18</Ставка>
					</СтавкаНалога>
				</СтавкиНалогов>
				<ЗначенияРеквизитов>
					<ЗначениеРеквизита>
						<Наименование>ВидНоменклатуры</Наименование>
						<Значение>Электротовары</Значение>
					</ЗначениеРеквизита>
					<ЗначениеРеквизита>
						<Наименование>ТипНоменклатуры</Наименование>
						<Значение>Товар</Значение>
					</ЗначениеРеквизита>
				</ЗначенияРеквизитов>
				<Единица>
					<Ид>796</Ид>
					<НаименованиеКраткое>шт</НаименованиеКраткое>
					<Код>796</Код>
					<НаименованиеПолное>Штука</НаименованиеПолное>
				</Единица>
				<Коэффициент>1</Коэффициент>
				<Количество>1</Количество>
				<Цена>3338</Цена>
				<Сумма>3338</Сумма>
				<Налоги>
					<Налог>
						<Наименование>НДС</Наименование>
						<УчтеноВСумме>false</УчтеноВСумме>
						<Сумма>600.84</Сумма>
						<Ставка>18</Ставка>
					</Налог>
				</Налоги>
			</Товар>
			<Товар>
				<Ид>bd72d913-55bc-11d9-848a-00112f43529a#b02e2814-720f-11df-b436-0015e92f2802</Ид>
				<Наименование>Ботинки женские демисезонные (35, 5, натуральная кожа, Бежевый)</Наименование>
				<СтавкиНалогов>
					<СтавкаНалога>
						<Наименование>НДС</Наименование>
						<Ставка>18</Ставка>
					</СтавкаНалога>
				</СтавкиНалогов>
				<ЗначенияРеквизитов>
					<ЗначениеРеквизита>
						<Наименование>ВидНоменклатуры</Наименование>
						<Значение>Обувь</Значение>
					</ЗначениеРеквизита>
					<ЗначениеРеквизита>
						<Наименование>ТипНоменклатуры</Наименование>
						<Значение>Товар</Значение>
					</ЗначениеРеквизита>
				</ЗначенияРеквизитов>
				<Единица>
					<Ид>715</Ид>
					<НаименованиеКраткое>пар</НаименованиеКраткое>
					<Код>715</Код>
					<НаименованиеПолное>Пара (2 шт.)</НаименованиеПолное>
				</Единица>
				<Коэффициент>1</Коэффициент>
				<Количество>1</Количество>
				<Цена>3600</Цена>
				<Сумма>3600</Сумма>
				<Налоги>
					<Налог>
						<Наименование>НДС</Наименование>
						<УчтеноВСумме>false</УчтеноВСумме>
						<Сумма>648</Сумма>
						<Ставка>18</Ставка>
					</Налог>
				</Налоги>
			</Товар>
		</Товары>
	</Документ>
	<Документ>
		<Ид>235</Ид>
		<НомерВерсии>AAAAMAAAAAA=</НомерВерсии>
		<ПометкаУдаления>false</ПометкаУдаления>
		<Номер>235</Номер>
		<Номер1С>ТДЦУ-000002</Номер1С>
		<Дата>2015-06-29</Дата>
		<Дата1С>2015-06-29</Дата1С>
		<Время>16:36:25</Время>
		<ХозОперация>Заказ товара</ХозОперация>
		<Контрагенты>
			<Контрагент>
				<Ид>4a65ecb6-8b1b-11df-be16-e0cb4ed5f70f</Ид>
				<НомерВерсии>AAAAAQAAAG4=</НомерВерсии>
				<ПометкаУдаления>false</ПометкаУдаления>
				<Наименование>Kikinda (Сербия)</Наименование>
				<ОфициальноеНаименование>Kikinda (Сербия)</ОфициальноеНаименование>
				<Роль>Покупатель</Роль>
				<ИНН/>
				<КПП/>
				<КодПоОКПО/>
				<РасчетныеСчета>
					<РасчетныйСчет>
						<НомерСчета>89000</НомерСчета>
						<Банк>
							<Наименование>ИНГ БАНК (ЕВРАЗИЯ) АО</Наименование>
							<СчетКорреспондентский>30101810500000000222</СчетКорреспондентский>
							<БИК>044525222</БИК>
						</Банк>
						<БанкКорреспондент/>
					</РасчетныйСчет>
					<РасчетныйСчет>
						<НомерСчета>5678999</НомерСчета>
						<Банк>
							<Наименование>"МИЛЛЕНИУМ БАНК" (ЗАО)</Наименование>
							<СчетКорреспондентский>30101810500000000555</СчетКорреспондентский>
							<БИК>044579555</БИК>
						</Банк>
						<БанкКорреспондент/>
					</РасчетныйСчет>
				</РасчетныеСчета>
				<Представители>
					<Представитель>
						<Отношение>Контактное лицо</Отношение>
						<Ид>5018186c-ddb3-11df-aeb7-0015e9b8c48d</Ид>
						<Наименование>Смирнов Олег Иванович</Наименование>
					</Представитель>
				</Представители>
				<Адрес>
					<Представление>Адрес</Представление>
				</Адрес>
			</Контрагент>
		</Контрагенты>
		<Склады>
			<Склад>
				<Ид>6f87e83f-722c-11df-b336-0011955cba6b</Ид>
				<Наименование>Центральный склад</Наименование>
			</Склад>
		</Склады>
		<Валюта>RUB</Валюта>
		<Курс>1.0000</Курс>
		<Сумма>4100</Сумма>
		<Роль>Продавец</Роль>
		<Комментарий>[Номер документа на сайте: 235] </Комментарий>
		<Налоги>
			<Налог>
				<Наименование>НДС</Наименование>
				<УчтеноВСумме>true</УчтеноВСумме>
				<Сумма>625.42</Сумма>
			</Налог>
		</Налоги>
		<ЗначенияРеквизитов>
			<ЗначениеРеквизита>
				<Наименование>Проведен</Наименование>
				<Значение>true</Значение>
			</ЗначениеРеквизита>
			<ЗначениеРеквизита>
				<Наименование>Номер оплаты по 1С</Наименование>
				<Значение>ТДЦУ-000002</Значение>
			</ЗначениеРеквизита>
			<ЗначениеРеквизита>
				<Наименование>Дата оплаты по 1С</Наименование>
				<Значение>2015-06-29T16:36:25</Значение>
			</ЗначениеРеквизита>
			<ЗначениеРеквизита>
				<Наименование>Статуса заказа ИД</Наименование>
				<Значение>P</Значение>
			</ЗначениеРеквизита>
		</ЗначенияРеквизитов>
		<Товары>
			<Товар>
				<Ид>bd72d913-55bc-11d9-848a-00112f43529a#b02e2814-720f-11df-b436-0015e92f2802</Ид>
				<Наименование>Ботинки женские демисезонные (35, 5, натуральная кожа, Бежевый)</Наименование>
				<СтавкиНалогов>
					<СтавкаНалога>
						<Наименование>НДС</Наименование>
						<Ставка>18</Ставка>
					</СтавкаНалога>
				</СтавкиНалогов>
				<ЗначенияРеквизитов>
					<ЗначениеРеквизита>
						<Наименование>ВидНоменклатуры</Наименование>
						<Значение>Обувь</Значение>
					</ЗначениеРеквизита>
					<ЗначениеРеквизита>
						<Наименование>ТипНоменклатуры</Наименование>
						<Значение>Товар</Значение>
					</ЗначениеРеквизита>
				</ЗначенияРеквизитов>
				<Единица>
					<Ид>715</Ид>
					<НаименованиеКраткое>пар</НаименованиеКраткое>
					<Код>715</Код>
					<НаименованиеПолное>Пара (2 шт.)</НаименованиеПолное>
				</Единица>
				<Коэффициент>1</Коэффициент>
				<Количество>1</Количество>
				<Цена>3600</Цена>
				<Сумма>3600</Сумма>
				<Налоги>
					<Налог>
						<Наименование>НДС</Наименование>
						<УчтеноВСумме>true</УчтеноВСумме>
						<Сумма>549.15</Сумма>
						<Ставка>18</Ставка>
					</Налог>
				</Налоги>
			</Товар>
			<Товар>
				<Ид>ORDER_DELIVERY</Ид>
				<Наименование>Доставка заказа</Наименование>
				<СтавкиНалогов>
					<СтавкаНалога>
						<Наименование>НДС</Наименование>
						<Ставка>18</Ставка>
					</СтавкаНалога>
				</СтавкиНалогов>
				<ЗначенияРеквизитов>
					<ЗначениеРеквизита>
						<Наименование>ВидНоменклатуры</Наименование>
						<Значение>Услуга</Значение>
					</ЗначениеРеквизита>
					<ЗначениеРеквизита>
						<Наименование>ТипНоменклатуры</Наименование>
						<Значение>Услуга</Значение>
					</ЗначениеРеквизита>
				</ЗначенияРеквизитов>
				<Единица>
					<Ид>796</Ид>
					<НаименованиеКраткое>шт</НаименованиеКраткое>
					<Код>796</Код>
					<НаименованиеПолное>Штука</НаименованиеПолное>
				</Единица>
				<Коэффициент>1</Коэффициент>
				<Количество>1</Количество>
				<Цена>500</Цена>
				<Сумма>500</Сумма>
				<Налоги>
					<Налог>
						<Наименование>НДС</Наименование>
						<УчтеноВСумме>true</УчтеноВСумме>
						<Сумма>76.27</Сумма>
						<Ставка>18</Ставка>
					</Налог>
				</Налоги>
			</Товар>
		</Товары>
	</Документ>
   </Контейнер>
</КоммерческаяИнформация>


Пользовательские комментарии

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

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх