Atualizando um produto específico

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:

{
  "produtoVarianteId": 0,
  "produtoId": 0,
  "idPaiExterno": "string",
  "idVinculoExterno": "string",
  "sku": "string",
  "nome": "string",
  "nomeProdutoPai": "string",
  "urlProduto": "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,
  "produtoPerigoso": true,
  "garantia": 0,
  "isTelevendas": true,
  "ean": "string",
  "localizacaoEstoque": "string",
  "listaAtacado": [
    {
      "precoPor": 0,
      "quantidade": 0
    }
  ],
  "estoque": [
    {
      "estoqueFisico": 0,
      "estoqueReservado": 0,
      "centroDistribuicaoId": 0,
      "alertaEstoque": 0,
      "permitePreVenda": true,
      "estoquePreVenda": 0,
      "dataLancamento": "2026-06-30T22:46:32.752Z"
    }
  ],
  "atributos": [
    {
      "tipoAtributo": "Selecao",
      "isFiltro": true,
      "nome": "string",
      "valor": "string",
      "exibir": true
    }
  ],
  "quantidadeMaximaCompraUnidade": 0,
  "quantidadeMinimaCompraUnidade": 0,
  "condicao": "Novo",
  "informacoes": [
    {
      "informacaoId": 0,
      "titulo": "string",
      "texto": "string",
      "tipoInformacao": "Informacoes",
      "exibirSite": true
    }
  ],
  "tabelasPreco": [
    {
      "tabelaPrecoId": 0,
      "nome": "string",
      "precoDe": 0,
      "precoPor": 0
    }
  ],
  "categorias": [
    {
      "id": 0,
      "nome": "string",
      "ativo": true,
      "caminhoHierarquia": "string",
      "categoriaPrincipal": true
    }
  ],
  "dataCriacao": "2026-06-30T22:46:32.752Z",
  "dataAtualizacao": "2026-06-30T22:46:32.752Z",
  "urlVideo": "string",
  "spot": true,
  "paginaProduto": true,
  "marketplace": true,
  "somenteParceiros": true,
  "reseller": {
    "resellerId": 0,
    "razaoSocial": "string",
    "centroDistribuicaoId": 0,
    "ativo": true,
    "ativacaoAutomaticaProdutos": true,
    "autonomia": true,
    "buyBox": true,
    "nomeMarketPlace": "string"
  },
  "buyBox": true,
  "consumo": {
    "quantidadeDias": 0,
    "enviarEmail": true
  },
  "prazoValidade": 0,
  "parentId": 0,
  "urlImagem": "string"
}

🚧
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": 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.