Skip to main content
POST
Executar enriquecimento marketplace sem entidade
Rota sob /integration-execution. Usa os mesmos códigos de integração do Marketplace (veja Códigos de provedores).
Exige permissão para executar enriquecimentos (mesma família que POST /integration-execution/marketplace/enrichment).
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.

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 e Detalhe por id.

URL

Query

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

Corpo (JSON)

string
required
Código de integração do Marketplace.
string
required
País ISO-3166-1 alpha-2.
string
required
person ou company.
string
Opcional. Exige pelo menos taxId ou name.
string
Opcional.
object
Opcional; padrão {}.

Resposta 200 (enriquecimento com sucesso)

Quando enrichmentSuccess é true, o corpo inclui entre outros:
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).
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