VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API legada/Referência completa/Produtos

POSTEnviar produtos com preço único

Envia produtos com um único preço, em lotes de até 60 por requisição.

Use este endpoint para enviar produtos que têm um único preço, ou seja, sem preço diferente por quantidade ou por segmento de cliente. O corpo é um array de objetos de produto e você pode enviar até 60 produtos por requisição. A resposta devolve o ID dos produtos criados ou atualizados.

POST/api/productsSeller

Envia produtos com preço único

Cabeçalhos

Authorizationstringobrigatório
Basic Auth. Combinação usuário:senha codificada em Base64 (o e-mail e a chave de API do Seller Center).

O corpo deve conter um array de objetos de produto. Você pode enviar até 60 produtos por requisição.

Corpo da requisição

product_codestringobrigatório
Código universal do produto (código de barras).
ncmstring
Código de classificação fiscal NCM.
productstringobrigatório
Nome do produto.
brandstring
Nome da marca.
weightstring
Peso do produto em gramas.
pricestringobrigatório
Preço unitário do produto. Use vírgula como separador decimal, por exemplo "8,99".
amountstringobrigatório
Quantidade disponível em estoque.
qty_stepstringpadrão: 1
Incremento mínimo de quantidade.
statusstringobrigatório
ADH
Status do produto: "A" (ativo), "D" (desativado) ou "H" (oculto).
internal_product_codestring
Número interno do produto no sistema de gestão do fornecedor.
quantity_per_packagestring
Número de unidades por embalagem/fardo. Se for maior que um, o cliente poderá comprar a embalagem fechada além de comprar por unidade.

Exemplo de requisição

bash
curl -X POST "$BASE_URL/api/products" \
  -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "product_code": "7891404130314",
    "ncm": "18069000",
    "product": "Chocolate Sensação 80g",
    "brand": "NESTLE",
    "weight": "80",
    "amount": "230",
    "qty_step": "1",
    "status": "A"
  }
]'

Resposta

O endpoint devolve o ID do produto criado ou atualizado (ou dos produtos, quando o lote tem vários).

201Produto criado (201 Created)
json
{
  "product_id": 934887,
  "product_ids": [
    934887
  ]
}

Erros

StatusQuandoCorpo de exemplo
400Requisição inválida.{"message": "Bad Request", "status": 400}
Dica

Para ter bom desempenho, envie os produtos em lotes de até 60 por requisição. Por exemplo, para atualizar 240 produtos, faça 4 requisições com 60 produtos cada.

Importante

Se você precisa definir preços diferentes por segmento de cliente ou por quantidade do pedido, use o endpoint de envio de produtos com vários preços.

Separador decimal

Neste endpoint o preço é uma string com vírgula como separador decimal ("8,99").

Veja também

  • Enviar produtos com vários preços
  • Atualizar produtos
  • Visão geral de produtos
Anterior
Enviar produtos com vários preços
Próxima
Características do produto
Nesta página
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também