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

Conexões

Lista as conexões do seller com marketplaces, registra uma nova e desconecta.

Listar conexões

Devolve as conexões do seller, da mais nova para a mais antiga, com o total de anúncios de cada uma. Um seller sem conexões recebe {"items": []}.

GET/api/v1/vendor/channelsSeller

Listar conexões

Cabeçalhos

Authorizationstringobrigatório
Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Exemplo de requisição

Resposta

200Conexões

Campos da resposta

itemsobject[]

As conexões.

iduuid
Id da conexão (UUID).
vendor_iduuid
Seller dono (UUID).
channelstring
mercadolivreamazonshopee
Canal.
statusstring
connectedreauth_requireddisabled
Estado da conexão.
external_account_idstring
Id da conta no marketplace. Ausente até a autorização terminar.
listings_countinteger
Anúncios desta conexão.
created_atstring
Criação, RFC 3339 em UTC.

Erros

StatusQuandoCorpo de exemplo
401Token ausente, inválido, expirado ou revogado.invalid or expired token
403O token não é de um usuário seller, ou a loja ainda está em análise de cadastro.{"error":"vendor_pending_review"}
410A loja usa o Hub de Marketplaces próprio e este recurso foi movido para lá.{"error":"crs_markethub_only","moved_to":"markethub"}
500Falha ao listar.{"error":"failed to list channels"}

Conectar um canal

Registra a conexão do seller com o canal (ou reaproveita a que já existe) e devolve o endereço onde o seller autoriza a Venddor no marketplace. A conexão fica com status: reauth_required até a autorização terminar.

POST/api/v1/vendor/channels/{channel}/connectSeller

Conectar um canal

Cabeçalhos

Authorizationstringobrigatório
Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de caminho

channelstringobrigatório
mercadolivreamazonshopee
Canal de venda.

Exemplo de requisição

Resposta

200Endereço de autorização

Campos da resposta

authorize_urlstring
Endereço de autorização do marketplace para abrir no navegador do seller.

Erros

StatusQuandoCorpo de exemplo
400channel desconhecido.{"error":"failed to connect channel","detail":"invalid channel"}
410A loja usa o Hub de Marketplaces próprio e este recurso foi movido para lá.{"error":"crs_markethub_only","moved_to":"markethub"}
401Token ausente, inválido, expirado ou revogado.invalid or expired token
403O token não é de um usuário seller, ou a loja ainda está em análise de cadastro.{"error":"vendor_pending_review"}
O endereço devolvido é mínimo

authorize_url traz apenas response_type=code e state (o id do seller). Ele não inclui o identificador do aplicativo no marketplace. Confirme com a Venddor como a sua loja completa o fluxo de autorização antes de depender dele em produção.

Chamar de novo

É seguro repetir connect: não duplica a conexão, só devolve o endereço outra vez.

Desconectar um canal

Apaga a conexão do seller com o canal e todas as listings dela. Se não existir conexão, a resposta também é de sucesso.

DELETE/api/v1/vendor/channels/{channel}/disconnectSeller

Desconectar um canal

Cabeçalhos

Authorizationstringobrigatório
Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de caminho

channelstringobrigatório
mercadolivreamazonshopee
Canal de venda.

Exemplo de requisição

Resposta

200Desconectado

Erros

StatusQuandoCorpo de exemplo
410A loja usa o Hub de Marketplaces próprio e este recurso foi movido para lá.{"error":"crs_markethub_only","moved_to":"markethub"}
500Falha ao apagar.{"error":"failed to disconnect","detail":"..."}
401Token ausente, inválido, expirado ou revogado.invalid or expired token
403O token não é de um usuário seller, ou a loja ainda está em análise de cadastro.{"error":"vendor_pending_review"}
Anúncios no marketplace continuam

Desconectar remove a conexão e as listings da Venddor, mas não cancela anúncios que já estão publicados no marketplace. Pause-os antes, se for o caso.

Veja também

  • Anúncios
  • Canais de venda
Anterior
Canais de venda
Próxima
Anúncios
Nesta página
  • Listar conexões
  • Exemplo de requisição
  • Resposta
  • Erros
  • Conectar um canal
  • Exemplo de requisição
  • Resposta
  • Erros
  • Desconectar um canal
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também
bash
curl -X GET "$BASE_URL/api/v1/vendor/channels" \
  -H "Authorization: Bearer $TOKEN"
bash
curl -X POST "$BASE_URL/api/v1/vendor/channels/mercadolivre/connect" \
  -H "Authorization: Bearer $TOKEN"
bash
curl -X DELETE "$BASE_URL/api/v1/vendor/channels/mercadolivre/disconnect" \
  -H "Authorization: Bearer $TOKEN"
json
{
  "items": [
    {
      "id": "b4f1c2a0-7d11-4e32-9a5b-0c1d2e3f4a5b",
      "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
      "channel": "mercadolivre",
      "status": "reauth_required",
      "listings_count": 0,
      "created_at": "2026-10-11T22:10:00Z"
    }
  ]
}
json
{
  "authorize_url": "https://auth.mercadolivre.com.br/authorization?response_type=code&state=94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36"
}
json
{
  "disconnected": true
}