A dor
O financeiro passa o dia conferindo fatura contra política e caçando aprovador.
Quem usa
O analista de contas a pagar e quem aprova acima do teto.
Quem compra
CFO ou controller de empresa média com ERP e alçadas de aprovação.
O ganho
A fila do dia sai sozinha dentro do mandato. Só a exceção chega a uma pessoa, com a regra e o comprovante junto.
O fluxo, lado a lado
Da fatura aprovada à prova no ERP.
A obrigação já existe. O copiloto paga sob o mandato; uma pessoa só decide a exceção.
01Cliente
Aprovada no ERP
O financeiro aprova a fatura no próprio fluxo. O copiloto lê fornecedor, valor, vencimento e a linha digitável do boleto.
INV-2291 · R$ 18.400,00 · vence em 3 dias02Agente
Preparado e conferido
O copiloto paga o boleto pelo codespar_pay. O valor é conferido contra os tetos do mandato antes de qualquer envio.
R$ 10.000,00 por transação · R$ 150.000,00 por mês03CodeSpar
Aguarda, aprovado, pago
Acima do teto por transação o pagamento aguarda uma pessoa no Dashboard. Aprovado, roda o ciclo completo: saldo reservado, débito, recibo assinado.
aguardando → aprovado → pago · rcpt_demo_229104Meio de pagamento · ERP
Liquidado e devolvido
O boleto liquida. Gravar o status e o recibo de volta no ERP é a sua integração.
ERP "pago" · Ilustrativo · integração
Por trás
Mandato, aprovações, pagamento, recibo.
A política mora no mandato: um teto por transação em que uma pessoa entra e um teto mensal que recusa. As aprovações rodam no Dashboard; o copiloto só pede e lê o status.
Exemplo do SDK · dados de demonstração · não roda nesta página
O que existe hoje
Existe, sandbox, piloto ou direção: um rótulo por controle.
O que você roda hoje com uma chave de teste, o que roda no sandbox, o que depende de piloto ou integração e o que ainda é só direção.
Cookbook
Uma fatura dentro da política, de ponta a ponta.
O mandato é assinado na página de consentimento; o copiloto faz três chamadas no código. Acima do teto por transação o pagamento aguarda aprovação no Dashboard; o copiloto lê o resultado.
- Uma chave de testeNo Dashboard. Chaves de teste são gratuitas; nada movimenta dinheiro real.
- Um mandatoTeto por transação e teto mensal. O Dashboard abre a página de consentimento; o consumidor assina.
- Uma fatura aprovadaQualquer referência que o agente possa citar: número da fatura, fornecedor, valor, a linha digitável do boleto.
// 1 · o mandato foi assinado na página de consentimento: R$ 10.000,00 por transação, R$ 150.000,00 por mêsimport { CodeSpar, isApprovalRequired } from "@codespar/sdk";const session = await new CodeSpar().create("user_0000", { preset: "brazilian" }); // 2 · o copiloto paga o boleto de uma fatura que o ERP aprovouconst run = await session.send("pay the logistics supplier's boleto for invoice INV-2291");const pay = run.tool_calls.find((c) => c.tool_name === "codespar_pay"); // 3 · abaixo do teto: pago · acima dele: aguarda aprovação no Dashboardif (pay && isApprovalRequired(pay.output)) console.log(pay.output.approval_id, pay.output.expires_at);else if (pay) console.log((await session.paymentStatus(pay.id)).payment_status); // "succeeded"Exemplo do SDK · dados de demonstração · não roda nesta página
Casos de uso relacionados