integração

A API pública ainda não existe

Não há endpoint publicado, não há emissão de chave, não há documentação de integração e não há data anunciada. Se você chegou aqui procurando como integrar o Convertou ao seu sistema, a resposta honesta é: hoje, não dá.

O que existe é a conversão pelo navegador. E existe uma decisão de arquitetura tomada desde o começo para que a API seja um invólucro no futuro, e não uma reescrita — está descrita abaixo, porque é a única coisa concreta que se pode dizer sobre o assunto hoje.

o que já está pronto

O conversor já é um módulo isolado

A conversão não mora dentro do site. Ela é um pacote separado, que o site consome como qualquer outro consumidor consumiria — a camada web recebe o arquivo, chama a conversão e devolve o resultado, sem que a conversão saiba que existe um site do outro lado.

Isso não é organização de pastas. É uma fronteira com regras, e cada uma delas foi escolhida pensando em quem eventualmente chamaria esse código por HTTP:

Não faz rede. A conversão não chama serviço externo, não consulta API de terceiro e não envia o extrato para lugar nenhum. Tudo acontece dentro do processo que recebeu o arquivo.
Não toca em disco nem em banco de dados. O PDF entra como bytes em memória e é descartado quando a função retorna. O pacote sequer aceita um caminho de arquivo como parâmetro — só o conteúdo. É restrição de LGPD imposta pela assinatura da função, não promessa de rodapé.
Não lê variável de ambiente. Toda configuração entra por parâmetro. Isso é o que permite rodar a conversão inteira num teste, sem subir infraestrutura — e é também o que permitiria rodá-la atrás de qualquer camada de transporte.
Não conhece HTTP, usuário, sessão ou crédito. Nada de Express, requisição, cookie ou cobrança atravessa essa fronteira. Autenticação, medição e faturamento são problemas da camada de fora — que hoje é o site, e amanhã poderia ser um serviço.
É determinístico. Cada instituição tem um leitor escrito para o layout dela. O mesmo PDF produz sempre o mesmo OFX, byte a byte. Numa integração automática essa propriedade vale mais do que em qualquer outro contexto: é o que torna possível reprocessar e comparar.

Nada disso é uma API. É a condição para que uma exista sem que a conversão precise ser reescrita — e é o motivo de esta página não prometer uma data: o trabalho que falta é autenticação, controle de consumo, versionamento e compromisso de compatibilidade, não conversão.

o que falta

Por que ainda não publicamos

Publicar uma API é assumir compatibilidade. A partir do primeiro integrador, o formato da resposta vira contrato: mudar o nome de um campo passa a quebrar o sistema de outra pessoa, num horário que não é o seu. É um compromisso que se assume uma vez e se carrega para sempre.

Enquanto o produto ainda está aprendendo com os extratos reais que recebe — quais layouts aparecem, quais variações existem, o que precisa entrar no resultado — congelar o formato cedo demais custaria caro dos dois lados. Preferimos publicar quando o contrato puder ser mantido.

Não há nada aqui sobre preço, limite de requisição ou modelo de autenticação porque nada disso está decidido. Quando estiver, esta página muda.

ser avisado

Quer saber quando existir?

Não há lista de espera automatizada, nem formulário de captura. Fale direto com a gente e diga o que você precisaria integrar — volume, sistema de destino, se a conversão entraria num processo automático ou sob demanda. Esse tipo de detalhe é o que define o formato da API, e quem responde antes de ela existir ajuda a desenhá-la.

Todos os canais estão reunidos na página de contato.

perguntas

Perguntas sobre a API

Existe uma API pública do Convertou hoje?

Não. Não há endpoint publicado, não há emissão de chave e não há documentação de integração. O que existe é a conversão pelo navegador, em convertou.com.br.

Existe uma previsão de lançamento?

Não anunciamos data. Uma API pública envolve autenticação, controle de consumo, versionamento e compromisso de compatibilidade — e assumir prazo antes de ter isso resolvido é como se cria a promessa que não se cumpre. Preferimos avisar quando estiver de pé.

Quanto vai custar?

Não está definido. Não há preço, nem plano, nem limite de requisição decidido. Qualquer número aqui hoje seria inventado.

Se a API não existe, por que esta página existe?

Porque a pergunta é frequente e merece uma resposta direta em vez de silêncio. Escritórios com volume avaliam ferramentas por integração, e descobrir a ausência depois de contratar é pior do que ler aqui.

Dá para automatizar a conversão de outro jeito enquanto isso?

Pelo site, a conversão aceita vários PDFs de uma vez — é o que atende volume hoje. São 14 instituições reconhecidas automaticamente, sem passo de escolha de banco, então subir um lote de extratos de clientes diferentes funciona sem configuração.