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

bash

curl -X GET "$BASE_URL/api/v1/vendor/channels" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Conexões

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"
    }
  ]
}

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

Status	Quando	Corpo de exemplo
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"}`
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 channels"}`

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

bash

curl -X POST "$BASE_URL/api/v1/vendor/channels/mercadolivre/connect" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Endereço de autorização

json

{
  "authorize_url": "https://auth.mercadolivre.com.br/authorization?response_type=code&state=94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36"
}

Campos da resposta

authorize_urlstring

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

Erros

Status	Quando	Corpo de exemplo
400	`channel` desconhecido.	`{"error":"failed to connect channel","detail":"invalid channel"}`
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"}`

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

bash

curl -X DELETE "$BASE_URL/api/v1/vendor/channels/mercadolivre/disconnect" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Desconectado

json

{
  "disconnected": true
}

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 apagar.	`{"error":"failed to disconnect","detail":"..."}`
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"}`

Veja também

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

bash

curl -X GET "$BASE_URL/api/v1/vendor/channels" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Conexões

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"
    }
  ]
}

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

Status	Quando	Corpo de exemplo
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"}`
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 channels"}`

Conectar um canal

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

bash

curl -X POST "$BASE_URL/api/v1/vendor/channels/mercadolivre/connect" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Endereço de autorização

json

{
  "authorize_url": "https://auth.mercadolivre.com.br/authorization?response_type=code&state=94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36"
}

Campos da resposta

authorize_urlstring

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

Erros

Status	Quando	Corpo de exemplo
400	`channel` desconhecido.	`{"error":"failed to connect channel","detail":"invalid channel"}`
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"}`

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

bash

curl -X DELETE "$BASE_URL/api/v1/vendor/channels/mercadolivre/disconnect" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Desconectado

json

{
  "disconnected": true
}

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 apagar.	`{"error":"failed to disconnect","detail":"..."}`
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"}`