👠Cadastrar produto

Realizando o cadastramento de um novo produto.

Para cadastrar um ou mais produtos a sua loja virtual sua aplicação deve fazer uma requisição do tipo post para o endpoint /produto. No corpo da requisição devem ser informados, no formato JSON, os dados dos produtos a serem cadastrados. O exemplo abaixo mostra como isso deve ser feito:

[
  {
    "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

Cadastra um novo produto.

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

Requisição para registrar um novo produto.

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.
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.
referencia*	String	Referência do item ou produto. Mínimo de 1 caractere e máximo de 30 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.
dimensoes*	Object	largura: Largura do item ou produto em centímetros. Ex: 11. altura: Altura do item ou produto em centímetros. comprimento: Comprimento do item ou produto em centímetros. peso: Peso do item ou produto em gramas. Ex.: 1,5 quilos equivale a 1500.
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 Produto cadastrado com sucesso.

{
    "message":{
      "referencia": "SMGs20",
      "nome": "Smartphone Samsung Galaxy S20+ Preto",
      "descricao": "Produto cadastrado com sucesso.",
    },
    "status": { 200 }
 } 

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

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

409: Conflict Já existe um produto cadastrado com essa referência.

415: Unsupported Media Type A imagem excede 400KB.

500: Internal Server Error Erro ao cadastrar 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.

Exemplo para cadastro de 02 ou mais produtos:

[
  {
    "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..."
    }
  },
  {
    "nome": "Relógio Smartwatch Samsung Galaxy Watch Bt 46mm - Prata",
    "categoria": "Smartwatch",
    "marca": "Samsung",
    "referencia": "WATCHBT01",
    "descricao": "O SmartWatch Galaxy Watch BT da Samsung tem display de 1,2" com tela Super AMOLED, 4GB de
       memória interna, processador Dual-Core, conexão Bluetooth 4.2 e é indicado para uso no dia a dia e na
       prática de exercícios físicos. Com ele, você faz e recebe chamadas, recebe notificações de mensagens,
       tem monitoramento automático de atividades Fitness & Saúde, funções de monitoramento de estresse e sono
       e é resistente à água.",
    "preco": "1145.99",
    "precopromo": "999.99",
    "estoque": "10",
    "dimensoes":{
      "largura": "5",
      "altura": "8",
      "comprimento": "4",
      "peso": "130"
    },
    "imagem":{
      "0": "data:image/png;base64,iVBORw0KGgoAAAA..."
      "1": "data:image/png;base64,iVBORw0KGgoAAAA..."
    }
  }
]