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

POSTVender um produto

Anuncia para venda, com as credenciais do seller, um produto que já existe no banco universal.

Use este endpoint para que um seller anuncie para venda um produto que já existe no banco universal. Diferente da criação no banco universal, que exige credenciais de administrador, este endpoint é usado por cada seller para oferecer o próprio estoque de produtos existentes. Você pode enviar até 60 produtos por requisição.

Nota

Use as credenciais do seller que vai anunciar o produto.

POST/api/ProductsSeller

Anuncia um produto do banco universal para venda

Cabeçalhos

Authorizationstringobrigatório
Basic Auth. Combinação usuário:senha do seller codificada em Base64.

Você pode enviar até 60 produtos por requisição.

Corpo da requisição

productstringobrigatório
Nome do produto.
product_codestringobrigatório
Código de barras/SKU do produto a vender. É a chave usada para identificar o produto.
category_idsarrayobrigatório
Array com os IDs das categorias a que o produto pertence.
pricestringobrigatório
Preço unitário do produto.
amountstringobrigatório
Quantidade disponível em estoque.

Exemplo de requisição

bash
curl -X POST "$BASE_URL/api/Products" \
  -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product": "Test Product Name",
  "product_code": "product_code",
  "category_ids": [
    "1447"
  ],
  "price": "1000",
  "amount": "50"
}'

Resposta

O endpoint devolve o ID dos produtos recém-anunciados.

200Produto anunciado
json
{
  "product_id": 973732,
  "product_ids": [
    973732
  ]
}
Dica

Este endpoint permite que sellers criem anúncios a partir de produtos que já existem no banco universal. Se o produto ainda não existe lá, um administrador precisa criá-lo antes, com o endpoint de criação de produto no banco universal.

Importante

O código do produto precisa ser exatamente igual ao do banco universal. Se não corresponder a nenhum produto existente, a requisição falha.

Veja também

  • Criar produto no banco universal
  • Atualizar produtos
  • Visão geral de produtos
Anterior
Consultar um produto
Próxima
Enviar produtos com vários preços
Nesta página
  • Exemplo de requisição
  • Resposta
  • Veja também