Perguntas Integração com o bling para envio de produtos e pedidos

Panza  <-- polling 1x/min -->  API Bling v3  <-- integração nativa -->  TikTok Shop

• A Bling sincroniza esses dados com o TikTok Shop (e com qualquer outro canal que a loja tenha ativado lá).
• Pedidos feitos no TikTok Shop chegam primeiro na Bling; o Panza busca esses pedidos por polling (thread própria a cada 1 minuto — não usamos webhook, pois o Panza não expõe um endpoint HTTPS público).

• Loja já cadastrada na Bling, com a integração TikTok Shop ativada lá dentro (feito pelo próprio cliente/consultor Bling).
• App cadastrado em developer.bling.com.br , com Client ID e Client Secret em mãos.
• Acesso de administrador ao Panza para configurar a integração.

Os campos usados para o Client ID/Client Secret da Bling são os mesmos já usados para o WooCommerce (tela de Login/credenciais do Panza) — mesmo padrão de reaproveitamento de campo, só que agora guardando client_id/client_secret em vez de consumer key/secret.

1. No Partner/Developer Center da Bling, monte a URL de autorização com o Client ID e a URL de retorno (redirect URI) configurada no app.
2. Abra essa URL num navegador, faça login com a conta da Bling do cliente e autorize o app.
3. A Bling redireciona para a URL configurada com um parâmetro

   ?code=...

   na query string. Copie esse código — ele expira em cerca de 1 minuto, então o próximo passo precisa ser feito rápido.
4. No Panza, rode a autorização inicial informando esse código (rotina interna que chama o método de troca de token pela primeira vez).

Depois desse passo único, o Panza renova o token sozinho (o token de acesso expira, mas o token de renovação dura cerca de 30 dias e é renovado automaticamente antes de expirar). Só é preciso repetir esse passo manual se o token de renovação for revogado ou expirar por inatividade.

• Tipo de integração: selecionar "Bling" na tela de configuração de integrador (mesmo lugar onde hoje se escolhe WooCommerce/SSWeb).
• Credenciais: Client ID / Client Secret da Bling.
• Filtro de loja/canal: se a conta Bling do cliente atende mais de um canal de venda, é preciso informar o identificador da loja/canal correspondente ao TikTok Shop dentro da Bling, para o Panza não misturar pedidos de outros canais no polling.
• Mapeamento de situações de pedido: quais situações da Bling equivalem a "pedido novo a importar" e "pedido confirmado" no Panza (A CONFIRMAR — depende da configuração de situações de pedido de venda de cada conta Bling).

• O Panza envia produto por produto para a Bling (não existe endpoint de lote confirmado na API da Bling, diferente do WooCommerce).
• Só produtos novos ou alterados desde o último envio são reenviados (mesmo mecanismo de controle por chave/checksum já usado no WooCommerce).
• Categoria: a Bling permite cadastro de categoria via API. O vínculo entre categoria interna do Panza e categoria da Bling usa o mesmo campo já existente para WooCommerce (id_ecommerce), então quem já conhece esse fluxo não precisa aprender nada novo.

• A cada 1 minuto, o Panza busca na Bling os pedidos alterados desde a última busca (sincronização incremental por data, não por status fixo).
• Pedidos novos viram orçamento/venda no Panza automaticamente.
• Depois de processado no Panza, o status é devolvido para a Bling (mesmo princípio do fluxo de confirmação que já existe com o WooCommerce).

A Bling tem uma cota de 3 requisições por segundo e 120.000 por dia — bem mais folgada que a de outras plataformas. O intervalo de 1 minuto do polling de pedidos cabe tranquilamente dentro desse limite.

• "Nenhum token disponível": a autorização inicial (passo 3) não foi feita ou o token de renovação expirou — repetir o passo manual.
• Erro HTTP 429 (Too Many Requests): estourou a cota de requisições por segundo/dia. Verificar se não há mais de um processo do Panza rodando a integração ao mesmo tempo, ou se o intervalo entre envios de produto está sendo respeitado.
• "Categoria não localizada": produto está com categoria que ainda não tem vínculo com a Bling (id_ecommerce vazio) — cadastrar/vincular a categoria primeiro.
• Pedido não chega no Panza: confirmar se o filtro de loja/canal está apontando para o canal correto do TikTok Shop dentro da conta Bling, e se a situação do pedido na Bling está entre as configuradas para importação.

• API | Bling — Autenticação
• API | Bling — Limites
• API | Bling — Referência da API
• API | Bling — Ambiente de homologação
• Bling — Integração TikTok Shop