> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ejecutar enriquecimiento marketplace sin entidad

> Lanzar un enriquecimiento desde taxId y/o nombre sin persistir entidad; modo opcional solo caché. Consulta el esquema del request, códigos de respuesta.

<Note>
  Ruta bajo **`/integration-execution`**. Usa los mismos **códigos de integración** que el Marketplace (véase [Códigos compartidos](/es/api-reference/integrations/provider-codes) y las tablas por tipo en la misma sección).\
  Requiere permiso para **ejecutar enriquecimientos** (misma familia que `POST /integration-execution/marketplace/enrichment`).
</Note>

<Warning>
  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.
</Warning>

## 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](/es/api-reference/integrations/headless-executions) y [Detalle por id](/es/api-reference/integrations/headless-executions-item).

## URL

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

## Query

<ParamField query="cached" type="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`).
</ParamField>

## Cuerpo (JSON)

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

## Respuesta 200 (éxito de enriquecimiento)

Cuando `enrichmentSuccess` es `true`, el cuerpo incluye entre otros:

<ResponseField name="result" type="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).
</ResponseField>

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

```bash theme={null}
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": {}
  }'
```