В данном разделе описан 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С заполнение поля не требуется
СерияПаспортаСтрокаПри выгрузке из 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</Закрыт>
</ЗаказПокупателя>

Таблица "Статус заказа"


Внутренний тегФорматЗначение
 <ВремяИзменения>Дата и время

гггг-ММ-ддTчч:мм:сс

<Заказ>Гуид 1С гуид заказа в 1С
<Статус>СтрокаЗначение статуса

Пример:

<СтатусЗаказа>

<ВремяИзменения>2021-06-01T12:02:09</ВремяИзменения>

<Заказ>b506664a-751a-45cf-b25c-4ffcf247e289</Заказ>

<Статус>Закрыт</Статус>

</СтатусЗаказа>

Таблица "Счет заказа"


Для выгрузки счета к заказу необходимо использовать следующий формат

Внутренний тег

Формат

Значение

Заказ

Гуид 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Сгуид склада
ПроцентСкидкичислоСумма всех скидок по позиции (символ % -не ставится)
ДатаОтгрузкиДата и Времягггг-ММ-ддTчч:мм:сс Желаемая дата отгрузки
ОтмененобулевоПризнак отмены строки
ПричинаОтменыСтрокаОписание причины отмены
ВидЦеныгуид 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</ПроцентСкидки>
<ДатаОтгрузки>2021-06-14T00:00:00</ДатаОтгрузки>
<Отменено>1</Отменено>
<ПричинаОтмены>Нет на складе</ПричинаОтмены>
<ВидЦены>d2ce10ba-70e4-4aa8-8294-7d1e3790ef4e</ВидЦены>
</Строка>
</Товары>

Таблица "Валюты"


Внутренний тегФорматЗначение
ВремяИзмененияДата и Время

гггг-ММ-дд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</ИНН>
<Телефон>+7(999)999-99-99</Телефон>
<СерияПаспорта>1234</СерияПаспорта>
<НомерПаспорта>123456</НомерПаспорта>
<КПП/>
<ОсновнойМенеджер>cbcf494f-55bc-11d9-848a-00112f43529a</ОсновнойМенеджер>

</Контрагенты>

Таблица "Договоры контрагентов"


Внутренний тег

ФорматЗначение
ВремяИзмененияДата и Время

гггг-ММ-ддTчч:мм:сс

Ссылкагуид 1Сгуид договора
ПометкаУдалениябулево0 или 1
НаименованиеСтроканазвание договора
Организациягуид 1СИд организации
ДатаНачалаДействияДата и ВремяДата начала действия договора
ДатаОкончанияДействияДата и ВремяЖата окончания действия договора
ВидЦенгуид 1Сгуид вида цен договора
Контрагентгуид 1Сгуид Контрагента
Валютагуид 1Сгуид валюты
ТиповоеБулевоПризнак типового договора
ДопустимоеЧислоДнейЗадолженностичислоколичество дней

Пример:

<ДоговорыКонтрагентов>
<ВремяИзменения>2014-06-27T16:17:26</ВремяИзменения>
<Ссылка>f3e070c5-fdf4-11e3-80bf-002268891092</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Наименование>Основной договор Агора</Наименование>
<Организация>d527176d-10e9-4da4-9a1e-f3d0aebd137a</Организация>
<ДатаНачалаДействия>2010-01-01T00:00:00</ДатаНачалаДействия>
<ДатаОкончанияДействия/>
<ВидЦен>a9569e34-a1f2-4900-8182-08dfc787a379</ВидЦен>
<Контрагент>fc7fe51d-af2b-4ca7-a68d-71bc4bd48b28</Контрагент>
<Валюта>7d40155b-2ece-475f-a7e1-cbdea7e40782</Валюта>
<Типовое>1</Типовое>
<ДопустимоеЧислоДнейЗадолженности>1</ДопустимоеЧислоДнейЗадолженности>
</ДоговорыКонтрагентов>

Таблица "Уточненные цены"


Для выгрузки уточненных цен в соглашении необходимо выгружать из 1С соглашение с указанием товаров, у которых указана уточненная цена.

Выгрузка утоненных цен может осуществляться:

1. В привязке к договору, но без типа цены.

2. В привязке к договору, с типом цены.

3. В привязке к договору, с типом цены отличным от типа цены самого договора.

Внутренний тег

Формат

Значение

Номенклатура

гуид 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
НаименованиеСтроканаименование единицы
НаименованиеПолноеСтрокаполное наименование единицы

Пример:

<ЕдиницыИзмерения>
<ВремяИзменения>2014-07-01T11:23:15</ВремяИзменения>
<Ссылка>9f09a9ca-701b-11e2-beac-00155d002500</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Наименование>шт</Наименование>
<НаименованиеПолное>Штука</НаименованиеПолное>
</ЕдиницыИзмерения>

Таблица "Группа номенклатура"


Внутренний тегФорматЗначение
Ссылкагуид 1Сгуид группы
Пометка удалениябулево1 или 0
Родительгуид 1Сгуид родительской группы
Наименованиестроканаименование группы (папки каталога)

Пример:

<ГруппаНоменклатура>
<Ссылка>11b7ed21-eca8-11e3-80be-002268891092</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Родитель/>
<Наименование>Мебель</Наименование>
</ГруппаНоменклатура>

Таблица "Номенклатура"


Внутренний тегФорматЗначение
ВремяИзмененияДата и Время

гггг-ММ-дд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</Штрихкод>
</ХарактеристикиНоменклатуры>

Таблица "Свойства объектов"


Внутренний тегФорматЗначение
ВремяИзмененияДата и Время

гггг-ММ-дд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
Наименованиестроканаименование типа цен

Пример:

<ТипыЦенНоменклатуры>
<ВремяИзменения>2015-02-13T13:39:58</ВремяИзменения>
<Ссылка>3ec9fa33-6e8e-11e2-973d-bcaec51b91f9</Ссылка>
<ПометкаУдаления>0</ПометкаУдаления>
<Наименование>Оптовые</Наименование>
</ТипыЦенНоменклатуры>

Таблица "Цены номенклатуры"


Внутренний тегФорматЗначение
ВремяИзмененияДата и Время

гггг-ММ-ддTчч:мм:сс

ПериодДата и ВремяДата начала действия цены
ВидЦеныгуид 1Сгуид типа цен
Номенклатурагуид 1Сгуид номенклатуры
ХарактеристикаНоменклатурыгуид 1Сгуид характеристики номенклатуры
Валютагуид 1Сгуид валюты
Ценачислоцена

Пример:

<ЦеныНоменклатуры>
<ВремяИзменения>2014-07-01T11:23:17</ВремяИзменения>
<Период>2021-06-01T00:00:00</Период>
<ВидЦены>c94b52b9-ac27-45e7-bc27-6a2d206cc200</ВидЦены>
<Номенклатура>d2ce9316-5d16-46dd-b030-791d33096c4f</Номенклатура>
<Характеристика>ff4d76a0-58a4-4a21-b196-3dadae0c6f0c</Характеристика>
<Валюта>df01dff5-56e6-478f-bb22-5f9b3897975a</Валюта>
<Цена>120</Цена>
</ЦеныНоменклатуры>

Таблица "Остатки товаров"


Таблица выгружается с параметром указывающим взятый тип данных 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

(ошибка) Мы не можем гарантировать корректность загрузки изображений, если их формат будет отличаться от вышеуказанных. 

(вопрос) По-умолчанию размер загружаемого файла не должен превышать 15MB, в случае необходимости увеличения объема загружаемого файла достаточно отправить обращение в нашу техническую поддержку: 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чч:мм:сс

Акткод актазакодированный документ
ДоговорКонтрагентагуид 1Сгуид договора

Пример:

<АктСверкиВзаиморасчетов>
<ВремяИзменения>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....

</Акт>
<ДоговорКонтрагента>da0834f1-d74c-4c20-b94c-40009e621547</ДоговорКонтрагента>
</АктСверкиВзаиморасчетов>


Выгрузка скидок

Часть скидок можно выгрузить в следующих форматах:

Таблица "Простая скидка номенклатуры"


Данная скидка распространяется на все товары без исключения.

Внутренний тегФорматЗначение
НазваниеСтрокаНаименоваине скидки
ВремяИзмененияДата и Время

гггг-ММ-дд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 до 7)
ОГРНСтрокаОГРН контрагента
БИКСтрокаБИК контрагента
РасчетныйСчетСтрокаР/счет контрагента
АдресЭлектроннойПочтыСтрокаE-mail
СтранаСтрокаНазвание страны
ГородСтрокаНазвание города
АдресСтрокаАдрес

Пример:

<Контрагенты>
<ВремяИзменения />
<Ссылка>c44b90df-2b0a-11eb-82c3-0cc47aa9a551</Ссылка>
<ИНН>6542764254</ИНН>
<КПП>391444493</КПП>
<Телефон />
<Наименование>Орбита</Наименование>
<Договор />
<ОсновнойМенеджер>386d13ce-79c1-11e6-8129-0cc47aa9a551</ОсновнойМенеджер>
<ДниДоставки>1;2;3;4;5;6;7</ДниДоставки>
<ОГРН>0987654321</ОГРН>
<БИК>041012715</БИК>
<РасчетныйСчет>12345678901234567890</РасчетныйСчет>
<АдресЭлектроннойПочты>QQ@mail.ru</АдресЭлектроннойПочты>
<Страна>Россия</Страна>
<Город>Москва</Город>
<Адрес>Адрес в москве</Адрес>
</Контрагенты>

Таблица "Товары"


В приходящем пакете таблица идентична исходящему: 

Таблица "Товары" входит в состав Заказа Покупателя и состоит из таблиц строк товаров, из их множества, таблица Строки Товара выглядит следующим образом:

Внутренний тегФорматЗначение
Номенклатурагуид 1Сгуид номенклатуры
ХарактеристикаНоменклатурыгуид 1Сгуид характеристики номенклатуры
Количествочислоколичество товара в заказе
ЕдиницаИзмерениягуид 1Сгуид единицы измерения
Суммачислосумма по позиции
СтавкаНДСчислоставка НДС (символ % -не ставится)
СуммаНДСчислосумма НДС по позиции
Ценачислоцена позиции
Размещениегуид 1Сгуид склада
ПроцентСкидкичислоСумма всех скидок по позиции (символ % -не ставится)

Ставка НДС может не передаваться, если это отключено в настройках сайта.

Пример:

<Товары>
<Строка>
<Номенклатура>9f09a9c9-701b-11e2-beac-00155d002500</Номенклатура>
<ХарактеристикаНоменклатуры/>
<Количество>1.0</Количество>
<ЕдиницаИзмерения>9f09a9cb-701b-11e2-beac-00155d002500</ЕдиницаИзмерения>
<Сумма>60231.00</Сумма>
<СтавкаНДС/>
<СуммаНДС/>
<Цена>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

Наименование

Строка

ФИО Менеджера

Телефон

Строка

Телефон

Почта

Строка

E-mail

Подразделение

гуид 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</ЭлектроннаяПочта>
</ПользователиАгоры>

Порядок выгрузки

Во избежание возникновения ошибок должен соблюдаться следующие порядок выгрузки:

  • Менеджер.
  • Контрагент.
  • ДоговорыКонтрагента.
  • ПользователиАгоры.