Casos de uso

Lo que los agentes construyen sobre CodeSpar.

Diez patrones que los primeros builders están lanzando hoy, organizados por el movimiento de dinero que ejecutan: comercio, compras, nómina, tesorería y cross-border. Cada uno es una composición corta de las mismas primitivas: sesiones, mandatos, ruteo, auditoría.

ComercioCompras / Cuentas por pagarNómina + payoutsTesoreríaCross-border

Destacado · Operaciones

Agente de cuentas por pagar

De la factura a pagada, con aprobación solo sobre el tope

El agente comprador paga los boletos de los proveedores bajo un mandato de presupuesto firmado: sobre el tope por transacción, el boleto espera aprobación; sobre el tope mensual, se rechaza. Cada boleto pagado bajo el mandato deja un recibo firmado. Hacer el match con el ERP y adjuntar la NF-e son tu integración.

Boleto

pagado bajo el mandato

Ver ejemplo →

accounts-payable.ts

// Una llamada cierra el loop

await session.send("Pay the supplier invoices due this week, inside the July budget.");

✓ Boleto · selladousa ·

Comercio

Agente de fulfillment autónomoCobrar, facturar, enviar y avisar un pedido con cuatro meta-toolsPara cada pedido, el agente le cobra al comprador por Pix con codespar_charge, emite la NF-e con codespar_invoice (NFe.io, solo en proyectos live), compra la etiqueta con codespar_ship (Melhor Envio) y envía un texto por WhatsApp con codespar_notify (Z-API, solo en proyectos live). Leer el flujo de pedidos y escribir de vuelta en tu ERP son tu integración.4meta-tools por pedidoVer ejemplo Bot de comercio por WhatsAppCheckout conversacional que liquida en el chatEl cliente explora, negocia y paga sin salir de WhatsApp. El agente genera un QR Pix inline, confirma el pago, emite el documento fiscal y manda el tracking apenas el transportista retira. Sin links, sin redirects.3-tapcheckout dentro del chatVer ejemplo Agente de suscripcionesCobros mensuales por Pix Automático, autorizados una vez por el clienteEl agente crea una recurrencia de Pix Automático en Celcoin con codespar_charge: el cliente la autoriza en la app de su banco, y cada ciclo se cobra sobre esa autorización. Requiere Pix Automático activado para tu organización. Cobrar un precio en varias monedas y la gestión de cobranza no son funciones del producto; el documento fiscal de cada ciclo va por NFe.io, solo en proyectos live.Pix Automáticorecurrencia que el cliente autoriza una vezVer ejemplo Agente de reembolsos de soporteDevolver el Pix del cliente a quien pagó, limitado al pago originalCuando un cliente pide su dinero de vuelta, el agente de soporte devuelve el Pix que pagó: POST /v1/consumers/{consumerId}/pix/devolutions reembolsa por el endToEndId del pago, nunca más de lo que queda por devolver del crédito original, con una clave de idempotencia. El reembolso no se verifica contra un mandato ni un tope: el pago original es su límite. Una nota de crédito y la consulta del pedido en tu ERP siguen en tus sistemas.Pix ↩de vuelta a quien pagó, como máximo el monto originalVer ejemplo Acceso a API medidoCobrar el tope en el 402, devolver lo que la llamada no usóPara un vendedor detrás de Gate: un paywall medido anuncia un tope en el 402 (un precio base por un multiplicador máximo); después de la llamada, el multiplicador que tu API informa en un header de la respuesta fija el precio real, y la diferencia se devuelve on-chain desde la billetera del vendedor. El cobro medido está apagado en un despliegue hasta que el operador lo habilita.402 → refundel tope no usado vuelve on-chainVer ejemplo Monetización white-labelTu app, tus suscriptores como consumidores de tu organizaciónUna fintech ofrece pago de cuentas dentro de su propia app sobre CodeSpar: cada suscriptor es un consumidor de la organización de la fintech, abre una cuenta de pago con el onboarding de codespar_kyc y paga Pix o boletos con codespar_pay.org → consumerscada suscriptor, un consumidor de tu organizaciónVer ejemplo

Compras / Cuentas por pagar

Piloto automático fiscalEmitir el documento fiscal de cada venta con codespar_invoicePara cada venta liquidada, el agente emite el documento fiscal con codespar_invoice: NF-e o NFS-e en Brasil por NFe.io (solo en proyectos live), CFDI en México por FacturAPI, Factura en Argentina por AFIP. Lee el estado del documento y lo corrige con action=status y action=amend. Validar antes el ID fiscal del comprador y reintentar un rechazo de la SEFAZ no se hacen por ti.NF-e · CFDI · Facturaemitido por venta con codespar_invoiceVer ejemplo Puente con el ERPUna propuesta: escribir cada evento de dinero en tu ERP desde los registros de CodeSparUna propuesta conceptual. CodeSpar no escribe en ERPs: Omie y Tiny no son conectores a los que enrute, y Bling se enruta solo para emitir NFS-e. Lo que existe para construir encima: el estado de cada pago por su id y el extracto de la billetera. Escribir el asiento en el ERP correcto por país y entidad es tu integración.ERPtu integración, desde los registros de CodeSparVer ejemplo Agente de compras en tienda onlineCompras en las tiendas que admite codespar_shop, pagadas bajo un mandatoEl agente busca en el catálogo en vivo de una tienda que admite codespar_shop (Cobasi, Animale y Lojas Pompeia en VTEX; Mercado Livre con la sesión conectada del comprador), inicia el checkout real de la tienda y paga el Pix que la tienda genera desde la billetera del consumidor, dentro del mandato. Solo esas tiendas: no es un catálogo de tus proveedores.Pixel Pix de la propia tienda, pagado dentro del mandatoVer ejemplo

Nómina + payouts

Agente de nómina de contratistasUna transferencia Pix por contratista, desde tu lista aprobadaEl agente paga a cada contratista de tu lista aprobada por Pix con codespar_pay, una transferencia por beneficiario, con una clave de idempotencia para que un reintento nunca pague dos veces. Armar la lista, revisar a cada beneficiario y cerrar la corrida en tu ERP siguen en tus sistemas.1 Pixpor contratista de la lista aprobadaVer ejemplo

Tesorería

Agente de tesoreríaUna propuesta para mantener líquido el float de pagos, sobre los saldos de la billeteraUna propuesta conceptual. La billetera de CodeSpar guarda un saldo por moneda y se fondea por Pix; el agente lee los saldos y el extracto con codespar_wallet. Mantener un piso y mover saldo entre BRL y USDC no son funciones del producto: en esta propuesta son tu política, en tu código.BRL · USDCsaldo por moneda, leído con codespar_walletVer ejemplo Agente de recarga de la billeteraFondear la billetera con un Pix dinámico cuando tu piso lo pidaEl agente lee el saldo en BRL de la billetera con codespar_wallet y, cuando está por debajo del piso que fija tu código, genera un cobro Pix dinámico para fondearla. Quien controla la fuente de fondos paga ese Pix; hasta entonces no se fondea nada. El piso y la decisión son de tu agente; CodeSpar no vigila el saldo.Pixun cobro dinámico para fondear la billeteraVer ejemplo Gasto máquina a máquina (x402)APIs pagadas por llamada en USDC, bajo un mandatoUna API con precio x402 responde 402 con su precio en USDC. El agente paga esa llamada por la ruta REST de gasto del mandato: dentro del tope por llamada y del tope mensual se paga y deja un recibo firmado; por encima de cualquiera de los dos se rechaza y no se paga nada.x402por llamada, dentro de los topes del mandatoVer ejemplo Tarjeta gobernada del agenteUna tarjeta vinculada al mandato del agente, con un autorizador que revisa cada intentoCodeSpar emite tarjetas por Pomelo con codespar_issue, y un autorizador evalúa cada intento de cobro que envía el emisor contra el mandato firmado del agente: vigencia, moneda, tope por transacción, tope total y comercios permitidos. Tiene dos modos: observe registra la decisión y responde aprobado; enforce hace que la decisión sea vinculante.5verificaciones en cada intento de cobroVer ejemplo

Cross-border

Orquestador de payouts transfronterizosPix en Brasil; en el exterior, USDC por el offramp de UnblockPayEl agente paga a vendedores en Brasil por Pix con codespar_pay. En el exterior, codespar_crypto_pay envía USDC por UnblockPay, que paga la cuenta del destinatario en BRL, USD, EUR o MXN. Elegir el riel más barato por destino con tipo de cambio en vivo es una propuesta, no una función del producto.Pix · USDCBrasil por Pix; el exterior por el offramp en USDCVer ejemplo

¿Tu idea no está acá?Probablemente está a unos pocos servers de distancia.

Cada caso de uso de arriba es una composición corta de las mismas primitivas — sesiones, mandatos, ruteo, auditoría. Abrí el sandbox y probá el tuyo en diez minutos.

Abrir el Sandbox →Ver la documentación ↗