Skip to main content
Todos os casos de uso
Folha + payoutsOperations

O dia de pagamento é uma intenção, não um upload de planilha.

O agente lê a lista aprovada de prestadores, valida a chave Pix e o documento de cada um e paga a rodada via Pix dentro de um mandato de folha com teto mensal. Cada payout ganha o próprio recibo, e a rodada fecha conciliada no ERP sem nada pendente.

AntesArquivo CNAB → portal do banco → corrigir rejeições
DepoisUma intenção → 24 recibos → rodada selada
1 intent
a rodada inteira, selada
Teste no Sandbox
Pix
Trilho de payout
Instantâneo, um recibo por favorecido
Monthly cap
Mandato de folha
A rodada não passa do teto
Per payee
Validado
Chave e documento checados antes de pagar
ERP
Fechado no ERP
Rodada conciliada lançamento a lançamento
A rodada, como registro

Uma rodada. Vinte e quatro recibos. Zero pendências.

A rodada de junho, de ponta a ponta: cada favorecido validado antes de qualquer centavo se mover, cada transferência executada via Pix sob o mandato de folha, cada recibo selado e casado com o lançamento no ERP. Uma chave desatualizada falha rápido na validação: antes do pagamento, não depois de uma rejeição do banco.

  • Favorecidos validados antes: chave desatualizada não chega ao trilho
  • O mandato limita o mês; a rodada para no teto, por construção
  • Cada payout selado com o próprio recibo e conciliado no ERP

Rode a folha de prestadores de junho.

24 prestadores na lista aprovada: validando chaves e documentos e pagando via Pix dentro do teto do mandato de folha.

Rodada de folha · junho
RUN-06 · 24 contractors
Liquidada · conciliada
TotalR$ 96.400,00
Mandatocm_pay…4Rd · cap R$ 120.000/mo
TrilhoPix · 24 transfers
Validação24/24 keys + tax IDs checked
ERPOmie · 24 entries matched
run-06.csvreceipts-run06.json
liquidada · conciliada · seladarcp_pr0624
A dor

A conversa é a parte fácil.

Folha de prestadores na LATAM é um ritual mensal: exportar a planilha, gerar o CNAB, subir no portal do banco, corrigir as rejeições e conciliar na mão. Funciona até uma chave estar desatualizada, um nome não bater, ou o mesmo arquivo subir duas vezes. E cada falha aparece depois que o dinheiro já tentou se mover.

Gerar um arquivo CNAB e subir no portal do banco todo mês

Uma intenção: o agente roda a folha inteira via Pix

Descobrir chaves desatualizadas como rejeições do banco, depois da rodada

Chave e documento de cada favorecido validados antes do pagamento

Confiar que ninguém erra o total nem sobe o arquivo duas vezes

O mandato de folha limita o mês; o excesso simplesmente não executa

Conciliar a rodada contra o ERP lançamento a lançamento, na mão

O codespar_ledger casa os 24 recibos de volta automaticamente

Como o agente faz isso

Uma intenção. A rodada inteira, governada.

O codespar_kyc valida cada favorecido antes de a rodada começar. O codespar_wallet confirma que o mandato de folha tem espaço para o total. O codespar_pay executa as transferências via Pix, um recibo por favorecido, e o codespar_ledger concilia a rodada no ERP. O dia de pagamento termina liquidado, casado e selado.

01
Lista
ERP / planilha

24 prestadores aprovados

02
Validação
codespar_kyc

Chaves + documentos checados

Trilho de KYC
03
Checagem de teto
codespar_wallet

A rodada cabe no mandato

Motor de políticas
04
Pagamento
codespar_pay

24 × Pix · um recibo cada

Trilho Pix
05
Conciliação
codespar_ledger

Casada com o ERP

Ledger de auditoria
Arquitetura

A lista aprovada entra pelo ERP ou por planilha. O agente valida cada favorecido, confere o total da rodada contra o teto mensal do mandato de folha e executa as transferências via Pix. A correlação de liquidação casa cada confirmação com seu favorecido e lançamento no ERP, e a rodada sela como um registro com 24 recibos dentro.

Em código

Algumas linhas. O loop inteiro.

contractor-payroll.ts
const session = await codespar.sessions.create();

const run = await session.execute("codespar_pay", {
  batch: contractors.map((c) => ({
    amount: c.monthlyFee,
    destination: c.pixKey,      // validated before the run starts
    reference: `RUN-06/${c.id}`,
  })),
  mandate: "cm_payroll",        // monthly cap · revocable
});

// 24 transfers, 24 receipts, one sealed run —
// reconciled against the ERP entry by entry
1 intent · seladoreceipt · rcp_contra
Ferramentas em destaque
codespar_pay

Executa a rodada via Pix, um recibo selado por favorecido.

codespar_wallet

Confere a rodada contra o teto mensal do mandato de folha antes de pagar.

codespar_kyc

Valida a chave e o documento de cada favorecido antes de a rodada começar.

Ver a referência das meta-tools

Coloque no ar ainda hoje.

Abra o sandbox, aponte uma sessão para os seus provedores e rode o loop inteiro contra rails reais em minutos — não no trimestre que levaria para construir tudo na mão.

Agente de folha de prestadores — CodeSpar | CodeSpar