Acesso Comercial / Docs / Office / API
Ctrl K
MUTATION

updateProduct

Atualiza os dados de um produto existente. Requer permissão products:write.

Assinatura

mutation {
  updateProduct(input: OfficeApiUpdateProductInput!): OfficeApiProductResult

Parâmetros de Input

CampoTipoObrigatórioDescrição
idID!SimID global do produto a ser atualizado.
titleStringNãoNovo nome do produto.
descriptionStringNãoNova descrição (aceita HTML).
priceFloatNãoNovo preço de venda.
categoryStringNãoCategoria do produto.
base64Images[String]NãoNovas imagens em base64. Substitui todas as imagens anteriores. Veja Upload de Imagens.
filenames[String]NãoNomes dos arquivos de imagem.
section[String]NãoSeção/departamento.
isActiveBooleanNãoAtivar ou desativar o produto.
brandStringNãoMarca do produto.
shippingInfoShippingInfoInputNãoDados de envio (peso, dimensões).
menu[String!]NãoIDs dos menus.
groups[String]NãoGrupos/tags.
seoSeoInputNãoMeta tags SEO.
Nota: Apenas envie os campos que deseja alterar (além do id obrigatório). Campos não enviados mantêm o valor anterior.
Imagens: Ao enviar base64Images, as imagens anteriores são substituídas. Se quiser manter as existentes, inclua-as novamente junto com as novas.

Retorno

CampoTipoDescrição
successBooleanSe a operação foi bem sucedida.
productIdIDID global do produto atualizado.
productProductProduto atualizado.

Atualizar Preço e Título

GraphQL
mutation {
  updateProduct(input: {
    id: "UHJvZHVjdDo2MTIz..."
    title: "Camiseta Azul Premium"
    price: 59.90
  }) {
    success
    product {
      id
      title
      price
    }
  }
}

Desativar Produto

GraphQL
mutation {
  updateProduct(input: {
    id: "UHJvZHVjdDo2MTIz..."
    isActive: false
  }) {
    success
  }
}

Atualizar Imagens

GraphQL
mutation($input: OfficeApiUpdateProductInput!) {
  updateProduct(input: $input) {
    success
    product {
      images {
        url
      }
    }
  }
}