Actualizar entidad (refresh)
Referencia API
Actualizar entidad (refresh)
Re-ejecutar enrichments en una entidad existente con recursión opcional de socios y motor de reglas — scope unificado y flags preserve para nombre y ficha.
POST
Actualizar entidad (refresh)
Descripción
Re-ejecuta enrichments del marketplace para una persona o empresa existente, opcionalmente:- Actualiza el nombre y/o
entityData(solo si lo indicás con los nuevos flags) - Crea o re-enriquece socios (empresas,
depth> 0) - Ejecuta el motor de reglas al finalizar
Retrocompatibilidad: Si omitís
refreshScope, preserveName y preserveEntityData, el comportamiento es el de siempre: la selección de proveedores sigue autoExecuteIntegrations y el nombre se sincroniza desde fullName normalizado cuando cambia. entityData no se modifica salvo refreshScope: "basic_data" con preserveEntityData.Endpoint
Autenticación
Requiere permiso para ejecutar enrichments (igual quePOST /entities/{entityId}/enrich).
Parámetros de ruta
string
required
UUID de la entidad a actualizar.
Cuerpo
boolean
default:"true"
Si es
true, omite caché y vuelve a llamar a los proveedores.boolean
default:"false"
Si es
true, no ejecuta reglas después del enrichment.integer
default:"1"
Profundidad de socios (0–5). Ignorado con
refreshScope: "basic_data" (siempre 0).object
Selección legacy de proveedores (cuando
refreshScope se omite). Misma forma que POST /entities/automatic.Pipeline de socios (empresas,
depth > 0). Misma forma que creación automática.string
Scope unificado opcional. Si está presente, reemplaza
autoExecuteIntegrations en la entidad raíz:array
Obligatorio cuando
refreshScope es selected.boolean
true: conservar el nombre actual.false: sincronizar desde mapeo (basic_data) ofullNamenormalizado.- Omitido (legacy): sincronizar nombre si
fullNamecambió (comportamiento anterior).
boolean
Solo con
refreshScope: "basic_data" y enrichment exitoso:- Omitido: no tocar
entityData. true: completar solo campos vacíos (gap-fill).false: reemplazarentityDatadesde datos básicos.
all_active, selected o bodies legacy sin basic_data.Ejemplos
Refresh legacy (sin cambios)
Solo datos básicos (seguro)
Respuesta
Incluyedata.entity, data.enrichmentResult, contadores de socios y errors. Con skipRulesEngine: false, también rulesExecutionSummary en la raíz (igual que Analyze).
Eventos Socket.IO
entity:refresh-started, entity:refreshed, entity:refresh-failed.
Endpoints relacionados
Analyze
Motor de reglas (enrichment opcional).
Materializar relaciones
Cadena de socios desde normalized.