API v1

curl https://api.capflux.com.br/v1/eu \
  -H "Authorization: Bearer $CHAVE"

const r = await fetch('https://api.capflux.com.br/v1/eu', {
  headers: { Authorization: `Bearer ${process.env.CHAVE}` },
});
console.log(await r.json());

import os, requests

r = requests.get('https://api.capflux.com.br/v1/eu', headers={'Authorization': f"Bearer {os.environ['CHAVE']}"})
print(r.json())

curl https://api.capflux.com.br/v1/documentos \
  -H "Authorization: Bearer $CHAVE" \
  -H "Idempotency-Key: erp-nota-000123" \
  -F "arquivos=@nota-000123.pdf" \
  -F "arquivos=@nota-000123.xml" \
  -F "assunto=NF 123 — Fornecedor Fictício Ltda"

import { readFile } from 'node:fs/promises';

const pdf = await readFile('nota-000123.pdf');
const r = await fetch('https://api.capflux.com.br/v1/documentos', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CHAVE}`,
    'Idempotency-Key': 'erp-nota-000123',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    assunto: 'NF 123 — Fornecedor Fictício Ltda',
    arquivos: [{ nome: 'nota-000123.pdf', conteudo_base64: pdf.toString('base64') }],
  }),
});
console.log(r.status, await r.json()); // 202 { documento_id, situacao: 'recebida', ... }

import os, requests

with open('nota-000123.pdf', 'rb') as pdf:
    r = requests.post(
        'https://api.capflux.com.br/v1/documentos',
        headers={'Authorization': f"Bearer {os.environ['CHAVE']}", 'Idempotency-Key': 'erp-nota-000123'},
        files=[('arquivos', ('nota-000123.pdf', pdf, 'application/pdf'))],
        data={'assunto': 'NF 123 — Fornecedor Fictício Ltda'},
    )
print(r.status_code, r.json())

curl https://api.capflux.com.br/v1/documentos/$DOCUMENTO_ID \
  -H "Authorization: Bearer $CHAVE"

const r = await fetch(`https://api.capflux.com.br/v1/documentos/${documentoId}`, {
  headers: { Authorization: `Bearer ${process.env.CHAVE}` },
});
const { situacao, card_id } = await r.json(); // 'virou_card' quando a leitura termina

r = requests.get(f'https://api.capflux.com.br/v1/documentos/{documento_id}', headers={'Authorization': f"Bearer {os.environ['CHAVE']}"})
print(r.json()['situacao'], r.json()['card_id'])

curl "https://api.capflux.com.br/v1/cards?pronto_para_lancar=true&limite=50" \
  -H "Authorization: Bearer $CHAVE"
# Próxima página: acrescente &cursor=<proximo_cursor>

# Consulta para BI (cenário 8): o que mudou desde a última carga, com os tempos
curl "https://api.capflux.com.br/v1/cards?atualizado_desde=2026-11-10T08:00:00-03:00&limite=200" \
  -H "Authorization: Bearer $CHAVE"

// Puxa a fila inteira, página por página.
let cursor = null;
do {
  const q = new URLSearchParams({ pronto_para_lancar: 'true', limite: '50', ...(cursor ? { cursor } : {}) });
  const r = await fetch(`https://api.capflux.com.br/v1/cards?${q}`, { headers: { Authorization: `Bearer ${process.env.CHAVE}` } });
  const page = await r.json();
  for (const card of page.itens) console.log(card.codigo, card.fornecedor.nome, card.valores.liquido);
  cursor = page.proximo_cursor;
} while (cursor);

// Consulta para BI (cenário 8): sem pronto_para_lancar, com filtros e tempos.
const q = new URLSearchParams({ situacao: 'lancado', criado_de: '2026-11-01', criado_ate: '2026-11-30', limite: '200' });
const bi = await (await fetch(`https://api.capflux.com.br/v1/cards?${q}`, { headers: { Authorization: `Bearer ${process.env.CHAVE}` } })).json();
for (const c of bi.itens) console.log(c.codigo, c.tempos.total_segundos / 86400, 'dias');

import os, requests

h = {'Authorization': f"Bearer {os.environ['CHAVE']}"}
params = {'pronto_para_lancar': 'true', 'limite': 50}
while True:
    page = requests.get('https://api.capflux.com.br/v1/cards', headers=h, params=params).json()
    for card in page['itens']:
        print(card['codigo'], card['fornecedor']['nome'], card['valores']['liquido'])
    if not page['proximo_cursor']:
        break
    params['cursor'] = page['proximo_cursor']

# Consulta para BI (cenário 8): o que mudou desde a última carga, com os tempos
bi = requests.get('https://api.capflux.com.br/v1/cards', headers=h, params={'atualizado_desde': '2026-11-10T08:00:00-03:00', 'limite': 200}).json()
for card in bi['itens']:
    for etapa in card['tempos']['por_etapa']:
        print(card['codigo'], etapa['chave'], etapa['segundos'])

curl -X POST https://api.capflux.com.br/v1/pedidos-pagamento \
  -H "Authorization: Bearer $CHAVE" \
  -H "Idempotency-Key: despesas-RB-2026-0042" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo": "reembolso",
    "favorecido": { "nome": "Pessoa Fictícia", "cnpj_cpf": "12345678909" },
    "valor": 150.40,
    "vencimento": "2026-11-30",
    "descricao": "Táxi para visita ao cliente fictício",
    "numero": "RB-2026-0042"
  }'

const r = await fetch('https://api.capflux.com.br/v1/pedidos-pagamento', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CHAVE}`,
    'Idempotency-Key': 'despesas-RB-2026-0042',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tipo: 'reembolso',
    favorecido: { nome: 'Pessoa Fictícia', cnpj_cpf: '12345678909' },
    valor: 150.4,
    descricao: 'Táxi para visita ao cliente fictício',
    numero: 'RB-2026-0042',
    anexos: [{ nome: 'recibo.pdf', conteudo_base64: reciboBase64 }],
  }),
});
const card = await r.json(); // 201: card.etapa diz para onde as regras mandaram

import os, requests

with open('recibo.pdf', 'rb') as f:
    r = requests.post(
        'https://api.capflux.com.br/v1/pedidos-pagamento',
        headers={'Authorization': f"Bearer {os.environ['CHAVE']}", 'Idempotency-Key': 'despesas-RB-2026-0042'},
        data={'tipo': 'reembolso', 'favorecido_nome': 'Pessoa Fictícia', 'favorecido_cnpj_cpf': '12345678909',
              'valor': '150.40', 'descricao': 'Táxi para visita ao cliente fictício', 'numero': 'RB-2026-0042'},
        files=[('anexos', ('recibo.pdf', f, 'application/pdf'))],
    )
print(r.status_code, r.json()['etapa'])

curl -X PUT https://api.capflux.com.br/v1/fornecedores/11222333000181 \
  -H "Authorization: Bearer $CHAVE" \
  -H "Idempotency-Key: erp-forn-11222333000181-20261111" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Fornecedor Fictício Ltda",
    "empresas": [{ "codigo_erp": "F001", "prazo_pagamento_dias": 28 }],
    "dados_pagamento": [{ "tipo": "banco", "banco": "341", "agencia": "1234", "conta": "12345-6", "tipo_conta": "corrente" }],
    "motivo": "Conta nova informada pelo fornecedor"
  }'
# dados_pagamento volta com situacao "pendente_aprovacao": vale depois que alguém aprovar na tela.

const r = await fetch('https://api.capflux.com.br/v1/fornecedores/11222333000181', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.CHAVE}`,
    'Idempotency-Key': 'erp-forn-11222333000181-20261111',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    nome: 'Fornecedor Fictício Ltda',
    empresas: [{ codigo_erp: 'F001', prazo_pagamento_dias: 28 }],
    dados_pagamento: [{ tipo: 'pix', tipo_chave: 'email', chave: 'financeiro@fornecedor.exemplo' }],
  }),
});
const { fornecedor, dados_pagamento } = await r.json(); // dado bancário só mascarado

import os, requests

r = requests.put(
    'https://api.capflux.com.br/v1/fornecedores/11222333000181',
    headers={'Authorization': f"Bearer {os.environ['CHAVE']}", 'Idempotency-Key': 'erp-forn-11222333000181-20261111'},
    json={'nome': 'Fornecedor Fictício Ltda', 'situacao': 'ativo', 'empresas': [{'codigo_erp': 'F001', 'prazo_pagamento_dias': 28}]},
)
print(r.status_code, r.json()['fornecedor']['id'])

curl https://api.capflux.com.br/v1/cards/$CARD_ID \
  -H "Authorization: Bearer $CHAVE"

const r = await fetch(`https://api.capflux.com.br/v1/cards/${cardId}`, { headers: { Authorization: `Bearer ${process.env.CHAVE}` } });
const card = await r.json(); // card.versao vai nas escritas

card = requests.get(f'https://api.capflux.com.br/v1/cards/{card_id}', headers={'Authorization': f"Bearer {os.environ['CHAVE']}"}).json()

curl -OJ https://api.capflux.com.br/v1/arquivos/$ARQUIVO_ID \
  -H "Authorization: Bearer $CHAVE"

import { writeFile } from 'node:fs/promises';

const r = await fetch(`https://api.capflux.com.br/v1/arquivos/${arquivoId}`, { headers: { Authorization: `Bearer ${process.env.CHAVE}` } });
await writeFile('nota.pdf', Buffer.from(await r.arrayBuffer()));

r = requests.get(f'https://api.capflux.com.br/v1/arquivos/{arquivo_id}', headers={'Authorization': f"Bearer {os.environ['CHAVE']}"})
open('nota.pdf', 'wb').write(r.content)

curl https://api.capflux.com.br/v1/cards/$CARD_ID/lancamento \
  -H "Authorization: Bearer $CHAVE" \
  -H "Idempotency-Key: lancamento-5100001234" \
  -H "Content-Type: application/json" \
  -d '{"numero_documento": "5100001234", "data_lancamento": "2026-11-10", "vencimento_erp": "2026-11-30"}'

const r = await fetch(`https://api.capflux.com.br/v1/cards/${cardId}/lancamento`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CHAVE}`,
    'Idempotency-Key': 'lancamento-5100001234',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ numero_documento: '5100001234', data_lancamento: '2026-11-10', vencimento_erp: '2026-11-30' }),
});
if (r.status === 422) {
  const { erro } = await r.json();
  // requer_confirmacao_na_tela: alerta de segurança do pagamento; uma pessoa confere na tela e você reenvia.
  console.log(erro.codigo, erro.mensagem, erro.campos ?? erro.alertas);
}

r = requests.post(
    f'https://api.capflux.com.br/v1/cards/{card_id}/lancamento',
    headers={'Authorization': f"Bearer {os.environ['CHAVE']}", 'Idempotency-Key': 'lancamento-5100001234'},
    json={'numero_documento': '5100001234', 'data_lancamento': '2026-11-10', 'vencimento_erp': '2026-11-30'},
)
print(r.status_code, r.json())

curl https://api.capflux.com.br/v1/cards/$CARD_ID/pagamento \
  -H "Authorization: Bearer $CHAVE" \
  -H "Idempotency-Key: pagamento-5100001234" \
  -F "data_paga=2026-11-20" \
  -F "valor=1234.56" \
  -F "comprovante=@comprovante.pdf"

const r = await fetch(`https://api.capflux.com.br/v1/cards/${cardId}/pagamento`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CHAVE}`,
    'Idempotency-Key': 'pagamento-5100001234',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ data_programada: '2026-11-20', valor: 1234.56 }),
});
console.log(r.status, await r.json()); // 201 { pagamento_id, ... }

with open('comprovante.pdf', 'rb') as f:
    r = requests.post(
        f'https://api.capflux.com.br/v1/cards/{card_id}/pagamento',
        headers={'Authorization': f"Bearer {os.environ['CHAVE']}", 'Idempotency-Key': 'pagamento-5100001234'},
        data={'data_paga': '2026-11-20', 'valor': '1234.56'},
        files={'comprovante': ('comprovante.pdf', f, 'application/pdf')},
    )
print(r.status_code, r.json())