Central de ajuda
Integre sua operação sem depender de suporte
Siga as etapas abaixo para conectar o Bling, Shopify ou WooCommerce, entender o caminho do pedido e saber exatamente quando ele será considerado pago.
Visão geral
O caminho do pedido
O Bling envia o pedido e seus itens para a Caps+Log.
Comparamos pedido, SKU, quantidade, endereço e valor.
Consultamos a loja de origem para provar o pagamento.
Só pedidos confirmados aparecem na fila de pagos.
Importante: receber o pedido no Bling não significa que ele foi pago. Pedidos sem prova ficam aguardando confirmação e não são liberados para despacho.
Como conectar o Bling
O Bling reúne as vendas da sua empresa. Nesta versão, a Caps+Log recebe os pedidos pelo Bling e consulta a Shopify ou o WooCommerce para verificar o pagamento. Por isso, comece por esta conexão.
Antes de clicar
Tenha acesso à conta Bling da empresa que vai usar a Caps+Log. Sua loja virtual precisa estar configurada para enviar pedidos a essa conta. Conectar o Bling à Caps+Log não configura automaticamente a ligação entre sua loja e o Bling.
- Abra Integrações na Caps+Log. No cartão Bling, clique em Conectar Bling. Se aparecer “Aguardando ativação”, a equipe Caps+Log ainda precisa liberar o aplicativo. Esse aviso não é um erro da sua conta.
- Entre no Bling. Você será levado à página de autorização. Use a conta da empresa correta e permita o acesso solicitado. A senha do Bling é informada no próprio Bling.
- Confira o retorno. Ao voltar à Caps+Log, verifique o nome e o CNPJ em Suas contas Bling. A conexão deve aparecer como Conectado.
- Confira os pedidos. Abra Ver pedidos recebidos. A busca começa a partir da conexão; todo o histórico antigo não é importado automaticamente. Se não houver uma nova venda, a lista pode continuar vazia.
- Conecte a plataforma da loja. Volte a Integrações e escolha Shopify ou WooCommerce. Essa segunda conexão permite consultar o pagamento.
Depois da conexão
A consulta é automática. Em Detalhes e opções, você encontra a última consulta e Sincronizar agora, que solicita uma nova busca. O resultado não é imediato: aguarde o processamento antes de conferir a lista novamente.
Se aparecer Reconectar, autorize novamente a conta. Se houver uma mensagem de erro, leia o motivo junto da empresa. Desconectar interrompe as atualizações e mantém os pedidos já recebidos.
Abrir IntegraçõesAtivar o aplicativo Bling — administrador
Esta configuração é feita pela equipe responsável pela Caps+Log. Os clientes depois usam apenas o botão Conectar Bling.
- Abra Aplicativo Bling e confira o endereço da Caps+Log. Ele deve incluir o caminho da aplicação, por exemplo
http://187.127.55.144:8081/applog. - No cadastro do seu aplicativo Bling, localize o Client ID e o Client Secret. Copie cada valor para o campo com o mesmo nome na Caps+Log. Use os dados do mesmo aplicativo.
- Clique em Salvar configuração. Se já existe um segredo salvo, deixe Client Secret vazio para mantê-lo. Ao trocar o Client ID, informe também o novo segredo.
- Na seção de endereços, copie a URL de redirecionamento e a URL de webhook para o cadastro no Bling. Os endereços mostrados correspondem à configuração salva. Se editar o endereço da Caps+Log, salve antes de copiá-los.
- Habilite a leitura de pedidos de venda e dos dados básicos da empresa. Configure os eventos de criação, atualização e exclusão de pedidos de venda, versão 1.
Salvar esses dados libera a configuração local. Para conferir a autorização real, volte a Integrações e conecte uma conta Bling. Se o Bling exigir HTTPS no cadastro dos endereços, a autorização depende da configuração do domínio e certificado.
Ao mudar de domínio, atualize o endereço na Caps+Log e os endereços correspondentes no Bling. Se o botão Copiar não funcionar no navegador, selecione o texto no campo e copie manualmente.
Abrir configuração do aplicativo BlingComo conectar a Shopify
Escolha Shopify se é nesse painel que você administra as vendas. Você vai associar uma loja recebida do Bling ao endereço da Shopify que vendeu aqueles produtos.
Separe o que vai precisar
Tenha acesso à Shopify com permissão para autorizar aplicativos e o endereço terminado em .myshopify.com. Exemplo: minha-loja.myshopify.com. Esse endereço pode ser diferente do domínio que seus clientes usam para comprar.
- Abra Configurar Shopify. Na aba Integrações, clique no botão do cartão Shopify. Será aberta a página exclusiva dessa plataforma.
- Localize a loja correta. Confira a empresa, o identificador da loja no Bling e o exemplo de pedido mostrado. Use o pedido para reconhecer a loja que você deseja conectar.
- Informe o domínio. Digite somente
minha-loja.myshopify.com, semhttps://, barras ou caminhos. Não use um endereço de exemplo: substitua pelo endereço da sua loja. - Autorize. Clique em Autorizar Shopify e conclua a autorização na Shopify. Ao retornar, confira o domínio e o status Conectada.
- Confira uma nova venda. Quando o pedido chegar pelo Bling, consulte os pedidos recebidos na Caps+Log. A loja conectada e o pedido confirmado são verificações diferentes: um pagamento pode estar pendente mesmo com a conexão correta.
Se não aparecer nenhuma loja
A tela Shopify depende de um pedido recebido do Bling com identificação de loja. Confirme primeiro que o Bling está conectado e recebeu uma venda dessa Shopify. Depois solicite a sincronização na Caps+Log. Se o aplicativo Shopify estiver aguardando configuração, o administrador precisa ativá-lo antes da autorização.
Quando o pagamento é confirmado?
A consulta verifica pagamento integral, venda ou captura eletrônica bem-sucedida, moeda em reais e correspondência do valor, dos códigos dos produtos e das quantidades. Uma autorização de cartão ainda sem captura não basta. Pedidos marcados como teste, pagamentos manuais, pagamentos parciais, cancelamentos e reembolsos não são liberados por essa verificação.
Abrir configuração ShopifyComo conectar o WooCommerce
Escolha WooCommerce se sua loja funciona no WordPress. A configuração tem duas partes: permitir a consulta dos pedidos e cadastrar o endereço para avisos de atualização.
1. Prepare a loja
Você precisa de acesso de administrador ao WordPress, do endereço HTTPS da loja e de uma empresa Bling conectada à Caps+Log. O ID da loja no Bling deve corresponder à origem dos pedidos dessa loja; ele não é o CNPJ nem o número de um pedido. Não invente esse número. Se já recebeu pedidos, confira o identificador mostrado na referência da loja no Bling.
2. Gere os códigos de acesso
- No WordPress, abra WooCommerce → Configurações → Avançado → REST API e adicione uma chave.
- Use a descrição Caps+Log, escolha um usuário com acesso aos pedidos e a permissão Leitura. Gere a chave.
- Copie os dois códigos: Consumer Key e Consumer Secret. O segredo é mostrado uma única vez; guarde-o antes de sair.
Se a API não responder, confira também se os links permanentes do WordPress usam um formato diferente de “Simples”. Instruções oficiais sobre as chaves WooCommerce.
3. Preencha os campos na Caps+Log
Em Integrações, clique em Configurar WooCommerce. Na empresa correta, preencha:
- ID da loja no Bling
- O número que identifica a origem dessa loja dentro do Bling.
- URL da loja WooCommerce
- O endereço completo, por exemplo
https://minhaloja.com.br. Use o endereço da sua loja, não a página de login do WordPress. - Consumer Key e Consumer Secret
- Cole cada código no campo com o mesmo nome. Evite espaços no início ou no fim.
- Segredo do webhook
- Crie um segredo exclusivo para identificar as notificações. Guarde o texto: você vai repeti-lo no WooCommerce. É diferente dos dois códigos anteriores.
Clique em Salvar e continuar. A conexão aparecerá como Credenciais salvas, junto ao endereço para copiar. Salvar as credenciais não comprova, por si só, que uma consulta real à loja funcionou.
4. Cadastre a notificação no WooCommerce
Um webhook é um aviso automático de que houve uma alteração. Na Caps+Log, copie o endereço exibido após salvar. Se o botão de copiar não funcionar no navegador, selecione o endereço e copie manualmente.
- No WordPress, abra WooCommerce → Configurações → Avançado → Webhooks e adicione um webhook.
- Preencha nome Caps+Log — pedidos, status Ativo e tópico Pedido atualizado.
- Em URL de entrega, cole o endereço exibido pela Caps+Log. Em Segredo, repita exatamente o segredo criado na etapa anterior. Salve.
Se a entrega falhar, consulte WooCommerce → Status → Logs e procure as entregas de webhooks. Confira o endereço e o segredo antes de tentar novamente. Guia oficial de webhooks WooCommerce.
5. Confira o primeiro pedido
Verifique uma venda real paga que também tenha entrado no Bling. Na Caps+Log, abra os pedidos recebidos e confira cliente, endereço, produtos, quantidades e valor. O pagamento precisa estar registrado pelo WooCommerce; apenas mudar manualmente o status do pedido não é uma confirmação independente do gateway.
O conector consulta status processando ou concluído, data de pagamento e dados do pedido. O resultado depende de como o plugin de pagamento preenche esses campos. Ainda é necessário validar a combinação usada pela sua loja; não há garantia de compatibilidade de todos os gateways.
Abrir configuração WooCommerceAntes de começar
Checklist de integração
- Acesso de administrador ao Bling.
- Acesso de administrador à Shopify ou WordPress/WooCommerce.
- Produtos com o mesmo SKU nas duas plataformas.
- Um pedido de teste real, com endereço completo.
- Confirme que o pedido aparece na Caps+Log.
- Confira nome, endereço, SKU e quantidade.
- Verifique se ele entra como Confirmado.
- Teste um cancelamento ou reembolso.
Status dos pedidos
O que cada status significa
| Status | Significado | O que fazer |
|---|---|---|
| Confirmado | Pagamento e itens conferidos. | Pode seguir para separação e expedição. |
| Aguardando confirmação | A loja ainda não comprovou o pagamento. | Confira o pagamento e aguarde a nova consulta. |
| Não verificado | Há divergência de valor, SKU, quantidade, moeda ou referência. | Corrija os dados na origem e reenvie/atualize o pedido. |
| Estornado | A loja informou cancelamento, falha ou reembolso. | Não despache. Verifique a venda com o cliente. |
Resolver problemas
Erros comuns e como resolver
Crie novas chaves na REST API do WooCommerce com permissão de leitura e copie sem espaços. Confirme que a URL começa com https://.
Confirme o tópico Pedido atualizado, o endereço copiado da Caps+Log e o mesmo segredo nos dois lados. Remova modo de manutenção ou bloqueios de firewall para a REST API.
Confirme a conexão Bling, clique em Sincronizar agora e verifique se o pedido possui loja de origem identificada.
Compare valor, BRL, SKU e quantidade. No WooCommerce, confirme date_paid, needs_payment=false e transaction_id para pagamentos manuais.
Entenda os termos e confira os dados
- SKU: o código de cada produto
- É o identificador usado para comparar os itens. Se o Bling usa 00123 e a loja usa 123, os códigos são diferentes. Confira também a quantidade de cada item.
- Sincronização: a consulta automática
- A Caps+Log busca alterações periodicamente. Receber o pedido e consultar o pagamento são etapas diferentes; atualizar a página várias vezes não acelera o processamento.
- Conectado e Confirmado
- Conectado descreve a configuração da conta ou loja. Confirmado descreve o resultado da verificação de pagamento de um pedido. Um não implica automaticamente o outro.
- Endereço de entrega
- Confira destinatário, CEP com oito dígitos, rua, número, bairro, cidade e estado. Informe complemento quando houver. O comprador pode ser diferente de quem recebe a encomenda. Dados faltantes devem ser corrigidos na origem.
A etapa atual integra pedidos e consulta pagamentos. A conferência da equipe, a impressão de etiquetas, a embalagem e o despacho são etapas operacionais posteriores; conectar uma loja não significa que uma encomenda foi enviada.
FAQ
Perguntas frequentes
Por que meu pedido está aguardando confirmação?
A loja de origem ainda não confirmou pagamento integral, ou existe divergência de valor, SKU, quantidade, moeda ou referência do pedido. Confira o pedido na loja e aguarde a próxima consulta.
O status “processando” significa pago?
O status isolado não comprova pagamento. A consulta também confere data, valor e itens. O preenchimento depende do plugin da loja. No Bling, situação e parcelas não são prova financeira.
Onde encontro o webhook?
Depois de salvar a conexão WooCommerce, o endereço aparece na própria tela Lojas. Copie-o para WooCommerce > Configurações > Avançado > Webhooks.
Posso trocar o gateway depois?
Você pode trocar, mas precisa validar novamente a integração com uma venda real. Um pedido em modo de teste não será tratado como pagamento real na Shopify. Confira também o comportamento de cancelamentos e reembolsos antes de usar a nova configuração.
O que fazer quando o SKU não confere?
Use exatamente o mesmo SKU no Bling e na loja, incluindo zeros à esquerda. A quantidade também precisa ser igual.