Skip to main content
POST
Ejecutar enriquecimiento marketplace sin entidad
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

Query

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)

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

Respuesta 200 (éxito de enriquecimiento)

Cuando enrichmentSuccess es true, el cuerpo incluye entre otros:
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