Skip to main content
Todos los casos de uso
Nómina + payoutsOperations

El día de pago es una intención, no un upload de planilla.

El agente lee la lista aprobada de contratistas, valida la clave Pix y el documento de cada uno y paga la corrida por Pix dentro de un mandato de nómina con tope mensual. Cada payout recibe su propio recibo, y la corrida cierra conciliada en el ERP sin nada pendiente.

AntesArchivo CNAB → portal del banco → corregir rechazos
DespuésUna intención → 24 recibos → corrida sellada
1 intent
toda la corrida, sellada
Pruébalo en el Sandbox
Pix
Riel de payout
Instantáneo, un recibo por beneficiario
Monthly cap
Mandato de nómina
La corrida no supera el tope
Per payee
Validado
Clave y documento verificados antes de pagar
ERP
Cerrado en el ERP
Corrida conciliada asiento por asiento
La corrida, como registro

Una corrida. Veinticuatro recibos. Cero pendientes.

La corrida de junio, de punta a punta: cada beneficiario validado antes de que se mueva un centavo, cada transferencia ejecutada por Pix bajo el mandato de nómina, cada recibo sellado y emparejado con su asiento en el ERP. Una clave desactualizada falla rápido en la validación: antes del pago, no después de un rechazo del banco.

  • Beneficiarios validados antes: una clave desactualizada no llega al riel
  • El mandato limita el mes; la corrida se detiene en el tope, por construcción
  • Cada payout sellado con su propio recibo y conciliado en el ERP

Corre la nómina de contratistas de junio.

24 contratistas en la lista aprobada: validando claves y documentos y pagando por Pix dentro del tope del mandato de nómina.

Corrida de nómina · junio
RUN-06 · 24 contractors
Liquidada · conciliada
TotalR$ 96.400,00
Mandatocm_pay…4Rd · cap R$ 120.000/mo
RielPix · 24 transfers
Validación24/24 keys + tax IDs checked
ERPOmie · 24 entries matched
run-06.csvreceipts-run06.json
liquidada · conciliada · selladarcp_pr0624
El problema

La conversación es la parte fácil.

La nómina de contratistas en LATAM es un ritual mensual: exportar la planilla, generar el CNAB, subirlo al portal del banco, corregir los rechazos y conciliar a mano. Funciona hasta que una clave está desactualizada, un nombre no coincide o el mismo archivo se sube dos veces. Y cada falla aparece después de que el dinero ya intentó moverse.

Generar un archivo CNAB y subirlo al portal del banco cada mes

Una intención: el agente corre toda la nómina por Pix

Descubrir claves desactualizadas como rechazos del banco, después de la corrida

Clave y documento de cada beneficiario validados antes del pago

Confiar en que nadie se equivoca en el total ni sube el archivo dos veces

El mandato de nómina limita el mes; el exceso simplemente no se ejecuta

Conciliar la corrida contra el ERP asiento por asiento, a mano

codespar_ledger empareja los 24 recibos automáticamente

Cómo lo hace el agente

Una intención. Toda la corrida, gobernada.

codespar_kyc valida a cada beneficiario antes de que la corrida empiece. codespar_wallet confirma que el mandato de nómina tiene espacio para el total. codespar_pay ejecuta las transferencias por Pix, un recibo por beneficiario, y codespar_ledger concilia la corrida en el ERP. El día de pago termina liquidado, emparejado y sellado.

01
Lista
ERP / planilla

24 contratistas aprobados

02
Validación
codespar_kyc

Claves + documentos verificados

Riel de KYC
03
Chequeo de tope
codespar_wallet

La corrida cabe en el mandato

Motor de políticas
04
Pago
codespar_pay

24 × Pix · un recibo cada uno

Riel Pix
05
Conciliación
codespar_ledger

Emparejada con el ERP

Ledger de auditoría
Arquitectura

La lista aprobada entra por el ERP o por planilla. El agente valida a cada beneficiario, verifica el total de la corrida contra el tope mensual del mandato de nómina y ejecuta las transferencias por Pix. La correlación de liquidación empareja cada confirmación con su beneficiario y asiento del ERP, y la corrida se sella como un registro con 24 recibos adentro.

En código

Unas pocas líneas. Todo el loop.

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 · selladoreceipt · rcp_contra
Herramientas destacadas
codespar_pay

Ejecuta la corrida por Pix, un recibo sellado por beneficiario.

codespar_wallet

Verifica la corrida contra el tope mensual del mandato de nómina antes de pagar.

codespar_kyc

Valida la clave y el documento de cada beneficiario antes de que la corrida empiece.

Ver la referencia de meta-tools

Ponlo en marcha esta misma tarde.

Abre el sandbox, apunta una sesión a tus proveedores y corre todo el loop contra rails reales en minutos — no en el trimestre que toma construirlo a mano.

Agente de nómina de contratistas — CodeSpar | CodeSpar