Anúncios
Lista os anúncios de um canal, enfileira a publicação de produtos e pausa um anúncio.
Listar anúncios
Devolve as listings do seller no canal, da atualizada há menos tempo para a mais antiga. Sem conexão ou sem anúncios a lista vem vazia, sem erro.
/api/v1/vendor/channels/{channel}/listingsSellerListar anúncios
Cabeçalhos
AuthorizationstringobrigatórioBearer $TOKEN. Token de acesso do usuário seller (veja Tokens).Parâmetros de caminho
channelstringobrigatóriomercadolivreamazonshopeeCanal de venda.
Exemplo de requisição
Resposta
200Anúncios
Campos da resposta
itemsobject[]As listings.
iduuidId da listing (UUID).
connection_iduuidConexão (UUID).
product_iduuidProduto (UUID).
product_namestringNome do produto.
external_idstringId do anúncio no marketplace. Ausente enquanto não confirmado.
external_category_idstringCategoria do marketplace usada na publicação.
statusstringpendingpublishederrorpausedclosedEstado do anúncio.
last_errorstringÚltimo erro de sincronização. Ausente quando não há.
last_synced_atstringÚltima sincronização, RFC 3339 em UTC. Ausente se nunca sincronizou.
Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 410 | A loja usa o Hub de Marketplaces próprio e este recurso foi movido para lá. | {"error":"crs_markethub_only","moved_to":"markethub"} |
| 500 | Falha ao listar. | {"error":"failed to list listings"} |
| 401 | Token ausente, inválido, expirado ou revogado. | invalid or expired token |
| 403 | O token não é de um usuário seller, ou a loja ainda está em análise de cadastro. | {"error":"vendor_pending_review"} |
Publicar produtos
Cria (ou reinicia) uma listing pending para cada produto informado e enfileira a publicação. Se o produto já tem listing neste canal, ela volta para pending e a categoria é atualizada.
/api/v1/vendor/channels/{channel}/listingsSellerPublicar produtos
Cabeçalhos
AuthorizationstringobrigatórioBearer $TOKEN. Token de acesso do usuário seller (veja Tokens).Content-Typestringobrigatórioapplication/json.Parâmetros de caminho
channelstringobrigatóriomercadolivreamazonshopeeCanal de venda.
Corpo da requisição
product_idsuuid[]obrigatórioProdutos a publicar. Só os produtos do seller (e não apagados) são considerados.
external_category_idstringId da categoria no marketplace. Se omitido, mantém a categoria já usada.
Exemplo de requisição
Resposta
200Publicação enfileirada
Campos da resposta
queuedintegerQuantos produtos foram enfileirados. Ids que não são do seller, ou de produtos apagados, não contam e não geram erro.
Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 400 | Corpo que não é JSON, ou o seller não tem conexão com o canal. | {"error":"failed to publish","detail":"channel not connected"} |
| 410 | A loja usa o Hub de Marketplaces próprio e este recurso foi movido para lá. | {"error":"crs_markethub_only","moved_to":"markethub"} |
| 401 | Token ausente, inválido, expirado ou revogado. | invalid or expired token |
| 403 | O token não é de um usuário seller, ou a loja ainda está em análise de cadastro. | {"error":"vendor_pending_review"} |
Pausar anúncio
Marca a listing como paused na hora e enfileira a pausa no marketplace.
/api/v1/vendor/channels/listings/{id}/pauseSellerPausar anúncio
Cabeçalhos
AuthorizationstringobrigatórioBearer $TOKEN. Token de acesso do usuário seller (veja Tokens).Parâmetros de caminho
iduuidobrigatórioId da listing (UUID).
Exemplo de requisição
Resposta
200Pausado
Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 400 | Listing inexistente ou de outro seller. | {"error":"failed to pause listing","detail":"listing not found"} |
| 410 | A loja usa o Hub de Marketplaces próprio e este recurso foi movido para lá. | {"error":"crs_markethub_only","moved_to":"markethub"} |
| 401 | Token ausente, inválido, expirado ou revogado. | invalid or expired token |
| 403 | O token não é de um usuário seller, ou a loja ainda está em análise de cadastro. | {"error":"vendor_pending_review"} |