Исходящий 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) |
ОГРН | Строка | ОГРН контрагента |
БИК | Строка | БИК контрагента |
РасчетныйСчет | Строка | Р/счет контрагента |
АдресЭлектроннойПочты | Строка | |
Страна | Строка | Название страны |
Город | Строка | Название города |
Адрес | Строка | Адрес |
Пример:
<Контрагенты>
<ВремяИзменения />
<Ссылка>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</Сумма>
<СтавкаНДС/>
<СуммаНДС/>
<Размещение>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</АгораВход>
</Менеджер>
Таблица "Контрагенты"
Используется таблица, представленная в разделе Таблица "Контрагенты".
Таблица "Договоры контрагентов"
Используется таблица, представленная в разделе Таблица "Договоры Контрагентов".
Таблица "Пользователи Агоры"
На основании этой таблицы создадутся пользователи для входа под контрагентом.
Внутренний тег | Формат | Значение |
---|---|---|
ВремяИзменения | Дата и Время | гггг-ММ-дд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</ЭлектроннаяПочта>
</ПользователиАгоры>
Порядок выгрузки
Во избежание возникновения ошибок должен соблюдаться следующие порядок выгрузки:
- Менеджер.
- Контрагент.
- ДоговорыКонтрагента.
- ПользователиАгоры.