В данном разделе описан XML-формат выгрузки данных на примере взаимодействия с УТ версии 10.3. |
В самом начале выставляются обязательные параметры для 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С |
Счет | строка | значение счета в кодировке base64 |
ВремяИзменения | Дата и время | гггг-ММ-ддTчч:мм:сс |
ИмяФайла | строка | Наименование счета |
Пример:
<СчетЗаказа>
<Заказ>ca7d8f45-1991-11e9-844f-00155d659300</Заказ>
<Счет>JVBERi0xLjcKJeLjz9MKMSAwIG9iago8PAovRmlsdGVyIC9GbGF0ZURlY29kZQov
TGVuZ3RoIDIgMCBSCi9MZW5ndGgxIDU1MDQ4Ci9MZW5ndGgyIDAKL0xlbmd0aDMg
MAo+......
</Счет>
<ВремяИзменения>2019-01-24T08:32:54</ВремяИзменения>
<ИмяФайла>Счет на оплату - Заказ №ИМ00-000001 от 2019-01-16.PDF</ИмяФайла>
</СчетЗаказа>
Таблица "Товары" входит в состав Заказа Покупателя, состоит из множества таблиц строк товаров, и выглядит следующим образом:
Внутренний тег | Формат | Значение |
---|---|---|
Номенклатура | гуид 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С | Гуид грузополучателя в 1С |
Наименование | строка | Наименование грузополучателя |
ИНН | строка | ИНН грузополучателя |
АдресДоставки | строка | текст адреса доставки |
КПП | строка | КПП грузополучателя (если необходимо) |
ПометкаУдаления | булево | 0 или 1 |
Пример:
<Грузополучатели>
<ВремяИзменения>2018-12-07T11:03:23</ВремяИзменения>
<Ссылка>3d90c9aa-d694-11e8-aa38-00155d014303gp</Ссылка>
<Наименование>Пиневич Денис Александрович</Наименование>
<ИНН>526212980327</ИНН>
<АдресДоставки>
603024, Нижегородская обл, Нижний Новгород г, Невзоровых ул, дом № 83, пом. 5
</АдресДоставки>
<КПП/>
<ПометкаУдаления>0</ПометкаУдаления>
</Грузополучатели>
Для привязки грузополучателя к контрагенту, нужно выгружать обновленный формат контрагента.
Внутренний тег | Формат | Значение |
ВремяИзменения | Дата и время | гггг-ММ-ддTчч:мм:сс |
Ссылка | Гуид 1С | Гуид контрагента в 1С |
Наименование | строка | Наименование контрагента |
ИНН | Строка | ИНН контрагента |
КПП | Строка | КПП контрагента (если необходимо) |
ОсновнойМенеджер | гуид 1С | гуид менеджера (пользователя) в 1С |
ГрузополучателиСтроки | Открывающий тег | Тег для указания списка грузополучателей |
ГрузополучателиСтрока | открывающий тег | Тег для указания одного грузополучателя |
Грузополучатель | гуид 1С | Гуид грузополучателя в 1С |
Пример:
<Контрагенты>
<ВремяИзменения>2014-06-27T16:17:26</ВремяИзменения>
<Ссылка>f3d3eb53-7d90-4b8c-9267-5689128f79a0</Ссылка>
<Наименование>ООО "Интернет магазин"</Наименование>
<ИНН>0000000001</ИНН>
<КПП/>
<ОсновнойМенеджер>cbcf494f-55bc-11d9-848a-00112f43529a</ОсновнойМенеджер>
<ГрузополучателиСтроки>
<ГрузополучателиСтрока>
<Грузополучатель>3d90c9aa-d694-11e8-aa38-00155d014303gp</Грузополучатель>
</ГрузополучателиСтрока>
</ГрузополучателиСтроки>
</Контрагенты>
В теге <Грузополучатель> указывается гуид грузополучателя ранее выгруженного на портал.
Строк <Грузополучатель> может быть несколько.
Внутренний тег | Формат | Значение |
---|---|---|
ВремяИзменения | Дата и Время | гггг-ММ-дд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</ДопустимоеЧислоДнейЗадолженности>
</ДоговорыКонтрагентов>
Для выгрузки уточненных цен в соглашении необходимо выгружать из 1С соглашение с указанием товаров, у которых указана уточненная цена.
Внутренний тег | Формат | Значение |
Номенклатура | гуид 1С | гуид номенклатуры (товара) в 1С |
ВидЦены | гуид 1C | гуид вида цены (типа цены) в 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</ДопустимоеЧислоДнейЗадолженности>
<Товары>
<Строка>
<Номенклатура>9f09a9c9-701b-11e2-beac-00155d002500</Номенклатура>
<ВидЦены/>
<Цена>60231</Цена>
</Строка>
</Товары>
</ДоговорыКонтрагентов>
Внутренний тег | Формат | Значение |
---|---|---|
ВремяИзменения | Дата и Время | гггг-ММ-дд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 или 0 |
Родитель | гуид 1С | гуид родительской группы |
НаименованиеRU | строка | наименование группы (папки каталога) на русском языке |
НаименованиеEN | строка | наименование группы (папки каталога) на английском языке |
НаименованиеLV | строка | наименование группы (папки каталога) на латышском языке |
Пример:
<ГруппаНоменклатура>
<Ссылка>11b7ed21-eca8-11e3-80be-002268891092</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Родитель/>
<Наименование>Мебель</Наименование>
<НаименованиеRU>Мебель</НаименованиеRU>
<НаименованиеEN>Furniture</НаименованиеEN>
<НаименованиеLV/>
</ГруппаНоменклатура>
Внутренний тег | Формат | Значение |
---|---|---|
ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
Ссылка | гуид 1С | гуид номенклатуры |
Родитель | гуид 1С | Группа номенклатуры |
ПометкаУдаления | булево | 0 или 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С | гуид контрагента |
ДоговорКонтрагента | гуид 1С | гуид договора |
Долг | число | долг контрагента |
Пример:
<ВзаиморасчетыСКонтрагентами>
<ВремяИзменения>2016-01-26T10:54:08</ВремяИзменения>
<Контрагент>92224f2c-c371-11e5-94cc-0015174f37f4</Контрагент>
<ДоговорКонтрагента>f3e070c5-fdf4-11e3-80bf-002268891092</ДоговорКонтрагента>
<Долг>10000</Долг>
</ВзаиморасчетыСКонтрагентами>
Внутренний тег | Формат | Значение |
---|---|---|
ВремяИзменения | Дата и Время | гггг-ММ-ддTчч:мм:сс |
Ссылка | гуид 1С | гуид картинки |
Номенклатура / Характеристика | гуид 1С | гуид номенклатуры / характеристики номенклатуры |
ФайлХранилище | гуид 1С | файл (гуид картинки + расширение) |
ПометкаУдаления | булево | 0 или 1 |
Основной | булево | 0 или 1 |
Загружаемый формат изображений должен соответствовать любому из перечисленного:
gif, ief, jp2, jpg2, jpeg, jpg, jpe, jpm, jpx, jpf, pcx, png, svg, svgz, tiff, tif, djvu, djv, ico, wbmp, cr2, cru, ras, cdr, pat, cdt, cpt, erf, art, jong, bmp, nef, orf, psd, pnm, pbm, pgm, ppm, rgb, xbm, xpm, xwd
Мы не можем гарантировать корректность загрузки изображений, если их формат будет отличаться от вышеуказанных.
По-умолчанию, размер загружаемого файла не должен превышать 3MB, в случае необходимости увеличения объема загружаемого файла, достаточно отправить обращение в нашу техническую поддержку: help@agora.ru
Пример:
<КартинкаНоменклатуры>
<ВремяИзменения>2014-07-01T11:23:16</ВремяИзменения>
<Ссылка>9f09a9cb-701b-11e2-beac-00155d002500</Ссылка>
<Номенклатура>9f09a9c9-701b-11e2-beac-00155d002500</Номенклатура>
<ФайлХранилище>9f09a9cb-701b-11e2-beac-00155d002500.jpeg</ФайлХранилище>
<ПометкаУдаления>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-пакетов, такие как версия и кодировка передаваемых данных:
<?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С | гуид склада |
ПроцентСкидки | число | Сумма всех скидок по позиции (символ % -не ставится) |
Ставка НДС может не передаваться, если это отключено в настройках сайта.
Пример:
Структура, по сути, аналогичная.
В самом начале выставляются обязательные параметры для 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</АгораВход>
</Менеджер>
Используется таблица, представленная в разделе Таблица "Контрагенты".
Используется таблица, представленная в разделе Таблица "Договоры Контрагентов".
На основании этой таблицы создадутся пользователи для входа под контрагентом.
Внутренний тег | Формат | Значение |
---|---|---|
ВремяИзменения | Дата и Время | гггг-ММ-дд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</ЭлектроннаяПочта>
</ПользователиАгоры>
Во избежание возникновения ошибок должен соблюдаться следующие порядок выгрузки: