Registro de catálogo

Nesta seção explicamos um pouco sobre os recursos relacionados ao envio das informações de um novo cadastro de produtos

Esta chamada será utilizada para enviar uma sugestão de um novo produto para o Marketplace. Toda vez que o serviço de "Notificação de Catálogo (Change Notification)" retornar o status 404, significa que o SKU em questão não foi encontrado no Marketplace, portanto será enviado o produto para aprovação e cadastro.

Para que essa notificação aconteça, o Seller irá chamar o endpoint fornecido pelo Marketplace.

Endpoint

Send SKU Suggestion

PUT https://{environmentMarketplace}/suggestions/{sellerId}/{sellerSkuId}

Path Parameters

Name	Type	Description
{environmentMarketplace}*	string	URL da API do Marketplace
{sellerId}*	string	ID da conta do Seller
{sellerSkuId}*	string	ID do SKU no Seller

Headers

Name	Type	Description
X-VTEX-API-AppKey*	string	{{appKey}}
X-VTEX-API-AppToken*	string	{{appToken}}
Accept*	string	application/json
Content-Type*	string	application/json

200: OK SKU recebido pelo Marketplace com sucesso

400: Bad Request Se a requisição não atender os requisitos mínimos

{
  "errorCode": "string",
  "message": "string"
}

401: Unauthorized Se a requisição não for autenticada

500: Internal Server Error Se ocorrer um erro no servidor

{
  "errorCode": "string",
  "message": "string"
}

Será enviado no Header as chaves de autenticação que poderão ser utilizada pelo Marketplace para validação caso seja conveniente

Descrição dos campos:

• ProductName * (string): nome do produto sugerido. O campo deverá respeitar o limite de 150 caracteres.

• ProductId * (string): SKU do produto no Seller.

• ProductDescription * (string): descrição das principais informações relacionadas ao produto. Como padrão será enviado no formato "Texto", caso o Marketplace necessite que seja enviado em outro formado poderá escolher em "HTML" que será incluído a melhor formatação aplicada pelo Seller ou em "HTML Simples" aplicando tags padrões. Para isto deve entrar em contato conosco

• BrandName * (string): nome da marca do produto.

• SkuName * (string): nome do SKU sugerido.

• SellerId * (string): ID do seller criado pelo Marketplace.

• Height * (integer): altura do SKU. Unidade de medida esta em milímetro (mm)

• Width * (integer): largura do SKU. Unidade de medida esta em milímetro (mm)

• Length * (integer): comprimento do SKU. Unidade de medida esta em milímetro (mm)

• WeightKg * (integer): peso do SKU em quilogramas, sem separador de casas decimais, considere apenas 2 dígitos.

• RefId ** (string): código de referência do SKU. Obrigatório caso não seja informado o EAN.

• EAN ** (string): código de referência do SKU. Obrigatório caso não seja informado o RefId.

• SellerStockKeepingUnitId * (string): ID do Sku registrado no Seller. Quando produto sem variação será o mesmo valor informado no campo ProductID, já quando existir a variação será o ID correspondente. Este será o SKU que deve ser retornado no pedido.

• CategoryFullPath * (string): caminho completo para a categoria do SKU. Exemplo: um sku que está na categoria Forno que é filha do departamento eletrodomésticos deverá ter o valor "Eletrodomésticos/Forno".

• SkuSpecifications *** (array of objects): lista de objetos que conterá as caracteristicas do SKU. Preenchido apenas quando o SKU pertencer a um Produto com variação

  • FieldName * (string): nome do campo de especificação do SKU. Exemplo: "Cor"

  • FieldValues * (string): valor da especificação do SKU para o campo em questão. Exemplo "Vermelho"

• ProductSpecifications *** (array of objects): lista de objetos que conterá as caracteristicas do Produto.

  • FieldName * (string): nome do campo de especificação do Produto. Exemplo: "Fabricante"

  • FieldValues * (string): valor da especificação do Produto para o campo em questão. Exemplo "Fast"

• Image * (array of objects): Lista de objetos que conterá as imagens do SKU em questão.

  • imageName * (string): Nome da imagem do SKU.

  • imageUrl * (string): URL da imagem do SKU.

• MeasurementUnit (string): unidade de medida para o SKU. Se nulo, o padrão é "un".

• UnitMultiplier (integer): multiplicador de unidades para o SKU. Se nulo, o padrão é 1.

• AvailableQuantity (integer): quantidade de estoque do SKU.

• Pricing * (object): Informações do Preço do SKU

  • ListPrice * (integer): valor de listagem do sku ("Preço de"), sem separador de casas decimais. Os dois últimos dígitos são os centavos. Este campo será visualizado apenas para Marketplace Não-VTEX

  • SalePrice * (integer): valor de venda do sku ("Preço por"), sem separador de casas decimais. Os dois últimos dígitos são os centavos.

  • Currency (string): código do pais da precificação. Exemplo "BRL"

  • CurrencySymbol (string): Símbolo da moeda relacionada a precificação. Exemplo "R$"

* Campos obrigatórios ** Um dos campos obrigatório. RefId obrigatório, caso o campo EAN seja nulo. *** Lista que irá conter pelo menos 1 objeto.

Exemplo do Request

Produto Simples

{
    "ProductName": "Capa Teclado para Galaxy Tab S6 de Policarbonato e Polímero plástico PU Cinza - Samsung - EF-DT860BJPGBR",
    "ProductId": "SGEFDT860BCNZ",
    "ProductDescription": "Capa Teclado para Galaxy Tab S6, fabricada em policarbonato\r\nCaracterísticas\r\nTipo: Capa Teclado\r\nCompatibilidade: Galaxy Tab S6\r\n\r\nEspecificação Técnicas\r\nModelo: EF-DT860BJPGBR\r\nMaterial: Policarbonato e Polímero plástico PU\r\nCor: Cinza\r\nEAN: 8806090101595\r\nGarantia: 3 meses\r\n\r\nDimensões e Peso\r\nDimensões do produto sem embalagem (AxLxP): 245x162x15,6 mm\r\nDimensões do produto com embalagem (AxLxP): 255.9x172.28x20.9 mm\r\nPeso do produto sem embalagem: 0,36 kg\r\nPeso do produto com embalagem: 0,40 kg\r\n\r\nItens Inclusos\r\n01 Capa",
    "BrandName": "SAMSUNG",
    "SkuName": "Capa Teclado para Galaxy Tab S6 de Policarbonato e Polímero plástico PU Cinza - Samsung - EF-DT860BJPGBR",
    "SellerId": "FSH",
    "Height": 255,
    "Width": 172,
    "Length": 20,
    "WeightKg": 40,
    "RefId": "8806090101595",
    "EAN": "8806090101595",
    "SellerStockKeepingUnitId": "SGEFDT860BCNZ",
    "CategoryFullPath": "Smartphones/cabos e acessórios/outros",
    "SkuSpecifications": [],
    "ProductSpecifications": [
        {
            "fieldName": "Cor",
            "fieldValue": "Cinza"
        },
        {
            "fieldName": "Voltagem",
            "fieldValue": "NA"
        },
        {
            "fieldName": "TIPO_CODIGO_DE_BARRAS",
            "fieldValue": "13"
        },
        {
            "fieldName": "Cubagem Líquido",
            "fieldValue": "0.1"
        },
        {
            "fieldName": "Cubagem Bruto",
            "fieldValue": "0.1"
        },
        {
            "fieldName": "Largura do produto sem embalagem",
            "fieldValue": "162"
        },
        {
            "fieldName": "Disponibilidade SP",
            "fieldValue": "0"
        },
        {
            "fieldName": "Click Collect",
            "fieldValue": "Sim"
        }
    ],
    "Images": [
        {
            "imageName": "SGEFDT860BCNZ_G.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/SGEFDT860BCNZ_G.jpg"
        },
        {
            "imageName": "SGEFDT860BCNZ_G1.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/SGEFDT860BCNZ_G1.jpg"
        },
        {
            "imageName": "SGEFDT860BCNZ_G2.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/SGEFDT860BCNZ_G2.jpg"
        },
        {
            "imageName": "SGEFDT860BCNZ_G3.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/SGEFDT860BCNZ_G3.jpg"
        },
        {
            "imageName": "SGEFDT860BCNZ_G4.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/SGEFDT860BCNZ_G4.jpg"
        },
        {
            "imageName": "SGEFDT860BCNZ_G5.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/SGEFDT860BCNZ_G5.jpg"
        },
        {
            "imageName": "SGEFDT860BCNZ_G6.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/SGEFDT860BCNZ_G6.jpg"
        }
    ],
    "MeasurementUnit": "un",
    "UnitMultiplier": 1,
    "AvailableQuantity": 553,
    "Pricing": {
        "Currency": "BRL",
        "ListPrice": 86178,
        "SalePrice": 86178,
        "CurrencySymbol": "R$"
    }
}

Produto com Variação

{
    "ProductName": "Refrigerador Multidoor Electrolux de 03 Portas Frost Free com 579 Litros Painel Eletrônico Inox - DM84X",
    "ProductId": "EXDM84X_PRD",
    "ProductDescription": "Destaques\r\n\r\nMultidoor super flexível\r\nDiversas opções de configurações para adaptar o Refrigerador as suas necessidades..\r\n\r\nPrateleiras Fast Adapt\r\nPrateleiras retráteis que possibilitam organizar itens de diferentes tamanhos e formatos.\r\n\r\nDrink Express\r\nResfria garrafas e latas de bebidas rapidamente quando acionado pelo painel.\r\n\r\nGaveta de frutas e legumes com Hortinatura\r\nPreserva frutas e verduras por até 60% mais tempo do que as gavetas comuns (resultado aferido em alface crespa, alface lisa e rúcula).\r\n\r\nTurbo Freezer\r\nResfria e congela rapidamente os itens, conservando melhor os alimentos.\r\n\r\nIce Twister\r\nGela a qualquer hora de forma prática e simples.\r\n\r\nPorta-ovos - 12 unidades\r\nOrganização e segurança para armazenar os ovos.\r\n\r\nPés niveladores frontais e rodízios traseiros\r\nFácil nivelamento e movimentação do produto.\r\n\r\nSistema Frost Free\r\nNão precisa descongelar nunca.\r\n\r\nCaracterísticas\r\nTipo: French Door (Freezer Invertido)\r\nQuantidade de Portas: 3\r\nFrost Free\r\nPainel Eletrônico\r\nPrateleiras: 03 prateleiras internas no refrigerador, 04 prateleiras em cada contra porta do refrigerador e 02 prateleiras na contra porta do freezer\r\nAlarme de Porta Aberta\r\nFunção Gelo Rápido\r\nDegelo Automático\r\nControle de Temperatura para Bebidas\r\nGavetas: 04\r\nPés Niveladores\r\n\r\nEspecificações Técnicas\r\nModelo: DM84X\r\nCor: Inox (Porta) e Cinza (Laterais)\r\nCapacidade Total: 579 Litros\r\nCapacidade de Armazenamento do Freezer: 188 Litros\r\nCapacidade de Armazenamento do Refrigerador: 391 Litros\r\nSelo Procel (Eficiência Energética): A\r\nConsumo de Energia: 75 KWh/mês\r\nFrequência: 60Hz\r\nVoltagem: 110V e 220V (não é bivolt)\r\nEAN: 7896584073591 (110V) e 7896584073607 (220V)\r\nGarantia: 12 meses\r\n\r\nDimensões e Peso\r\nDimensões do produto sem embalagem (AxLxP): 1900x835x795 mm\r\nDimensões do produto com embalagem (AxLxP): 1922x870x823 mm\r\nPeso do produto sem embalagem: 113 Kg\r\nPeso do produto com embalagem: 115 Kg\r\n\r\nItens Inclusos\r\n01 Refrigerador\r\nManual\r\n\r\nServiço de Instalação e Orientação de Uso\r\nPara sua comodidade e segurança, a Fast Shop dispõe do serviço de Instalação e Orientação de Uso*. Agendamos o serviço para você, executamos a instalação com equipes próprias especializadas e autorizadas pelo fabricante, ensinamos como utilizar os produtos da melhor forma e temos uma área de qualidade para acompanhar e garantir que tudo dê certo. É rápido e fácil.\r\nVocê pode contratar o serviço com o nosso Televendas pelo tel.: [phone] ou em uma de nossas lojas. Consulte os valores e regiões atendidas.\r\n\r\n* Verifique com nossos vendedores se a Fast Shop realiza a instalação desse produto.",
    "BrandName": "Electrolux",
    "SkuName": "Refrigerador Multidoor Electrolux de 03 Portas Frost Free com 579 Litros Painel Eletrônico Inox - DM84X",
    "SellerId": "FSH",
    "Height": 1922,
    "Width": 870,
    "Length": 823,
    "WeightKg": 11500,
    "RefId": "7896584073607",
    "EAN": "7896584073607",
    "SellerStockKeepingUnitId": "EXDM84X2",
    "CategoryFullPath": "Eletrodomésticos/refrigeradores/multi - portas /  french door",
    "SkuSpecifications": [
        {
            "fieldName": "Voltagem",
            "fieldValue": "220V"
        },
        {
            "fieldName": "Cor",
            "fieldValue": "INOX"
        }
    ],
    "ProductSpecifications": [
        {
            "fieldName": "Capacidade",
            "fieldValue": "Acima de 500 litros"
        },
        {
            "fieldName": "Porta Taças",
            "fieldValue": "Não"
        },
        {
            "fieldName": "Painel Eletrônico",
            "fieldValue": "Sim"
        },
        {
            "fieldName": "Gelo Rápido",
            "fieldValue": "Sim"
        },
        {
            "fieldName": "Dispenser de Agua",
            "fieldValue": "Não"
        },
        {
            "fieldName": "Dispenser de Gelo",
            "fieldValue": "Não se aplica"
        },
        {
            "fieldName": "Conexão de Ponto de Água",
            "fieldValue": "Não"
        },
        {
            "fieldName": "Porta-Garrafas",
            "fieldValue": "Não"
        },
        {
            "fieldName": "Controle Automático de Temperatura",
            "fieldValue": "Sim"
        },
        {
            "fieldName": "Portas Reversíveis",
            "fieldValue": "Não"
        },
        {
            "fieldName": "Portas",
            "fieldValue": "03 Portas"
        },
        {
            "fieldName": "Frost Free",
            "fieldValue": "Sim"
        },
        {
            "fieldName": "Tipo",
            "fieldValue": "French Door"
        },
        {
            "fieldName": "Alarme de Portas Abertas",
            "fieldValue": "Sim"
        },
        {
            "fieldName": "Porta-Latas",
            "fieldValue": "Não"
        },
        {
            "fieldName": "Controle de Temperatura para Bebidas",
            "fieldValue": "Sim"
        },
        {
            "fieldName": "Pés Niveladores",
            "fieldValue": "Sim"
        },
        {
            "fieldName": "ProductLineId",
            "fieldValue": "15"
        },
        {
            "fieldName": "Prateleiras",
            "fieldValue": "Removíveis"
        },
        {
            "fieldName": "Capacidade Total",
            "fieldValue": "579 Litros"
        },
        {
            "fieldName": "Consumo de Energia",
            "fieldValue": "75 kWh/mês"
        },
        {
            "fieldName": "Capacidade do Freezer",
            "fieldValue": "188 Litros"
        },
        {
            "fieldName": "Capacidade do Refrigerador",
            "fieldValue": "391 Litros"
        },
        {
            "fieldName": "Gavetas",
            "fieldValue": "04"
        },
        {
            "fieldName": "Garantia",
            "fieldValue": "12 meses"
        }
    ],
    "Images": [
        {
            "imageName": "EXDM84X_G.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/EXDM84X_G.jpg"
        },
        {
            "imageName": "EXDM84X_G1.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/EXDM84X_G1.jpg"
        },
        {
            "imageName": "EXDM84X_G3.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/EXDM84X_G3.jpg"
        },
        {
            "imageName": "EXDM84X_G4.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/EXDM84X_G4.jpg"
        },
        {
            "imageName": "EXDM84X_G5.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/EXDM84X_G5.jpg"
        },
        {
            "imageName": "EXDM84X_GI.jpg",
            "imageUrl": "https://imagens.fastshop.com.br/imgprod/EXDM84X_GI.jpg"
        }
    ],
    "MeasurementUnit": "un",
    "UnitMultiplier": 1,
    "AvailableQuantity": 1212,
    "Pricing": {
        "Currency": "BRL",
        "ListPrice": 599900,
        "SalePrice": 405589,
        "CurrencySymbol": "R$"
    }
}