Требования к товарам
Мы стремимся к высокому качеству контента на нашем сайте, чтобы покупатель мог легко и быстро найти интересующие его товары и получить максимально полную информацию о них.
Именно поэтому мы выставляем определенные требования к описанию товаров для наших продавцов. Следуя рекомендациям, вы не только обеспечиваете быстрое прохождение модерации ваших товаров и их публикации на нашем сайте, а это, в свою очередь, способствует увеличению количества продаж.
Штрихкод производителя
Это ключевой параметр, по которому осуществляется поиск соответствий на сайте, производится сопоставление товара продавца и карточки Мегамаркет, предотвращается появление дублей одного и того же товара. У одного товара может быть одновременно несколько штрихкодов, для указания которых предусмотрено несколько полей. На этапе загрузки шаблона или сохранения карточки в интерфейсе система проверяет указанные штрихкоды на корректность. Система валидации Мегамаркет проверяет на соответствие штрихкодов следующим форматам: EAN 13, EAN 8, GTIN, ISBN.
При добавлении товара система валидации может уведомить, что загружаемая позиция с указанным штрихкодом уже существует (например, была заведена во время описания товара другим продавцом).
В таком случае, товар получит статус «Дубль».
Наведя курсор на ярлык со статусом «Дубль» в списке карточек или перейдя на детальную карточку товара, вы можете увидеть дублем какого товара она стала, и артикул Мегамаркета этого товара. По указанному коду вы можете осуществить склейку в разделе «Ассортимент» → «Сводка по ассортименту» «Подтверждение соответствия».
Товары без штрихкодов
Если вы хотите добавить товар, у которого отсутствует фактический штрихкод производителя или штрихкод не уникален (например, начинается с «2»), то в веб-интерфейсе создания карточки вы можете нажать галочку «Нет штрихкода», выбрать причину отсутствия штрихкода из списка, после чего сайт подскажет дальнейшие действия.
Код товара продавца (offer ID), Артикул товара
Код товара продавца (offer Id)
Это уникальный код товара в вашей системе, который вы передаете в фиде. На основе кода товара продавца осуществляется автоматическая «склейка» товара с карточкой на Мегамаркет после успешного прохождения товара этапа модерации. Если код товара продавца будет указан неправильно, например, вместо него будет указан штрихкод или артикул товара, то автоматическая склейка не произойдет, и вам придется осуществлять поиск соответствия вручную.
Код товара продавца НЕ должен содержать пробелы и запрещенные символы: # % ; ~ \ / . Ограничение по длине до 50 символов.
Получение предложения по идентификатору
Возвращает ресурс предложения, соответствующий идентификатору предложения.
Предварительные требования
- Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с помощью автономных учетных данных приложения и приложения и пользователя.
- Идентификатор предложения.
C#
Чтобы найти определенное предложение по идентификатору, используйте коллекцию IAggregatePartner.Offers, установите страну или регион с вызовом ByCountry(), а затем вызовите метод ByID(). Затем вызовите метод Get() или Get Async( ).
// IAggretagePartner partnerOperations; // string countryCode; // string offerId; // retrieve the offer var offer = partnerOperations.Offers.ByCountry(countryCode).ById(offerId).Get(); Пример: тестовое приложение консоли. Проект: Класс PartnerSDK.FeatureSample: GetOffer.cs
Java
Пакет SDK для Java центра партнеров можно использовать для управления ресурсами Центра партнеров. Это проект с открытым исходным кодом, поддерживаемый сообществом партнеров и официально не поддерживаемый корпорацией Майкрософт. При необходимости вы можете получить помощь от сообщества или опубликовать проблему в GitHub.
Чтобы найти определенное предложение по идентификатору, используйте функцию IAggregatePartner.getOffers , установите страну или регион с вызовом функции byCountry(), а затем вызовите функцию byID( ). Затем вызовите функцию get( ).
// IAggretagePartner partnerOperations; // String countryCode; // String offerId; // Retrieve the offer Offer offer = partnerOperations.getOffers().byCountry(countryCode).byId(offerId).get(); PowerShell
Модуль PowerShell Центра партнеров можно использовать для управления ресурсами Центра партнеров. Это проект с открытым исходным кодом, поддерживаемый сообществом партнеров и официально не поддерживаемый корпорацией Майкрософт. При необходимости вы можете получить помощь от сообщества или опубликовать проблему в GitHub.
Чтобы найти определенное предложение по идентификатору, выполните команду Get-PartnerOffer и укажите параметры CountryCode и OfferId .
# $countryCode # $offerId Get-PartnerOffer -Country $countryCode -OfferId $offerId Запрос REST
Синтаксис запроса
| Метод | URI запроса |
|---|---|
| GET | /v1/offers/?country= HTTP/1.1 |
Параметр универсального кода ресурса
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| offer-id | guid | Y | Глобальный уникальный идентификатор, который соответствует предложению. |
| country-id | string | Y | Идентификатор страны или региона. |
Заголовки запросов
- Языковой стандарт , отформатированный в виде строки, является обязательным. Дополнительные сведения см. в статье о заголовках REST Центра партнеров.
Текст запроса
Пример запроса
GET https://api.partnercenter.microsoft.com/v1/offers/?country= HTTP/1.1 Authorization: Bearer Accept: application/json MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8 MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533 X-Locale: Connection: Keep-Alive Ответ REST
В случае успешного выполнения этот метод возвращает ресурс Предложения в тексте ответа.
Коды успешного выполнения и ошибок в ответе
Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. См. полный список кодов ошибок.
Пример ответа
HTTP/1.1 200 OK Content-Length: 1918 Content-Type: application/json MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533 MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8 Date: Mon, 23 Nov 2015 23:13:01 GMT < "id": "031C9E47-4802-4248-838E-778FB1D2CC05", "name": "Office 365 Business Premium", "description": "For businesses with 1 to 300 users that need the latest desktop version of Office, plus anywhere access to email, filesharing, and online conferencing.", "minimumQuantity": 1, "maximumQuantity": 300, "rank": 56, "uri": "/3c95518e-8c37-41e3-9627-0ca339200f53/Offers/031C9E47-4802-4248-838E-778FB1D2CC05", "locale": "en-us", "country": "US", "category": < "id": "SmallBusiness_Key", "name": "Small Business", "rank": 30, "locale": "en-us", "country": "US", "attributes": < "objectType": "OfferCategory" >>, "prerequisiteOffers": [], "isAddOn": false, "isAvailableForPurchase": true, "billing": "license", "isAutoRenewable": true, "product": < "id": "f245ecc8-75af-4f8e-b61f-27d8114de5f3", "name": "Office 365 Business Premium", "unit": "Licenses" >, "unitType": "Licenses", "links": < "learnMore": < "uri": "http: //g.microsoftonline.com/0BXPS00en/909", "method": "GET", "headers": [] >>, "attributes": < "objectType": "Offer" >> Обратная связь
Были ли сведения на этой странице полезными?
фид YML offer артикула. Как сделать?
Добрый день.
Переезжаем на SS. Встал вопрос формирования фида для маркета. Чтобы не переделывать карточки на маркете (SKU товара в карточке менять нельзя) мне нужно в фиде чтобы offer id был равен коду артикула.
Пока пробую бесплатный плагин Яндекс.Маркет. Не нашел в его настройках как это сделать.
Подскажите как реализовать то что мне нужно? какой плагин купить?
1 ответ
1
creativit.ru Эксперт Разработчик 17 декабря 2022 10:43 #
Загрузка каталога в систему через ICML
Важно!
На бесплатном тарифе можно вести не более 10000 товаров.
Формат ICML является расширением формата YML. Он позволяет выгружать техническую информацию о товарах в систему (ID и XML ID товаров, информация о количестве), а также сложную структуру каталогов с торговыми предложениями (SKU). Вы можете генерировать файл выгрузки самостоятельно на стороне вашего интернет-магазина в соответствии с описанием ниже. Для ряда CMS есть готовые модули интеграции, которые умеют генерировать ICML с каталогом товаров.
Описание формата
Интернет-магазин Интернет-магазин Офисная мебель Стеллажи http://testbitrix.test/upload/iblock/d2b/d2b25cbdc1f76b8b1672f5e8d1ec6589.JPG http://testbitrix.test/upload/iblock/d2b/d2b25cbdc1f76b8b1672f5e8d1ec6590.JPG Рабочие места Стулья и кресла Мягкая мебель Диваны Кровати Мебель для сада Зеркала Освещение Текстиль http://testbitrix.test/catalog/shelves/rack_2_sectional/ 14000.00 13200.00 3 http://testbitrix.test/upload/iblock/d2b/d2b25cbdc1f76b8b1672f5e8d1ec6589.JPG http://testbitrix.test/upload/iblock/d2b/d2b25cbdc1f76b8b1672f5e8d1ec6590.JPG http://testbitrix.test/upload/iblock/d2b/d2b25cbdc1f76b8b1672f5e8d1ec6591.JPG Стеллаж 2-х секционный 82 Стеллаж 2-х секционный 789789 двухъярусный белый Abagure 50 18 100/50.8/150 012485ab Y http://testbitrix.test/catalog/shelves/rack_2_sectional/ 14500.00 11000.00 3 http://testbitrix.test/upload/iblock/d2b/d2b25cbdc1f76b8b1672f5e8d1ec1501.JPG Стеллаж 2-х секционный (оранжевый) 83 Стеллаж 2-х секционный 789789 двухъярусная черный Cologio 60 none 100/50.8/150 012485ab Y Y http://testbitrix.loc/catalog/textile/sheet_beige/ 200.00 175.00 12 http://testbitrix.loc/upload/iblock/be7/be7139e39cda62e8c032f3b2ed0106e4.JPG Ткань льняная бежевая 66 Ткань льняная бежевая 151642 150 бежевый 10 2.05 N http://testbitrix.loc/catalog/summer_collection/rocker/ 4250.00 9 http://testbitrix.loc/upload/iblock/68b/68b955690e0f1f9dacb96cc4248e9c44.jpg Кресло-качалка 104 Кресло-качалка 891081 Riotto XML-заголовок
ICML-файл является XML-документом, в его начале следует разместить XML-заголовок, например, . В качестве кодировки рекомендуется использовать UTF-8.
Элемент
В качестве корневого элемента в формате ICML используется элемент . В одном файле может находится только один такой элемент. Тег имеет один обязательный атрибут date , значение которого должно соответствовать дате и времени генерации файла. Для хранения и передачи нескольких каталогов рекомендуем использовать несколько подобных xml-документов.
Элемент
Мой интернет-магазин Моя компания … … Элемент содержит описание интернет-магазина и каталога товаров. Магазин описывается следующими элементами:
— название интернет-магазина; Максимальная длина 255 символов;
— название компании;
— контейнер, который содержит категории товаров;
— контейнер, который содержит описания всех товаров интернет-магазина.
Все элементы не должны дублироваться.
Элемент
Офисная мебель Стеллажи http://testbitrix.test/upload/iblock/d2b/d2b25cbdc1f76b8b1672f5e8d1ec6589.JPG http://testbitrix.test/upload/iblock/d2b/d2b25cbdc1f76b8b1672f5e8d1ec6590.JPG Рабочие места Стулья и кресла Мягкая мебель Диваны Кровати Мебель для сада Зеркала Освещение Текстиль В элементе содержится список категорий товаров интернет-магазина. Элемент описывает одну отдельную категорию и содержит ее название. Название не должно превышать 255 символов. Каждый элемент должен иметь атрибут id — идентификатор категории, он должен быть уникальной последовательностью символов не длиннее 255 знаков. Также каждый элемент может содержать атрибут parentId — идентификатор родительской категории, его значение должно быть одно из идентификаторов существующих категорий. Этот атрибут позволяет описывать вложенную структуру каталога. Если описание категории товара не содержит атрибут parentId, категория считается корневой. Также категория может быть описана следующими элементами:
- — название категории, максимальная длина 255 символов.
- — URL картинки категории. Тег может повторяться. Максимальная длина ссылки 2000 символов.
Элемент
В элементе содержится список товаров и товарных предложений интернет-магазина. Каждый элемент описывает товар и торговое предложение. Элемент должен быть в единственном экземпляре, а элементов может быть сколь угодно много.
Элемент
http://testbitrix.test/catalog/shelves/rack_2_sectional/ 14000.00 13200.00 3 http://testbitrix.test/upload/iblock/d2b/d2b25cbdc1f76b8b1672f5e8d1ec6589.JPG http://testbitrix.test/upload/iblock/d2b/d2b25cbdc1f76b8b1672f5e8d1ec6590.JPG Стеллаж 2-х секционный 82 Стеллаж 2-х секционный 789789 двухъярусная белый Riotto 50 none 100/50.8/150 50 012485ab Y Элемент содержит поля описывающие свойства как товара, так и торгового предложения, что дает возможность элементу быть как товаром, так и торговым предложением. Элемент содержит обязательные атрибуты id (внешний идентификатор торгового предложения в системе) и productId , которые соответствуют идентификаторам торгового предложения и товара. В случае если в интернет-магазине отсутствуют торговые предложения, то идентификаторы могут совпадать. id и productId должны быть не длиннее 255 символов. Просим вас обратить внимание, что идентификатор торгового предложения должен быть уникальным, и если при генерации скопировать идентификатор товара в идентификатор торгового предложения, то идентификатор может совпасть с идентификатором другого торгового предложения, это может привести к неисправимым последствиям.
Элемент может содержать атрибут quantity , который соответствует количеству товара (торгового предложения). Для каждого торгового предложения может быть свое количество. Количество должно быть целым или дробным числом с точностью до 3 знаков после запятой, в интервале от 0 до 99 999 999.
Торговое предложение (товар) описывается следующими элементами:
— показатель активности торгового предложения. Элемент не является обязательным. Если он не указан, то торговое предложение считается активным. Для неактивного торгового предложения необходимо передавать N , в остальных случаях можно передать Y или опустить элемент.
— показатель активности товара. Элемент не является обязательным. Если он не указан, то товар считается активным. Для деактивации товара необходимо указывать данный элемент у всех торговых предложений этого товара.
— страница торгового предложения (товара) в интернет-магазине. Важно указывать корректный протокол ( http:// или https:// ) и домен (с www или без него). Данный URL используется для определения просмотренных клиентом товаров в рамках интеграции с Universal Analytics; Максимальная длина ссылки 2000 символов;
— цена торгового предложения (товара); Цена может быть целой или дробной с точностью до 2 знаков после запятой в промежутке от 0 до 99 999 999;
— закупочная цена торгового предложения (товара), не является обязательной; При отсутствии тега в файле значение не будет сбрасываться; Закупочная цена может быть целой или дробной с точностью до 2 знаков после запятой в промежутке от 0 до 99 999 999;
— идентификатор категории, к которой принадлежит торговое предложение (товар). Если торговое предложение (товар) находится в нескольких категориях, то таких элементов может быть несколько;
— URL картинки торгового предложения (товара), тег может повторяться, не является обязательным. Используется для отображения превью изображений. Можно указывать изображения в формате jpg, png размером не более 2Мб. Важно указывать корректный протокол ( http:// или https:// ) и домен (с www или без него), иначе система не сможет отобразить превью товаров. Также важно, чтобы ссылка на товар была прямой и при переходе на нее не производились редиректы. Максимальная длина ссылки 2000 символов;
— название торгового предложения; Максимальная длина 255 символов;
— название товара; Максимальная длина 255 символов;
— внешний идентификатор товара, элемент не является обязательным — в случае если интернет-магазин использует выгрузку номенклатуры товаров из складской системы (1С, МойСклад), то значение этого элемента соответствует идентификатору товара в данной системе; Поле представляет собой последовательность символов длиной не более 255;
name — название параметра товара; Максимальная длина 255 символов;
code — буквенно-цифровой код параметра, допустимые символы: a-Z0-9_ , прочие символы будут обрезаны пример: color , size . Максимальная длина кода 50 символов. См. также параметры со специальной обработкой. Длина значения свойства товара не должна превышать 255 символов.
— производитель товара, элемент не является обязательным; Максимальная длина 255 символов;
— единица измерения для товара, элемент не является обязательным;
code — буквенно-цифровой код единицы измерения, допустимые символы: a-Z0-9_- , первый символ должен быть a-z ; Максимальная длина 255 символов;
name — полное название единицы измерения, необязательный элемент — в случае отсутствия, при создании, в качестве названия берется код, для существующей единицы измерения передавать не требуется; Максимальная длина 255 символов;
sym — краткое название единицы измерения, необязательный элемент — в случае отсутствия, при создании, в качестве краткого названия берется код, для существующей единицы измерения передавать не требуется; Максимальная длина 5 символов;
— Ставка налога на добавленную стоимость (НДС) для товара в процентах; Для передачи значения «Без НДС» используйте none ; элемент не является обязательным;
— Габариты товара в формате Длина/Ширина/Высота. Единица измерения для каждой размерности — сантиметр. Формат: три положительных числа с точностью до тысячных (0.001), разделитель целой и дробной части — точка. Числа должны быть разделены символом «/» без пробелов. При указании более высокой точности значение автоматически округляется до третьего знака (включительно) в дробной части. Максимально допустимое значение — 999 999 999 см. При загрузке каталога габариты будут переведены в миллиметры, так как единицей измерения габаритов в системе являются миллиметры.
— Вес товара. Единица измерения — килограмм. Формат: положительное число с точностью 0.001 (или 0.000001, в зависимости от настройки CRM «Точность веса»: граммы или миллиграммы соответственно), разделитель целой и дробной части — точка. При указании более высокой точности значение автоматически округляется до третьего знака (включительно) в дробной части. Максимально допустимое значение — 9 999 999 кг. При загрузке каталога вес будет переведен в граммы, так как единицей измерения веса в системе являются граммы.
Примечание
Вес может быть указан как с помощью данного элемента, так и с помощью параметра со специальной обработкой . Последний был оставлен в целях обратной совместимости. Если для одного и того же товара вес будет указан одновременно и с помощью элемента, и с помощью параметра, то будет взято последнее встретившееся значение. Также обратите внимание на то, что для параметра возможно указание единицы измерения веса, для данного же элемента ( ) единица измерения — всегда килограмм, и её указывать не надо.
— Штрих-код товара. Может быть указан как с помощью данного элемента, так и с помощью параметра со специальной обработкой . Формат: строка длиной до 255 символов включительно, состоящая только из цифр и латинских букв.
— признак необходимости маркировки товара. Если товар подлежит маркировке, необходимо передать Y , в противном случае нужно передать N или опустить элемент. Если данный признак будет отличаться для торговых предложений одного и того же товара, то будет установлено значение из последнего торгового предложения.
Значение элемента используется при обмене со складской системой (1C, МойСклад) данными о товарах и заказах.
Параметры со специальной обработкой
В списке представлены code параметров, которые имеют специальную обработку в системе:
article — артикул торгового предложение; Произвольная строка;
weight — вес торгового предложение в граммах; Вес переведенный в граммы должен быть целым или дробным числом с точностью до 3 знаков после запятой в промежутке от 0 до 9 999 999 999;
description — описание торгового предложения;
barcode — штрих-код торгового предложения.
color — цвет торгового предложения;
size — размер торгового предложения.
Для параметров color и size будет выведено системное название поля и проигнорировано то, что задано в файле.
Обратите внимание, что поле description в системе не выводится. Его можно использовать в twig-шаблонах. Например, для вывода в печатных формах.
также допускается указание значений веса с указанием сокращенных единиц измерения веса (г, кг, ц, т)
1.02 0.2 кгпри загрузке каталога вес будет переведен в граммы, т.к. единицей измерения веса в системе являются граммы.