A conexão com o marketplace do Grupo Casas Bahia usa a API de seller — a documentação e os endereços antigos ainda trazem a marca Via Varejo, mas é a mesma operação. A credencial é o access_token do seller, informado junto com o ambiente ao qual ele pertence. Não há tela de autorização: você cola o token direto na Toca.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Antes de começar

• Tenha uma conta de seller ativa no marketplace da Casas Bahia.
• Tenha em mãos o access_token do seller. Ele vem do fluxo de onboarding do marketplace, na seleção de integradores, ou do suporte ao seller — confirme na documentação oficial da Casas Bahia Marketplace o caminho exato para a sua conta.
• Saiba para qual ambiente o token vale: Produção ou Homologação. Os dois usam servidores diferentes e o mesmo token não vale nos dois.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Casas Bahia e clique em Conectar.
3. Preencha:
   • access_token do seller — o token emitido para a sua conta.
   • Ambiente — Produção ou Homologação, conforme o token. Escolher o ambiente errado não gera erro: as consultas respondem da base de teste e os relatórios saem zerados.
4. Salve. O card fica marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê o catálogo e as ofertas do seller (preço e estoque), os pedidos por status (novos, aprovados, enviados, entregues e cancelados), o faturamento (NF-e), etiquetas e rastreio no marketplace. A integração é somente leitura: a Toca não altera nada na sua conta de seller.

Enquanto a homologação não termina, a Toca não oferece consulta de receita nesta integração: a semântica financeira dos valores (frete, desconto, comissão) ainda não foi confirmada na API do marketplace.

Manutenção da conexão

O access_token do seller é estático: não há renovação automática do lado da Toca. A expiração e a rotação do token não são documentadas publicamente — confirme na documentação oficial da Casas Bahia Marketplace. Se o token for trocado ou desativado, atualize-o no card em Configurações → Integrações. Por segurança, o token salvo não é exibido de volta.

Problemas comuns

• Relatórios zerados ou consultas vazias — o ambiente selecionado não corresponde ao token: as consultas estão respondendo da base de teste. Confira o campo Ambiente e salve de novo.
• Acesso negado nas consultas — token incorreto, inexistente ou inativo. É estado da conta do seller, não defeito da conexão: verifique a situação da conta com o suporte do marketplace e, se receber um token novo, atualize-o na Toca.
• Token colado com espaços extras — cole o token exatamente como emitido, sem espaços no início ou no fim.