Limitações importantes

Leia com atenção antes de habilitar a baixa automática para um cliente — o processo é novo (beta) e tem comportamentos específicos. Novas implementações serão feitas nas próximas versões.

Limites da API

Rate limit de 3 req/s e 120.000/dia

São 3 requisições por segundo e 120.000 por dia por conta Bling — o Koncili controla isso no próprio lado. Ao estourar, o item espera e é reenfileirado automaticamente, nunca falha por isso.

Janela de 1 dia por consulta

Cada consulta de títulos cobre só 1 dia — pedir um período maior que 1 ano numa única consulta retorna erro da Bling.

Data de início da sincronização é fixa

A data de início da sincronização (cadastrada na conexão) precisa ser de no máximo 1 ano atrás e não pode ser alterada depois — fica somente leitura na edição.

Não existe ambiente de testes (sandbox)

O Bling não tem sandbox — mesmo em testes, o Koncili fala com o host de produção.

Quando a baixa é bloqueada

Divergência de valor

Se o valor do título no Bling não bate com o valor calculado pelo Koncili, a baixa é bloqueada (o item fica FAILED) — nunca baixa no valor errado. A ocorrência fica registrada e pode ser vista no relatório do Smart Report.

Ambiguidade de parcela

Quando uma venda tem várias parcelas e o casamento por valor fica ambíguo, o item falha em vez de arriscar baixar o título errado (ver Vínculo de títulos).

Categoria vazia é aceita

A categoria vazia é aceita na prática, mesmo o Bling documentando o campo como obrigatório — o Koncili simplesmente não envia o campo quando está em branco.

Quando a conexão fica inválida

Não existe estado "expirado" separado

As quatro situações abaixo colapsam para credencial inválida, exigindo reconexão manual (botão "Reconectar"):

• O refresh_token é rejeitado depois de ~30 dias sem uso (a janela desliza: renova a cada refresh bem-sucedido).
• Uma tentativa de reautorização falha.
• Uma baixa é abortada por 401 com refresh que também falhou, ou por 403.
• A credencial é desativada manualmente.

O que ainda não foi implementado

Sem notificação proativa de falha

Só existe o ícone binário "enviado" (ver Consulta e acompanhamento) — que não distingue sucesso de falha.

Botão não reabilita após falha

Se a baixa falha, o botão "Enviar ao ERP" fica desabilitado indefinidamente para aquela conciliação — sem reset automático. Funcionalidade será criada no futuro.