Общая информация
Список участников
Новости
Описание стандарта
Соглашение
Контакты
Поиск по сайту



Описание XML-схемы обмена коммерческой информацией

Введение

Данный документ описывает XML-схему обмена коммерческой информацией (версия 1.0) между торговыми системами. Эта XML-схема разработана совместно фирмами "1С" и Extra.RU при методологической поддержке специалистов представительства Microsoft в Москве. Схема не претендует на законченный стандарт, планируется ее дальнейшее развитие и совершенствование.

Предусматривается использование данной схемы, в частности, для обмена:

  • каталогами товаров;

  • коммерческими предложениями;

  • документами.

Формирование коммерческих предложений по каталогу

Предложение практически совпадает с одной строкой "обычного" прайс-листа. Предлагается такой-то товар по такой-то цене, имеющийся в наличии в таком-то количестве. Например, сахарный песок по цене 100 рублей за мешок, на складе имеется 125 мешков. Предложения группируются в Пакет предложений, в котором задается общая часть всех предложений (аналог "шапки" прайс-листа).

Для того чтобы получатели предложений могли понять, какой товар предлагается, последний должен быть описан. Описание товара и его классификация "складываются" в Каталог. Каталог может быть "внутренним", т.е. вложенным в тот же документ, что и пакет предложений, и составленным непосредственно автором пакета предложений. Он также может быть "внешним" – составленным одной из известных фирм. В этом случае в пакете предложений оговаривается, на какой каталог (классификатор) он ориентирован. Для однозначного определения товара в последнем случае достаточно ссылки (идентификатора товара во внешнем каталоге), т.е. в тот же документ, что и пакет предложений, каталог товаров можно вообще не включать. Таким образом, каталог товаров можно рассматривать как некий классификатор. Следовательно, в каталоге должен быть оговорен список Свойств (по каким критериям производится классификация). Устойчивые сочетания свойств удобно фиксировать в Наборы свойств (например, "свойства видеомагнитофона", "свойства телевизора"). Для указания, какие свойства (или наборы свойств) доступны (могут быть определены, обязательно должны быть указаны) для всего каталога, для его группы или для отдельного товара, используются Ссылки на свойства (Ссылки на наборы Свойств). Каталог (классификатор) обычно создается многоуровневым (т.е. имеющим разветвленное дерево категорий (Групп), к которым можно отнести товар). Иногда однозначная классификация может вызвать затруднения, поэтому для удобства разрешается включать товары сразу в несколько категорий. Но при этом одна из них должна быть выбрана в качестве "основной". Например, радио-будильник можно отнести как к категории "Радиоприемники", так и к категории "Будильники", но в первую очередь, радио-будильник является радиоприемником. При разработке классификаторов принято для каждой позиции указывать Аналоги (например, для лекарства это – другие лекарства аналогичного действия, для запчастей – запчасти, которые можно поставить вместо данной).

Указание, какими собственно свойствами из заданных в каталоге может обладать товар (или группа), достигается с помощью Ссылки на свойство (при этом еще можно задать обязательность заполнения данного свойства). Аналогичный тип элемента создан и для набора (Ссылка на набор свойств).

Для хранения значений свойств, в том числе и дополнительной, не предусмотренной классификатором информации, служит специальный тип элемента ЗначениеСвойства.

В итоге, для опубликования своего прайс-листа (составления своего пакета предложений) надо сделать следующее:

  1. Классифицировать свои товары
    Это можно сделать

    1. или путем составления собственного классификатора, для чего нужно:

      1. составить список свойств, по которым будет производится классификация,

      2. объединить устойчивые сочетания свойств в наборы свойств,

      3. составить иерархический список категорий (групп),

      4. отнести каждый товар к одной или нескольким категориям,

      5. определить для каждого товара его аналоги;

    2. или путем нахождения своих товаров во внешнем классификаторе;

      1. если некоторые товары не найдены во внешнем классификаторе, то для них (и только для них!) придется составлять внутренний классификатор.

  2. Отправить пакет предложений.

    1. Если при составлении пакета предложений оказалось достаточно внешнего классификатора, то отправленный файл будет содержать только пакет предложений.

    2. Если для составления пакета (всего или его части) понадобился внутренний классификатор, то в отправляемый файл придется включить внутренний классификатор.

Обмен документами

В задачу, решаемую с помощью данной схемы, не входит обмен произвольными документами. Также не входят задачи поддержки распределенной базы данных. Схема описывает документы, сопровождающие наиболее распространенные торговые (хозяйственные) операции:

    • Заказ товара;

    • Cчет на оплату;

    • Отпуск товара;

    • Счет-фактура;

    • Возврат товара;

    • Передача товара на реализацию;

    • Возврат товара с реализации;

    • Отчет о продажах комиссионного товара;

    • Выплата наличных денег;

    • Возврат наличных денег;

    • Выплата безналичных денег;

    • Возврат безналичных денег.

Причем для предприятий (фирм) – отправителя и получателя XML-документа – указанные хозяйственные операции представляются разными документами. Например "Отпуск товара" для отправителя сопровождается оформлением "расходной накладной" ("накладной на отпуск товара"), а для получателя – оформлением "приходной накладной". Программа автоматизации учета может, исходя из вида хозяйственной операции и роли, которая указана для данного предприятия, "понять", является ли "собственное предприятие" (от лица которого автоматизируется учет в программе) получателем данного документа. Роли предусмотрены следующие:

    • Продавец;

    • Покупатель;

    • Плательщик;

    • Получатель.

Например, если в обрабатываемом XML-документе, описывающем "Отпуск товара" роль "собственного предприятия" обозначена как "Покупатель", то это означает, что XML-документ описывает расходную накладную поставщика, и ее следует импортировать в учетную систему как "накладную на поступление товара".

Соглашения

Обозначения:

  • "0-1" - атрибут или элемент не обязателен. Может принимать только одно значение;
  • "1-1" - атрибут или элемент обязателен. Может принимать только одно значение;
  • "0-*" - атрибут или элемент не обязателен. Может содержать список значений;
  • "1-*" - атрибут или элемент обязателен. Может содержать список значений.

По умолчанию – все атрибуты и элементы являются не обязательными и имеют тип "строка", если специально не оговорено другое.

КоммерческаяИнформация (CommerceInfo)

Описание: Корневой элемент XML-документа, описывающего каталог (каталоги) товаров, список (списки) предложений. Содержит один или несколько каталогов товаров, включая список возможных свойств товаров в каталоге, один или несколько пакетов предложений.

Атрибуты:

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

Тип

Описание

Комментарий

Комментарий (Comment)

  

Предназначен для передачи "сопроводительной записки" в виде произвольной текстовой информации по документу.

0-1

Содержит: Каталог (0-*), ПакетПредложений (0-*), Контрагент (0-*), Документ (0-*), Банк (0-*), Склад (0-*).

Каталог (Catalog)

Описание: Каталог товаров служит для "классификации" товаров. Может составляться разными предприятиями (например, классификация товаров "по 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-*).

Контрагент (Company)

Описание: Под контрагентом понимается "участник процесса". Т.е. отправитель и (или) получатель каталогов, предложений товаров, документов. Это может быть торговое предприятие, фирма, частное лицо.

Содержит списки расчетных (банковских) счетов, складов, контактов, и значения дополнительных свойств.

Атрибуты:

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

Тип

Описание

Комментарий

Идентификатор (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-*).

РасчетныйСчет (BankAccount)

Описание: Расчетный счет описывает банковский счет контрагента в объеме, необходимом для оформления (и передачи) документов.

Атрибуты:

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

Тип

Описание

Комментарий

НомерСчета (AccountNumber)

  

Номер счета.

1-1

Банк (Bank)

Idref

Банк, в котором открыт счет.

1-1

БанкКорреспондент (CorrespondentBank)

Idref

Банк-корреспондент, в случае не прямых расчетов.

0-1

Комментарий (Comment)

  

Произвольный сопроводительный текст.

0-1

Содержит: ДополнительныйРеквизит (0-*).

Банк (Bank)

Описание: Содержит информацию о банке в объеме, необходимом для оформления (и передачи) документов.

Атрибуты:

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

Тип

Описание

Комментарий

Идентификатор (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-*).

Склад (Storage)

Описание: Содержит информацию о складе в объеме, необходимом для оформления (и передачи) документов.

Атрибуты:

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

Тип

Описание

Комментарий

Идентификатор (Id)

GUID

Идентификатор.

1-1

Наименование (Name)

  

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

1-1

Адрес (Address)

  

Индекс, почтовый адрес.

0-1

ОсновнойКонтакт (BaseContact)

IdRef

Ссылка на основной вариант контакта со складом контрагентом (т.е. как и где его найти).

0-1

Комментарий (Comment)

  

Произвольный сопроводительный текст.

0-1

Содержит: Контакт (0-*), ДополнительныйРеквизит (0-*).

Контакт (Contact)

Описание: Контакт предназначен для ответа на вопросы: "Где найти?" и "Кого спросить?".

Содержит список ФИО контактных лиц (например, список сотрудников отдела продаж), список телефонов, факсов, адресов электронной почты контакта, ICQ.

Атрибуты:

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

Тип

Описание

Комментарий

Идентификатор (Id)

Id

Уникален в рамках всего документа.

1-1

Наименование (Name)

  

Наименование (например: "Домашний телефон директора").

1-1

Комментарий (Comment)

  

Произвольный сопроводительный текст (например, как доехать на автомобиле).

0-1

Содержит: КонтактноеЛицо (0-*), Телефон (0-*), Факс (0-*), Почта (0-*), ICQ (0-*).

КонтактноеЛицо (ContactMan)

Описание: ФИО контактного лица. Представляет собой текстовую строку.

Телефон (Telephone)

Описание: Телефон контакта. Представляет собой текстовую строку.

Факс (Fax)

Описание: Факс контакта. Представляет собой текстовую строку.

Почта (E-mail)

Описание: Адрес электронной почты контакта. Представляет собой текстовую строку.

ICQ (ICQ)

Описание: Адрес в ICQ контакта. Представляет собой текстовую строку.

ДополнительныйРеквизит (AdditionalFeature)

Описание: Предназначен для задания дополнительных реквизитов элементов (документов и справочников).

Атрибуты:

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

Тип

Описание

Комментарий

Наименование (Name)

  

Наименование реквизита.

1-1

Значение (Value)

  

Значение реквизита.

1-1

Содержит: –

НаборСвойств (Profile)

Описание: Определяет набор (устойчивых сочетаний) свойств в данном каталоге. Содержит ссылки на наборы свойств и свойства, с указанием, какие из них являются обязательными.

Атрибуты:

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

Тип

Описание

Комментарий

Идентификатор (Id)

 

Идентификатор набора свойств. Уникален в рамках каталога.

1-1

Наименование (Name)

  

Наименование набора свойств.

1-1

Содержит: СсылкаНаСвойство (1-*), СсылкаНаНаборСвойств (0-*).

СсылкаНаНаборСвойств (ProfileReference)

Описание: Определяет наличие и обязательность задания того или иного набора свойств.

Атрибуты:

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

Тип

Описание

Комментарий

ИдентификаторКаталога (CatalogID)

GUID

Идентификатор каталога, содержащего набор свойств.

1-1

ИдентификаторНабора (ProfileId)

  

Идентификатор набора.

1-1

Обязательно (Required)

Boolean

Признак обязательности. По умолчанию – “N”.

0-1

ЗаполняетсяПродавцом (SellersSign)

Boolean

Дополнительный признак, поясняющий, что данный набор свойств заполняется продавцом в момент формирования предложения. По умолчанию – “N”.

0-1

Содержит: –

Свойство (Property)

Описание: Определяет одно из свойств, которым может в принципе обладать товар в данном каталоге, в том числе значение по умолчанию. Содержит списки возможных значений перечислений (для задания типов “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-*).

СсылкаНаСвойство (PropertyReference)

Описание: Определяет обязательность задания того или иного свойства.

Атрибуты:

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

Тип

Описание

Комментарий

ИдентификаторКаталога (CatalogID)

GUID

Идентификатор каталога, содержащего свойство.

1-1

ИдентификаторСвойства (PropertyId)

  

Идентификатор свойства.

1-1

Обязательно (Required)

Boolean

Признак обязательности свойства. По умолчанию “N”.

0-1

ЗаполняетсяПродавцом (SellersSign)

Boolean

Дополнительный признак, поясняющий, что данное свойство заполняется продавцом в момент формирования предложения. По умолчанию – “N”.

0-1

Содержит: –

ВариантСвойства (PropertyVariant)

Описание: Служит для задания значений перечислений.

Атрибуты:

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

Тип

Описание

Комментарий

Идентификатор (Id)

 

Идентификатор элемента перечисления. Уникально в пределах свойства.

1-1

Наименование (Name)

  

Название варианта значения свойства.

1-1

Содержит: –

Товар (Product)

Описание: Товар в каталоге характеризуется списком наборов свойств, которыми он может обладать (это определяется через задание ссылок на свойства и наборы свойств), базовой единицей измерения (в которой измеряются остальные единицы измерения, например, в пачке 10 штук). Товар может относиться к нескольким категориям (группам), но одна из групп выделяется и называется базовой. Товар может иметь аналоги (например, аналоги для лекарств и запчастей).

При определении того, какими же свойствами может обладать товар в каталоге (и какие из них являются обязательными для указания) учитываются, кроме свойств самого товара, свойства всех его родителей вплоть до каталога. Содержит "базовую" единицу измерения товара, относительно которой рассчитываются все остальные единицы (шт, ящ, кг), список для задания дополнительных значений свойств, список аналогов, список ссылок на свойства и наборы свойств, список групп, в которые входит данный товар.

Атрибуты:

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

Тип

Описание

Комментарий

Идентификатор (Id)

Id

Уникален в рамках всего документа.

1-1

ИдентификаторВКаталоге (IdInCatalog)

  

Идентификатор товара в каталоге. Уникален в пределах каталога. Способ генерации идентификатора товара может зависеть от каталога, например, это может быть уникальный номер товара в каталоге, а может быть GUID.

1-1

Наименование (Name)

  

Наименование товара.

1-1

Родитель (ParentCategory)

Idref

Идентификатор основной ("базовой") группы товара. Если не указан, то товар относится к корневой группе каталога.

0-1

Единица (Unit)

  

Краткое наименование единицы измерения товара.

0-1

Содержит: ЗначениеСвойства (0-*), Аналог (0-*), СсылкаНаНаборСвойств (0-*), СсылкаНаСвойство (0-*), СсылкаНаГруппу (0-*).

Группа (Category)

Описание: Группа (категория) обладает (характеризуется) практически теми же возможностями, что и "товар". За исключением того, что единица указывает на значение по умолчанию, группа не имеет аналогов.

Атрибуты:

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

Тип

Описание

Комментарий

Идентификатор (Id)

Id

Уникален в рамках всего документа.

1-1

ИдентификаторВКаталоге (IdInCatalog)

  

Идентификатор в каталоге Уникален в пределах каталога. Способ генерации идентификатора товара может зависеть от каталога, например, это может быть уникальный номер товара в каталоге, а может быть GUID.

1-1

Наименование (Name)

  

Наименование группы.

1-1

Родитель (ParentCategory)

Idref

Идентификатор группы, к которой принадлежит данная группа.

0-1

Единица (Unit)

  

Краткое наименование единицы измерения по умолчанию.

0-1

Содержит: ЗначениеСвойства (0-*), СсылкаНаНаборСвойств (0-*), СсылкаНаСвойство (0-*),
СсылкаНаГруппу (0-*).

СсылкаНаГруппу (CategoryReference)

Описание: Определяет ссылку на группу определенного каталога.

Атрибуты:

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

Тип

Описание

Комментарий

ИдентификаторКаталога (CatalogID)

GUID

Идентификатор каталога, содержащего группу.

1-1

ИдентификаторВКаталоге (IdInCatalog)

  

Идентификатор группы в указанном каталоге.

1-1

Содержит: –

СсылкаНаТовар (ProductReference)

Описание: Определяет ссылку на товар определенного каталога.

Атрибуты:

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

Тип

Описание

Комментарий

ИдентификаторКаталога (CatalogID)

GUID

Идентификатор каталога, содержащего товар.

1-1

ИдентификаторВКаталоге (IdInCatalog)

  

Идентификатор товара в указанном каталоге.

1-1

Содержит: –

Аналог (Relationship)

Описание: Определяет аналог товара, т.е. устанавливает соответствие между одним товаром и другим товаром. Содержит ссылку на товар (обязателен).

Атрибуты:

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

Тип

Описание

Комментарий

Описание (Description)

  

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

0-1

Сайт (WWW)

  

Адрес (URL) по которому можно найти дополнительную информацию.

0-1

Содержит: СсылкаНаТовар (1-1).

ПакетПредложений (OffersList)

Описание: Определяет общие свойства выдвигаемых предложений товара. Период действия, в какой валюте составлен (валюта по умолчанию, может быть изменена для конкретного предложения), какой классификатор (каталог) используется для идентификации товаров и т.д. Содержит: валюту цены по умолчанию (может быть переопределено для конкретного предложения), собственно предложения и поля для задания значений.

Атрибуты:

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

Тип

Описание

Комментарий

ИдентификаторКаталога (CatalogID)

GUID

Идентификатор каталога, по которому производится классификация товаров. Используется как значение по умолчанию для конкретного предложения, в списке м.б. изменен.

1-1

Владелец (Owner)

GUID

Идентификатор контрагента, автора данного пакета предложений.

1-1

ДействительноС (StartDate)

Date

Дата начала периода действия предложения.

0-1

ДействительноДо (EndDate)

Date

Дата окончания периода действия предложения.

0-1

Описание (Description)

  

Произвольное описание списка предложений (например, особые условия поставки).

0-1

Валюта (Currency)

  

Краткое наименование валюты.

0-1

Содержит: Предложение (0-*), ЗначениеСвойства (0-*).

Предложение (Offer)

Описание: Определяет выдвигаемое предложение товара (фирма предлагает такой-то товар, в таком-то количестве, по такой-то цене). Предполагается, что разбиение по группам будет производиться в соответствии с указанным каталогом (классификатором). В свойствах задаются дополнительные условия (например, условия поставки товара).

Содержит единицу измерения данного товара в предложении (например, 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-*).

ЗначениеСвойства (PropertyValue)

Описание: Определяет наименование поля и его значение

Атрибуты:

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

Тип

Описание

Комментарий

ИдентификаторКаталога (CatalogID)

GUID

Идентификатор каталога, задающего свойство.

1-1

ИдентификаторСвойства (PropertyId)

 

Идентификатор свойства.

1-1

Значение (Value)

  

Значение свойства.

1-1

Содержит: –

Документ (Document)

Описание: Определяет набор свойств документа.

Содержит списки позиций документа (состав), список дополнительных (накладных) расходов, суммы налогов, значения дополнительных свойств документа.

Атрибуты:

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

Тип

Описание

Комментарий

ХозОперация (Operation)

  

Определяет вид хозяйственной операции, производимой данным документом. Представляет собой перечисление со следующими возможными значениями:

  • Заказ товара (Order);
    •
  • Cчет на оплату (PayableBill);
  • Отпуск товара (Sale);
  • Счет-фактура (Invoice)
  • Возврат товара (BackSale);
  • Передача товара на реализацию (Comission);
  • Возврат товара с реализации (BackComission);
  • Отчет о продажах комиссионного товара (ReportComission);
  • Выплата наличных денег (Cash);
  • Возврат наличных денег (BackCash);
  • Выплата безналичных денег (Payment);
  • Возврат безналичных денег (BackPayment).

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-*).

Предприятие в документе (CompanyInDocument)

Описание: Определяет одно из предприятий (собственную фирму или контрагента) - действующих лиц документа.

Содержит списки позиций документа (состав), список дополнительных (накладных) расходов, суммы налогов, значения дополнительных свойств документа.

Атрибуты:

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

Тип

Описание

Комментарий

Роль(Role)

  

Определяет роль предприятия (фирмы или контрагента), которую оно играет в документе. Представляет собой перечисление со следующими значениями:

  • Продавец (Saler);
  • Покупатель (Buyer);
  • Плательщик (Payer);
  • Получатель (Recipient).

1-1

Контрагент(Company)

GUID

Идентификатор контрагента – действующего лица документа.

1-1

Расчетный счет(BankAccount)

  

Ссылка на один из расчетных счетов контрагента.

0-1

Склад(Storage)

  

Идентификатор одного из складов контрагента.

0-1

Контакт(Contact)

  

Ссылка на один из контактов (сотрудников).

0-1

Содержит: –

ТоварнаяПозиция (Article)

Описание: Определяет информацию о товарной позиции (строке документа) в объеме, необходимом для оформления (и передачи) документов. Содержит, список дополнительных (накладных) расходов, суммы налогов, значения дополнительных свойств позиции.

Атрибуты:

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

Тип

Описание

Комментарий

Каталог(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-*).

СуммаНалога (TaxSum)

Описание: Определяет информацию о сумме налога.

Атрибуты:

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

Тип

Описание

Комментарий

Налог (Tax)

  

Представляет собой перечисление со следующими значениями:

  • НДС (AVT);
  • НП (ST);
  • НГСМ (OT);
  • Акциз (Excise).

1-1

Ставка (TaxRate)

Number

Ставка налога.

1-1

Сумма (Sum)

Money

Сумма налога в валюте документа.

1-1

ВключенВсумму (IncludedInSum)

Boolean

Флаг, показывающий, что налог включен в сумму. По умолчанию – не включен.

0-1

Содержит: –

Дополнительный Расход денег (AdditionalExpense)

Описание: Определяет дополнительные расходы по документу в целом или по отдельной товарной позиции.

Атрибуты:

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

Тип

Описание

Комментарий

Сумма (Sum)

Money

Сумма дополнительного расхода в валюте документа.

1-1

Комментарий (Comment)

  

Текстовое описание дополнительного расхода.

0-1

Содержит: –