Um produto ou um pedido não apareceu no Bling, nem enviando manualmente? O primeiro passo é ver o que o Bling respondeu, no log do app.
Como ver o log do app do Bling
- No painel, acesse Aplicativos e abra o app Bling ERP V2.
- Desça até a seção Logs.
- Cada linha é uma tentativa de envio, com:
-
Recurso:
products(produto) ouorders(pedido); - ID do recurso: o ID do produto ou pedido na E-Com Plus;
- ID do recurso no Bling, quando o envio deu certo;
- Horário e Sucesso (marcado = enviado; desmarcado = deu erro);
- Notas: a resposta do Bling. É aqui que está o motivo do erro.
-
Recurso:
Clique em Editar em um registro para ver os campos separados:
No exemplo acima, o produto não foi importado porque o SKU 242 42 tem um espaço.
O log guarda só os registros mais recentes (cerca de 200). Se o erro foi há muito tempo, envie o produto ou pedido de novo e confira o log logo em seguida.
Leia as Notas: erros mais comuns
| O que aparece nas Notas | O que significa | O que fazer |
|---|---|---|
Status 429 e TOO_MANY_REQUESTS
|
O limite de requisições do Bling foi atingido | Veja a seção abaixo |
| “Código dos itens … já existem” | SKU duplicado no Bling | Use um SKU único |
Status 401 ou token inválido |
Token do Bling expirado | Renove o token |
| “data.sku deve corresponder ao padrão” | SKU com espaço, acento ou caractere especial | Use só letras, números, hífen (-), ponto (.) e underline (_) |
| Erro citando cidade, bairro ou endereço | Endereço do cliente inválido no pedido | Corrija o endereço do pedido |
| Erro citando a descrição do produto | Texto com código HTML inválido (geralmente colado de outro site) | Limpe a descrição e envie de novo |
| Nenhum registro | O envio nem foi disparado | Veja as causas abaixo e envie manualmente de novo |
Quando o limite do Bling é atingido
O Bling limita quantas requisições cada integração pode fazer por segundo e por dia. Quando o limite estoura, as Notas do log mostram Status 429 com TOO_MANY_REQUESTS. Se a descrição do erro falar em limite diário, o teto do dia foi atingido.
O que acontece e o que fazer:
- O app tenta de novo sozinho. Os envios recusados por limite voltam para a fila e são reenviados depois. Não é preciso reenviar um por um.
- Limite diário: os envios só voltam a ser aceitos quando o Bling renova o limite, no dia seguinte. Aguarde e confira o log no outro dia.
- Evite estourar de novo. O limite costuma ser atingido depois de edições em massa (preço, estoque, categoria) ou exportações em massa repetidas, porque cada produto alterado gera envios ao Bling. Prefira fazer grandes atualizações aos poucos ou fora do horário de vendas, e não repita a exportação em massa enquanto a anterior não terminou.
Produto não exporta: causas comuns
1. O produto está sem estoque
Produto com o campo quantidade em estoque vazio ou zerado não é enviado. Preencha a quantidade no cadastro do produto e envie de novo.
2. O SKU já existe no Bling
Se outro produto (inclusive um excluído ou inativo no Bling) já usa o mesmo SKU, o envio é recusado. Use um SKU único. Isso é comum quando se duplica um produto para corrigir as variações: o produto copiado mantém o mesmo SKU.
3. O SKU informado não existe na loja
Confira se o código que você está procurando é exatamente o mesmo cadastrado na E-Com Plus (letras, números e hífens).
4. Variações
Em produtos com variação (cor, tamanho), cada variação também precisa ter SKU único e estoque preenchido.
Para enviar muitos produtos de uma vez: Como enviar produtos em massa para Bling?
Pedido não exporta: causas comuns
1. O pedido não está como pago
O app só envia ao Bling os pedidos com status financeiro de pago. Se o cliente pagou por fora (link de pagamento, Pix direto etc.), confira se o valor caiu na sua conta e só então altere o status do pedido para pago no painel. Em seguida ele é enviado ao Bling normalmente.
2. Endereço do cliente inválido
O Bling recusa pedidos com cidade ou bairro inválidos, inclusive por um espaço sobrando no fim do campo. Abra o pedido, corrija cidade/bairro/CEP e salve.
3. Produto do pedido com SKU repetido
Se algum item do pedido tem SKU que já existe em outro produto no Bling, o pedido inteiro é recusado. Corrija o SKU no cadastro do produto (e não só no pedido), para não acontecer de novo na próxima venda.
Para enviar vários pedidos de uma vez: Como exportar em massa pedidos para o Bling?
Se nada está sendo enviado (nem produtos nem pedidos), renove o token: Como renovar o token do ERP Bling
Persistindo, abra um ticket com o SKU do produto ou o número do pedido.