Skip to main content
Todos os casos de uso
Compras / Automação de lojaOperations

O agente compra na loja real. Sem API, sem punch-out, sem projeto.

Fita adesiva, caixa de papelão, luva — os insumos recorrentes e de baixo valor que nunca ganharam uma integração de compras. O agente conduz uma sessão de navegador hospedada pela loja VTEX real do fornecedor: busca no catálogo, monta o carrinho e faz o checkout exatamente como um comprador humano faria. Cada compra roda dentro de um mandato de gasto assinado com teto próprio, e fecha com um recibo selado — sem API do fornecedor, sem catálogo punch-out, sem projeto de integração.

AntesReabastecimento manual no site do fornecedor, todo ciclo
DepoisAgente com mandato compra o mesmo carrinho, no prazo, selado
0
integrações de API necessárias
Teste no Sandbox
VTEX
Provado em produção
Uma compra real já rodou de ponta a ponta em uma loja VTEX ativa
0
Integração com a loja
Sem API, sem catálogo punch-out, sem projeto de fornecedor para comprar no site real
Signed mandate
Gasto limitado
Todo checkout roda dentro do mesmo mandato que governa qualquer outro gasto do agente
Sealed receipt
Do carrinho ao pagamento
Busca, carrinho e checkout amarrados em um único registro de auditoria
O que a operação vê

O agente compra na loja real. O mandato nunca sai do checkout.

Um ciclo de reabastecimento, de ponta a ponta: o agente busca na loja VTEX real do fornecedor, adiciona ao carrinho os mesmos SKUs do último pedido aprovado e faz o checkout — sem chamada de API, sem feed de catálogo, só a loja como ela existe hoje. O Pix que a loja gera no checkout é pago a partir da carteira governada, limitado pelo mandato de compras assinado, e toda a sessão fecha em um único recibo selado.

  • Uma sessão de navegador hospedada conduz busca, carrinho e checkout na loja real — sem integração do lado do fornecedor
  • O Pix da própria loja é gerado no checkout e pago a partir da carteira governada, dentro do teto do mandato
  • Carrinho, checkout e pagamento selam em um único recibo que o auditor pode reproduzir

Reabastecer fita adesiva e caixas quando o estoque cair abaixo de duas semanas de cobertura.

Fita e caixas pequenas estão abaixo do limite — abrindo a loja da EmbalaSul para remontar o carrinho do último ciclo dentro do mandato de suprimentos de julho.

Compra em loja online · suprimentos recorrentes
PO-4417 · EmbalaSul (VTEX)
Comprado · selado
LojaVTEX storefront · embalasul.com.br
ItensFita 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 · seladorcp_shop4417
A dor

A conversa é a parte fácil.

O que a operação realmente reabastece — embalagem, material de escritório, peças pequenas de manutenção — nunca ganha uma API. Todo ciclo é uma pessoa abrindo o mesmo site, buscando os mesmos SKUs de memória, remontando o mesmo carrinho e pagando com um cartão compartilhado que ninguém acompanha. É gasto pequeno demais para um projeto de integração e recorrente demais para continuar fazendo na mão.

Abrir o site do fornecedor e remontar o mesmo carrinho de memória, a cada ciclo de reposição

O agente conduz a loja real e remonta o último carrinho aprovado automaticamente

Esperar o time de desenvolvimento do fornecedor entregar uma API ou catálogo punch-out antes de automatizar qualquer coisa

Uma sessão de navegador hospedada compra na loja exatamente como ela existe hoje — sem projeto do fornecedor

Entregar um cartão compartilhado para quem reabastece, sem teto de gasto e sem dono

Todo checkout roda dentro de um mandato assinado com teto próprio, sem credencial compartilhada

Procurar o e-mail de confirmação da loja para provar o que foi comprado

Um recibo selado amarra o carrinho, o checkout e o mandato para o registro

Como o agente faz isso

O Shop conduz a loja que você já tem.

O codespar_shop age como o comprador: busca na loja real do fornecedor, monta o carrinho e inicia o checkout da própria loja — uma sessão de navegador hospedada no lugar do comprador humano. O codespar_pay paga o Pix gerado pela loja a partir da carteira governada, limitado pelo mandato de compras assinado. O codespar_ledger sela carrinho, checkout e pagamento em um único registro de auditoria. Sem API, sem catálogo punch-out — a mesma loja, comprada do mesmo jeito que uma pessoa compraria.

01
Busca
codespar_shop

Catálogo buscado · mesmos SKUs

Loja VTEX
02
Carrinho
codespar_shop

Checkout no navegador iniciado

Navegador hospedado
03
Checkout
codespar_shop

Pix da loja gerado

Checkout VTEX
04
Pagamento
codespar_pay

Pix pago · mandato

Trilho Pix
05
Conciliação
codespar_ledger

Carrinho + recibo selados

Ledger de auditoria
Arquitetura

O agente roda uma sessão de navegador hospedada contra a loja VTEX real do fornecedor — o mesmo site que um comprador humano usaria, sem API ou feed de catálogo por trás. O codespar_shop conduz busca, carrinho e checkout; a loja gera seu próprio Pix no final, que o codespar_pay paga a partir da carteira governada dentro do mandato de compras do tenant. O carrinho, a confirmação de checkout e o pagamento da sessão selam em um único registro de auditoria quando o pedido fecha.

Em código

Algumas linhas. O loop inteiro.

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 · seladoreceipt · rcp_agent-
Ferramentas em destaque
codespar_shop

Conduz uma sessão de navegador hospedada pela loja real — busca, carrinho, checkout — sem precisar de API do lado da loja.

codespar_pay

Paga o Pix gerado pela loja a partir da carteira governada, dentro do mandato de compras assinado.

codespar_ledger

Sela carrinho, checkout e pagamento em um único registro de auditoria.

Ver a referência das meta-tools
Servidores MCP conectados

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 compras em loja online — CodeSpar | CodeSpar