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

1. Receber

O Bling envia o pedido e seus itens para a Caps+Log.

2. Conferir

Comparamos pedido, SKU, quantidade, endereço e valor.

3. Confirmar

Consultamos a loja de origem para provar o pagamento.

4. Liberar

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.

  1. 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.
  2. 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.
  3. Confira o retorno. Ao voltar à Caps+Log, verifique o nome e o CNPJ em Suas contas Bling. A conexão deve aparecer como Conectado.
  4. 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.
  5. 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ções

Ativar 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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 Bling

Como 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.

  1. Abra Configurar Shopify. Na aba Integrações, clique no botão do cartão Shopify. Será aberta a página exclusiva dessa plataforma.
  2. 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.
  3. Informe o domínio. Digite somente minha-loja.myshopify.com, sem https://, barras ou caminhos. Não use um endereço de exemplo: substitua pelo endereço da sua loja.
  4. Autorize. Clique em Autorizar Shopify e conclua a autorização na Shopify. Ao retornar, confira o domínio e o status Conectada.
  5. 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 Shopify

Como 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

  1. No WordPress, abra WooCommerce → Configurações → Avançado → REST API e adicione uma chave.
  2. Use a descrição Caps+Log, escolha um usuário com acesso aos pedidos e a permissão Leitura. Gere a chave.
  3. 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.

  1. No WordPress, abra WooCommerce → Configurações → Avançado → Webhooks e adicione um webhook.
  2. Preencha nome Caps+Log — pedidos, status Ativo e tópico Pedido atualizado.
  3. 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 WooCommerce

Antes de começar

Checklist de integração

Você precisa ter
  • 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.
Antes de liberar a operação
  • 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

StatusSignificadoO que fazer
ConfirmadoPagamento e itens conferidos.Pode seguir para separação e expedição.
Aguardando confirmaçãoA loja ainda não comprovou o pagamento.Confira o pagamento e aguarde a nova consulta.
Não verificadoHá divergência de valor, SKU, quantidade, moeda ou referência.Corrija os dados na origem e reenvie/atualize o pedido.
EstornadoA loja informou cancelamento, falha ou reembolso.Não despache. Verifique a venda com o cliente.

Resolver problemas

Erros comuns e como resolver

Consumer Key/Secret inválidos

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://.

Webhook não chega

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.

Pedido não aparece

Confirme a conexão Bling, clique em Sincronizar agora e verifique se o pedido possui loja de origem identificada.

Pedido pago não foi confirmado

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.