有关市场上产品的信息

有两种类型的产品规格。 有些是常见的所有商店。 例如,同一产品在所有商店中命名相同,并且具有相同的重量。 其他决定销售条款的商店可能因商店而异。 例如,每个商店都有自己的送货时间表。

柜内所有商店的一般参数

重要

始终提供有关不会从更新更改为更新的产品的信息,例如您的SKU或产品名称。

市场可以禁用卖方商店,该商店定期为同一产品传输不同的参数值。

姓名(必填)

客户将在产品卡上看到该名称。

要求

产品类型和显着特征必须用俄语书写。

根据方案组成名称:类型+品牌或制造商+型号+功能,如果有的话(例如,颜色,尺寸或重量)和数量在包装中。

不要在名称中包含销售条款(例如,"折扣","免费送货"等。),情感特征("命中","超级"等。). 不要用大写字母写单词-除了品牌和型号的既定名称。

最佳长度为60-120个字符。

[建议]将帮助您创建好名字(title.md)。

示例: Ударная дрель Makita HP1630, 710 Вт

Yml中的表示

<Offer>元素内的<name>元素。

<name>Ударная дрель Makita HP1630, 710 Вт</name>

类别(必需)

您引用产品的类别。

提示

有时市场可以根据名称中的数据自动识别类别。 如果有几个,它会提供不同的选择。 从下拉列表中选择适当的类别或指定您自己的类别。

市场类别一览表

要求

在通过Excel文件、链接文件或API添加产品时,必须指定它。 类别描述必须用俄语书写。

指定特定类别—例如,最好将一组刀具分类为餐具,而不仅仅是菜肴

选择描述产品而不是抽象特征的类别-例如,最好指定香水而不是礼品

Yml中的表示

<Offer>元素内的<market_category_id>元素。

<market_category_id>743</market_category_id>

<market_category_id> 它包含类别编号,而不是其名称。

有关详细信息,请参阅YML说明.

项目编号(SKU)(必需)

系统中的产品ID。 如果您还没有使用ID,请在添加产品时正确创建它。 您可以自己提出或使用Yandex创建它。市场。 为此,请单击 .

该文章在工作中不断使用:它是所有货物操作所需的,并显示在报告中。 如果您自己创建标识符,请为自己提供方便。

您可以通过将已设置的值更改为另一个值来编辑它。 怎么做

规则:

-每个选项的文章必须是唯一的。
-一个已经设置的项目不能被释放和重复用于另一个产品-每个产品必须收到一个新的标识符,你以前没有使用过。

要求

长度不超过255个字符的任意字符序列。

例子:belaya-kofta-12345

Yml中的表示

<Offer>元素的id属性。

<offer id="belaya-kofta-12345">

重要

<Shop-sku>元素已经过时,最好不要使用它。 如果有一个,你的SKU的值是从它取的,而不是从<Offer>元素的id属性。

品牌(必填)

品牌或制造商的名称。

如果产品没有品牌,请单击该字段并从下拉列表中选择无品牌

如果所需的品牌不在列表中,请写信给支持。 说明

要求

写下品牌本身写的名字。 一定要检查它是如何拼写正确的,例如,在品牌的官方网站上。

例子:LEVENHUK

Yml中的表示

<Offer>元素内的<vendor>元素。

<vendor>LEVENHUK</vendor>

条码(必需)

来自制造商的产品的条形码。 如果产品以包装形式销售,则需要包装条形码。

大多数情况下,制造商在产品本身,标签或盒子上打印条形码。 如果没有代码,请在机柜中的产品页面上生成。 您可以通过在列表中选择它们并单击生成条形码来为目录中的多个产品生成条形码。

要求

将其指定为字符序列。 合适的代码是EAN-13,EAN-8,UPC-A,UPC-E或代码128。

对于书籍,请指定ISBN。 对于药房和兽医产品,条形码必须是有效的GTIN代码。

什么是GTIN?

GTIN — 这是在统一的国际[GS1](https://ru.wikipedia.org/wiki/GS1 )数据库中分配给产品的唯一编号。 此编号生成EAN、UPC或ISBN条形码。。 此编号生成EAN、UPC或ISBN条形码。

如何确保产品在数据库中

您可以在[验证页面](https://gepir.gs1.org/index.php/search-by-gtin )上查看代码在GS1协会的网站上。 如果未找到产品,请向供应商索取GTIN代码。

如何为您的产品获取GTIN

要接收GTIN代码,制造商需要加入GS1协会并注册产品。

请注意:以2或02开头的条形码和Code128格式代码不能用作制造商的条形码—它们仅供内部使用。

如果有多个条形码,请用逗号将它们分开。

例子:46012300000000

Yml中的表示

<Offer>元素内的<barcode>元素。

<barcode>46012300000000</barcode>

描述(必需)

详细的产品说明:例如,它的优点和特点。

要求

让我们用俄语进行描述。

说明中不提供安装和装配说明。 不要使用"折扣","销售","便宜","礼品"(礼品类别除外),"免费","特价","特价","新奇","新","模拟","订单","点击"等字样。 不要提供任何联系信息或链接。

您可以使用标签:

  • <h>, <h1>, <h2> 等等-对于头条新闻;
  • <br> 和 <p> — 换行;
  • <ol> — 对于编号列表;
  • <ul> — 对于项目符号列表;
  • <li> — 要创建列表项(必须在<ol><ul>内);
  • <div> — 支持,但不影响文本显示。.

最佳长度为400-600个字符,最大值为6000个字符。

[推荐](description.md )将帮助您创建一个很好的描述。

例子:В комплекте с детским микроскопом есть все, что нужно вашему ребенку для изучения микромира

Yml中的表示

<Offer>元素内的<description>元素。

<description>В комплекте с детским микроскопом есть все, что нужно вашему ребенку для изучения микромира.</description>

如果描述有标签,它应该放在CDATA内:

 <description>
   <![CDATA[
     <p>текст</p>
   ]]>
 </description>

包装尺寸及重量(必需)

长度,宽度,高度,包装重量。

请注明产品的实际尺寸和重量,考虑到包装. 有关如何指定尺寸的详细信息,请参阅article

如果在测量总长度、宽度和高度之前,产品占用多个空间(例如多个盒子或包装),请尽可能紧凑地折叠盒子或包装。

确保此处所示的尺寸和重量与产品的实际尺寸和重量之间没有显着差异,并为产品选择适当的包装。 如果市场发现差异,您将不得不支付罚款。 更多详情

要求

重量的计量单位是千克。 分数是允许的:分隔符是一个点或逗号,在它之后不超过三位数。

尺寸的测量单位是厘米。 分数是允许的:分隔符是一个点或逗号,在它之后不超过三位数。

在Excel文件中,写入分隔/不带空格的数字。

尺寸示例:20.1/20.551/22.5

重量示例:3.1

Yml中的表示

<Offer>元素内的<dimensions>元素。

<dimensions>22.1/40.425/22.1</dimensions>

<Offer>元素内的<weight>元素。

<weight>3.1</weight>

价格(必填)

一单位商品的价格,包括所有税费。 适用于所有橱柜商店.

要求

价格以产品指定的货币表示。 数字必须是整数。

例子:

240

Yml中的表示

<Offer>元素内的<price>元素。

<price>240</price>

划线价格(必填)

如果产品以折扣销售,请在此字段中指定没有折扣的价格。 市场将显示它划掉,以便客户可以看到好处。 适用于所有橱柜商店.

要求

价格以产品指定的货币表示。 数字必须是整数。

您可以指定折扣从5到99%的价格。

例子:

250

Yml中的表示

<Offer>元素内的<oldprice>元素。

<oldprice>250</oldprice>

图片(必填)

最多30个图像显示在产品配置文件。 请务必下载至少一个。

要求

符合[要求](images.md )的产品的jpg,jpeg, png, heic和webp图像被接受。

图像作为文件添加到机柜中。 在Excel文件中—以[链接](*图片-url)的形式用逗号分隔。 第一张照片成为主要的照片。

要更改图像,请通过新链接上传新图像,否则图像将不会更新。

Yml中的表示

<Offer>元素内的<picture>元素。

<offer id="12345-abcd">
                       ...
                       <picture>http://best.seller.ru/img/device12346-front.jpg</picture>
                       <picture>http://best.seller.ru/img/device12346-back.jpg</picture>
                       ...
                       </offer>

也填写个别商店的放置参数.

标签

您自己的产品标签-它们对客户不可见。 您可以按标签对目录中的不同产品进行分组,并在列表中过滤掉它们。

要求

拿出任何名称—它可以稍后更改。

最大标记长度为20个字符。

一个产品最多有10个标签.

总的来说,您可以创建不超过50个不同的标签。

例子:apple, 高达500卢布

Yml中的表示

<Offer>元素内的<set-ids>元素。

<set-ids>apple, 高达500卢布</set-ids>

成本价格

自行生产产品或从制造商或供应商处购买的成本。

在计算器和价格管理页面上填写此字段后,将计算产品的潜在[边缘性](*marginality)。

要求

价格以产品指定的货币表示。 数字必须是整数。

例子:

200

Yml中的表示

<Offer>元素内的<purchase_price>元素。

<purchase_price>200</purchase_price>

额外开支

产品的额外费用。 例如,用于运输或包装。

在计算器和价格管理页面上填写此字段后,将计算产品的潜在边际性。

要求

价格以产品指定的货币表示。 数字必须是整数。

例子:

75

Yml中的表示

<Offer>元素内的<additional_expenses>元素。

<additional_expenses>75</additional_expenses>

短片

产品卡的视频插图。

要求

视频必须符合要求

您可以添加不超过6个视频。

您可以在您的帐户下载视频文件。 指定指向Excel模板中的文件的链接。

第一个视频可以用作卡片的封面-它会自动运行。 如何制作视频封面

Yml中的表示

<Offer>元素内的<video>元素。

 <video>https://disk.yandex.ru/i/fUs4sweebCgjq_ytMN</video>
 <video>https://disk.yandex.ru/i/kEb8svrewPnaq_fnZA</video>
 <video>https://disk.yandex.ru/i/mOx2zqdbfLoph_pwGS</video>

货位数目

如果产品占用一个地方(它由一个盒子,包装等组成),请将字段留空。 如果产品占用多个地方,请指定它们的编号。 例如,空调占用两个空间-一个外部和一个内部单元在两个盒子里。

要求

指定座位数。

例子:2

Yml中的表示

<Offer>元素内的<box-count>元素。

<box-count>2</box-count>

制造业国家

产品生产的国家。

要求

用俄语指定国家。

写下这些国家的名字,因为它们写在列表.

例子:Россия

Yml中的表示

<Offer>元素内的<country_of_origin>元素。

<country_of_origin>Россия</country_of_origin>

制造商文章

制造商分配给它的产品代码。

对于汽车零部件,此代码将允许市场按批号在搜索中显示产品或向客户提供合适的类似物。

要求

如果有几篇文章,请指定它们以逗号分隔。

例子:VNDR-0005A, VNDR-0005B

Yml中的表示

<Offer>元素内的<vendorCode>元素。

<vendorCode>VNDR-0005A, VNDR-0005B</vendorCode>

一种特殊类型的产品

如果产品是书籍,数字图书,有声读物,医学,音乐或视频,您必须指定这一点。

如果你的产品是一本书

在产品规格中指定发布年份。 详细了解如何指定特征

要求

在您的个人帐户和Excel文件中,值是从列表中选择的。

Yml中的表示

<Offer>元素的type属性。

  • audiobook — 有声读物;

  • book — 一本书或一本数字书;

  • medicine — 医学;

  • artist.title — 音乐或视频制作;

<offer type="audiobook">

成人产品

该参数包括产品的标签18+。 仅将其设置为与满足性需求相关的产品。

要求

它在您的商家资料中启用。

Yml中的表示

<Offer>元素内的<adult>true</adult>元素或<Offer>数组前的<offer>元素内的<offer>元素-如果所有产品同时针对成人。

<Offer>内的示例

<offer>
                             ...
                             <adult>true</adult>
                             </offer>
<Offers>内的示例

<adult>true</adult>
                             <offers>
                             <offer>
                             ...
                             </offer>
                             </offers>

有效期限

从制造之日起的一段时间,之后产品变得无法使用。

指定jar或包上注明的日期。 当前日期、交货日期或装运日期无关紧要。

要求

可以以年、月、日、周和小时指定时间段。

请务必指定截止日期,如果有的话。

Yml中的表示

<Offer>元素内的<period-of-validity-days>元素。

持续时间根据ISO8601表示,即以字母P开头的行的形式。:

  • P1Y — 1年;
  • P1Y6M — 1年6个月;
  • P15D — 15天.
<period-of-validity-days>P1Y</period-of-validity-days>

对到期日期的评论

此字段用于描述存储条件。

要求

请用俄语发表评论。

不超过250个字符和没有特殊字符.

例子:Хранить в сухом помещении

Yml中的表示

<Offer>元素内的<comment-validity-days>元素。

<comment-validity-days>Хранить в сухом помещении.</comment-validity-days>

使用寿命

产品在其使用寿命期间必须正确地执行其功能。

请务必指定截止日期,如果有的话。

要求

时间段可以以年、月和天指定。

Yml中的表示

<Offer>元素内的<service-life-days>元素。

持续时间根据ISO8601表示,即以字母P开头的行的形式。:

  • P1Y — 1年;
  • P1Y2M — 1年2个月;
  • P15D — 15天;
  • P2Y10D — 2年零10天;
  • P2Y6M10D — 2年6个月零10天。
<service-life-days>P2Y2M10D</service-life-days>

评论使用寿命

此字段用于描述使用条款。

要求

请用俄语发表评论。

不超过250个字符和没有特殊字符.

例子:Использовать при температуре не ниже −10 градусов

Yml中的表示

<Offer>元素内的<comment-life-days>元素。

<comment-life-days>Использовать при температуре не ниже -10 градусов.</comment-life-days>

保修期

产品多久可以免费更换或修理。

要求

时间段可以以年、月或天指定。

Yml中的表示

<Offer>元素内的<warranty-days>元素。

<Offer>元素内的<service-life-days>元素。

持续时间根据ISO8601指定,即以字母P开头的行的形式:

  • P1Y — 1年;
  • P1Y2M — 1年2个月;
  • P15D — 15天;
  • P2Y10D — 2年零10天;
  • P2Y6M10D — 2年6个月零10天。
<warranty-days>P2Y2M10D</warranty-days>

关于保修期的评论

此字段旨在描述保修条件的具体细节。

请仅说明制造商保修范围内的内容。

要求

请用俄语发表评论。

不超过250个字符和没有特殊字符.

例子:Гарантия на аккумулятор — 6 месяцев

Yml中的表示

<Offer>元素内的<comment-warranty>元素。

<comment-warranty>Гарантия на аккумулятор — 6 месяцев.</comment-warranty>

产品说明

操作说明、装配图等。

要求

接受大小不超过30mb的jpg、png和pdf文件.

您最多可以添加6个文件。 指令名称的最大长度为150个字符。 您不需要转移名称。 默认情况下,该文件将被称为指令

您可以在您的帐户上传文件。 指定指向Excel模板中的文件的链接。

Yml中的表示

<offer>元素内具有<title>属性的<manual>元素,其中<title>是指令的名称。

 <manual title="Manual 1">http://ya.ru/man.pdf</manual>
 <manual title="Manual 2">http://ya.ru/man.jpg </manual>

文件编号

产品文件的编号:证书,符合性声明等。

在指定文档编号之前,请通过您的帐户上传文档的扫描副本。

说明

要求

指定文档编号。

例子:6241421

Yml中的表示

<Offer>元素内的<certificate>元素。

<certificate>6241421</certificate>

HS编码

对于某些产品类别,需要[HS代码](*tn-ved-code)。 如果这与您的产品有关,您将在目录中收到通知。 根据传输的HS编码,市场确定产品是否受到强制性标签的约束。

要求

没有空格的10或14位数字

例子:8517610008

Yml中的表示

<Offer>元素内的<tn-ved-codes>元素。 在<tn-ved-code>里面可以有任意数量的<tn-ved-code>元素,每个元素都包含一个产品代码。

                       <tn-ved-codes>
                         <tn-ved-code>8517610008</tn-ved-code>
                       </tn-ved-codes>

СTRU代码

СTRU代码 州和市级客户使用它来统一购买对象的名称和描述。

要求

所有没有空格的字符。

例子:20.41.32.121-00000006

Yml中的表示

<Offer>元素内的<ctru_code>元素。

<ctru_code>20.41.32.121-00000006</ctru_code>

从什么年龄使用

如果产品不适用于特定年龄以下的儿童,请注明。

要求

年龄限制可以以年(从零开始,从6,12,16或18)或月份(从0到12的任何数字)设置。

Yml中的表示

<Offer>元素内的<age>元素。 测量单位由unit属性定义: unit="year" — 年数, unit="month" — 个月.

<age unit="year">6</age>

只有特定类别的产品才具有的特性

除了一般性质之外,产品具有所属特定类别中固有的特征。 例如,自行车有一个框架大小,婴儿泥可以是蔬菜,肉类或水果。

要求

用俄语填写规格,除了具有有限值列表的特征。 对于这样的特征,有必要以其呈现的形式从列表中选择一个值。

在机柜中,可以在产品页面上更改特性。

要通过Excel文件编辑它们,您需要下载模板:

  • 与特定类别相关更方便。 说明

  • 将军。

    如何填写规格

    一般模板中的特征必须用分号分隔:

    参数 X|意义|测量单位; 参数 Y|意义|测量单位;

    规格说明

    建议

    尺寸

    尺寸|S; 尺寸网格|INT; 标签上的大小|L;

    传输尺寸时,请务必指定值尺寸网格尺寸。 大小取决于所选大小网格。 您可以在类别模板中看到完整列表。

    如果您与拥有自己尺寸网格的制造商合作,请指定制造商的尺寸网格。 例如: 大小网格|adidas; 大小|11;

    测量参数

    阔度|20|厘米; 电池数量|5|个人电脑;

    请务必指定测量单位。

    年龄(人数)

    最低年龄|6|年数: 最大年龄|24|年份;

    请务必指定测量单位。

    年龄(范围)

    年龄|14+|; 年龄|1-3 年数|; 年龄|0-6 个月|; 年龄|5-7 年数|;

    从市场上的类别值列表中指定选项-列表可以在类别模板中看到。

    是/否参数

    降临节日历|是的;

    指定显式值-是或否。

    作文

    作文|棉花 90%, 聚酯纤维 10%;

    参数的总和应等于100%。

    颜色

    滤镜的颜色|黑色; 来自制造商的颜色名称|Black Tiger;

    过滤器颜色字段中,指定原色,在制造商的颜色名称字段中,指定来自制造商的产品的唯一颜色。

    具有有限值列表的特征

    季节|夏天; 保罗|男; 类型|T恤衫;

    这些参数的某些值必须严格对应于市场上类别列表中的值,例如季节。 您可以在类别模板中看到列表。 如果指定的值不是列表中的值,则不会保存该值。

    但是,您可以为类型参数指定自己的值,它将显示在卡上。

    文本字段

    详细配置|细节-车轮,说明,扳手;

    文本长度不应超过1000个字符。 不要在此参数中指定值资料描述-模板中有一个单独的字段。

    具有多个值的特征

    主题事项|芭蕾舞团; 主题事项|航空业;

    在单独的段落中指定每个值。

    这种方法不适合更新组合在一张卡上的产品的特性。 以这种方式传输特征时,很容易出错,因此建议通过Excel类别模板来执行此操作。

在一张卡上组合选项

要在一张卡上组合产品选项,请填写选项组名称字段。 它可以是任何字符的序列,最长可达255个字符。

要正确执行此操作,请阅读说明.

存档

此字段允许您对产品进行存档,将其隐藏在所有商店的展示中,并从存档中恢复。 [文章](../operations/stop-and-resume.md)关于商品的存档:如何将产品存档并从存档中恢复,更改的应用条件和时间。

要求

在机柜中,目录中有一个产品的操作。

在目录和类别的Excel文件中,有一列存档,如果您需要将产品转移到存档,您可以在其中写入"是"。

在存档产品的Excel文件中,有一列档案库,如果您需要从存档中恢复产品,可以在其中写入"否"。

Yml中的表示

<Offer>元素内的<archived>元素。

如果要存档产品,请指定值"true",如果要从存档中还原产品,请指定值"false"。

<offer id="12345-abcd">
                     ...
                     <archived>true</archived>
                     ...
                     </offer>

商店放置参数

这些参数对于每个商店都是不同的。 它们与商品本身无关,而是与销售有关。 将货物交付到仓库(对于FBY和FBS商店)的参数是单独设置的。

可供选择的货物数量

可在Yandex上出售的商品总数。 市场。

请务必阅读文章如何管理余额

要求

如果产品缺货,请指定0。

例子:7

Yml中的表示

<Offer>元素内的<count>元素。

<count>7</count>

确保在根元素的"date"属性中指定数据相关性的日期。 说明

产品页面链接

您网站上带有照片和产品描述的页面地址。

要求

URL的最大长度为512个字符。 按照标准编写RFC3986.

例子:http://best.seller.ru/product_page.asp?pid=12346

Yml中的表示

<Offer>元素内的<url>元素。

<url>http://best.seller.ru/product_page.asp?pid=12346</url>

从销售中删除

此字段允许您暂停在一个商店中销售商品。

要求

橱柜看起来像一个复选标记隐藏在展示柜。 在Excel文件中-列从展柜中隐藏(FBS)中隐藏。

Yml中的表示

<Offer>元素内的<disabled>元素。

如果您需要暂停销售,请指定值true,如果您需要返回待售产品,请指定值false

<offer id="12345-abcd">
                       ...
                       <disabled>true</disabled>
                       ...
                       </offer>

最低货物数量

如果设置了该值,买家将无法订购更少的商品。 当库存商品数量少于此数量时,限制不起作用,那么买方将能够为剩余商品下订单。

重要

对于某些产品类别,参数的最大值有限制。 如果您指定上述值,产品将从展示中隐藏。

如何使用此参数

要求

一个整数。

Yml中的表示

<Offer>元素内的<min-quantity>元素。

销售量

如果设置了该值,买方将只能将产品的倍数添加到订单中。 当库存不足此数量时,限制不起作用,然后买方将能够为剩余的订单。

重要

对于某些产品类别,参数的最大值有限制。 如果您指定上述值,产品将从展示中隐藏。 查看类别列表

如何使用此参数

要求

一个整数。

Yml中的表示

<Offer>元素内的<step-quantity>元素。

货币

表示产品价格的货币。 市场向客户显示以卢布为单位的价格,按中央银行的汇率重新计算。

如果尚未为机柜启用基本价格,则使用此字段。

要求

必须使用帐户注册时选择的货币。

在内阁中,您可以简单地从列表中选择一种货币。 Excel文件指定货币代码:RUR,BYN,EUR,USD,UAN,KZT。

Yml中的表示

<Offer>元素内的<CurrencyID>元素。

Маржинальность показывает, сколько процентов прибыли вы получите с каждого проданного товара.

Товарная номенклатура внешнеэкономической деятельности — система классификации товаров в зависимости от их характеристик, состава и назначения. Используется в международной торговле, например для определения таможенной пошлины при перевозке товаров через границу.

Каталог товаров, работ и услуг.

Так как уровни заголовков не поддерживаются, в описании все заголовки будут отображаться одинаково.

Можно использовать только: . , ; ( ) - ? ! ' " « » ﹠ % / °

Указывайте ссылку целиком, включая протокол http или https.

Максимальная длина — 512 символов.

Русские буквы в URL можно.

Ссылки на изображение должны быть постоянными. Нельзя использовать динамические ссылки, меняющиеся от выгрузки к выгрузке.

Если вы хотите использовать одно и то же изображение для нескольких товаров, используйте одну и ту же ссылку.

Можно использовать прямые ссылки на изображения и на Яндекс Диск. Ссылки на Яндекс Диске нужно копировать с помощью функции Поделиться: нажмите на значок рядом с изображением, а  затем — Скопировать ссылку.

Относительные ссылки и ссылки на другие облачные хранилища — не работают.

✅ Правильно

https://example-shop.ru/images/sku12345.jpg``https://yadi.sk/i/NaBoRsimVOLov

❌ Неправильно

/images/sku12345.jpg``https://www.dropbox.com/s/818fkp8szfdxqc8/super-tovar.jpg?dl=0