A integração com o Bling traz para o Codewo o catálogo, os pedidos de venda e os clientes de cada pedido. Se a empresa quiser, também envia de volta ao Bling os produtos e as vendas feitos aqui. Tudo que chega do Bling ganha um selo verde com a marca dele e pode ser filtrado nas listas.
A integração está em liberação. Ela já funciona, mas as primeiras contas ainda estão sendo acompanhadas de perto. Antes de conectar o Bling da sua empresa, fale com o suporte do Codewo para acompanhar a primeira sincronização com você.
O que é
| Do Bling para cá | Daqui para o Bling (opcional, vem desligado) | |
|---|---|---|
| Catálogo | Produtos e variações, preço, custo, categoria, imagens, dados fiscais do produto e estoque | Produto criado ou editado aqui é criado ou atualizado lá (nome, código, preço, situação e categoria) |
| Pedidos | Pedidos de venda com itens, frete, desconto, parcelas, vendedor e situação | Venda confirmada aqui vira pedido de venda lá, com o cliente e as parcelas. Mudança de etapa ou de entrega atualiza a situação lá |
| Clientes | O cliente de cada pedido entra em Contatos | O cliente do pedido enviado é procurado pelo CPF/CNPJ antes de ser criado lá |
Para usar, o plano precisa incluir o Catálogo e as Integrações Externas. Conectar e configurar exige a permissão Gerenciar integrações. Cada empresa conecta uma conta do Bling.
Como funciona
Onde fica
Em Configurações → Integrações → Integrações Externas, clique no cartão Bling. A tela do Bling reúne a conexão, o que sincronizar e o andamento.
Conectar
- Conectar com o Bling: quando o botão aparece, é um clique. Você autoriza no Bling e volta para a tela com o aviso "Bling conectado! Confira o que sincronizar e salve para começar."
- Aplicativo próprio do Bling: para quem prefere, abra Usar aplicativo próprio do Bling. Quando o botão acima não aparece, a tela já mostra direto este caminho. O passo a passo está na tela: criar um aplicativo no Bling (em Central de Extensões › Área do Integrador), colar o Link de redirecionamento que a tela oferece, marcar os escopos pedidos, informar o Client ID e o Client Secret e clicar em Conectar com meu aplicativo. Com aplicativo próprio, cadastre também, na aba Webhooks do aplicativo, o endereço que a tela mostra depois da primeira conexão, para os pedidos chegarem em segundos.
A primeira sincronização só começa quando você salva
Depois de conectar, a tela mostra o que trazer, com cada linha já preenchida por uma sugestão. Nada é importado até você clicar em Salvar e começar a sincronizar.
Histórico em silêncio, novidade dispara tudo
A primeira carga traz meses de pedidos. Esse histórico entra em silêncio: não dispara as automações de venda nova nem manda mensagens aos clientes, não baixa estoque, não marca a conversa do cliente e não dispara webhooks de saída. Ele entra nos relatórios e no histórico de compras de cada cliente, e a data da última compra passa a valer para as automações de ausência (veja as pegadinhas).
O que chega depois, ao vivo, é venda nova e dispara tudo, como qualquer venda registrada aqui.
Estoque: o Bling é o dono
Com a opção Estoque ligada, o saldo de cada variação passa a ser um espelho do Bling:
- a venda feita aqui não baixa o estoque (o Bling já cuida disso);
- a contagem não pode ser lançada aqui: a célula mostra só o número, com a indicação "Estoque controlado pelo Bling";
- o estoque nunca é enviado daqui para o Bling.
Desligar a opção ou desconectar devolve o controle do estoque ao Codewo.
Ritmo da sincronização
- A cada 15 minutos, o sistema busca o que mudou no Bling.
- Com os webhooks ligados, pedido novo chega em segundos.
- O quadro Sincronizações mostra cada rodada, com os itens novos, atualizados, ignorados e com erro, e o motivo de cada erro.
- Sincronizar agora puxa na hora: Catálogo — o que mudou, Pedidos — o que mudou, Catálogo completo de novo ou Pedidos desde a data inicial.
- Pausar para tudo: nada entra nem sai do Bling. Retomar sincronização volta, e a próxima varredura traz o que mudou durante a pausa.
Passo a passo: conectar e configurar
Cenário: uma loja que já vende pelo Bling quer ver os pedidos e os clientes no Codewo, sem mandar nada de volta por enquanto.
- Fale com o suporte do Codewo e combine a primeira sincronização.
- Abra Configurações → Integrações → Integrações Externas e clique em Bling.
- Clique em Conectar com o Bling e autorize no Bling.
- No cartão Catálogo, deixe ligado e escolha o que trazer: Preço de venda, Custo, Estoque, Imagens, Categorias e, se quiser, Incluir produtos inativos. Deixe Enviar produtos daqui para o Bling desligado.
- No cartão Pedidos, em Trazer pedidos a partir de, escolha a data inicial (a sugestão é 90 dias atrás). Em Lojas e canais de venda, marque só as lojas que interessam; nenhuma marcada traz todas. Deixe Enviar pedidos daqui para o Bling desligado.
- Em Situações do pedido, confira cada situação do Bling: se entra (Importar), como fica aqui (Confirmado (conta como venda), Rascunho ou Cancelado), a Etapa do pedido e a Entrega.
- Em Formas de pagamento, confira como cada forma do Bling vira forma de pagamento nas parcelas.
- Em Responsável pelo pedido, ligue cada vendedor do Bling a uma pessoa da equipe e escolha o Responsável padrão.
- Em Clientes dos pedidos, decida se quer Criar o contato quando não existir, Completar campos vazios de quem já existe e quais Etiquetas para os contatos criados.
- Clique em Salvar e começar a sincronizar e acompanhe o quadro Sincronizações.
Como os clientes são casados
O cliente de cada pedido é procurado entre os contatos que já existem por CPF/CNPJ, depois e-mail, depois telefone, nessa ordem. Quem já existe é vinculado, nunca sobrescrito: no máximo os campos vazios são completados, se você ligar essa opção. O "Consumidor final" do Bling nunca vira contato.
O que o Bling mostra no Codewo
- Selo verde "Bling" em Contatos, Pedidos e Catálogo.
- Filtro "Integração" nas listas de Contatos, Pedidos e Catálogo, e Integração de origem no público das Transmissões.
- Nas Automações, a origem Veio do Bling no gatilho Contato criado e os campos Integração do contato, Integração do pedido e Integração do produto nas condições.
Os números no topo da tela do Bling (produtos, pedidos e contatos) levam direto às listas já filtradas.
Enviar de volta ao Bling (opcional)
As duas chaves de envio vêm desligadas e são independentes:
- Enviar produtos daqui para o Bling: produto criado ou editado aqui é criado ou atualizado lá (nome, código, preço, situação e categoria). Estoque, imagens e dados fiscais do Bling não são tocados.
- Enviar pedidos daqui para o Bling: só a venda confirmada vai. Escolha a Situação do pedido criado no Bling e a Forma de pagamento quando nenhuma casar. Com "Nenhuma — recusar o envio", o pedido sem forma correspondente não é enviado, e o motivo aparece no quadro Sincronizações.
Pegadinhas comuns
- Está em liberação. Fale com o suporte antes de conectar a conta da empresa.
- Um Bling por empresa. Não dá para conectar duas contas do Bling na mesma empresa.
- Mudança no cadastro do cliente lá só chega com um pedido novo. O Bling não avisa quando um contato muda. A atualização vem junto do próximo pedido daquele cliente.
- Nada fiscal é emitido aqui. Emissão de nota fiscal e tributação continuam no Bling.
- Estoque espelhado não se ajusta aqui. Com a opção Estoque ligada, faça a contagem no Bling.
- Situação mapeada como Cancelado nunca conta como venda. Só Confirmado (conta como venda) entra no faturamento.
- Pedidos antigos contam para as automações de ausência. Gatilhos como Cliente parou de comprar e Hora de recomprar olham a data da última compra, inclusive a que veio do Bling. Revise essas automações antes da primeira carga.
- Recargas completas também entram em silêncio. Catálogo completo de novo e Pedidos desde a data inicial tratam o que chega como histórico. O mesmo vale para a primeira varredura depois de mais de 48 horas sem sincronizar, como depois de uma pausa longa ou de uma autorização expirada.
- Quem vê só os próprios pedidos precisa ser o responsável. Pedido de um vendedor do Bling que não foi ligado a ninguém vai para o Responsável padrão (sem escolha, quem conectou o Bling), e só ele e quem vê todos os pedidos o enxergam. Ligue cada vendedor do Bling à pessoa certa da equipe.
- Autorização expirada. Se a tela mostrar "A autorização expirou ou foi revogada no Bling", clique em Reconectar (com aplicativo próprio, em Conectar com meu aplicativo). As escolhas de mapeamento ficam guardadas.
- Desconectar não apaga nada. Produtos, pedidos e contatos que já vieram continuam aqui com o selo do Bling, e o estoque volta a ser controlado pelo Codewo.
Boas práticas
- Comece só trazendo. Ligue o envio ao Bling depois de conferir algumas semanas de sincronização.
- Escolha uma data inicial curta na primeira carga. Para trazer mais tempo depois, mude Trazer pedidos a partir de, salve e use Sincronizar agora → Pedidos desde a data inicial.
- Crie as etapas do pedido antes de conectar (em Configurações → Vendas → Etapas do pedido), para mapear cada situação do Bling a uma etapa.
- Confira o quadro Sincronizações nos primeiros dias e resolva os erros apontados.