É o terceiro sistema que o financeiro pede para levar ao painel este ano.
Os dois primeiros estavam no catálogo da ferramenta e levaram uma tarde cada. O terceiro é um sistema de gestão de contratos que só a sua empresa e mais algumas usam. O problema é que catálogo de conectores é uma lista finita, e a sua fonte não entrou nela.
Neste artigo, explicamos as três saídas que sobram quando a fonte está fora do catálogo, o que um conector precisa resolver antes de virar tabela e o que a promessa de conector novo cobra de você.
Exportar à mão, pedir ao fornecedor, escrever a integração
Quando o nome não aparece na lista, a conversa costuma terminar em uma destas três opções. Vale reconhecer cada uma antes de escolher por eliminação.
- Exportar à mão. Alguém baixa um CSV toda segunda e joga numa pasta. Funciona na primeira semana, depende de uma pessoa lembrar na décima, e o painel fica com a data da última vez que ela lembrou.
- Pedir para o fornecedor da ferramenta. Vira item de backlog e volta com prazo em trimestres. Faz sentido quando a fonte é popular o bastante para servir a outros clientes, e não faz nenhum quando ela é sua.
- Escrever a integração. Alguém programa a leitura da API, trata paginação, guarda token e agenda a execução. É a saída que resolve de verdade, e é exatamente a que um time de uma ou duas pessoas sem programador não consegue sustentar.
A terceira é a única que entrega dado atualizado sem depender da memória de ninguém. Também é a que mais gente abandona no meio, porque escrever a primeira versão é fácil e manter a décima não é.
A conta chega na manutenção.
O que um conector precisa resolver sozinho
Conector não é uma chamada HTTP. Entre a resposta em JSON e uma tabela que o Power BI consegue ler existe uma lista de problemas que alguém precisa resolver, sempre os mesmos.
Autenticação é só a porta de entrada. A Airbyte publicou em 28 de agosto de 2026 que autenticação gerenciada virou o mínimo do mercado, e não o diferencial. Depois dela vêm paginação, limite de requisições por minuto, tipos de campo e o que fazer quando a resposta muda de formato.
Falta ainda o catálogo. Uma API devolve documentos aninhados; uma tabela quer colunas com tipo declarado. Alguém precisa decidir o que vira coluna, o que vira tabela separada, qual campo é a chave e qual data serve de marca para a próxima leitura.
Exemplo prático
Uma transportadora quer o tempo médio de resolução dos chamados do sistema de atendimento no painel semanal. A API devolve o chamado com uma lista de interações dentro. Sem decidir que a interação vira tabela própria, ligada por identificador de chamado, não existe consulta em SQL que responda à pergunta.
A pergunta define o catálogo.
O que a promessa de conector novo custa
Gerar conector a partir da documentação resolve o trabalho repetitivo, e não resolve tudo. Vale saber onde ele para antes de contar com ele.
O conector herda a qualidade da documentação. Se a especificação descreve um campo como texto e a API devolve número, quem gera a partir dela vai errar junto. Documentação desatualizada é o defeito mais comum, e ele só aparece na primeira carga que traz dado de verdade.
Autenticação fora do comum também trava. Assinatura de requisição, certificado de cliente e fluxo de aprovação em duas etapas não cabem nas formas usuais, e nenhuma geração automática inventa um protocolo que ninguém descreveu.
E há a diferença entre existir no catálogo e ser alcançável. Os sistemas de gestão mais usados no Brasil não têm conector pronto na lista do Januss. Isso é uma coisa, e ela é verdade.
Eles são alcançáveis pelo caminho da documentação da API, que é outra coisa, e o lugar onde ela aparece é a mesma tela de configuração. Confundir as duas custa caro nos dois sentidos: faz desistir de fonte que dá para ligar, e faz prometer conector que não existe.
Pergunte pelo caminho, não pela lista.
Onde o Januss entra
No Januss o caminho da fonte fora do catálogo é apontar a especificação da API ou colar a documentação dela. A partir daí saem o conector e o catálogo de tabelas, com autenticação e paginação resolvidas sem você escrever código de cola.
São seis formas de autenticação, nomeadas uma a uma. Nenhuma, API Key, HTTP Basic, Bearer, login que devolve token e OAuth 2.0 com credenciais de cliente. Fora dessas seis, o caminho não é gerar e torcer, e sim reconhecer que a fonte pede outra conversa.
Antes de salvar, o Januss faz uma chamada real e só conclui se conseguir ler o dado. Isso muda o momento em que você descobre que a documentação estava errada: na tela de configuração, e não na terça-feira em que o painel amanhece vazio.
A IA escreve o conector uma vez. Depois disso a extração é determinística e roda sempre igual, sem IA no caminho do dado, que é o que permite confiar no número do mês que vem. O conector Harvest, que já vem pronto, roda sobre esse mesmo motor.
Quer testar com a fonte que ficou de fora? O trial de 14 dias não pede cartão, e dá para colar a documentação da API e ver o catálogo nascer. Criar seu ambiente no Januss.
Fontes
A leitura de que autenticação gerenciada virou o mínimo do mercado está no blog da Airbyte:
Crie seu workspace em minutos.
Aponte para a sua origem e veja o dado chegando ao banco no mesmo dia.