Integração direta com ERP
Documentação completa da integração direta do Koncili com o Olist/Tiny e o Bling — conexão, configuração e baixa automática de contas a receber.
Olist/Tiny
1. Visão geral do fluxo
Quando uma conciliação é analisada no Koncili, o título de contas a receber correspondente no Olist/Tiny é baixado (marcado como recebido) — hoje, a partir de um envio feito pelo time a partir da tela de Conciliação.
2. Autenticação e credenciais
Cadastro inicial: criar a conta no Koncili, criar o aplicativo no Olist/Tiny e conectar as duas pontas via OAuth. Feito uma vez por cliente.
3. Configuração da baixa
Configuração única, feita depois da conexão — vale para todas as baixas seguintes dessa conta.
4. Vínculo de títulos
O Koncili precisa saber qual título de contas a receber, no ERP, corresponde a cada pedido — hoje esse vínculo não é descoberto automaticamente. É preciso importar essa relação manualmente, sempre que houver pedidos novos sem vínculo.
5. Consulta e acompanhamento
Passos 7, 8 e 9: como o time efetivamente aciona e valida a baixa, depois que a conta está conectada e configurada.
6. 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.
7. Informações técnicas
Endpoints da API do Olist/Tiny efetivamente consumidos pelo Koncili nesta integração — referência para quem vai dar suporte ou revisar o fluxo.
Bling
1. Visão geral do fluxo
Quando uma conciliação é analisada no Koncili, o título de contas a receber correspondente no Bling é baixado (marcado como recebido) — hoje, a partir de um envio feito pelo time a partir da tela de Conciliação.
2. Autenticação e credenciais
Cadastro inicial: criar a conta no Koncili, criar o aplicativo no Bling (na Central de Extensões) e conectar as duas pontas via OAuth. Feito uma vez por cliente.
3. Configuração da baixa
Configuração única, feita depois da conexão — vale para todas as baixas seguintes dessa conta. O Bling não tem o campo Conta de Destino, então não há passo equivalente ao "descobrir a conta de destino".
4. Vínculo de títulos
Na Integração Bling × Koncili o vínculo entre pedido e título é 100% automático — um job roda sozinho, 1× por dia, às 01:00 (horário de Brasília), sem nenhuma ação do time.
5. Consulta e acompanhamento
Passos 6, 7 e 8: como o time efetivamente aciona e valida a baixa, depois que a conta está conectada e configurada.
6. 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.
7. Informações técnicas
Endpoints da API do Bling efetivamente consumidos pelo Koncili nesta integração — referência para quem vai dar suporte ou revisar o fluxo.