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

POSTCriar produto no banco universal

Cria produtos no banco universal, o repositório central usado pelos sellers para anunciar produtos.

Use este endpoint para criar produtos no banco universal, o repositório central de informações de produtos que os sellers usam depois para anunciar o que vendem. O corpo é um array e o limite é de 60 produtos por requisição. A resposta devolve o ID dos produtos criados.

Importante

Este endpoint exige as credenciais de administrador do marketplace.

POST/api/ProductsSeller

Cria produtos no banco universal

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 com os produtos a criar. 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.
category_idsarrayobrigatório
Array com os IDs das categorias a que o produto pertence.
main_categorynumberobrigatório
ID da categoria principal.
weightstring
Peso do produto em gramas.
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).
product_featuresobject
Objeto com as características do produto em pares chave-valor: a chave é o ID da característica e o valor é o valor dela.

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": "Disney Footwear",
    "brand": "Disney",
    "category_ids": [
      1384,
      1792
    ],
    "main_category": 1384,
    "weight": "180",
    "amount": "230",
    "qty_step": "1",
    "status": "A",
    "product_features": {
      "16": "94",
      "14": "95",
      "20": "Masculino",
      "18": "Disney",
      "9": "36,6cm",
      "8": "23,6cm",
      "19": "31,7cm",
      "4": "0,41kg",
      "7": "PVC"
    }
  }
]'

Resposta

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

200Produto criado
json
{
  "product_id": 973732,
  "product_ids": [
    973732
  ]
}
Vários produtos na mesma requisição

Quando você envia vários produtos em uma requisição, o array product_ids traz o ID de todos os produtos criados e product_id traz o ID do último produto criado.

Dica

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

Veja também

  • Vender um produto
  • Atualizar produtos
  • Criar grupo de variações
Anterior
Produtos por token de app
Próxima
Criar grupo de variações
Nesta página
  • Exemplo de requisição
  • Resposta
  • Veja também