API de pesquisa e entrega de documentos sobre o Google Drive de um escritório de contabilidade, construída inteira em n8n auto-hospedado.
O problema
Um acervo de quase 190 mil pastas no Drive, e o pedido que chega é "o FGTS de março". Encontrar o arquivo é trabalho humano repetitivo, e delegar a busca a um modelo de linguagem cria um risco novo: entregar o documento de um cliente para outro. O que se quer automatizar é a localização e a entrega, não a decisão de quem pode receber o quê.
A arquitetura
O n8n atua como API HTTP, não como robô de tela: três rotas encadeadas — identificar (CNPJ ou nome devolve uma referência de 30 minutos), consultar (referência mais filtros devolve os documentos) e entregar (binário, base64 com teto de 5 MB, ou link assinado). O acervo é indexado em Data Tables, com o CNPJ vindo de um arquivo no nível zero de cada pasta de empresa em vez da convenção de nome, que é irregular. Produção e teste são conjuntos separados de rotas sobre os mesmos fluxos, o que permite desenvolver e demonstrar o consumidor contra dados semeados enquanto a credencial do Drive real não chega. A documentação inteira é servida pela própria instância — Swagger auto-contido sem CDN, manual, catálogo de expressões regulares, explorador do acervo e um painel de prontidão para entrega.
O resultado
Instância local com 15 workflows, 14 Data Tables e 53 rotas de webhook, com 163.738 pastas indexadas e 219 casos de teste passando. A origem do CNPJ foi conferida contra o disco sem divergência. O que falta está declarado em rota própria: a credencial da conta de serviço do cliente — até ela chegar, o provedor do Drive responde em modo simulado, e isso é dito no ar em vez de descoberto no uso.
🔒 Código-fonte
git clone https://git.programandosolucoes.com.br/git/repos/n8n-drive-contabil.gitCódigo-fonte privado. As credenciais de leitura são liberadas sob solicitação — me chame para conversar sobre o projeto.