1. Entre no painel
Acesse o painel da sua loja na Cestas App e abra a área da integração com Bling.
CESTAS APP
Manual da integração
Conecte sua loja ao Bling com o aplicativo público da Cestas App.
Este manual explica como a integração funciona hoje, quais dados técnicos são usados no aplicativo público e como concluir a autorização da conta sem precisar criar um aplicativo privado por loja.
Como usar
O fluxo recomendado para conectar uma loja
A conexão é iniciada pela própria loja, dentro do painel da Cestas App. Isso garante que a autorização do Bling fique vinculada ao tenant correto.
2. Ative o Bling
Habilite a integração, ajuste depósito padrão se necessário e escolha os módulos que devem sincronizar.
3. Autorize a conta
Clique em Conectar com Bling e conclua a autorização OAuth da conta que será usada no ERP.
4. Valide a operação
De volta ao painel, confira o status da conexão, os webhooks e rode o teste de homologação quando precisar.
Dados técnicos
Referência do aplicativo público
Estes são os dados técnicos usados na configuração e na homologação do app público da plataforma.
Link de redirecionamento
https://app.cestas.app/api/storefront/bling/callbackEste é o callback oficial do aplicativo público da Cestas App no Bling.
Autenticação
- OAuth com troca de código por token no callback da plataforma.
- JWT habilitado nas requisições de token e nas chamadas autenticadas.
- Refresh token usado quando o access token expira ou é invalidado.
Escopos utilizados
Pedidos de Venda
Produtos
Controle de Estoque
Clientes e Fornecedores
Depósitos de Estoque
Salvar imagens dos Produtos
Salvar variações de Produtos
Sincronização
O que a integração faz hoje
A operação atual foi desenhada para empurrar dados da loja para o Bling, com controles separados por tipo de sincronização.
Produtos e variações
A loja envia produtos e variações para o Bling quando a sincronização de catálogo está ativa.
Estoque
Os saldos podem ser atualizados no Bling a partir da operação da loja, inclusive com depósito padrão opcional.
Novos pedidos
Pedidos realizados no site podem ser enviados automaticamente para o ERP.
Status do pedido
Mudanças importantes no fluxo do pedido podem atualizar a situação correspondente no Bling.
Limitação atual: nesta versão, a integração não importa catálogo do Bling para dentro da loja. O fluxo principal continua sendo da loja para o ERP.
Homologação
Como validamos o aplicativo público
O painel da integração já executa a sequência oficial de homologação do Bling para ajudar no preparo da revisão.
Sequência coberta
GET, POST, PUT, PATCH e DELETE no fluxo de homologação de produtos, com encadeamento do header x-bling-homologacao entre as etapas.
Renovação de token
Se o Bling invalidar o access token durante a revisão, a integração usa o refresh token automaticamente e continua o teste.
Webhooks
Como acompanhar o retorno do Bling
Depois da conexão, a loja também expõe uma URL de webhook no submenu da integração para receber eventos de pedidos, produtos e estoque.
Se você precisar validar eventos recebidos, erros recentes ou a URL atual do webhook, abra a área de webhooks da integração dentro do painel da loja.
Suporte
Se precisar de ajuda, fale com a gente
Se a conexão falhar, se o callback voltar com erro ou se algum fluxo não sincronizar como esperado, envie os dados abaixo no primeiro contato para agilizar o atendimento.
Contato
E-mail de suporte: [email protected]
Sempre que possível, envie o nome da loja, uma descrição objetiva do problema, prints da tela e o horário aproximado da falha.
Links úteis