Skip to main content

Caso de uso · Operar em nome de um cliente

Piloto · na sua plataforma

A camada de dinheiro por baixo do assistente dos seus clientes.

O assistente e o app são seus. Cada cliente PJ assina um mandato com favorecidos, tetos e validade; o assistente paga e recebe dentro dele, e o seu app mostra o histórico.

As chaves de teste são gratuitas.

Seu app · o assistente de um cliente PJdemo

O mandato, como o seu cliente vê

Favorecidos

locador · contador · fornecedor de peças

Por transação

R$ 8.000,00 · acima, aprovação

Por mês

R$ 40.000,00 · acima, recusa

Validade

90 dias · renovação explícita

Outubro, como o assistente executou

Aluguel · boletoFavorecido listado · dentro dos tetos−R$ 6.200,00pago
Contador · boletoFavorecido listado · dentro dos tetos−R$ 890,00pago
Equipamento · boletoAcima do teto por transação de R$ 8.000,00 · aguarda aprovação−R$ 9.500,00aguardando aprovação
Fornecedor novo · boletoNenhum mandato nomeia este favorecido · nada enviado · o dono assina um novo mandato com eleR$ 3.800,00recusado
Um cliente paga a empresa · cobrança PixEntrada · lançamento no ledger, sem recibo assinado+R$ 2.400,00recebido
Teto mensal · outubroR$ 7.090,00 de R$ 40.000,00
1 aguardando aprovação · R$ 9.500,00recibos rcpt_demo_0410 · rcpt_demo_0411 · assinados

Piloto · dados de demonstração

A dor

A plataforma quer oferecer um assistente que mexe em dinheiro, mas não quer construir governança, aprovação e prova.

Quem usa

O dono do PJ, dentro do seu app.

Quem compra

Contabilidade online, fintech ou banco com base PJ.

O ganho

O cliente define favorecidos, tetos e validade; o assistente paga e recebe dentro disso; o seu app mostra o histórico.

O fluxo, lado a lado

Seu assistente, o mandato deles, nossas verificações.

Esta página vende o que roda por baixo. O assistente e o app são seus; a distribuição pela sua plataforma é um piloto.

  1. 01Cliente

    Assina o mandato

    No seu app o dono assina um mandato: favorecidos listados, teto por transação e teto mensal, 90 dias. A página de consentimento é da CodeSpar.

    mnd_demo_pj · 90 dias

  2. 02Seu assistente

    Paga o mês

    Seu assistente abre uma sessão para esse cliente e paga os boletos do mês pelo codespar_pay.

    codespar_pay · boleto

  3. 03CodeSpar

    Verifica cada pagamento

    O favorecido precisa estar na lista assinada e os tetos valem. Fora da lista é recusado; acima do teto por transação aguarda uma pessoa.

    favorecidos · tetos · recibos

  4. 04Sua plataforma

    Mostra o histórico

    Pagamentos, recibos e cobranças recebidas aparecem no seu app. A distribuição pela sua plataforma é um piloto.

    Piloto · integração

Por trás

Mandato, favorecidos, aprovações, recibos.

As regras do cliente moram num mandato que ele assina. A CodeSpar confere cada pagamento contra ele; a sua plataforma é dona do assistente e das telas.

Mandato · mnd_demo_pj demo
Assinado porO dono do PJ, na página de consentimento
Favorecidoslocador · contador · fornecedor de peças
Teto por transaçãoR$ 8.000,00 · acima dele uma pessoa aprova (boleto que o agente paga)
Teto mensalR$ 40.000,00 / mês · acima dele, recusa
Validade90 dias · renovação explícita
Três caminhos sob o mesmo mandato demo
Caminho felizAluguel · R$ 6.200 · favorecido listado, dentro dos tetos → pago por boleto, recibo assinado.
ExceçãoEquipamento · R$ 9.500 · acima do teto por transação de R$ 8.000 → aguarda aprovação no Dashboard. Levar essa decisão ao dono no seu app é a sua integração.
RecusaUm fornecedor novo que nenhum mandato nomeia → recusado, nada enviado. O dono assina um novo mandato com ele; aí o assistente paga.
TypeScript · @codespar/sdk 0.16.11Exemplo do SDK
const session = await new CodeSpar().create("cust_pj_0412", { preset: "brazilian" });const run = await session.send("pay this month's rent boleto for the workshop");const pay = run.tool_calls.find((c) => c.tool_name === "codespar_pay");// favorecido listado: pago, rcpt_demo_0410 · acima do teto: approval_required · fora do mandato: recusado

Exemplo do SDK · dados de demonstração · não roda nesta página

O que faz rodar demo
Mandato e regrasExisteLista assinada de favorecidos, teto por transação e teto mensal, validade.Abrir
PaySandboxPaga o boleto sob o mandato do cliente.Abrir
AprovaçõesExisteAcima do teto por transação o pagamento aguarda no Dashboard; a aprovação expira em 24 h.Abrir
CollectSandboxCobra os clientes do seu cliente por Pix; dinheiro entrando é um lançamento no ledger.Abrir
Seu appPiloto / integraçãoO assistente, as telas e a distribuição são seus.

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.

Mandato: favorecidos assinados, teto por transação e teto mensalConferidos em cada pagamento; acima do teto mensal é recusado.Existe
Um favorecido que o mandato não nomeiaRecusado, nada enviado. O caminho é um novo mandato com o favorecido; nada o segura para uma pessoa.Existe
Pagamentos de teste por boletoLiquidam no sandbox com chave de teste.Sandbox
Aprovação acima do teto por transaçãoNo Dashboard, por um admin da organização; a aprovação expira em 24 h.Existe
Cobrança recebidaUma cobrança Pix paga pelo cliente do seu cliente é um lançamento no ledger; dinheiro entrando não recebe recibo assinado.Sandbox
A aprovação no seu app, para o donoLevar a decisão ao dono do PJ é a sua integração.Piloto / integração
Distribuição pela sua plataformaSeus clientes chegam ao assistente pelo seu app: um piloto.Piloto / integração

Cookbook

Uma sessão por cliente, sob o mandato dele.

Cada cliente PJ assina um mandato na página de consentimento; o seu assistente abre uma sessão para esse cliente e paga em linguagem natural. Acima do teto por transação o pagamento aguarda no Dashboard; um favorecido fora do mandato é recusado.

  1. Uma chave de testeNo Dashboard. Chaves de teste são gratuitas; nada movimenta dinheiro real.
  2. Um mandato por clienteFavorecidos, teto por transação e teto mensal, validade. O Dashboard abre a página de consentimento; o seu cliente assina.
  3. O id do seu clienteO user id da sessão: uma sessão por cliente PJ.
@codespar/sdk 0.16.11Exemplo do SDK
// 1 · o seu cliente assinou mnd_demo_pj na página de consentimento: favorecidos listados, R$ 8.000,00 por transação, R$ 40.000,00 por mêsimport { CodeSpar, isApprovalRequired } from "@codespar/sdk";const session = await new CodeSpar().create("cust_pj_0412", { preset: "brazilian" }); // 2 · o seu assistente paga por esse cliente, numa sessão com o user id deleconst run = await session.send("pay this month's rent boleto for the workshop");const pay = run.tool_calls.find((c) => c.tool_name === "codespar_pay"); // 3 · dentro dos tetos: pago · acima do teto por transação: aguarda aprovação · favorecido fora do mandato: recusadoif (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 usoConceito

Assistentes pessoais

As obrigações do mês sob um mandato; exceções esperam por você.

Caso de usoSandbox

Copiloto do CFO

Pague faturas aprovadas dentro da sua política de alçadas.

Caso de usoSandbox

WhatsApp: cobrança Pix no chat

Uma cobrança Pix dentro da conversa, paga no app do banco.

Dê aos seus agentes um jeito de pagar e receber.

Construir é grátis: MCP hospedado, SDK e sandbox.

As chaves de teste são gratuitas.

terminal · modo de testedemo
$ claude mcp add --transport http codespar https://connect.codespar.dev/mcp \    --header "Authorization: Bearer <chave de teste>"> "pagar os boletos do mês do cliente cust_pj_0412"  aluguel e contador pagos · equipamento acima do teto por transação aguarda · fornecedor novo fora do mandato: recusado  2 pagos · 1 aguardando aprovação · 1 recusado · registrado

Ilustrativo · dados de demonstração

Assistente financeiro para seus clientes · CodeSpar