A dor
Obrigações fixas, favorecidos conhecidos, e mesmo assim alguém tem de lembrar, conferir e pagar.
Quem usa
A pessoa, ou o casal.
Quem compra
O app que já a atende: contabilidade online, banco.
O ganho
O assistente paga o que o mandato permite; só o inesperado pede a sua aprovação.
O fluxo, lado a lado
Da guia do contador ao recibo guardado com ela.
O valor vem do contador; o assistente não calcula, não concilia e não paga ninguém fora do mandato.
01Contador
Guia do mês
O contador manda a guia do mês. O valor é dele.
R$ 1.218,00 · vence dia 2002CodeSpar
Conferida
O código de barras a marca como tributo; os tetos do mandato são conferidos antes de qualquer envio.
tributo · órgão arrecadador03CodeSpar
Paga, ou aguardando
Abaixo do teto por transação o boleto é pago; acima dele, o pagamento aguarda aprovação.
−R$ 1.218,00 · boleto04O app
Recibo com a guia
O recibo assinado fica guardado com a guia no app que atende você.
rcpt_demo_1020 · assinado
Por trás
Mandato, guia, aprovação, recibo.
O que o assistente pode pagar mora num mandato que você assina. O valor vem do contador; a plataforma confere os tetos e guarda a prova.
Exemplo do SDK · dados de demonstração · não roda nesta página
Variações para depois
Mais duas rotinas, depois.
A cena A é a que esta página mostra. B e C são candidatas para depois, com as mesmas regras e nenhuma promessa além delas.
Cena BPara depois
Uma família
Escola, funcionária doméstica, luz e internet sob um teto mensal. Um boleto extra de matrícula acima do teto por transação aguarda aprovação.
Cena CPara depois
Um médico PJ
Aluguel do consultório e equipe sob o mandato; honorários recebidos das clínicas guardados no histórico, sem conciliação automática. Equipamento de um fornecedor que nenhum mandato nomeia precisa antes de um novo mandato.
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
A guia do mês, paga sob um mandato.
Você assina o mandato na página de consentimento; o assistente paga a guia em linguagem natural. Acima do teto por transação o pagamento aguarda aprovação; o assistente lê o resultado.
- Uma chave de testeNo Dashboard. Chaves de teste são gratuitas; nada movimenta dinheiro real.
- Um mandatoFinalidade, teto por transação e teto mensal. O Dashboard abre a página de consentimento; você assina.
- A guiaA linha digitável que veio do contador. O valor é dele; nada é calculado.
// 1 · você assinou o mandato na página de consentimento: guias de tributo, R$ 2.000,00 por transação, R$ 6.000,00 por mêsimport { CodeSpar, isApprovalRequired } from "@codespar/sdk";const session = await new CodeSpar().create("user_0000", { preset: "brazilian" }); // 2 · o assistente paga a guia no trilho de boleto; o valor é do contadorconst run = await session.send("pay this month's tax slip from the accountant, due on the 20th");const pay = run.tool_calls.find((c) => c.tool_name === "codespar_pay"); // 3 · abaixo do teto: paga · acima dele: aguarda a sua aprovaçãoif (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
Caso de usoPiloto / integração
Assistente financeiro para seus clientes
A camada de dinheiro por baixo do assistente de uma plataforma.