> ## 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.

# Executar enriquecimento marketplace sem entidade

> Rodar um enriquecimento a partir de taxId e/ou nome sem persistir entidade; modo opcional só cache. Consulte o esquema do request, códigos de resposta.

<Note>
  Rota sob **`/integration-execution`**. Usa os mesmos **códigos de integração** do Marketplace (veja [Códigos de provedores](/pt/api-reference/integrations/provider-codes)).\
  Exige permissão para **executar enriquecimentos** (mesma família que `POST /integration-execution/marketplace/enrichment`).
</Note>

<Warning>
  Execuções headless **não** criam nem atualizam **`entities`**, **`normalized_enrichment`** nem auditoria vinculada a entidade. Apenas gravam **auditoria append-only** (`headless_enrichment_execution_audit`) e, quando aplicável, **cache** (`headless_enrichment_cache`) em sucessos.
</Warning>

## Visão geral

Use para rodar **um** enriquecimento com **taxId e/ou nome**, **país** e **tipo** (`person` / `company`) **sem** cadastrar antes uma pessoa ou empresa na Gu1.

Endpoints relacionados (somente leitura): [Listar execuções headless](/pt/api-reference/integrations/headless-executions) e [Detalhe por id](/pt/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">
  Se `true` ou `1`, retorna apenas payload em cache de sucesso anterior (mesma org, integração, país, tipo, tax/nome, hash de parâmetros). **Sem chamada ao provedor** nem tokens. Sem cache → **404** (`CACHE_MISS`).
</ParamField>

## Corpo (JSON)

<ParamField body="integrationCode" type="string" required>Código de integração do Marketplace.</ParamField>
<ParamField body="country" type="string" required>País ISO-3166-1 alpha-2.</ParamField>
<ParamField body="type" type="string" required>`person` ou `company`.</ParamField>
<ParamField body="taxId" type="string">Opcional. Exige pelo menos **`taxId`** ou **`name`**.</ParamField>
<ParamField body="name" type="string">Opcional.</ParamField>
<ParamField body="parameters" type="object">Opcional; padrão `{}`.</ParamField>

## Resposta 200 (enriquecimento com sucesso)

Quando `enrichmentSuccess` é `true`, o corpo inclui entre outros:

<ResponseField name="result" type="object">
  Objeto com **`raw`** e **`mapped`**: cada um é um objeto indexado pelo código de integração (mesma família que enriquecimentos marketplace em entidade).
</ResponseField>

Também: `success`, `cached`, `integrationCode`, `country`, `type`, `enrichmentSuccess`, `errors`, `totalCostCents`, `executionTimeMs`, `probeEntityId`, `billing` (na resposta HTTP só `tokensSpent` e `balanceRemainingCents`; o custo em centavos do intento está em `totalCostCents` e na auditoria, não dentro de `billing`).

## Erros comuns

**400** sem provedor para o contexto; **422** falha do provedor ou normalização; **403** integração desabilitada; **404** `CACHE_MISS` com `cached=true`; **402** saldo insuficiente.

## Exemplo

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