A conexão com o marketplace MadeiraMadeira é feita pelo token de seller emitido no Portal Marketplace, junto com a escolha do ambiente (Produção ou Sandbox). Nenhuma senha de usuário é usada.

Antes de começar

• Tenha o cadastro de seller concluído e os Termos assinados no Portal Marketplace da MadeiraMadeira — o token só é liberado depois disso.
• Localize o token no Portal Marketplace, em Administração → Integração.
• Saiba qual ambiente o seu token pertence: Produção (a operação real) ou Sandbox (base de testes). Os dois usam servidores diferentes e a mesma credencial não vale nos dois.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card MadeiraMadeira e clique no botão de conexão.
3. Preencha os dois campos:
   • token — o token do seller, copiado de Administração → Integração no Portal Marketplace.
   • environment — o ambiente do token: Produção ou Sandbox. Para acompanhar a operação real, escolha Produção.
4. Salve. O card fica marcado como conectado e a Toca já consegue consultar a operação.

O que a Toca acessa

Com a conexão ativa, a Toca lê a operação de quem vende como seller no marketplace MadeiraMadeira: vendas, pedidos, faturamento e comissão; catálogo, preço, estoque e prazo de expedição; lançamentos financeiros (repasses e saques); tabelas de frete e a árvore de categorias. A integração é somente de leitura: a Toca não altera nada no marketplace.

Manutenção da conexão

O token do Portal Marketplace é estático e não expira sozinho: a conexão permanece ativa até o token ser revogado ou trocado no portal, ou até você desconectar a integração na Toca. Se o token deixar de valer, o card em Configurações → Integrações passa a indicar que a conexão precisa ser refeita.

Problemas comuns

• Relatórios saem zerados com vendas acontecendo — o sinal clássico de ambiente errado: com Sandbox selecionado, as consultas respondem da base de teste, sem erro nenhum. Troque o campo de ambiente para Produção e atualize a conexão.
• Não encontro o token no portal — o token em Administração → Integração só é liberado depois do cadastro de seller concluído e dos Termos assinados. Finalize o cadastro no Portal Marketplace.
• Erro de autenticação nas consultas — confira se o token foi colado inteiro, sem espaços extras, e se o ambiente selecionado é o mesmo para o qual o token foi emitido.