Appearance
InformeLegal · Personas
Consulta en vivo por CUIT al proveedor InformeLegal. A diferencia de las demás fuentes, su payload es un passthrough crudo: la respuesta del proveedor se adjunta tal cual, sin transformar.
| Slug | informelegal |
| Modo | LIVE (consulta al proveedor, con caché corta) |
| Clase de sujeto | Derivada del CUIT |
| Claves aceptadas | cuit |
| Claves obligatorias | cuit |
| Payload | informelegal.persona.v1 (forma libre) |
| Scopes | sources:read + provider:informelegal |
| Endpoint | POST /api/v1/sources/informelegal/query |
Consulta
bash
curl -X POST https://tu-host/api/v1/sources/informelegal/query \
-H "Authorization: Bearer ilk_live_xxx" \
-H "Content-Type: application/json" \
-d '{ "keys": { "cuit": "20111111112" } }'Sin cuit la consulta no puede ejecutarse y la respuesta es 400: el proveedor sólo resuelve por identificador fiscal.
Payload informelegal.persona.v1
Contrato abierto
Este es el único payload de la API cuya forma no está versionada por nuestro contrato. El data es exactamente el cuerpo que devuelve el proveedor, así que puede cambiar sin que cambie nuestra version.
Tratalo como un objeto abierto: leé los campos que necesitás de forma defensiva y no asumas que la estructura es estable. Si necesitás un contrato estable, usá las otras fuentes o los payloads de Person Search.
json
{
"schemaRef": "informelegal.persona.v1",
"version": "1.0.0",
"dedupeKey": "informelegal:20111111112",
"data": { }
}El envelope (schemaRef, version, dedupeKey) sí es nuestro y sí es estable; lo abierto es el contenido de data.
Comportamiento en vivo
- Sin datos ≠ error. Un CUIT sin información en el proveedor devuelve
200consubjects: []: no tener datos es un resultado válido. - Caída o timeout del proveedor. La respuesta llega con
partial: trueen lugar de caerse. - Caché corta. Las consultas repetidas del mismo CUIT en una ventana breve pueden servirse de caché. Eso reduce el costo técnico, no el precio comercial.
En Person Search
La misma dimensión llega como enriquecimiento del modelo PERSON_ADVANCED, que también exige CUIT entre las claves. Consultá la fuente directamente cuando sólo te interesa este dato y no necesitás el resto de la resolución.
Ver también: Catálogo de fuentes · Payloads por dominio.