condra
GitHub →
Protocolo abierto · v0.2

ACE — Agentic Commerce Exchange

El protocolo abierto para que cualquier agente de IA pueda descubrir y operar en tiendas de Latinoamérica.

Por qué ACE

Cada tienda de e-commerce tiene su propia API, sus propias rutas, sus propios formatos. Un agente de IA que quiere comprar en Tiendanube necesita aprender Tiendanube. Uno que quiera operar en VTEX necesita aprender VTEX. El resultado: los agentes no pueden comprar nada de forma genérica.

ACE resuelve eso con cuatro intents estándar: search, check_stock, buy, check_order. Un agente que habla ACE puede operar en cualquier tienda que lo implemente, sin configuración adicional. Es para el comercio lo que HTTP es para la web.

Los 4 intents

searchBuscar productos en lenguaje natural

Request

{
  "intent": "search",
  "session_id": "sess-abc",
  "query": {
    "text": "zapatillas negras talle 42",
    "limit": 5
  }
}

Response

{
  "status": "ok",
  "products": [
    {
      "id": "1234",
      "name": "Zapatilla Running Pro",
      "price": 38000,
      "currency": "ARS",
      "available": true,
      "variants": [...]
    }
  ]
}
check_stockVerificar disponibilidad de un producto/variante

Request

{
  "intent": "check_stock",
  "session_id": "sess-abc",
  "product_id": "1234",
  "variant_id": "5678"
}

Response

{
  "status": "ok",
  "available": true,
  "quantity": 12,
  "product_id": "1234",
  "variant_id": "5678"
}
buyCrear una orden de compra con link de pago

Request

{
  "intent": "buy",
  "session_id": "sess-abc",
  "product_id": "1234",
  "variant_id": "5678",
  "quantity": 1,
  "customer": {
    "email": "comprador@mail.com",
    "name": "María García"
  },
  "payment_method_id": "mercadopago"
}

Response

{
  "status": "ok",
  "order": {
    "order_id": "ord-xyz",
    "payment": {
      "payment_url": "https://www.mercadopago.com/...",
      "expires_at": "2026-06-19T12:00:00Z"
    }
  }
}
check_orderConsultar el estado de una orden creada

Request

{
  "intent": "check_order",
  "session_id": "sess-abc",
  "order_id": "ord-xyz"
}

Response

{
  "status": "ok",
  "order_status": "pending",
  "order_id": "ord-xyz",
  "payment_url": "https://www.mercadopago.com/..."
}

Adopción

Condra implementa ACE como adaptadores sobre las APIs nativas de cada plataforma. Una tienda conectada a Condra habla ACE automáticamente, sin trabajo adicional del vendedor.

Tiendanube

Adaptador activo

MercadoShops

Adaptador activo

VTEX

En beta

El protocolo es abierto. Cualquier plataforma puede implementar un adaptador ACE y unirse al registry. La spec completa y los tipos están en GitHub.