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:
{
"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
eexibirSite
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
eexibirSite
forem informados comotrue
, o produto permanecerá ativo e caso seja informado para osfalse
, 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.
Updated 18 days ago