Central do CControle Desktop: operar a integração e a loja integrada

Objetivo: acompanhar a integração entre o CControle Desktop (retaguarda) e o C Controle Online pela central Gestão da comunicação. Resultado esperado: você sabe o que cada parte do menu mostra, como ligar e desligar cada parte da integração e o que fazer quando os pedidos param, uma nota fica para conferir no canal ou a loja vende sem estoque.

Como a integração funciona

O CControle Desktop continua sendo a retaguarda da loja: ele envia ao Online o cadastro dos produtos, o saldo de estoque, as fotos e os clientes. O Online aplica o que chega conforme as regras que você salvou e mostra na loja virtual o que você publicou. No caminho de volta, os pedidos pagos são liberados ao Desktop, que importa, fatura e transmite a nota; o XML autorizado volta ao Online, que o entrega à plataforma de origem (marketplace) ou ao comprador da loja própria.

Nada é ligado sozinho: cada parte só passa a valer depois que um administrador liga a opção na central. Enquanto as regras estão no padrão, o Delphi continua gravando direto no banco, como sempre fez.

O que cada aba faz

O menu da central tem sete itens. Configurar e Acompanhar abrem páginas menores, numa segunda linha; em Configurar elas vêm numeradas na ordem de uso (1, 2 e 3). No topo de cada página, uma faixa mostra a situação: comunicação, último contato do Desktop, processamento automático e instalações.

Ligar a integração

1. Em Configurar › 1 Instalações e canais, registre a base do Desktop com a identificação combinada com a equipe Closmaq e clique em Salvar instalação.
2. Na mesma página, use Editar canais e cadastro e clique em Integrado nos canais que o Desktop vai usar. Canal em A mapear guarda o que chega sem aplicar; em Não utilizado, o Online recusa.
3. Em Configurar › 2 Regras da integração, no bloco Produtos e estoque, clique em Pela integração no Cadastro dos produtos e no Saldo de estoque. Como hoje mantém o Delphi gravando direto no banco.
4. Para o Desktop receber as alterações do Online, ligue o interruptor Enviar alterações do Online ao Desktop, no bloco Comunicação com o Desktop. Na primeira vez, o catálogo inteiro entra na fila aos poucos.
5. Clique em Salvar regras (a barra de salvar avisa quando há mudança ainda não salva).
6. Escolha como o Desktop entra no Online: uma credencial em Configurar › 3 Acesso do Desktop (a mais segura) ou o interruptor Aceitar a API Key Dashboard nas regras, com os dados liberados para ela. Acompanhe os primeiros envios em Acompanhar › Recebimentos.

Os pedidos de marketplace só são liberados ao Desktop depois que a Closmaq habilita essa opção para a empresa. Os pedidos da loja própria seguem pelo caminho da loja.

Desligar ou pausar

• Voltar ao modo antigo: em Configurar › Regras da integração, clique em Como hoje no cadastro e no saldo e salve as regras. O que chegar depois fica guardado sem aplicar.
• Pausar sem mexer nas regras: em Configurar › Instalações e canais, use Pausar recebimento. O que o Desktop enviar fica guardado; Retomar devolve tudo como estava.
• Parar o envio ao Desktop: desligue o interruptor Enviar alterações do Online ao Desktop e salve.
• Cortar o acesso pela internet: desligue Aceitar a API Key Dashboard nas regras ou use Revogar na credencial, em Configurar › Acesso do Desktop. O corte vale na hora.
• Tirar a base da central: em Configurar › Instalações e canais, use Arquivar instalação. Nada é apagado e a base pode ser restaurada.

Avisos no sino do topo

Quem tem acesso à central recebe estes avisos em Alertas (Central de Atenção). Eles são conferidos a cada poucos minutos e somem sozinhos quando a situação se resolve.

Ignorar esconde o aviso só para você até o próximo mês. Não exibir mais desliga, para toda a empresa, todos os alertas de integrações (inclusive os de marketplace); use com cuidado.

Quando os pedidos param

1. Confira se o CControle Desktop está ligado no computador da loja e com internet. Se o sino mostra sem comunicação, o problema está no Desktop ou na conexão dele.
2. Se o sino mostra Processamento da integração Desktop parado, chame o suporte Closmaq: é o servidor do Online.
3. Abra Pendências e Recebimentos para ver se há falha na comunicação com a base.
4. Confira se o pedido foi liberado ao Desktop: pedido cancelado, sem pagamento aprovado, já faturado no Online, com comprador sem CPF/CNPJ, com item sem produto vinculado ou sem forma de pagamento não vai para o Desktop até ser corrigido no Online.
5. Depois de corrigir, peça para o Desktop buscar os pedidos de novo. O pedido não é perdido: ele continua na fila até ser importado.

Nota em conferência manual

Quando o Online não consegue confirmar que a nota devolvida pelo Desktop chegou à plataforma (resposta incerta, recusa ou envio bloqueado neste servidor), o retorno fica como Conferir na plataforma, em Pedidos e notas.

1. Abra o pedido no painel da plataforma (Mercado Livre, Shopee e outras) e veja se a nota está anexada.
2. Se não estiver, anexe o XML pelo painel da plataforma ou pela tela de vendas do C Controle.
3. Volte à central, escreva o que foi conferido no campo da linha do retorno e clique em Já conferi na plataforma.

Reprocessar um envio com falha

1. Em Acompanhar › Recebimentos, leia o motivo de cada falha na coluna Estado. Exemplo: “Aguardando o cadastro do produto chegar do Desktop.” Pendências mostra só a contagem e os atalhos.
2. Corrija a causa: cadastre o que falta no Desktop, ligue o canal como Integrado em Configurar › Instalações e canais ou ajuste a regra em Configurar › Regras da integração.
3. Em Recebimentos, clique em Reprocessar no envio. Em Pedidos e notas, o equivalente é Nova tentativa.
4. Conflito não se reprocessa: o Desktop precisa mandar uma versão nova do cadastro. Nunca altere o conteúdo de um envio já recebido.

A loja vendeu sem estoque

1. Veja no sino se o Desktop está sem comunicação ou com envios em falha: o saldo da loja só acompanha o Desktop quando os envios de estoque chegam.
2. Enquanto o problema não for resolvido, use Despublicar nos produtos críticos ou Ligar controle de estoque neles, em Produtos e loja.
3. Fale com o comprador e cancele ou estorne o pedido pela tela de pedidos da loja, se não houver como atender.
4. Quando o Desktop voltar a enviar, confira o saldo dos produtos em Produtos e loja antes de publicar de novo.

Quem faz o quê

Problemas frequentes

• A central diz que a estrutura não está disponível: as atualizações do Online ainda não foram aplicadas no servidor. Chame o suporte Closmaq.
• Envio “Aguardando” com o canal “A mapear”: o canal da instalação está em A mapear e o envio fica guardado sem processar. Clique em Integrado no canal, em Configurar › Instalações e canais.
• O Desktop parou depois de uma API Key nova: a chave antiga deixou de valer. Cadastre a chave nova no Desktop ou use uma credencial em Configurar › Acesso do Desktop.
• Produto não aparece na loja: chegar do Desktop não publica. Use Publicar na loja em Produtos e loja.

Próximo passo

Se a empresa ainda vai trazer os dados antigos do Desktop de uma vez, veja Migrar dados pela Conversão C-Desktop. Para acompanhar os pedidos da loja, consulte Pedidos da loja virtual.

Revisado em: 15/10/2026.