O que é
Movimentações
Receitas & Despesas
Saldos
Fechamento de Caixa
Vendas
Relatório por Vendedor
Refresh
Cookie Automático
A autenticação usa cookies de sessão salvos no
.env. Cookies são renovados via POST /refresh com 2captcha.
Rotas da API
GET
/health
Verifica se a API está no ar.
{ "status": "ok" }
POST
/movimentacoes
Retorna receitas e despesas por conta num intervalo de datas.
| Campo | Tipo | Req. | Descrição |
|---|---|---|---|
franquia_id | string | ✓ | ID numérico da franquia |
data_inicio | string | ✓ | YYYY-MM-DD |
data_fim | string | ✓ | YYYY-MM-DD |
tipo_movimentacao | string | — | "" todos · "1" receita · "2" despesa |
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"}'
POST
/saldos
Retorna fechamento de caixa e saldo por conta para uma data específica.
Retorna dados apenas para datas já encerradas (dias anteriores ao atual).
| Campo | Tipo | Req. | Descrição |
|---|---|---|---|
franquia_id | string | ✓ | ID numérico da franquia |
data | string | ✓ | YYYY-MM-DD |
curl -X POST http://localhost:2007/saldos \
-H "Content-Type: application/json" \
-d '{"franquia_id":"535","data":"2026-04-01"}'
POST
/vendas
Relatório de Filiação por Vendedor num intervalo de datas.
curl -X POST http://localhost:2007/vendas \
-H "Content-Type: application/json" \
-d '{"franquia_id":"535","data_inicio":"2026-04-22","data_fim":"2026-04-29"}'
POST
/refresh
🔒 protegido
Renova os cookies do CTN via login automático + 2captcha. Atualiza o .env em disco sem reiniciar.
| Header | Valor |
|---|---|
X-API-Secret | Valor de API_SECRET no .env |
curl -X POST http://localhost:2007/refresh \
-H "X-API-Secret: sua_senha_forte"
Configure no n8n: cron
0 7 * * 1-5 → POST /refresh com o header. O refresh leva ~2 min (2captcha).
Configuração · .env
| Variável | Descrição | Atualização |
|---|---|---|
CTN_LOGIN | E-mail de acesso ao CTN | Manual |
CTN_SENHA | Senha de acesso ao CTN | Manual |
TWOCAPTCHA_API_KEY | Chave do 2captcha | Manual |
API_SECRET | Protege POST /refresh | Manual |
CTN_AUTH | Cookie de autenticação CTN | Auto via /refresh |
FRANQUIA_IDS | Mapa NOME:ID separado por vírgula | Manual |