Skip to main content
Todos los casos de uso
Compras / Cuentas por pagarOperations

Pagos de boletos a proveedores bajo tus reglas

El agente comprador paga cada boleto de proveedor por su línea digitable, dentro de un mandato de presupuesto firmado. Sobre el tope por transacción, el boleto espera la aprobación de una persona en el Dashboard; sobre el tope mensual, se rechaza. Cada boleto pagado bajo el mandato deja un recibo firmado, y una clave de idempotencia evita pagar dos veces el mismo boleto. Validar al proveedor, hacer el match con el ERP y adjuntar la NF-e son tu integración.

AntesBandeja de boletos → cadena manual de aprobación
DespuésAgente con mandato → pagado, con recibo firmado
Boleto
pagado bajo el mandato
Pruébalo en el Sandbox
Boleto
Boletos existentes
Pagados por la línea digitable, con clave de idempotencia obligatoria
idempotency_key
Sin doble pago
Reintentar con la misma clave de idempotencia devuelve el primer resultado
Mandate
Mandato firmado
Sobre el tope por transacción el boleto espera aprobación; sobre el tope mensual, se rechaza
rcpt
Recibo firmado
Cada boleto pagado bajo el mandato deja un recibo firmado
Ejemplo ilustrativo · datos de demostración

Cada pago responde quién, por qué y bajo qué presupuesto.

Una factura de proveedor, de punta a punta: el agente paga el boleto por su línea digitable bajo el mandato de operaciones y el pago deja un recibo firmado con el mandato que lo autorizó. El match con el ERP y la NF-e quedan en tu integración.

  • El pago se verifica contra el mandato antes de enviarse
  • Sobre el tope por transacción, el boleto espera aprobación en el Dashboard
  • El recibo firmado ata el pago al mandato para el auditor

Paga todo lo que vence esta semana con el presupuesto de operaciones.

Siete boletos por vencer: pagando cada uno dentro del mandato de operaciones; lo que pase del tope por transacción espera aprobación.

Factura de proveedor · cuentas por pagar
INV-2093 · Metalúrgica Prisma
Pagado · ejemplo
ProveedorMetalúrgica Prisma
MontoR$ 12.480,00
Boleto34191.79001 01043.510047 …
Mandatomnd_demo · R$ 20.000/mês
Reciborcpt_demo
receipt-inv2093.json
✓ pagado · recibo firmado · ejemplorcpt_demo
El problema

La conversación es la parte fácil.

Cuentas por pagar es una cadena de aprobación vestida de planilla. Las facturas llegan por correo, alguien las retipea en el ERP, otro aprueba por WhatsApp, y finanzas descubre los duplicados al cierre del mes. Es lento donde debería ser aburrido, y ciego exactamente donde debería ser auditable.

Retipear cada boleto recibido por correo en el ERP y el portal del banco

El agente paga el boleto por su línea digitable; el match con el ERP es tu integración

Aprobar pagos por WhatsApp, sin tope de gasto

Un mandato firmado limita el gasto: sobre el tope por transacción espera aprobación, sobre el mensual se rechaza

Pagar en lotes: temprano y pierdes float, tarde y pagas multas

Cada boleto se paga por separado, con su clave de idempotencia

Conciliar extracto y ERP a mano al cierre del mes

Cada boleto pagado bajo el mandato deja un recibo firmado; conciliar con el ERP es tu integración

Cómo lo hace el agente

El agente comprador, gobernado de punta a punta.

codespar_pay paga un boleto existente por su línea digitable bajo el mandato de operaciones: un presupuesto firmado, no un login bancario compartido. Sobre el tope por transacción, el boleto espera la decisión de un administrador en el Dashboard; sobre el tope mensual, se rechaza. Cada boleto pagado deja un recibo firmado. Validar al proveedor y conciliar con el ERP quedan en tu integración.

01
Ingesta
Correo / ERP

Factura y boleto recibidos

02
Mandato
CodeSpar

Tope por transacción y mensual

03
Aprobación
Dashboard

Sobre el tope por transacción

04
Pago
codespar_pay

Boleto · mandato

Riel de boleto
05
Recibo
Registro de auditoría

Recibo firmado del pago

Arquitectura

Las facturas entran por correo o por tu ERP. El agente paga el boleto por su línea digitable bajo el mandato de operaciones del consumidor: el pago se verifica contra el tope por transacción y el tope mensual antes de enviarse; sobre el primero, el boleto espera aprobación, y sobre el segundo, se rechaza. Cada boleto pagado bajo el mandato deja un recibo firmado. El match con el ERP y la NF-e son tu integración.

En código

El código, y lo que supone.

accounts-payable.ts
// Prerequisites: CODESPAR_API_KEY set to a test key (csk_test_…) and a mandate
// the consumer signed on the consent page (per-transaction cap and monthly cap).
import { CodeSpar, isApprovalRequired } from "@codespar/sdk";

const session = await new CodeSpar().create("user_0000", { preset: "brazilian" });

// the agent pays the supplier's boleto by its digitable line
const run = await session.send("pay Metalúrgica Prisma's boleto for INV-2093, R$ 12,480.00");
const pay = run.tool_calls.find((c) => c.tool_name === "codespar_pay");

// under the per-transaction cap: paid · above it: waits for approval in the Dashboard
if (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);

Ejemplo con el SDK publicado (@codespar/sdk 0.16.11). Los requisitos están en los comentarios. Compilar no prueba la integración: ejecútalo primero en modo de prueba.

Herramientas destacadas
codespar_pay

Paga un boleto existente por su línea digitable, dentro del mandato de operaciones firmado.

Approvals

Sobre el tope por transacción, el boleto espera a un administrador de la organización en el Dashboard.

Signed receipt

Cada boleto pagado bajo el mandato deja un recibo firmado.

Ver la referencia de meta-tools

Empieza con una clave de prueba.

Las claves de prueba son gratuitas. Abre el sandbox, conecta los proveedores que usa tu proyecto y mira qué herramientas puede llamar antes de construir.

Agente de cuentas por pagar — CodeSpar | CodeSpar