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

Canais de venda

Como o seller publica seus produtos em Mercado Livre, Amazon e Shopee pela API do painel do seller.

O hub de canais deixa o seller (lojista) vender os mesmos produtos em marketplaces externos, sem sair do painel da Venddor. Há três canais: Mercado Livre, Amazon e Shopee. O seller conecta a própria conta de cada marketplace e depois publica produtos nele; a plataforma mantém os anúncios (listings) sincronizados com o catálogo. Esta seção documenta as seis rotas /api/v1/vendor/channels.

Pontos principais
  • Os canais válidos são mercadolivre, amazon e shopee. Qualquer outro nome volta 400 em connect.
  • Uma conexão liga um seller a um canal. Uma listing liga um produto a uma conexão.
  • Publicar e pausar não são imediatos: a plataforma enfileira o trabalho e a listing muda de status quando a fila roda.
  • Só os produtos do próprio seller podem ser publicados. Ids de produto alheios são ignorados em silêncio.
  • Lojas que usam o Hub de Marketplaces próprio respondem 410 em todas estas rotas.

Como funciona

  1. Conectar

    POST /vendor/channels/{channel}/connect registra a conexão e devolve o endereço de autorização do marketplace. O seller abre o endereço e autoriza a Venddor a agir em nome dele.

  2. Publicar

    POST /vendor/channels/{channel}/listings com os ids de produto cria uma listing pending para cada um e enfileira a publicação.

  3. Acompanhar

    GET /vendor/channels/{channel}/listings mostra o status de cada anúncio, o último erro e quando foi sincronizado. Mudanças de preço e estoque do produto reenfileiram a sincronização sozinhas.

  4. Pausar ou desconectar

    POST /vendor/channels/listings/{id}/pause pausa um anúncio. DELETE /vendor/channels/{channel}/disconnect apaga a conexão e todos os anúncios dela.

Status da conexão (status):

ValorSignificado
connectedConexão ativa.
reauth_requiredConexão registrada, mas a autorização no marketplace ainda não foi concluída ou expirou. É o status em que connect a cria.
disabledConexão desativada.

Status da listing (status):

pending→published→paused
ValorSignificado
pendingPublicação enfileirada.
publishedA fila processou a publicação.
errorFalhou; veja last_error.
pausedPausada pelo seller.
closedEncerrada.

Conceitos-chave

Conexão e listing

Uma conexão é única por par (seller, canal): chamar connect de novo reaproveita a mesma. Apagar a conexão apaga as listings dela (em cascata), mas não remove os anúncios que já estão no marketplace.

Ids

Todos os ids são UUID (texto): id da conexão, connection_id, id da listing e product_id.

Endpoints

MétodoCaminhoPara que servePágina
GET/api/v1/vendor/channelsLista as conexões do seller.Conexões
POST/api/v1/vendor/channels/{channel}/connectRegistra a conexão e devolve o endereço de autorização.Conexões
DELETE/api/v1/vendor/channels/{channel}/disconnectApaga a conexão e as listings.Conexões
GET/api/v1/vendor/channels/{channel}/listingsLista os anúncios de um canal.Anúncios
POST/api/v1/vendor/channels/{channel}/listingsEnfileira a publicação de produtos.Anúncios
POST/api/v1/vendor/channels/listings/{id}/pausePausa um anúncio.Anúncios

Erros comuns

  • Publicar antes de conectar. listings exige uma conexão já registrada; sem ela a resposta é 400 channel not connected.
  • Achar que queued é o número de produtos enviados. queued conta só os produtos que eram do seller e foram enfileirados. Os demais sumiram sem erro.
  • Tratar published como prova de que o marketplace recebeu. Confira external_id: ele só vem preenchido quando o canal devolve o id do anúncio.
  • Usar o endereço de connect como se fosse completo. Veja o aviso na página de Conexões.
  • Desconectar para "pausar tudo". Desconectar apaga as listings da Venddor. Para pausar, use pause em cada anúncio.
  • Esperar mudança imediata. Depois de publish ou pause, leia as listings de novo mais tarde.

Próximos passos

Conexões
Listar, conectar e desconectar.
Anúncios
Publicar, listar e pausar.
Anterior
Fluxo de separação
Próxima
Conexões
Nesta página
  • Como funciona
  • Conceitos-chave
  • Conexão e listing
  • Ids
  • Endpoints
  • Erros comuns
  • Próximos passos