Предложение практически совпадает с одной строкой «обычного» прайс-листа. Предлагается такой-то товар по такой-то цене, имеющийся в наличии в таком-то количестве. Например, сахарный песок по цене 100 рублей за мешок, на складе имеется 125 мешков. Предложения группируются в Пакет предложений, в котором задается общая часть всех предложений (аналог «шапки» прайс-листа).
Для того чтобы получатели предложений могли понять, какой товар предлагается, последний должен быть описан. Описание товара и его классификация «складываются» в Каталог. Каталог может быть «внутренним», т. е. вложенным в тот же документ, что и пакет предложений, и составленным непосредственно автором пакета предложений. Он также может быть «внешним» — составленным одной из известных фирм. В этом случае в пакете предложений оговаривается, на какой каталог (классификатор) он ориентирован.
Для однозначного определения товара в последнем случае достаточно ссылки (идентификатора товара во внешнем каталоге), т. е. в тот же документ, что и пакет предложений, каталог товаров можно вообще не включать. Таким образом, каталог товаров можно рассматривать как некий классификатор. Следовательно, в каталоге должен быть оговорен список Свойств (по каким критериям производится классификация). Устойчивые сочетания свойств удобно фиксировать в Наборы свойств (например, «свойства видеомагнитофона», «свойства телевизора»). Для указания, какие свойства (или наборы свойств) доступны (могут быть определены, обязательно должны быть указаны) для всего каталога, для его группы или для отдельного товара, используются Ссылки на свойства (Ссылки на наборы Свойств).
Каталог (классификатор) обычно создается многоуровневым (т.е. имеющим разветвленное дерево категорий (Групп), к которым можно отнести товар). Иногда однозначная классификация может вызвать затруднения, поэтому для удобства разрешается включать товары сразу в несколько категорий. Но при этом одна из них должна быть выбрана в качестве «основной».
Например, радио-будильник можно отнести как к категории «Радиоприемники», так и к категории «Будильники», но в первую очередь, радио-будильник является радиоприемником. При разработке классификаторов принято для каждой позиции указывать Аналоги (например, для лекарства это — другие лекарства аналогичного действия, для запчастей — запчасти, которые можно поставить вместо данной).
Указание, какими собственно свойствами из заданных в каталоге может обладать товар (или группа), достигается с помощью Ссылки на свойство (при этом еще можно задать обязательность заполнения данного свойства). Аналогичный тип элемента создан и для набора (Ссылка на набор свойств).
Для хранения значений свойств, в том числе и дополнительной, не предусмотренной классификатором информации, служит специальный тип элемента ЗначениеСвойства.
Это можно сделать
Например, если в обрабатываемом XML-документе, описывающем «Отпуск товара» роль «собственного предприятия» обозначена как «Покупатель», то это означает, что XML-документ описывает расходную накладную поставщика, и ее следует импортировать в учетную систему как «накладную на поступление товара».
По умолчанию — все атрибуты и элементы являются не обязательными и имеют тип «строка», если специально не оговорено другое.
КоммерческаяИнформация (CommerceML)
Описание: Корневой элемент XML-документа, описывающего каталог (каталоги) товаров, список (списки) предложений. Содержит один или несколько каталогов товаров, включая список возможных свойств товаров в каталоге, один или несколько пакетов предложений.
Атрибуты:
Наименование | Описание | Комментарий |
---|---|---|
Комментарий (Comment) | Предназначен для передачи «сопроводительной записки» в виде произвольной текстовой информации по документу. | 0-1 |
Содержит: Каталог (0-*), ПакетПредложений (0-*), Контрагент (0-*), Документ (0-*), Банк (0-*), Склад (0-*).
Описание: Каталог товаров служит для «классификации» товаров. Может составляться разными предприятиями (например, классификация товаров «по 1С»). Определяется уникальным идентификатором каталога (для этой цели предлагается использовать GUID), чтобы можно было различать каталоги, составленные разными организациями. Содержит единицу измерения товаров в каталоге по умолчанию (Рекомендуется при задании единиц измерения придерживаться ОКЕИ), список самих товаров и их групп (категорий), список возможных свойств и наборов свойств товаров данного каталога, а также списки ссылок на наборы свойств и свойства, задающие присущие для всех товаров каталога свойства.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Идентификатор (ID) | GUID | Идентификатор каталога. Должен быть уникальным во всем мире (чтобы можно было на него ссылаться). | 1-1 |
Наименование (Name) | Наименование каталога (например: классификатор товаров, составленный фирмой «1С»). | 1-1 | |
Владелец (Owner) | GUID | Идентификатор контрагента — владельца данного каталога. | 1-1 |
Описание (Description) | Произвольное описание каталога (например, содержащее особые условия использования). | 0-1 | |
Единица (Unit) | Краткое наименование единицы измерения по умолчанию. | 0-1 |
Содержит: Группа (0-*), Товар (0-*), Свойство (0-*), НаборСвойств (0-*), СсылкаНаНаборСвойств (0-*), СсылкаНаСвойство (0-*).
Описание: Под контрагентом понимается «участник процесса». Т.е. отправитель и (или) получатель каталогов, предложений товаров, документов. Это может быть торговое предприятие, фирма, частное лицо.
Содержит списки расчетных (банковских) счетов, складов, контактов, и значения дополнительных свойств.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Идентификатор (ID) | GUID | Идентификатор контрагента. Это может быть GUID, ИНН или нечто уникальное, по чему можно было бы различать контрагентов. | 1-1 |
Наименование (Name) | Полное наименование контрагента (например: «АОЗТ 1С»). | 1-1 | |
ОтображаемоеНаименование (DisplayName) | Отображаемое (краткое) наименование контрагента (например: «1С»). | 1-1 | |
Адрес (Address) | Почтовый (фактический) адрес. | 0-1 | |
ЮридическийАдрес (JuridicAddress) | Юридический адрес. | 0-1 | |
ОсновнойКонтакт (BaseContact) | IdRef | Ссылка на основной вариант контакта с контрагентом (т.е. как и где его найти). | 0-1 |
Сайт (WWW) | Адрес сайта. | 0-1 | |
Комментарий (Comment) | Произвольный сопроводительный текст. | 0-1 |
Содержит: РасчетныйСчет (0-*), Контакт (0-*), ДополнительныйРеквизит (0-*).
Описание: Расчетный счет описывает банковский счет контрагента в объеме, необходимом для оформления (и передачи) документов.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
НомерСчета (AccountNumber) | Номер счета. | 1-1 | |
Банк (Bank) | Idref | Банк, в котором открыт счет. | 1-1 |
БанкКорреспондент (CorrespondentBank) | Idref | Банк-корреспондент, в случае не прямых расчетов. | 0-1 |
Комментарий (Comment) | Произвольный сопроводительный текст. | 0-1 |
Содержит: ДополнительныйРеквизит (0-*).
Описание: Содержит информацию о банке в объеме, необходимом для оформления (и передачи) документов.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Идентификатор (ID) | ID | Идентификатор. | 1-1 |
Наименование (Name) | Наименование банка. | 1-1 | |
Местонахождение (Location) | Местонахождение банка. | 0-1 | |
БИК (BIC) | БИК. | 0-1 | |
НомерСчета (AccountNumber) | Корреспондентский счет банка. | 0-1 | |
Адрес (Address) | Индекс, почтовый адрес банка. | 0-1 | |
Телефон (Telephone) | Телефон банка. | 0-1 | |
Комментарий (Comment) | Произвольный сопроводительный текст. | 0-1 |
Содержит: ДополнительныйРеквизит (0-*).
Описание: Содержит информацию о складе в объеме, необходимом для оформления (и передачи) документов.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Идентификатор (Id) | GUID | Идентификатор. | 1-1 |
Наименование (Name) | Наименование. | 1-1 | |
Адрес (Address) | Индекс, почтовый адрес. | 0-1 | |
ОсновнойКонтакт (BaseContact) | IdRef | Ссылка на основной вариант контакта со складом контрагентом (т.е. как и где его найти). | 0-1 |
Комментарий (Comment) | Произвольный сопроводительный текст. | 0-1 |
Содержит: Контакт (0-*), ДополнительныйРеквизит (0-*).
Описание: Контакт предназначен для ответа на вопросы: «Где найти?» и «Кого спросить?».
Содержит список ФИО контактных лиц (например, список сотрудников отдела продаж), список телефонов, факсов, адресов электронной почты контакта, ICQ.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Идентификатор (Id) | Id | Уникален в рамках всего документа. | 1-1 |
Наименование (Name) | Наименование (например: «Домашний телефон директора»). | 1-1 | |
Комментарий (Comment) | Произвольный сопроводительный текст (например, как доехать на автомобиле). | 0-1 |
Содержит: КонтактноеЛицо (0-*), Телефон (0-*), Факс (0-*), Почта (0-*), ICQ (0-*).
Описание: ФИО контактного лица. Представляет собой текстовую строку.
Описание: Телефон контакта. Представляет собой текстовую строку.
Описание: Факс контакта. Представляет собой текстовую строку.
Описание: Адрес электронной почты контакта. Представляет собой текстовую строку.
Описание: Адрес в ICQ контакта. Представляет собой текстовую строку.
Описание: Предназначен для задания дополнительных реквизитов элементов (документов и справочников).
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Наименование (Name) | Наименование реквизита. | 1-1 | |
Значение (Value) | Значение реквизита. | 1-1 |
Содержит: –
Описание: Определяет набор (устойчивых сочетаний) свойств в данном каталоге. Содержит ссылки на наборы свойств и свойства, с указанием, какие из них являются обязательными.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Идентификатор (Id) | Идентификатор набора свойств. Уникален в рамках каталога. | 1-1 | |
Наименование (Name) | Наименование набора свойств. | 1-1 |
Содержит: СсылкаНаСвойство (1-*), СсылкаНаНаборСвойств (0-*).
Описание: Определяет наличие и обязательность задания того или иного набора свойств.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
ИдентификаторКаталога (CatalogID) | GUID | Идентификатор каталога, содержащего набор свойств. | 1-1 |
ИдентификаторНабора (ProfileId) | Идентификатор набора. | 1-1 | |
Обязательно (Required) | Boolean | Признак обязательности. По умолчанию — «N». | 0-1 |
ЗаполняетсяПродавцом (SellersSign) | Boolean | Дополнительный признак, поясняющий, что данный набор свойств заполняется продавцом в момент формирования предложения. По умолчанию — «N». | 0-1 |
Содержит: –
Описание: Определяет одно из свойств, которым может в принципе обладать товар в данном каталоге, в том числе значение по умолчанию. Содержит списки возможных значений перечислений (для задания типов «enumeration»).
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Идентификатор (Id) | Идентификатор свойства. Уникален в рамках каталога. | 1-1 | |
Наименование (Name) | Наименование свойства. | 1-1 | |
ТипДанных (DataType) | Одно из: «string» «number» «datetime» «money» «enumeration» «float» «filename». По умолчанию — «string». | 1-1 | |
Отображается (DisplayOnSite) | Boolean | Признак, разрешающий показ свойства на сайте. По умолчанию «Y». | 0-1 |
Множественность (Multiple) | Boolean | Признак, разрешающий свойству иметь несколько значений. По умолчанию «N». | 0-1 |
МинимальноеЗначение (MinimalValue) | Минимально-допустимое значение (число, для строк — длина строки). | 0-1 | |
МаксимальноеЗначение (MaximalValue) | Максимально-допустимое значение (число, для строк — длина строки). | 0-1 | |
ЗначениеПоУмолчанию (DefaultValue) | Значение по умолчанию (тип совпадает с типом самого свойства). | 0-1 |
Содержит: ВариантСвойства (0-*).
Описание: Определяет обязательность задания того или иного свойства.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
ИдентификаторКаталога (CatalogID) | GUID | Идентификатор каталога, содержащего свойство. | 1-1 |
ИдентификаторСвойства (PropertyId) | Идентификатор свойства. | 1-1 | |
Обязательно (Required) | Boolean | Признак обязательности свойства. По умолчанию «N». | 0-1 |
ЗаполняетсяПродавцом (SellersSign) | Boolean | Дополнительный признак, поясняющий, что данное свойство заполняется продавцом в момент формирования предложения. По умолчанию — «N». | 0-1 |
Содержит: –
Описание: Служит для задания значений перечислений.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Идентификатор (Id) | Идентификатор элемента перечисления. Уникально в пределах свойства. | 1-1 | |
Наименование (Name) | Название варианта значения свойства. | 1-1 |
Содержит: –
Описание: Товар в каталоге характеризуется списком наборов свойств, которыми он может обладать (это определяется через задание ссылок на свойства и наборы свойств), базовой единицей измерения (в которой измеряются остальные единицы измерения, например, в пачке 10 штук). Товар может относиться к нескольким категориям (группам), но одна из групп выделяется и называется базовой. Товар может иметь аналоги (например, аналоги для лекарств и запчастей).
При определении того, какими же свойствами может обладать товар в каталоге (и какие из них являются обязательными для указания) учитываются, кроме свойств самого товара, свойства всех его родителей вплоть до каталога. Содержит «базовую» единицу измерения товара, относительно которой рассчитываются все остальные единицы (шт, ящ, кг), список для задания дополнительных значений свойств, список аналогов, список ссылок на свойства и наборы свойств, список групп, в которые входит данный товар.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Идентификатор (Id) | Id | Уникален в рамках всего документа. | 1-1 |
ИдентификаторВКаталоге (IdInCatalog) | Идентификатор товара в каталоге. Уникален в пределах каталога. Способ генерации идентификатора товара может зависеть от каталога, например, это может быть уникальный номер товара в каталоге, а может быть GUID. | 1-1 | |
Наименование (Name) | Наименование товара. | 1-1 | |
Родитель (ParentCategory) | Idref | Идентификатор основной («базовой») группы товара. Если не указан, то товар относится к корневой группе каталога. | 0-1 |
Единица (Unit) | Краткое наименование единицы измерения товара. | 0-1 |
Содержит: ЗначениеСвойства (0-*), Аналог (0-*), СсылкаНаНаборСвойств (0-*), СсылкаНаСвойство (0-*), СсылкаНаГруппу (0-*).
Описание: Группа (категория) обладает (характеризуется) практически теми же возможностями, что и «товар». За исключением того, что единица указывает на значение по умолчанию, группа не имеет аналогов.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Идентификатор (Id) | Id | Уникален в рамках всего документа. | 1-1 |
ИдентификаторВКаталоге (IdInCatalog) | Идентификатор в каталоге Уникален в пределах каталога. Способ генерации идентификатора товара может зависеть от каталога, например, это может быть уникальный номер товара в каталоге, а может быть GUID. | 1-1 | |
Наименование (Name) | Наименование группы. | 1-1 | |
Родитель (ParentCategory) | Idref | Идентификатор группы, к которой принадлежит данная группа. | 0-1 |
Единица (Unit) | Краткое наименование единицы измерения по умолчанию. | 0-1 |
Содержит: ЗначениеСвойства (0-*), СсылкаНаНаборСвойств (0-*), СсылкаНаСвойство (0-*), СсылкаНаГруппу (0-*).
Описание: Определяет ссылку на группу определенного каталога.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
ИдентификаторКаталога (CatalogID) | GUID | Идентификатор каталога, содержащего группу. | 1-1 |
ИдентификаторВКаталоге (IdInCatalog) | Идентификатор группы в указанном каталоге. | 1-1 |
Содержит: –
Описание: Определяет ссылку на товар определенного каталога.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
ИдентификаторКаталога (CatalogID) | GUID | Идентификатор каталога, содержащего товар. | 1-1 |
ИдентификаторВКаталоге (IdInCatalog) | Идентификатор товара в указанном каталоге. | 1-1 |
Содержит: –
Описание: Определяет аналог товара, т. е. устанавливает соответствие между одним товаром и другим товаром. Содержит ссылку на товар (обязателен).
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Описание (Description) | Произвольной описание соответствия (например, в каких случаях данный аналог может использоваться). | 0-1 | |
Сайт (WWW) | Адрес (URL) по которому можно найти дополнительную информацию. | 0-1 |
Содержит: СсылкаНаТовар (1-1).
Описание: Определяет общие свойства выдвигаемых предложений товара. Период действия, в какой валюте составлен (валюта по умолчанию, может быть изменена для конкретного предложения), какой классификатор (каталог) используется для идентификации товаров и т. д. Содержит: валюту цены по умолчанию (может быть переопределено для конкретного предложения), собственно предложения и поля для задания значений.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
ИдентификаторКаталога (CatalogID) | GUID | Идентификатор каталога, по которому производится классификация товаров. Используется как значение по умолчанию для конкретного предложения, в списке м. б. изменен. | 1-1 |
Владелец (Owner) | GUID | Идентификатор контрагента, автора данного пакета предложений. | 1-1 |
ДействительноС (StartDate) | Date | Дата начала периода действия предложения. | 0-1 |
ДействительноДо (EndDate) | Date | Дата окончания периода действия предложения. | 0-1 |
Описание (Description) | Произвольное описание списка предложений (например, особые условия поставки). | 0-1 | |
Валюта (Currency) | Краткое наименование валюты. | 0-1 |
Содержит: Предложение (0-*), ЗначениеСвойства (0-*).
Описание: Определяет выдвигаемое предложение товара (фирма предлагает такой-то товар, в таком-то количестве, по такой-то цене). Предполагается, что разбиение по группам будет производиться в соответствии с указанным каталогом (классификатором). В свойствах задаются дополнительные условия (например, условия поставки товара).
Содержит единицу измерения данного товара в предложении (например, 100 руб. за погонный метр, если не заполнен, то равен базовой единице товара), валюты цены (если не заполнено, то берется из списка предложений).
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
ИдентификаторТовара (ProductId) | Idref | Ссылка на тег товара в этом же документе. Предложение должно содержать ссылку на тег товара в этом же документе или (и) ссылку (ссылки) на товар в каком-то каталоге. | 0-1 |
Цена (Price) | Money | Величина цены. | 1-1 |
НормаУпаковки (Ratio) | Number | Коэффициент пересчета единицы измерения товара в предложении по отношению к базовой единице товара, определенной для товара в каталоге. По умолчанию — 1. | 0-1 |
Количество (Amount) | Number | Предлагаемое количество товара (складской остаток). Измеряется в указанной единице измерения. | 0-1 |
Единица (Unit) | Краткое наименование единицы измерения. | 0-1 | |
Валюта (Currency) | Краткое наименование валюты. | 0-1 |
Содержит: ЗначениеСвойства (0-*), СсылкаНаТовар (0-*).
Описание: Определяет наименование поля и его значение
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
ИдентификаторКаталога (CatalogID) | GUID | Идентификатор каталога, задающего свойство. | 1-1 |
ИдентификаторСвойства (PropertyId) | Идентификатор свойства. | 1-1 | |
Значение (Value) | Значение свойства. | 1-1 |
Содержит: –
Описание: Определяет набор свойств документа.
Содержит списки позиций документа (состав), список дополнительных (накладных) расходов, суммы налогов, значения дополнительных свойств документа.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
ХозОперация (Operation) |
Определяет вид хозяйственной операции, производимой данным документом. Представляет собой перечисление со следующими возможными значениями:
|
1-1 | |
Номер (NumberDoc) | Номер документа. | 1-1 | |
Дата (DateDoc) | Date | Дата документа. | 1-1 |
Время (TimeDoc) | Time | Время документа. | 0-1 |
СрокПлатежа (PaymentDate) | Date | Дата, до которой документ должен быть оплачен. | 0-1 |
Сумма (Sum) | Money | Общая сумма документа в указанной валюте. | 0-1 |
Комментарий (Comment) | Произвольный сопроводительный текст. | 0-1 | |
Валюта (Currency) | Валюта документа. | 0-1 | |
Курс (RateOfExchange) | Number | Курс валюты по отношению к национальной валюте (рублю). | 0-1 |
Кратность (CurrencyRatio) | Number | Кратность валюты по отношению к национальной валюте (рублю). | 0-1 |
Содержит: ПредприятиеВДокументе (1-*), ТоварнаяПозиция (0-*), ДополнительныйРасход (0-*), СуммаНалога (0-*), ДополнительныйРеквизит (0-*).
Описание: Определяет одно из предприятий (собственную фирму или контрагента) — действующих лиц документа.
Содержит списки позиций документа (состав), список дополнительных (накладных) расходов, суммы налогов, значения дополнительных свойств документа.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Роль (Role) |
Определяет роль предприятия (фирмы или контрагента), которую оно играет в документе. Представляет собой перечисление со следующими значениями:
|
1-1 | |
Контрагент (Company) | GUID | Идентификатор контрагента — действующего лица документа. | 1-1 |
Расчетный счет (BankAccount) | Ссылка на один из расчетных счетов контрагента. | 0-1 | |
Склад (Storage) | Идентификатор одного из складов контрагента. | 0-1 | |
Контакт (Contact) | Ссылка на один из контактов (сотрудников). | 0-1 |
Содержит: –
Описание: Определяет информацию о товарной позиции (строке документа) в объеме, необходимом для оформления (и передачи) документов. Содержит, список дополнительных (накладных) расходов, суммы налогов, значения дополнительных свойств позиции.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Каталог (Catalog) | GUID | Идентификатор каталога. | 1-1 |
Товар (Product) | Идентификатор товара в каталоге. | 1-1 | |
Единица (Unit) | Единица измерения товара. | 1-1 | |
Количество (Amount) | Number | Количество товара. Измеряется в указанной единице измерения. | 0-1 |
Цена (Price) | Money | Величина цены. | 0-1 |
Сумма (Sum) | Number | Сумма без налогов. | 0-1 |
Описание (Description) | Общее описание (примечание) по товарной позиции. | 0-1 | |
СтранаПроисхождения (Country) | Страна происхождения. | 0-1 | |
ГТД (GTD) | Номер ГТД. | 0-1 |
Содержит: ДополнительныйРасход (0-*), СуммаНалога (0-*), ДополнительныйРеквизит (0-*).
Описание: Определяет информацию о сумме налога.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Налог (Tax) |
Представляет собой перечисление со следующими значениями:
|
1-1 | |
Ставка (TaxRate) | Number | Ставка налога. | 1-1 |
Сумма (Sum) | Money | Сумма налога в валюте документа. | 1-1 |
ВключенВсумму (IncludedInSum) | Boolean | Флаг, показывающий, что налог включен в сумму. По умолчанию — не включен. | 0-1 |
Содержит: –
Описание: Определяет дополнительные расходы по документу в целом или по отдельной товарной позиции.
Атрибуты:
Наименование | Тип | Описание | Комментарий |
---|---|---|---|
Сумма (Sum) | Money | Сумма дополнительного расхода в валюте документа. | 1-1 |
Комментарий (Comment) | Текстовое описание дополнительного расхода. | 0-1 |
Содержит: –