A dor
Pedidos saem toda semana, e pagar cada fornecedor ainda espera alguém.
Quem usa
O agente de operações ou compras, e a pessoa que aprova acima do teto.
Quem compra
COO ou líder de operações de uma empresa que compra dos mesmos fornecedores todo mês.
O ganho
A compra sai abaixo do teto por transação. Acima dele, uma pessoa decide com a regra à vista; além do teto mensal, é recusada.
O fluxo, lado a lado
Da necessidade ao recibo assinado.
O seu sistema aponta a necessidade e faz o pedido; o agente paga. Uma pessoa entra só acima do teto por transação.
01Seu sistema
Necessidade e pedido
O seu estoque aponta a necessidade e o seu fluxo de compras faz o pedido a um fornecedor com quem você trabalha. O agente lê fornecedor, valor, vencimento e a linha digitável do boleto.
PO-0418 · R$ 1.180,0002CodeSpar
Mandato
O teto por transação e o teto mensal são verificados antes de qualquer envio. Um pagamento acima do teto mensal é recusado.
R$ 3.000,00 por transação · R$ 20.000,00 por mês03Meio de pagamento
Pagamento
Abaixo do teto por transação, o boleto é pago. Acima dele, o pagamento espera uma pessoa no Dashboard; na aprovação roda o ciclo completo: saldo reservado, débito, recibo assinado.
−R$ 1.180,00 · boleto04CodeSpar · trilha de auditoria
Recibo
Cada boleto pago recebe um recibo assinado e um lançamento com categoria fornecedor; a referência do pedido vai na descrição.
rcpt_demo_8a31 · assinado
Por trás
Mandato, pagamento, aprovações, recibo.
Três chamadas do agente. O resto é a plataforma: mandato, pagamento, aprovações, recibo.
Exemplo do SDK · dados de demonstração · não roda nesta página
Dois jeitos de pagar
De onde vem o pedido.
Dois jeitos de um pedido se formar antes de o agente pagar. Com os seus fornecedores, o seu fluxo de compras faz o pedido. Nas lojas que o codespar_shop suporta, o agente busca, compara e faz o checkout sozinho.
Caminho A · seu fornecedor
SandboxO seu fluxo de compras faz o pedido
O pedido vai a um fornecedor com quem você já trabalha; o agente paga o boleto do fornecedor sob o mandato. Acima do teto por transação uma pessoa aprova no Dashboard.
O que a cena e a demo mostram. Escolher entre os seus fornecedores fica no seu fluxo de compras.
Caminho B · uma loja suportada
SandboxO agente compra sozinho
Nas lojas que o codespar_shop suporta, o agente busca o catálogo, compara ofertas e inicia o checkout da loja; o pedido é pago por Pix sob o mandato. Acima do teto por transação esse pagamento é recusado, não fica aguardando.
Só as lojas que o codespar_shop suporta, não um catálogo dos seus fornecedores. Roda em modo de teste com chave de teste.
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
Um pagamento a fornecedor, de ponta a ponta.
O consumidor assina o mandato na página de consentimento; o agente faz três chamadas no código. Um pagamento acima do teto por transação aguarda aprovação no Dashboard; o agente lê o status.
- 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.
- Um pedido de compraQualquer referência que o agente possa citar: número do PO, fornecedor, valor, a linha digitável do boleto.
// 1 · o consumidor assinou o mandato na página de consentimento: R$ 3.000,00 por transação, R$ 20.000,00 por mêsimport { CodeSpar, isApprovalRequired } from "@codespar/sdk";const session = await new CodeSpar().create("user_0000", { preset: "brazilian" }); // 2 · o agente paga o boleto do pedido de compraconst run = await session.send("pay the packaging supplier's boleto for PO-0418");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
Caso de usoSandbox
WhatsApp: cobrança Pix no chat
Uma cobrança Pix dentro da conversa, paga no app do banco.