Para atualizar os dados de um produto específico, utilize o endpoint Atualiza um produto.

Parâmetros para atualização:

  • identificador - Valor único utilizado para identificar o produto;
  • tipoIdentificador - Define se o identificador informado é um sku ou um id interno da fstore;
  • produto - Dados do produto a ser atualizado.

Request body:

{
  "idPaiExterno": "string",
  "idVinculoExterno": "string",
  "sku": "string",
  "nome": "string",
  "nomeProdutoPai": "string",
  "exibirMatrizAtributos": "Sim",
  "contraProposta": true,
  "fabricante": "string",
  "autor": "string",
  "editora": "string",
  "colecao": "string",
  "genero": "string",
  "precoCusto": 0,
  "precoDe": 0,
  "precoPor": 0,
  "fatorMultiplicadorPreco": 0,
  "prazoEntrega": 0,
  "valido": true,
  "exibirSite": true,
  "freteGratis": "Sempre",
  "trocaGratis": true,
  "peso": 0,
  "altura": 0,
  "comprimento": 0,
  "largura": 0,
  "garantia": 0,
  "isTelevendas": true,
  "ean": "string",
  "localizacaoEstoque": "string",
  "listaAtacado": [
    {
      "precoPor": 0,
      "quantidade": 0
    }
  ],
  "estoque": [
    {
      "estoqueFisico": 0,
      "estoqueReservado": 0,
      "centroDistribuicaoId": 0,
      "alertaEstoque": 0
    }
  ],
  "listaAtributos": [
    {
      "nome": "string",
      "valor": "string",
      "exibir": true
    }
  ],
  "quantidadeMaximaCompraUnidade": 0,
  "quantidadeMinimaCompraUnidade": 0,
  "condicao": "Novo",
  "urlVideo": "string",
  "spot": true,
  "paginaProduto": true,
  "marketplace": true,
  "somenteParceiros": false,
  "buyBox": false,
  "prazoValidade": 0,
  "consumo": {
    "quantidadeDias": 0,
    "enviarEmail": true
  }
}

🚧

Informações importantes:

  • Se o produto a ser atualizado estiver ativo na plataforma e na atualização os campos valido e exibirSite forem enviados vazios ou null ou não sejam enviados no objeto, o produto permanecerá ativo, da mesma forma, ocorrerá para caso o produto esteja inativo.

  • Caso o produto a ser atualizado esteja ativo na plataforma e na atualização para os campos valido e exibirSite forem informados como true, o produto permanecerá ativo e caso seja informado para os false, o produto será desativado.

  • Ao enviar zero para o campo centroDistribuicaoId do objeto de estoque, será feita a inserção do estoque para o Centro de Distribuição principal.

  • Campos: "prazoValidade", "consumo": { "quantidadeDias", "enviarEmail" } não são obrigatórios, caso não seja enviado, o cadastro ficará com os campos em branco no painel do Administrativo.

  • Quando a loja utiliza a configuração Validar Preço Por abaixo do Preço de Custo, será retornado uma mensagem na API ao realizar um PUT no Produto passando um preço de custo maior que o preço Por

  • Caso queira alterar o SKU de uma variante, o tipoIdentificado deve ser ProdutoVarianteId, e no body informar o novo SKU no campo SKU e remover o campo idVinculoExterno ou caso queira manter o campo, ele deve ser enviado com o mesmo valor do novo SKU.

  • No campo "valor" de um atributos, o mesmo não pode conter mais que 2.000 caracteres, caso contrario irá dar erro e não irá atualizar os dados dos atributos.

  • Estoque deve ser sempre um valor inteiro, hoje a plataforma não suporta um valor fracionado como estoque.

  • Para realizar um desvinculo de parente ID que foi feito com base no mesmo nome, a configuração "Desconsiderar-Nome-Vinculo-Grupo-Produto" deverá estar ativa no admin da loja, após isso terá que ser feito a atualização enviando no campo idVinculoExterno um valor ainda não utilizado em nenhum outro produto, dessa forma o vinculo será desfeito.