- Создал(а) Дмитрий Мазуров, редактировал(а) Михаил Кузьмин сент. 06, 2018
Вы просматриваете старую версию данной страницы. Смотрите текущую версию.
Сравнить с текущим просмотр истории страницы
« Предыдущий Версия 49 Следующий »
Формат выгрузки данных в пакете XML на примере взаимодействия с редакцией УТ 10.3.
Структура исходящего XML-пакета из 1С базы
В самом начале выставляются обязательные параметры для XML-пакетов, такие как версия и кодировка передаваемых данных:
<?xml version="1.0" encoding="UTF-8"?>
Затем выгружается объект AgoraMessage содержащий в себе набор определённых таблиц, некоторые из которых так же содержат в себе таблицы.
Тег включает в себя описание используемых схем переменных:
<AgoraMessage xmlns="http://www.agora.centrobit.ru" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="AgoraMessage">
Все выгружаемые из 1С значения тегов имеют тип String (Строка), подставляемые числа не имеют пробелов и запятых, запятые заменяются на точки.
Содержание страницы:
Таблица "Заказ Покупателя"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид заказа |
| Проведен | булево | 0 или 1 |
| ПометкаУдаления | булево | 0 или 1 |
| Номер | Строка | номер заказа в 1С |
| Дата | Дата создания | гггг-ММ-ддTчч:мм:сс |
| ВалютаДокумента | гуид 1С | гуид Валюты |
| Контрагент | гуид 1С | гуид Контрагента |
| ИННКонтрагента | Строка | При выгрузке из 1С заполнение поля не требуется |
| НаименованиеКонтрагента | Строка | При выгрузке из 1С заполнение поля не требуется |
| ДоговорКонтрагента | гуид 1С | гуид Договора Контрагента |
| СкладГруппа | гуид 1С | гуид склада указанного в заказе |
| СуммаДокумента | число | сумма заказа |
| АдресДоставки | Строка | Текст адреса доставки из заказа |
| Комментарий | Строка | Текст комментария из заказа |
| Товары | Таблица | Отбельная табличная часть (описана ниже) |
| Оплата | число | Сумма оплаты поступившая по заказу |
| Отгрузка | Строка | Отгружен / Не отгружен |
| Закрыт | Булево | 0 или 1 |
Пример:
<ЗаказПокупателя>
<ВремяИзменения>2014-07-01T11:43:16</ВремяИзменения>
<Ссылка>945825ce-c141-4de4-8abc-5a71eeedcb0f</Ссылка>
<Проведен>1</Проведен>
<ПометкаУдаления>0</ПометкаУдаления>
<Номер>ТД000000354</Номер>
<Дата>2014-07-01T11:43:06</Дата>
<ВалютаДокумента>bd72d8f9-55bc-11d9-848a-00112f43529a</ВалютаДокумента>
<Контрагент>f3d3eb53-7d90-4b8c-9267-5689128f79a0</Контрагент>
<ИННКонтрагента/>
<НаименованиеКонтрагента/>
<ДоговорКонтрагента>f3e070c5-fdf4-11e3-80bf-002268891092</ДоговорКонтрагента>
<СкладГруппа>bd72d91f-55bc-11d9-848a-00112f43529a</СкладГруппа>
<СуммаДокумента>60231</СуммаДокумента>
<АдресДоставки>Пробный от Центробит</АдресДоставки>
<Комментарий>Пробный от Центробит, Способ доставки: Экспресс доставка</Комментарий>
<Товары>
<Строка>
<Номенклатура>9f09a9c9-701b-11e2-beac-00155d002500</Номенклатура>
<ХарактеристикаНоменклатуры/>
<Количество>1</Количество>
<ЕдиницаИзмерения>9f09a9ca-701b-11e2-beac-00155d002500</ЕдиницаИзмерения>
<Сумма>60231</Сумма>
<СтавкаНДС>18</СтавкаНДС>
<СуммаНДС>9187.78</СуммаНДС>
<Цена>60231</Цена>
<Размещение>bd72d91f-55bc-11d9-848a-00112f43529a</Размещение>
<ПроцентСкидки>0</ПроцентСкидки>
</Строка>
</Товары>
<Оплата>0</Оплата>
<Отгрузка>Не отгружен</Отгрузка>
<Закрыт>0</Закрыт>
</ЗаказПокупателя>
Таблица "Товары"
Таблица "Товары" входит в состав Заказа Покупателя и состоит из таблиц строк товаров, из их множества, таблица Строки Товара выглядит следующим образом:
| Внутренний тег | Формат | Значение |
|---|---|---|
| Номенклатура | гуид 1С | гуид номенклатуры |
| ХарактеристикаНоменклатуры | гуид 1С | гуид характеристики номенклатуры |
| Количество | число | количество товара в заказе |
| ЕдиницаИзмерения | гуид 1С | гуид единицы измерения |
| Сумма | число | сумма по позиции |
| СтавкаНДС | число | ставка НДС (символ % -не ставится) |
| СуммаНДС | число | сумма НДС по позиции |
| Цена | число | цена позиции |
| Размещение | гуид 1С | гуид склада |
| ПроцентСкидки | число | Сумма всех скидок по позиции (символ % -не ставится) |
Пример:
<Товары>
<Строка>
<Номенклатура>9f09a9c9-701b-11e2-beac-00155d002500</Номенклатура>
<ХарактеристикаНоменклатуры/>
<Количество>1</Количество>
<ЕдиницаИзмерения>9f09a9ca-701b-11e2-beac-00155d002500</ЕдиницаИзмерения>
<Сумма>60231</Сумма>
<СтавкаНДС>18</СтавкаНДС>
<СуммаНДС>9187.78</СуммаНДС>
<Цена>60231</Цена>
<Размещение>bd72d91f-55bc-11d9-848a-00112f43529a</Размещение>
<ПроцентСкидки>0</ПроцентСкидки>
</Строка>
<Строка>
<Номенклатура>9f09a9c9-701b-11e2-beac-00155d002544</Номенклатура>
<ХарактеристикаНоменклатуры/>
<Количество>4</Количество>
<ЕдиницаИзмерения>9f09a9ca-701b-11e4-beac-00155d002500</ЕдиницаИзмерения>
<Сумма>10000</Сумма>
<СтавкаНДС>18</СтавкаНДС>
<СуммаНДС>7200</СуммаНДС>
<Цена>40000</Цена>
<Размещение>bd72d91f-55bc-11d9-848a-00112f43529a</Размещение>
<ПроцентСкидки>0</ПроцентСкидки>
</Строка>
</Товары>
Таблица "Валюты"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид валюты |
| ПометкаУдаления | булево | 0 или 1 |
| Код | Строка | 3 цифры - код |
| Наименование | Строка | пример: USD |
| НаименованиеПолное | Строка | Полное название валюты |
Пример:
<Валюты>
<ВремяИзменения>2015-02-13T13:39:57</ВремяИзменения>
<Ссылка>7cf7375c-8fc8-11e3-bbc4-bcaec51b91f9</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Код>840</Код>
<Наименование>USD</Наименование>
<НаименованиеПолное>Доллар США</НаименованиеПолное>
</Валюты>
Таблица "Курсы Валют"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Период | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Валюта | гуид 1С | гуид валюты |
| Курс | число | курс |
| Кратность | число | кратность |
Пример:
<КурсыВалют>
<ВремяИзменения>2015-02-13T13:39:57</ВремяИзменения>
<Период>2014-02-07T00:00:00</Период>
<Валюта>7cf7375c-8fc8-11e3-bbc4-bcaec51b91f9</Валюта>
<Курс>34.7287</Курс>
<Кратность>1</Кратность>
</КурсыВалют>
Таблица "Контрагенты"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид Контрагента |
| Наименование | Строка | Наименование контрагента |
| ИНН | Строка | ИНН контрагента |
| КПП | Строка | Не используется, обычно тег пуст |
| ОсновнойМенеджер | гуид 1С | гуид менеджера (пользователя) в 1С |
Пример:
<Контрагенты>
<ВремяИзменения>2014-06-27T16:17:26</ВремяИзменения>
<Ссылка>f3d3eb53-7d90-4b8c-9267-5689128f79a0</Ссылка>
<Наименование>ООО "Интернет магазин"</Наименование>
<ИНН>0000000001</ИНН>
<КПП/>
<ОсновнойМенеджер>cbcf494f-55bc-11d9-848a-00112f43529a</ОсновнойМенеджер>
</Контрагенты>
Таблица "Договоры Контрагентов"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид договора |
| ПометкаУдаления | булево | 0 или 1 |
| Наименование | Строка | название договора |
| Основной | булево | 0 или 1 |
| Контрагент | гуид 1С | гуид Контрагента |
| ТипЦен | гуид 1С | гуид типа цен |
| Валюта | гуид 1С | гуид валюты |
| ДопустимоеЧислоДнейЗадолженности | число | количество дней |
Пример:
<ДоговорыКонтрагентов>
<ВремяИзменения>2014-06-27T16:17:26</ВремяИзменения>
<Ссылка>f3e070c5-fdf4-11e3-80bf-002268891092</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Наименование>Основной договор Агора</Наименование>
<Основной>0</Основной>
<Контрагент>f3d3eb53-7d90-4b8c-9267-5689128f79a0</Контрагент>
<ТипЦен>cbcf493b-55bc-11d9-848a-00112f43529a</ТипЦен>
<Валюта>bd72d8f9-55bc-11d9-848a-00112f43529a</Валюта>
<ДопустимоеЧислоДнейЗадолженности>0</ДопустимоеЧислоДнейЗадолженности>
</ДоговорыКонтрагентов>
Таблица "Менеджер"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид менеджера (пользователя) в 1С |
| ПометкаУдаления | булево | 0 или 1 |
| Наименование | Строка | ФИО Менеджера |
| Телефон | Строка | Телефон |
| Почта | Строка | Почта |
| Подразделение | гуид 1С | гуид подразеделения |
| НаименованиеПодразделения | Строка | Наименование подразделения |
Пример:
<Менеджер>
<ВремяИзменения>2014-06-27T16:17:26</ВремяИзменения>
<Ссылка>cbcf494f-55bc-11d9-848a-00112f43529a</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Наименование>Иванов Василий Петрович</Наименование>
<Телефон>+7(495)344-33-33</Телефон>
<Почта/>
<Подразделение>00000000-0000-0000-0000-000000000000</Подразделение>
<НаименованиеПодразделения>Отдел продаж</НаименованиеПодразделения>
</Менеджер>
Таблица "Единицы Измерения"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид единицы измерения |
| ПометкаУдаления | булево | 0 или 1 |
| Наименование | Строка | наименование единицы |
| Владелец | гуид 1С | гуид номенклатуры / характеристики номенклатуры |
| ЕдиницаПоКлассификатору | гуид 1С | гуид единицы по классификатору |
| Вес | число | вес единицы |
| Объём | число | объём единицы |
| Коэффициент | число | коэффициент для единицы |
Пример:
<ЕдиницыИзмерения>
<ВремяИзменения>2014-07-01T11:23:15</ВремяИзменения>
<Ссылка>9f09a9ca-701b-11e2-beac-00155d002500</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Наименование>шт</Наименование>
<Владелец>9f09a9c9-701b-11e2-beac-00155d002500</Владелец>
<ЕдиницаПоКлассификатору>bd72d926-55bc-11d9-848a-00112f43529a</ЕдиницаПоКлассификатору>
<Вес>0</Вес>
<Объем>0</Объем>
<Коэффициент>1</Коэффициент>
</ЕдиницыИзмерения>
Таблица "Группа Номенклатура"
| Внутренний тег | Формат | Значение |
|---|---|---|
| Ссылка | гуид 1С | гуид группы |
| Родитель | гуид 1С | гуид родительской группы |
| НаименованиеRU | строка | наименование группы (папки каталога) на русском языке |
| НаименованиеEN | строка | наименование группы (папки каталога) на английском языке |
| НаименованиеLV | строка | наименование группы (папки каталога) на латышском языке |
Пример:
<ГруппаНоменклатура>
<Ссылка>11b7ed21-eca8-11e3-80be-002268891092</Ссылка>
<Родитель/>
<НаименованиеRU>Мебель</НаименованиеRU><НаименованиеEN>Furniture</НаименованиеEN><НаименованиеLV/>
</ГруппаНоменклатура>
Таблица "Номенклатура"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид номенклатуры |
| Родитель | гуид 1С | Группа номенклатуры |
| ПометкаУдаления | булево | 0 или 1 |
| Артикул | строка | артикул товара |
| Наименование | строка | наименование товара |
| СтавкаНДС | число | ставка НДС (символ % -не ставится) |
| ДополнительноеОписаниеНоменклатуры | строка | описание номенклатуры |
| АгораОбмен | булево | 0 или 1 |
| ЕдиницаХраненияОстатков | гуид 1С | гуид единицы измерения |
| ВестиУчетПоХарактеристикам | булево | 0 или 1 |
| ТипНоменклатуры | строка | тип номенклатуры |
| Штрихкод | строка | штрих код номенклатуры |
Пример:
<Номенклатура>
<ВремяИзменения>2014-07-01T11:23:15</ВремяИзменения>
<Ссылка>11b7ed22-eca8-11e3-80be-002268891092</Ссылка>
<Родитель>11b7ed21-eca8-11e3-80be-002268891092</Родитель>
<ПометкаУдаления>0</ПометкаУдаления>
<Артикул>1233453</Артикул>
<Наименование>Номенклатура1</Наименование>
<СтавкаНДС>18%</СтавкаНДС>
<ДополнительноеОписаниеНоменклатуры/>
<АгораОбмен>0</АгораОбмен>
<ЕдиницаХраненияОстатков>11b7ed23-eca8-11e3-80be-002268891092</ЕдиницаХраненияОстатков>
<ВестиУчетПоХарактеристикам>1</ВестиУчетПоХарактеристикам>
<ТипНоменклатуры>Товар</ТипНоменклатуры>
<Штрихкод/>
</Номенклатура>
Таблица "Характеристики Номенклатуры"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид характеристики номенклатуры |
| ПометкаУдаления | булево | 0 или 1 |
| Владелец | гуид 1С | гуид номенклатуры |
| Наименование | строка | наименование характеристики |
| Штрихкод | строка | штрих код номенклатуры |
Пример:
<ХарактеристикиНоменклатуры>
<ВремяИзменения>2014-07-01T11:23:15</ВремяИзменения>
<Ссылка>9c0de226-b633-11e3-8829-00155d002500</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Владелец>9f09a9c9-701b-11e2-beac-00155d002500</Владелец>
<Наименование>0100000D10201a</Наименование>
<Штрихкод>1236546</Штрихкод>
</ХарактеристикиНоменклатуры>
Кратность и Минимальное количество в заказе
Если Вам необходимо догрузить параметры "Кратность" по товару и "Минимальное количество в заказе", то нужно прописать выгрузку необходимых тегов в таблицы "Номенклатура" и "Характеристики Номенклатуры"
| Внутренний тег | Формат | Значение |
|---|---|---|
| МинЗаказ | число | Минимальное количество товара в заказе |
| Кратность | число | Кратность товара в заказе |
Пример:
<Номенклатура>
<ВремяИзменения>2014-07-01T11:23:15</ВремяИзменения>
<Ссылка>11b7ed22-eca8-11e3-80be-002268891092</Ссылка>
<Родитель>11b7ed21-eca8-11e3-80be-002268891092</Родитель>
<ПометкаУдаления>0</ПометкаУдаления>
<Артикул>1233453</Артикул>
<Наименование>Номенклатура1</Наименование>
<СтавкаНДС>18%</СтавкаНДС>
<ДополнительноеОписаниеНоменклатуры/>
<АгораОбмен>0</АгораОбмен>
<ЕдиницаХраненияОстатков>11b7ed23-eca8-11e3-80be-002268891092</ЕдиницаХраненияОстатков>
<ВестиУчетПоХарактеристикам>1</ВестиУчетПоХарактеристикам>
<ТипНоменклатуры>Товар</ТипНоменклатуры>
<Штрихкод/>
<МинЗаказ>15</МинЗаказ>
<Кратность>15</Кратность>
</Номенклатура>
<ХарактеристикиНоменклатуры>
<ВремяИзменения>2014-07-01T11:23:15</ВремяИзменения>
<Ссылка>9c0de226-b633-11e3-8829-00155d002500</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Владелец>9f09a9c9-701b-11e2-beac-00155d002500</Владелец>
<Наименование>0100000D10201a</Наименование>
<Штрихкод>1236546</Штрихкод>
<МинЗаказ>15</МинЗаказ>
<Кратность>15</Кратность>
</ХарактеристикиНоменклатуры>
Таблица "Свойства Объектов"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид свойства |
| ПометкаУдаления | булево | 0 или 1 |
| Наименование | строка | наименование свойства |
Пример:
<СвойстваОбъектов>
<ВремяИзменения>2016-02-16T10:57:51</ВремяИзменения>
<Ссылка>ca32ce03-3a88-11dc-bf97-0030485b85c1ei1</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Наименование>Цвет</Наименование>
</СвойстваОбъектов>
Таблица "Значения Свойств Объектов"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Объект | гуид 1С | гуид номенклатуры / характеристики номенклатуры |
| ПометкаУдаления | булево | 0 или 1 |
| Свойство | гуид 1С | гуид свойства |
| Значение | строка | значение свойства |
| Тип | строка | тип объекта |
Пример:
<ЗначенияСвойствОбъектов>
<ВремяИзменения>2014-07-01T11:23:15</ВремяИзменения>
<Объект>9c0de226-b633-11e3-8829-00155d002500</Объект>
<ПометкаУдаления>1</ПометкаУдаления>
<Свойство>7c752f08-b968-11de-80de-000423ccaba4</Свойство>
<Значение/>
<Тип>ХарактеристикиНоменклатуры</Тип>
</ЗначенияСвойствОбъектов>
Таблица "Склады"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид склада |
| ПометкаУдаления | булево | 0 или 1 |
| Наименование | строка | наименование склада |
Пример:
<Склады>
<ВремяИзменения>2015-02-13T13:39:58</ВремяИзменения>
<Ссылка>3d869e11-3c16-11e1-86a9-0015170edf69</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Наименование>Тарасовка</Наименование>
</Склады>
Таблица "Типы Цен Номенклатуры"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид типа цен |
| ПометкаУдаления | булево | 0 или 1 |
| Наименование | строка | наименование типа цен |
| Рассчитывается | булево | 0 или 1 |
| БазовыйТипЦен | гуид 1С | гуид базового типа цен |
| ПроцентСкидкиНаценки | число | скидка / наценка (символ % -не ставится) |
Пример:
<ТипыЦенНоменклатуры>
<ВремяИзменения>2015-02-13T13:39:58</ВремяИзменения>
<Ссылка>3ec9fa33-6e8e-11e2-973d-bcaec51b91f9</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Наименование>Оптовые</Наименование>
<Рассчитывается>0</Рассчитывается>
<БазовыйТипЦен>3ec9fa33-6e8e-11e2-973d-bcaec51b91f9</БазовыйТипЦен>
<ПроцентСкидкиНаценки>0</ПроцентСкидкиНаценки>
</ТипыЦенНоменклатуры>
Таблица "Цены Номенклатуры"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| ТипЦен | гуид 1С | гуид типа цен |
| Номенклатура | гуид 1С | гуид номенклатуры |
| ХарактеристикаНоменклатуры | гуид 1С | гуид характеристики номенклатуры |
| Валюта | гуид 1С | гуид валюты |
| Цена | число | цена |
Пример:
<ЦеныНоменклатуры>
<ВремяИзменения>2014-07-01T11:23:17</ВремяИзменения>
<ТипЦен>cbcf493b-55bc-11d9-848a-00112f43529a</ТипЦен>
<Номенклатура>9f09a9c9-701b-11e2-beac-00155d002500</Номенклатура>
<ХарактеристикаНоменклатуры>587b5005-b634-11e3-8829-00155d002500</ХарактеристикаНоменклатуры>
<Валюта>bd72d8f9-55bc-11d9-848a-00112f43529a</Валюта>
<Цена>1000</Цена>
</ЦеныНоменклатуры>
Таблица "Остатки Товаров"
Таблица выгружается с параметром указывающим взятый тип данных xsi:type="ТоварыНаСкладах"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Склад | гуид 1С | гуид склада |
| Номенклатура | гуид 1С | гуид номенклатуры |
| ХарактеристикаНоменклатуры | гуид 1С | гуид характеристики номенклатуры |
| Остаток | число | остаток |
Пример:
<ОстаткиТоваров xsi:type="ТоварыНаСкладах">
<ВремяИзменения>0001-01-01T00:00:00</ВремяИзменения>
<Склад>bd72d91f-55bc-11d9-848a-00112f43529a</Склад>
<Номенклатура>9f09a9c9-701b-11e2-beac-00155d002500</Номенклатура>
<ХарактеристикаНоменклатуры>587b5003-b634-11e3-8829-00155d002500</ХарактеристикаНоменклатуры>
<Остаток>997</Остаток>
</ОстаткиТоваров>
Таблица "Взаиморасчеты С Контрагентами"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Контрагент | гуид 1С | гуид контрагента |
| Долг | число | долг контрагента |
Пример:
<ВзаиморасчетыСКонтрагентами>
<ВремяИзменения>2016-01-26T10:54:08</ВремяИзменения>
<Контрагент>92224f2c-c371-11e5-94cc-0015174f37f4</Контрагент>
<Долг>10000</Долг>
</ВзаиморасчетыСКонтрагентами>
Таблица "Хранилище Дополнительной Информации" (картинка)
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид картинки |
Номенклатура / Характеристика | гуид 1С | гуид номенклатуры / характеристики номенклатуры |
| Картинка | гуид 1С | файл (гуид картинки + расширение) |
| ПометкаУдаления | булево | 0 или 1 |
| Основной | булево | 0 или 1 |
Пример:
<ХранилищеДополнительнойИнформации>
<ВремяИзменения>2014-07-01T11:23:16</ВремяИзменения>
<Ссылка>9f09a9cb-701b-11e2-beac-00155d002500</Ссылка>
<Номенклатура>9f09a9c9-701b-11e2-beac-00155d002500</Номенклатура>
<Картинка>9f09a9cb-701b-11e2-beac-00155d002500.jpeg</Картинка>
<ПометкаУдаления>0</ПометкаУдаления>
<Основной>1</Основной>
</ХранилищеДополнительнойИнформации>
Таблица "Акт Сверки Взаиморасчетов"
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид документа |
| Контрагент | гуид 1С | гуид контрагента |
| ДатаНачала | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| ДатаОкончания | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Акт | код акта | закодированный документ |
Пример:
<АктСверкиВзаиморасчетов>
<ВремяИзменения>2014-07-01T12:35:51</ВремяИзменения>
<Ссылка>244d7592-27f4-45a6-b37b-1a68018aedc6</Ссылка>
<Контрагент>f3d3eb53-7d90-4b8c-9267-5689128f79a0</Контрагент>
<ДатаНачала>2014-05-01T00:00:00</ДатаНачала>
<ДатаОкончания>2014-07-01T00:00:00</ДатаОкончания>
<Акт>0M8R4KGxGuEAAAAAAAAAAAAAAAAAAAAAPgADA....
</Акт>
</АктСверкиВзаиморасчетов>
Можно выгрузить часть скидок из в следующих форматах:
Таблица "Простая Скидка Номенклатуры"
Данная скидка распространяется на все товары без исключения.
| Внутренний тег | Формат | Значение |
|---|---|---|
| Название | Строка | Наименоваине скидки |
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид документа |
| ПометкаУдаления | булево | 0 или 1 |
| ПроцентСкидки | число | значение скидки в % (символ % -не ставится) |
| ДатаНачала | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| ДатаОкончания | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| ДляВсехПолучателей | булево | 0 или 1 (1 - если скидка применяется для всех) |
| ПолучателиСкидки | список гуидов 1С | гуиды контрагентов |
| Приоритет | число | приоритет скидки |
| ГруппаСкидок | гуид 1С | группа, к которой относится скидка |
Пример:
<ПростаяСкидкаНоменклатуры>
<Название>Простая скидка</Название>
<ВремяИзменения>2016-03-10T12:19:38</ВремяИзменения>
<Ссылка>88da6404-6772-11dc-9be3-0030485b85c1</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<ПроцентСкидки>2</ПроцентСкидки>
<ДатаНачала>2007-09-20T00:00:00</ДатаНачала>
<ДатаОкончания>2014-09-30T00:00:00</ДатаОкончания>
<ДляВсехПолучателей>1</ДляВсехПолучателей>
<ПолучателиСкидки/>
<Приоритет>1</Приоритет>
<ГруппаСкидок>80de88e4-de65-11dd-a1bc-0030555b85c1</ГруппаСкидок>
</ПростаяСкидкаНоменклатуры>
Пример №2, со списком контрагентов:
<ПростаяСкидкаНоменклатуры>
<Название>Простая скидка</Название>
<ВремяИзменения>2016-03-10T12:19:38</ВремяИзменения>
<Ссылка>88da6404-6772-11dc-9be3-0030485b85c1</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<ПроцентСкидки>2</ПроцентСкидки>
<ДатаНачала>2007-09-20T00:00:00</ДатаНачала>
<ДатаОкончания>2014-09-30T00:00:00</ДатаОкончания>
<ДляВсехПолучателей>0</ДляВсехПолучателей>
<ПолучателиСкидки>
<Контрагент>36fca3cf-aab1-11e4-9490-0015174f37f4</Контрагент>
</ПолучателиСкидки>
<Приоритет>5</Приоритет>
<ГруппаСкидок/>
</ПростаяСкидкаНоменклатуры>
Таблица "Акционная Скидка Номенклатуры"
Данная скидка распространяется на определённые товары или группы товаров.
| Внутренний тег | Формат | Значение |
|---|---|---|
| Название | Строка | Наименоваине скидки |
| ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| Ссылка | гуид 1С | гуид документа |
| ПометкаУдаления | булево | 0 или 1 |
| ПроцентСкидки | число | значение скидки в % (символ % -не ставится) |
| ДатаНачала | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| ДатаОкончания | Дата и Время | гггг-ММ-ддTчч:мм:сс |
| ДляВсехПолучателей | булево | 0 или 1 (1 - если скидка применяется для всех) |
| ПолучателиСкидки | список гуидов 1С | гуиды контрагентов |
| ТоварыСоСкидкой | список гуидов 1С | гуиды номенклатуры и характеристик номенклатуры |
| ГруппыТоваровСоСкидкой | список гуидов 1С | гуиды групп номенклатуры |
| Приоритет | число | приоритет скидки |
| ГруппаСкидок | гуид 1С | группа, к которой относится скидка |
Пример:
<АкционнаяСкидкаНоменклатуры>
<Название>Название какое-то</Название>
<ВремяИзменения>2015-12-24T16:44:51</ВремяИзменения>
<Ссылка>fe31b6c3-aadf-11e4-9490-0015174f37f4</Ссылка> - тут гуид
<ПометкаУдаления>0</ПометкаУдаления>
<ПроцентСкидки>15</ПроцентСкидки>
<ДатаНачала>2007-09-20T00:00:00</ДатаНачала>
<ДатаОкончания>2014-09-30T00:00:00</ДатаОкончания>
<ДляВсехПолучателей>0</ДляВсехПолучателей>
<ПолучателиСкидки>
<Контрагент>36fca3cf-aab1-11e4-9490-0015174f37f4</Контрагент>
<Контрагент>36fca3cf-aab1-11e4-9490-0015174f38f4</Контрагент>
<Контрагент>36fca3cf-aab1-11e4-9490-0015134f37f4</Контрагент>
</ПолучателиСкидки>
<ТоварыСоСкидкой>
<Номенклатура>36fca3cf-aab1-11e4-9490-0015167f37f4</Номенклатура>
<ХарактеристикаНоменклатуры>36fca3cf-aab1-11e4-5690-0015167f37f4</ХарактеристикаНоменклатуры>
</ТоварыСоСкидкой>
<ГруппыТоваровСоСкидкой>
<ГруппаНоменклатуры>80de88e4-de65-11dd-a1bc-0030485b85c1</ГруппаНоменклатуры>
</ГруппыТоваровСоСкидкой>
<Приоритет>1</Приоритет>
<ГруппаСкидок>80de88e4-de65-11dd-a1bc-0030555b85c1</ГруппаСкидок>
</АкционнаяСкидкаНоменклатуры>
Таблица "Группы Скидок"
| Внутренний тег | Формат | Значение |
|---|---|---|
| Ссылка | гуид 1С | гуид группы скидок |
| ПометкаУдаления | булево | 0 или 1 |
| Родитель | гуид 1С | гуид родительской группы скидок |
| Наименование | строка | наименование группы скидок |
| ВариантПрименения | строка | способ применения скидок в группе |
| Приоритет | число | приоритет группы скидок |
Пример:
<ГруппыСкидок>
<Ссылка>80de88e4-de65-11dd-a1bc-0030558b85c1</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Родитель>80de88e4-de65-11dd-a1bc-0030554b85c1</Родитель>
<Наименование>Скидки по акции</Наименование>
<ВариантПрименения>Вытеснение<ВариантПрименения>
<Приоритет>2</Приоритет>
</ГруппыСкидок>
Существуют так же другие таблицы, которые не входят в стандартный набор функционала, для их получения свяжитесь с Вашим менеджером.
Структура входящего XML-пакета с сайта в 1С базу
Структура по сути та же:
В самом начале выставляются обязательные параметры для XML-пакетов, такие как версия и кодировка передаваемых данных:
<?xml version="1.0" encoding="UTF-8"?>
Затем выгружается объект AgoraMessage содержащий в себе набор определённых таблиц, некоторые из которых так же содержат в себе таблицы.
Тег включает в себя описание используемых схем переменных:
<AgoraMessage xmlns="http://www.agora.centrobit.ru" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="AgoraMessage">
Все выгружаемые из 1С значения тегов имеют тип String (Строка), подставляемые числа не имеют пробелов и запятых, запятые заменяются на точки.
Таблица "Заказ Покупателя"
Используется только при создании заказа, дальнейшие обновления по заказу приходят из 1С.
| Внутренний тег | Формат | Значение |
|---|---|---|
| ВремяИзменения | Дата и Время | поле обычно пусто |
| Ссылка | гуид 1С | гуид заказа |
| Проведен | булево | 0 или 1 |
| ПометкаУдаления | булево | 0 или 1 |
| Номер | Строка | номер заказа в 1С |
| Дата | Дата создания | гггг-ММ-дд |
| ВалютаДокумента | гуид 1С | гуид Валюты |
| Контрагент | гуид 1С | гуид Контрагента, если это первый заказ - поле пустое |
| ИННКонтрагента | Строка | Заполняется только при первом заказе, для идентификации |
| НаименованиеКонтрагента | Строка | Заполняется только при первом заказе |
| ДоговорКонтрагента | гуид 1С | гуид Договора Контрагента, , если это первый заказ - поле пустое |
| СкладГруппа | гуид 1С | гуид склада указанного в заказе |
| СуммаДокумента | число | сумма заказа |
| АдресДоставки | Строка | Текст адреса доставки из заказа |
| Комментарий | Строка | Текст комментария из заказа |
| Товары | Таблица | Отбельная табличная часть (описана ниже) |
Пример:
<ЗаказПокупателя>
<ВремяИзменения/>
<Ссылка>83a16287-56e7-46f5-84e8-b04a23f7eb7a</Ссылка>
<Проведен>1</Проведен>
<ПометкаУдаления>0</ПометкаУдаления>
<Номер/>
<Дата>2014-07-02</Дата>
<ВалютаДокумента>bd72d8f9-55bc-11d9-848a-00112f43529a</ВалютаДокумента>
<Контрагент>f3d3eb53-7d90-4b8c-9267-5689128f79a0</Контрагент>
<ИННКонтрагента/>
<НаименованиеКонтрагента/>
<ДоговорКонтрагента>f3e070c5-fdf4-11e3-80bf-002268891092</ДоговорКонтрагента>
<СкладГруппа>bd72d91f-55bc-11d9-848a-00112f43529a</СкладГруппа>
<СуммаДокумента>60231.00</СуммаДокумента>
<АдресДоставки>Пробный от Центробит</АдресДоставки>
<Комментарий>Пробный от Центробит, Способ доставки: Экспресс доставка</Комментарий>
<Товары>
<Строка>
<Номенклатура>9f09a9c9-701b-11e2-beac-00155d002500</Номенклатура>
<ХарактеристикаНоменклатуры/>
<Количество>1.0</Количество>
<ЕдиницаИзмерения>9f09a9cb-701b-11e2-beac-00155d002500</ЕдиницаИзмерения>
<Сумма>60231.00</Сумма>
<СтавкаНДС/>
<СуммаНДС/>
<Цена>60231.00</Цена>
<Размещение>bd72d91f-55bc-11d9-848a-00112f43529a</Размещение>
<ПроцентСкидки/>
</Строка>
</Товары>
</ЗаказПокупателя>
Таблица "Товары"
В приходящем пакете таблица идентична исходящему:
Таблица "Товары" входит в состав Заказа Покупателя и состоит из таблиц строк товаров, из их множества, таблица Строки Товара выглядит следующим образом:
| Внутренний тег | Формат | Значение |
|---|---|---|
| Номенклатура | гуид 1С | гуид номенклатуры |
| ХарактеристикаНоменклатуры | гуид 1С | гуид характеристики номенклатуры |
| Количество | число | количество товара в заказе |
| ЕдиницаИзмерения | гуид 1С | гуид единицы измерения |
| Сумма | число | сумма по позиции |
| СтавкаНДС | число | ставка НДС (символ % -не ставится) |
| СуммаНДС | число | сумма НДС по позиции |
| Цена | число | цена позиции |
| Размещение | гуид 1С | гуид склада |
| ПроцентСкидки | число | Сумма всех скидок по позиции (символ % -не ставится) |
Ставка НДС может не передаваться, если это отключено в настройках сайта.
Пример:
<Номенклатура>9f09a9c9-701b-11e2-beac-00155d002500</Номенклатура>
<ХарактеристикаНоменклатуры/>
<Количество>1.0</Количество>
<ЕдиницаИзмерения>9f09a9cb-701b-11e2-beac-00155d002500</ЕдиницаИзмерения>
<Сумма>60231.00</Сумма>
<СтавкаНДС/>
<СуммаНДС/>
<Размещение>bd72d91f-55bc-11d9-848a-00112f43529a</Размещение>
<ПроцентСкидки/>
</Строка>
</Товары>
Структура исходящего XML-пакета для создания пользователя на сайте из 1С
Структура по сути та же:
В самом начале выставляются обязательные параметры для XML-пакетов, такие как версия и кодировка передаваемых данных:
<?xml version="1.0" encoding="UTF-8"?>
Затем выгружается объект AgoraMessage содержащий в себе набор определённых таблиц, некоторые из которых так же содержат в себе таблицы.
Тег включает в себя описание используемых схем переменных:
<AgoraMessage xmlns="http://www.agora.centrobit.ru" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="AgoraMessage">
Таблица "Менеджеры"
По сути та же самая таблица которая которая приходит после первого заказа с контрагентом, только добавился тег <AгораВход>, если в этом теге стоит "1" то для этого менеджера создаться пользователь в Агоре.
Внутренний тег | Формат | Значение |
ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
Ссылка | гуид 1С | гуид менеджера (пользователя) в 1С |
ПометкаУдаления | булево | 0 или 1 |
Наименование | Строка | ФИО Менеджера |
Телефон | Строка | Телефон |
Почта | Строка | |
Подразделение | гуид 1С | гуид подразеделения |
НаименованиеПодразделения | Строка | Наименование подразделения |
АгораВход | Булево | 0 или 1 |
Пример
<Менеджер>
<ВремяИзменения>2014-06-27T16:17:26</ВремяИзменения>
<Ссылка>cbcf494f-55bc-11d9-848a-00112f43529a</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Наименование>Иванов Василий Петрович</Наименование>
<Телефон>+7(495)344-33-33</Телефон>
<Почта>haha@mail.ru</Почта> - обязательно для заполнения!!!!!!!!!
<Подразделение>00000000-0000-0000-0000-000000000000</Подразделение>
<НаименованиеПодразделения>Отдел продаж</НаименованиеПодразделения>
<АгораВход>1</АгораВход>
</Менеджер>
Таблица "Договоры Контрагентов"
используется та же таблица что представлена в пункте 1.5 Таблица "Договоры Контрагентов"
Таблица "Пользователи Агоры"
На основании этой таблицы создадутся пользователи для входа под контрагентом.
Внутренний тег | Формат | Значение |
ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
Ссылка | гуид 1С | гуид пользователя |
ПометкаУдаления | булево | 0 или 1 |
ФИО | Строка | ФИО контактного лица контрагента |
Должность | Строка | должность контактного лица |
Контрагент | гуид 1С | гуид Контрагента |
Телефон | Строка | телефон контактного лица |
ЭлПочта | Строка | e-mail контактного лица (обязательно для заполнения) |
Пример
<ПользователиАгоры>
<ВремяИзменения>2016-07-04T16:24:40</ВремяИзменения>
<Ссылка>e3e53bb2-c111-11dd-b651-0030485b85c1</Ссылка>
<ПометкаУдаления>"0"</ПометкаУдаления>
<ФИО>Петрова Наталья</ФИО>
<Должность/>
<Контрагент> f3d3eb53-7d90-4b8c-9267-5689128f79a0</Контрагент>
<Телефон>969-6998</Телефон>
<ЭлектроннаяПочта>test@mail.ru</ЭлектроннаяПочта>
</ПользователиАгоры>
Порядок Выгрузки объектов должен быть именно такой, если будет какой-то другой порядок то возникнут ошибки
Порядок выгрузки следующий:
- Менеджер
- Контрагент
- ДоговорыКонтрагента
- ПользователиАгоры
- Нет меток