CTN Extrator

Visão Geral

O CTN Extrator é uma API Flask que faz scraping autenticado no sistema CTN para extrair dados financeiros por unidade (franquia):

Como funciona

A autenticação usa cookies de sessão (CTN.Auth, id_menu_clicado, TiPMix) salvos no .env. A cada chamada, uma sessão HTTP é criada com esses cookies e o CTN é consultado diretamente. Os cookies são renovados automaticamente toda manhã via POST /refresh.

Estrutura do Projeto

Configuração — arquivo .env

Subindo com Docker

git pull
docker-compose up -d --build

# Forçar refresh manual logo após subir (garante cookies frescos)
curl -X POST http://localhost:2007/refresh \
  -H "X-API-Secret: <API_SECRET>"

Rotas da API

{ "status": "ok" }

{
  "franquia_id": "535",
  "data_inicio": "2026-04-01",
  "data_fim":    "2026-04-06",
  "resumo": [
    { "Conta": "CAIXA DINHEIRO", "Entrada": "R$ 1.200,00", "Saida": "R$ 300,00", "Total": "R$ 900,00" }
  ],
  "detalhes": [
    { "Conta": "CAIXA DINHEIRO", "SubConta": "VENDAS", "Tipo Mov.": "Receita",
      "Funcionário/Sócio": "JOÃO SILVA", "Data Lan.": "01/04/2026", "Valor": "R$ 1.200,00" }
  ]
}

{
  "franquia_id": "535",
  "data": "2026-04-01",
  "fechamento": [
    { "Data": "01/04/2026", "Saldo Anterior": "R$ 5.000,00",
      "Entrada": "R$ 1.200,00", "Saída": "R$ 300,00", "Saldo Atual": "R$ 5.900,00" }
  ],
  "saldo_contas": [
    { "Data": "2026-04-01", "Contas": "CAIXA DINHEIRO",
      "Saldo Anterior": "R$ 5.000,00", "Movimentação Dia": "R$ 900,00", "Saldo Atual": "R$ 5.900,00" }
  ]
}

// Sucesso
{ "status": "ok", "mensagem": "Cookies renovados com sucesso." }

// Não autorizado (secret errado)
HTTP 401 — { "status": "erro", "mensagem": "Não autorizado" }

// Falha no login / 2captcha
HTTP 500 — { "status": "erro", "mensagem": "..." }

Exemplos de Uso

cURL — Movimentações

curl -X POST http://localhost:2007/movimentacoes \
  -H "Content-Type: application/json" \
  -d '{ "franquia_id": "535", "data_inicio": "2026-04-01", "data_fim": "2026-04-06" }'

cURL — Saldos

curl -X POST http://localhost:2007/saldos \
  -H "Content-Type: application/json" \
  -d '{ "franquia_id": "535", "data": "2026-04-01" }'

cURL — Refresh

curl -X POST http://localhost:2007/refresh \
  -H "X-API-Secret: sua_senha_forte"

IDs de franquia disponíveis

Refresh Automático — Como Funciona

Os cookies do CTN expiram diariamente. O fluxo de renovação é totalmente automático:

1. n8n aciona POST /refresh com o X-API-Secret todo dia útil às 07h.
2. A API acessa ctn.sistematodos.com.br → é redirecionada para a página de login OAuth.
3. Credenciais são preenchidas e o reCAPTCHA é enviado ao 2captcha (~100s para resolver).
4. Após login, os cookies novos são capturados e salvos no .env.
5. A partir da próxima requisição, a API já usa os cookies atualizados — sem reiniciar.

Custo do 2captcha

Cada resolução de reCAPTCHA custa aproximadamente $0.0017. Com 20 renovações mensais (seg–sex):

20 × $0.0017 = $0.034 / mês   →   $3 de crédito ≈ 7 anos de uso

Erros Comuns