Appearance
Payloads por dominio
Cada subject trae un arreglo de payloads. Un payload es el conocimiento propio de una fuente, sin deformar, identificado por schemaRef + version:
json
{
"schemaRef": "golden_record.person.v1",
"version": "1.0.0",
"data": { },
"dedupeKey": "golden_record:ent_..."
}Los payloads que recibís ya están filtrados por tus scopes: solo aparecen las dimensiones que tu API Key está autorizada a ver. La forma exacta de cada data está en la referencia OpenAPI; acá va el resumen.
Un payload, dos caminos
El payload de una fuente es idéntico venga por Person Search o por la consulta directa a esa fuente. Lo que cambia es cuántos payloads trae cada sujeto, no su forma.
golden_record.person.v1
Identidad canónica consolidada del sujeto: entity (publicId, clase, nombre canónico, estado, confianza), names[], identifiers[], flags[], y opcionalmente fiscalStatus, addresses[], events[], relationships[].
Es la base de todo resultado de Person Search. No se consulta como fuente puntual: es el resultado de consolidar las demás.
igj.company.v1
Lo que el registro societario sabe de una sociedad: numeroCorrelativo, razonSocial, cuit, tipoSocietario (+ descripción) y si fue dada de baja.
arca.padron.v1
Padrón fiscal: cuit, denominacion, dniDerivado y un bloque fiscal (ganancias, IVA, monotributo, etc.). Requiere el scope provider:arca.
bcra.credit.v1
Información crediticia (Central de Deudores), presente en PERSON_ADVANCED: identificacion, denominacion, situacionActualPeor (señal 1..5 del período más reciente), y el detalle de deudas, historicas y chequesRechazados.
informelegal.persona.v1
Enriquecimiento provisto por un tercero comercial, adjuntado crudo (passthrough): la forma de data la define esa fuente y no está versionada por este contrato, así que tratala como un objeto abierto.
Llega por PERSON_ADVANCED y por la consulta directa a la fuente; en ambos casos requiere CUIT.
Deduplicación
El campo dedupeKey (p.ej. arca:20111111112, bcra:20111111112) identifica el mismo conocimiento de forma estable, para que una fuente no aparezca dos veces.