Skip to main content
POST
/
integration-execution
/
execute-without-entity
Ejecutar enriquecimiento marketplace sin entidad
curl --request POST \
  --url http://api.gu1.ai/integration-execution/execute-without-entity \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "integrationCode": "<string>",
  "country": "<string>",
  "type": "<string>",
  "taxId": "<string>",
  "name": "<string>",
  "parameters": {}
}
'
{
  "result": {}
}
Ruta bajo /integration-execution. Usa los mismos códigos de integración que el Marketplace (véase Códigos compartidos y las tablas por tipo en la misma sección).
Requiere permiso para ejecutar enriquecimientos (misma familia que POST /integration-execution/marketplace/enrichment).
Las ejecuciones headless no crean ni actualizan entities, normalized_enrichment ni auditorías ligadas a entidad. Solo escriben auditoría append-only (headless_enrichment_execution_audit) y, si aplica, caché (headless_enrichment_cache) en éxitos.

​
Resumen

Sirve para lanzar un enriquecimiento con taxId y/o nombre, país y tipo (person / company) sin registrar antes una Persona o Empresa en Gu1. Endpoints relacionados (solo lectura): Listar ejecuciones headless y Detalle por id.

​
URL

POST https://api.gu1.ai/integration-execution/execute-without-entity

​
Query

​
cached
boolean
default:"false"
Si es true o 1, solo devuelve un payload cacheado de éxito previo (misma org, integración, país, tipo, tax/nombre, hash de parámetros). Sin llamada al proveedor ni consumo de tokens. Sin caché → 404 (CACHE_MISS).

​
Cuerpo (JSON)

​
integrationCode
string
required
Código de integración del Marketplace.
​
country
string
required
País ISO-3166-1 alpha-2 (dos letras; se guarda en mayúsculas).
​
type
string
required
person o company.
​
taxId
string
Opcional. Al menos uno de taxId o name (tras trim) es obligatorio.
​
name
string
Opcional. Al menos uno de taxId o name.
​
parameters
object
Opcional; por defecto {}.

​
Respuesta 200 (éxito de enriquecimiento)

Cuando enrichmentSuccess es true, el cuerpo incluye entre otros:
​
result
object
Objeto con raw y mapped: cada uno es un objeto indexado por código de integración (rama cruda del proveedor y campos normalizados; misma familia que enriquecimientos marketplace sobre entidad).
También: success, cached, integrationCode, country, type, enrichmentSuccess, errors, totalCostCents, executionTimeMs, probeEntityId, billing (en HTTP solo tokensSpent y balanceRemainingCents; el coste en centavos del intento va en totalCostCents y en auditoría interna, no dentro de billing).

​
Errores habituales

400 si no hay proveedor para el contexto; 422 fallo de proveedor o normalización; 403 integración deshabilitada; 404 CACHE_MISS con cached=true; 402 saldo insuficiente; validación Zod en 4xx.

​
Ejemplo

curl -sS -X POST 'https://api.gu1.ai/integration-execution/execute-without-entity' \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "integrationCode": "br_bdc_basic_data_enrichment",
    "country": "BR",
    "type": "person",
    "taxId": "12345678909",
    "parameters": {}
  }'