🖊️Atualizar produto

Atualizando um produto cadastrado.

Para atualizar um ou mais produtos a sua loja virtual sua aplicação deve fazer uma requisição do tipo PUT para o endpoint /produto. No corpo da requisição devem ser informados, no formato JSON, os produtos que sua aplicação deseja atualizar. A atualização será sempre feita baseada no código de referência do produto. O exemplo abaixo mostra como isso deve ser feito:

Formato do JSON para um produto:

[
  {
    "nome": "Smartphone Galaxy S20+ Preto",
    "categoria": "Smartphones",
    "marca": "Samsung",
    "referencia": "SMGs20",
    "descricao": "Conheça os Galaxy S20, o S20+ e o S20 Ultra. Eles contam com o revolucionário 8K Video Snap,
      que muda a forma como você grava vídeos e tira fotos. Com a segurança do Samsung Knox, uma bateria
      inteligente, um processador poderoso e um espaço de armazenamento enorme, os 3 modelos do Galaxy S20
      revelam um novo mundo para os smartphones.",
    "preco": "4299.99",
    "precopromo": "4099.99",
    "estoque": "10",
    "dimensoes":{
      "largura": "7",
      "altura": "16",
      "comprimento": "4",
      "peso": "186"
    },
    "imagem":{
      "0": "data:image/png;base64,iVBORw0KGgoAAAA..."
      "1": "data:image/png;base64,iVBORw0KGgoAAAA..."
    }
  }
]

Requisição

Atualiza um produto

PUT https://api.vendasbyweb.com.br/v1/produto

Requisição para atualizar um produto cadastrado.

Headers

Name	Type	Description
Authorization*	String	Sua API key.

Request Body

Name	Type	Description
nome*	String	Nome do item ou produto. Mínimo de 15 caracteres e máximo de 255 caracteres.
referencia*	String	Referência do item ou produto. Mínimo de 1 caractere e máximo de 30 caracteres.
categoria	String	Nome da categoria do item ou produto. Mínimo de 2 caracteres e máximo de 100 caracteres.
descricao	String	Descrição de um item ou produto.
marca	String	Nome da marca do item ou produto. Mínimo de 2 caracteres e máximo de 100 caracteres.
preco*	Integer	Valor do item ou produto. Deve-se utilizar o ponto como separador decimal e sem agrupador de milhares. Ex.: 4299.99 equivale a R$ 4.299,99.
precopromo	Integer	Valor promocional do item ou produto. Deve-se utilizar o ponto como separador decimal e sem agrupador de milhares. Ex.: 4099.99 equivale a R$ 4.099,99.
estoque*	Integer	Quantidade em estoque do item ou produto.
imagem	Object	Imagens do item ou produto. Deve-se utilizar imagens no formato Base64. O tamanho de cada imagem não pode exceder 400KB.

200: OK

{
    "message":{
      "referencia": "SMGs20",
      "preco": "4299.99",
      "estoque": "10",
      "descricao": "Produto atualizado com sucesso.",
    },
    "status":{ 200 }
 }

400: Bad Request JSON informado não está no formato correto.

401: Unauthorized Requisição não autorizada para este usuário.

500: Internal Server Error Erro ao atualizar o produto.

Podem ser enviados no corpo de uma mesma requisição um JSON contendo até 10 produtos.

ATENÇÃO: Antes de cadastrar a descrição de um produto, você precisa criar uma guia chamada "Descrição" no painel administrativo da sua loja.