For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /automacoes/n8n.md.
Gera Base

    n8n

    O n8n roda em container separado e conversa com a API do Gera Base.

    Acesso

    https://automacao.jvbgprojects.com.br

    Para executar lotes pela interface do Gera Base:

    https://gera-base.jvbgprojects.com.br/automacao-lote

    Use o webhook:

    https://automacao.jvbgprojects.com.br/webhook/gera-base-lote

    Variaveis

    O container recebe:

    GERA_BASE_API_URL=http://gerador-litestar:8050
GERA_BASE_API_TOKEN=gb_token_dedicado_do_n8n
GERA_BASE_ADMIN_URL=https://admin.jvbgprojects.com.br
GENERIC_TIMEZONE=America/Sao_Paulo
TZ=America/Sao_Paulo

    O container do Gerador recebe:

    GERA_BASE_N8N_PUBLIC_URL=https://automacao.jvbgprojects.com.br/
GERA_BASE_N8N_INTERNAL_URL=http://n8n:5678

    Essas variaveis fazem o backend encaminhar a chamada pela rede interna dos containers, sem passar pelo Cloudflare.

    Gere um token dedicado no painel Admin e salve o valor real somente no .env do servidor. O compose exige esse segredo. O workflow aceita api_url e api_token no payload como sobrescritas pontuais; no fluxo normal, omita ambos para evitar que o segredo apareça nos dados de execução.

    Fluxo de API

    Fluxo recomendado:

    1. Criar um token no painel Admin.
    2. Enviar Authorization: Bearer gb_xxx.
    3. Chamar /api/v1/templates, /api/v1/databases ou /api/v1/n8n/batch.

    Fluxo legado:

    1. Fazer login em /api/auth/login.
    2. Guardar o cookie gera_base_session.
    3. Chamar /api/templates ou /api/databases.

    Lote

    O workflow de lote fica em:

    n8n/gera-base-lote.json

    Ele aceita lista JSON, CSV em campo texto ou arquivo CSV via multipart/form-data.

    O workflow precisa estar publicado ou ativo. Quando importado pela CLI com o n8n em execucao, reinicie o container depois de publicar.

    CSV para bancos no mesmo host

    Configure a conexao Postgres uma vez e informe um banco por linha. A API adiciona _db ao campo name.

    name;mode;template;use_all_columns;description
empresa_a;append;reforma_tributaria;true;"Destino: empresa_a_db"
empresa_b;append;reforma_tributaria;true;"Destino: empresa_b_db"

    Solucao de problemas

    • Webhook nao registrado: publique o workflow e reinicie o n8n quando necessario.
    • Cloudflare 1010: confira as variaveis GERA_BASE_N8N_PUBLIC_URL e GERA_BASE_N8N_INTERNAL_URL no container do Gerador.
    • Banco nao encontrado em append: confirme que name_db existe no host configurado.