Skip to main content
Todos los casos de uso
Compras / Automatización de tiendaOperations

El agente compra en la tienda real. Sin API, sin punch-out, sin proyecto.

Cinta adhesiva, cajas de cartón, guantes — los insumos recurrentes y de bajo valor que nunca tuvieron una integración de compras. El agente ejecuta una sesión de navegador alojada a través de la tienda VTEX real del proveedor: busca en el catálogo, arma el carrito y hace el checkout tal como lo haría un comprador humano. Cada compra corre dentro de un mandato de gasto firmado con su propio tope, y cierra con un recibo sellado — sin API del proveedor, sin catálogo punch-out, sin proyecto de integración.

AntesReabastecimiento manual en el sitio del proveedor, cada ciclo
DespuésAgente con mandato compra el mismo carrito, a tiempo, sellado
0
integraciones de API necesarias
Pruébalo en el Sandbox
VTEX
Probado en producción
Una compra real ya se ejecutó de punta a punta en una tienda VTEX activa
0
Integración con la tienda
Sin API, sin catálogo punch-out, sin proyecto de proveedor para comprar en el sitio real
Signed mandate
Gasto limitado
Cada checkout corre dentro del mismo mandato que gobierna cualquier otro gasto del agente
Sealed receipt
Del carrito al pago
Búsqueda, carrito y checkout unidos en un solo registro de auditoría
Lo que ve el equipo de operaciones

El agente compra en la tienda real. El mandato nunca sale del checkout.

Un ciclo de reabastecimiento, de punta a punta: el agente busca en la tienda VTEX real del proveedor, agrega al carrito los mismos SKU del último pedido aprobado y hace el checkout — sin llamada a una API, sin feed de catálogo, solo la tienda tal como existe hoy. El Pix que genera la tienda al momento del checkout se paga desde la billetera gobernada, limitado por el mandato de compras firmado, y toda la sesión cierra en un solo recibo sellado.

  • Una sesión de navegador alojada conduce la búsqueda, el carrito y el checkout en la tienda real — sin integración del lado del proveedor
  • El propio Pix de la tienda se genera en el checkout y se paga desde la billetera gobernada, dentro del tope del mandato
  • Carrito, checkout y pago se sellan en un solo recibo que el auditor puede reproducir

Reabastecer cinta adhesiva y cajas cuando el stock caiga por debajo de dos semanas de cobertura.

La cinta y las cajas pequeñas están por debajo del umbral — abriendo la tienda de EmbalaSul para rearmar el carrito del último ciclo dentro del mandato de insumos de julio.

Compra en tienda online · insumos recurrentes
PO-4417 · EmbalaSul (VTEX)
Comprado · sellado
TiendaVTEX storefront · embalasul.com.br
ArtículosFita adesiva 45mm ×24 · Caixa nº3 ×100
TotalR$ 1.180,00
Mandatocm_supplies…3K9 · cap R$5.000/mês
PixMinted at checkout · paid
cart-po4417.jsonreceipt-po4417.json
comprado · selladorcp_shop4417
El problema

La conversación es la parte fácil.

Lo que operaciones realmente reabastece — empaques, insumos de oficina, piezas pequeñas de mantenimiento — nunca consigue una API. Cada ciclo es una persona abriendo el mismo sitio, buscando los mismos SKU de memoria, rearmando el mismo carrito y pagando con una tarjeta compartida que nadie controla. Es un gasto demasiado pequeño para un proyecto de integración y demasiado recurrente para seguir haciéndolo a mano.

Abrir el sitio del proveedor y rearmar el mismo carrito de memoria, en cada ciclo de reposición

El agente conduce la tienda real y rearma automáticamente el último carrito aprobado

Esperar a que el equipo de desarrollo del proveedor entregue una API o catálogo punch-out antes de automatizar algo

Una sesión de navegador alojada compra en la tienda tal como existe hoy — sin proyecto del proveedor

Entregar una tarjeta compartida a quien reabastece, sin tope de gasto ni responsable

Cada checkout corre dentro de un mandato firmado con su propio tope, sin credenciales compartidas

Buscar el correo de confirmación de la tienda para probar qué se compró realmente

Un recibo sellado une el carrito, el checkout y el mandato para el registro

Cómo lo hace el agente

Shop conduce la tienda que ya tienes.

codespar_shop actúa como el comprador: busca en la tienda real del proveedor, arma el carrito e inicia el checkout de la propia tienda — una sesión de navegador alojada en lugar del comprador humano. codespar_pay paga el Pix generado por la tienda desde la billetera gobernada, limitado por el mandato de compras firmado. codespar_ledger sella el carrito, el checkout y el pago en un solo registro de auditoría. Sin API, sin catálogo punch-out: la misma tienda, comprada de la misma forma en que lo haría una persona.

01
Búsqueda
codespar_shop

Catálogo consultado · mismos SKU

Tienda VTEX
02
Carrito
codespar_shop

Checkout en el navegador iniciado

Navegador alojado
03
Checkout
codespar_shop

Pix de la tienda generado

Checkout VTEX
04
Pago
codespar_pay

Pix pagado · mandato

Riel Pix
05
Conciliación
codespar_ledger

Carrito + recibo sellados

Ledger de auditoría
Arquitectura

El agente ejecuta una sesión de navegador alojada contra la tienda VTEX real del proveedor — el mismo sitio que usaría un comprador humano, sin API ni feed de catálogo detrás. codespar_shop conduce la búsqueda, el carrito y el checkout; la tienda genera su propio Pix al final, que codespar_pay paga desde la billetera gobernada dentro del mandato de compras del tenant. El carrito, la confirmación de checkout y el pago de la sesión se sellan en un solo registro de auditoría cuando el pedido cierra.

En código

Unas pocas líneas. Todo el loop.

storefront-reorder.ts
const session = await codespar.sessions.create();

const found = await session.execute("codespar_shop", {
  action: "search",
  merchant: "embalasul",
  query: "fita adesiva mm",
});

// START the store's real checkout — returns immediately, do not block
const started = await session.execute("codespar_shop", {
  action: "checkout",
  merchant: "embalasul",
  items: lastApprovedCart.map((item) => ({
    variant_id: item.skuId,
    quantity: item.quantity,
  })),
});

// poll until the store's payable Pix is ready
let status;
do {
  await sleep(15_000);
  status = await session.execute("codespar_shop", {
    action: "checkout_status",
    checkout_session_id: started.checkout_session_id,
  });
} while (status.status === "in_progress");

// the store's own Pix, settled inside the supplies mandate
await session.execute("codespar_pay", {
  method: "pix",
  code: status.pix_copia_e_cola,
  amount: status.total,
  mandate: "cm_supplies",
});
0 · selladoreceipt · rcp_agent-
Herramientas destacadas
codespar_shop

Conduce una sesión de navegador alojada por la tienda real — búsqueda, carrito, checkout — sin necesitar API del lado de la tienda.

codespar_pay

Paga el Pix generado por la tienda desde la billetera gobernada, dentro del mandato de compras firmado.

codespar_ledger

Sella el carrito, el checkout y el pago en un solo registro de auditoría.

Ver la referencia de meta-tools
Servidores MCP conectados

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 compras en tienda online — CodeSpar | CodeSpar