XML для импорта информации в базу от Участников РАЭК

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

Импорт со страницы http://catalog.raec.su/product/import/index временно отключен.

Общие требования к XML-файлу

  1. Стандарт XML учитывает порядок следования элементов, поэтому важно соблюдать его в соответствии с шаблоном company_products.dtd и примером company_products.xml. Это требование продиктовано стандартом XML DTD.

  2. Стандарт XML не допускает использования в текстовых данных непечатаемых символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки). Это требует обязательной замены некоторых символов на эквивалентные им символьные коды:

    Символ в текстеКод для XML-файла
    ""
    &&
    >>
    <&lt;
    '&apos;
  3. Допустимые кодировки — UTF-8.

Описания элементов

XML header

Заголовок документа (XML header)

Это стандартный XML-заголовок со ссылкой на файл описания формата. Заголовок должен начинаться с первой строки, с нулевого символа.

Вторая строка заголовка XML-документа определяет ссылку на файл описания формата данных (XML DTD). Здесь достаточно указать только имя файла company_products.dtd, путь указывать не нужно.

Пример:

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE raec_catalog SYSTEM "company_products.dtd">

<raec_catalog>

Любой XML-документ может содержать только один корневой элемент. Формат RAEC в качестве корневого использует элемент <raec_catalog>. Атрибут date элемента <raec_catalog> должен соответствовать дате и времени генерации XML-файла на стороне участника RAEC. Дата должна иметь формат YYYY-MM-DD hh:mm.

<company>

Элемент <company> содержит описание компании и её товарных предложений.

<offers>

В элементе <offers> содержится список товарных предложений компании. Каждое товарное предложение описывается отдельным элементом <offer>.

<raecId>

Элемент <raecId> содержит ID товара в базе RAEC. Товар может идентифицироваться с использование элемента <raecId> или с использованием пары элементов <supplierId> и <brandName>.

<supplierId>

Элемент <supplierId> содержит код поставщика товара.

<brandName>

Элемент <brandName> содержит название бренда, полное или краткое.

<article>

Элемент <article> содержит артикул товара, используемый в данной компании. Атрибут <status> элемента <article> должен соответствовать складскому статусу. Возможные значения: Z,D,S.

<externalLink>

Элемент <externalLink> может содержать внешнюю ссылку на товар на сайте участника