Intelidata — Portal de operaciones

Cargando análisis…

Los tiempos son aproximados y corresponden a la etapa actual. No incluyen el tiempo que tardes en confirmar el presupuesto.

Actualizaciones recientes

Sociedades y trámites concretos que cambiaron durante los últimos 7 días.

últimos 8

Verificaciones

Trabajos asíncronos, sin mantener conexiones largas.

cola

Canales de entrega

Salud de endpoints registrados.

webhooks

Requiere atención

Monitores con fallos recientes.

operación

Sociedades en seguimiento

Intelidata revisa diariamente estas sociedades y conserva cada cambio registral.

0 sociedades

Sociedad	Folio	Situación	Estatus oficial	Última revisión	Acciones

Seguimientos externos

Casos ajenos a la cartera automática que la firma decidió observar.

0 resultados

Historial observado

Intelidata conserva lo que ha visto desde el primer baseline; no reconstruye estados anteriores.

Elija un seguimientoVerá su estado actual, completitud y cambios observados.

Propiedades en seguimiento

Fincas a nombre de sus sociedades y las que siga aparte. Clic en una finca abre su ficha.

0 fincas

Buscar en toda la base

Sociedades, fundaciones, personas y fichas.

Buscar encuentra coincidencias en nombres y directivos. «¿Nombre disponible?» revisa el nombre que quiere constituir contra colisiones exactas, fonéticas y por tipeo — con la grafía EXACTA registrada.

0 cambios

Auditorías de cartera

Qué está en cola, qué terminó y qué requiere criterio humano · lo accionable primero · se actualiza solo.

Sin auditorías todavíaSeleccione sociedades y cree una auditoría para ver aquí su progreso.

Correo de notificaciones

Quién recibe los cambios registrales de la cartera y los seguimientos por correo, y cómo: al instante, en un resumen diario o nada. Todo sigue visible en Actualizaciones.

0 correos

Al instante: un correo por cada cambio · Resumen diario: un solo correo al día, a la hora elegida (hora de Panamá) · No enviar: sin correos, el registro se conserva. Cada persona puede cambiar el modo de su propio correo; un administrador, el de cualquiera.

Probar la API · consulta de una sociedad

La misma llamada que hará su sistema, con la respuesta real. Cada envío cuenta como una consulta.

Solicitud

GET https://intelidata.net/api/v1/fichas?nombre=andres%20downing
Authorization: Bearer $INTELIDATA_API_KEY

Respuesta

Pulse «Enviar» para ver la respuesta.

Llaves de la organización

Prefijo, último uso, vencimiento, rotación y revocación.

0 llaves

Conecte su sistema

Son dos APIs que se usan en secuencia: con un nombre se obtienen las fichas y con la ficha se consulta la sociedad, revisada en ese momento en la fuente oficial.

Autenticación Bearer con una API key de la organización, creada arriba en Llaves de la organización.
La llave es secreta: va en su servidor, nunca en el navegador ni en repositorios.
Si ya tiene la ficha, vaya directo a la API 2.
Todo bajo https://intelidata.net/api/v1. Los errores llegan como {"error","code"}.

1 · Fichas por nombre

Con el nombre de una sociedad o de una persona devuelve las fichas que coinciden · responde de inmediato.

export INTELIDATA_API_KEY='PEGUE_LA_LLAVE_AQUI'

curl 'https://intelidata.net/api/v1/fichas?nombre=andres%20downing' \
  -H "Authorization: Bearer $INTELIDATA_API_KEY"

2 · Consulta por ficha

Revisa la sociedad en ese momento y devuelve su detalle · de 2 a 5 segundos.

curl 'https://intelidata.net/api/v1/consulta?ficha=155123&tipo=sociedad' \
  -H "Authorization: Bearer $INTELIDATA_API_KEY"

1 · Fichas por nombre

GET /fichas?nombre=…

nombre (obligatorio): cualquier nombre, mínimo 3 letras. Puede ser el de una sociedad o fundación, o el de una persona: director, dignatario, apoderado, agente residente o suscriptor. No distingue mayúsculas ni tildes.
estado (opcional): vigente, suspendida o disuelta.
Una entrada por sociedad o fundación, sin repetidas.
coincide_por: nombre_sociedad, persona o ambos. Si coincide por persona, personas dice quién y con qué cargo.
Sin coincidencias: 200 con total: 0.

Respuesta

Recortada.

200

{
  "nombre": "andres downing",
  "total": 2,
  "fichas": [
    {
      "ficha": 155123,
      "tipo": "sociedad",
      "nombre": "GRUPO EJEMPLO, S.A.",
      "estatus": "VIGENTE",
      "folio_id": 2790218,
      "coincide_por": ["persona"],
      "personas": [
        { "nombre": "ANDRES … DOWNING …", "cargo": "Director / Presidente" }
      ]
    },
    {
      "ficha": 98765,
      "tipo": "sociedad",
      "nombre": "DOWNING HOLDINGS, S.A.",
      "estatus": "VIGENTE",
      "folio_id": 1055497,
      "coincide_por": ["nombre_sociedad"],
      "personas": []
    }
  ]
}

2 · Consulta por ficha

GET /consulta?ficha=…&tipo=…

ficha: el número de ficha público. Es la forma normal de consultar.
tipo: sociedad o fundacion. Recomendado: algunas fichas existen como las dos, y sin tipo la respuesta es 409 con ambas opciones.
folio_id: alternativa a ficha, el identificador que devuelve la API 1. Nunca es ambiguo.
nombre: alternativa, solo con el nombre exacto de la sociedad. Para nombres aproximados o de personas, use la API 1.
data trae nombre, estatus_oficial, directivos (persona y relación), entradas (documentos presentados y su trámite) y asientos (inscripciones vigentes).
freshness.verified_at dice exactamente de cuándo es el dato.

Respuesta

Recortada.

200

{
  "folio_id": 1055497,
  "ficha": 155123,
  "tipo": "sociedad",
  "consulta": { "estado": "actualizada", "revisada_en_esta_consulta": true, "ms": 2830 },
  "data": {
    "nombre": "ACME HOLDINGS, S.A.",
    "estatus_oficial": "VIGENTE",
    "directivos": [ { "Usuario": "…", "Relacion": "Presidente" } ],
    "entradas": [ … ],
    "asientos": [ … ],
    "verified_at": "2026-10-19T15:00:02Z"
  },
  "freshness": { "verified_at": "2026-10-19T15:00:02Z", "age_seconds": 1 },
  "medidor": { "usadas_hoy": 37, "limite_dia": 200 }
}

consulta.estado

Siempre hay respuesta; este campo dice qué tan nueva es.

actualizada           se revisó en esta llamada
actualizada_parcial   se revisó, pero algo no respondió completo
                      (ver data.partial_reasons)
en_curso              tardó más de 15 s: va el último dato y
                      status_url; repetir en 5–10 s trae el nuevo
fuera_de_horario      fuera de horario: va el último dato y
                      proxima_apertura
sin_capacidad         no se pudo revisar ahora: va el último dato
fallo_la_revision

Horario, tiempos y límites

Horario: la API 2 revisa en el momento de 5:00 a. m. a 8:00 p. m. (hora de Panamá) entre semana; los sábados, un horario más corto. Fuera de ese horario responde igual, con el último dato. La API 1 responde a cualquier hora.
Tiempos: API 1, inmediata. API 2, de 2 a 5 segundos (sociedades muy grandes, hasta ~10). Configure su cliente HTTP con 30 segundos de espera.
Límites: su organización tiene topes por hora y por día. Al alcanzarlos la respuesta es 429 con reset_at y, en la API 2, el encabezado Retry-After. Cada llamada cuenta, encuentre o no resultados.
Guarde la ficha de cada sociedad y consulte directo con la API 2: no hace falta repetir la API 1.

Errores

Un 503 se reintenta con espera; un 4xx no.

invalid_name, invalid_state_filter          API 1
     missing_identifier, invalid_ficha,
     invalid_folio_id, invalid_tipo              API 2
invalid_api_key      llave ausente, inválida o revocada
not_found            API 2: no existe esa ficha
ambiguous            API 2: más de una coincidencia;
                          trae candidatos con su folio_id
not_society          API 2: no es sociedad ni fundación
quota_exceeded       tope de la organización alcanzado
(varios)             indisponible por un momento

Conecte su sistema

La API v1 expone lo mismo que ve en el portal: su cartera, la situación registral de cada sociedad y el rastro de cambios.

Autenticación Bearer con una API key de la organización.
El monitoreo ya es automático: Intelidata revisa a diario las sociedades En seguimiento y los trámites en curso cada 40 minutos. No hace falta que su sistema lo pida.
Por eso el punto de partida es leer la cartera, no pedir verificaciones. Pedir una actualización inmediata es la excepción, no el ciclo normal.
Todo lo que fuerza datos nuevos es asíncrono: responde 202 con un trabajo consultable y consultar su progreso no vuelve a consultar la fuente oficial.
Un resultado parcial siempre declara la causa; nunca se presenta como completo.

1 · Listar su cartera

El punto de entrada · devuelve situación, estatus y frescura de cada sociedad.

export INTELIDATA_API_KEY='PEGUE_LA_LLAVE_AQUI'

curl 'https://intelidata.net/api/v1/cartera?limit=100&offset=0' \
  -H "Authorization: Bearer $INTELIDATA_API_KEY"

2 · Leer una sociedad

Devuelve el último dato guardado; si ya es viejo, pide una revisión nueva y lo indica en freshness.

curl https://intelidata.net/api/v1/sociedades/1055497 \
  -H "Authorization: Bearer $INTELIDATA_API_KEY"

3 · Pedir una actualización inmediata

Excepción, no rutina: fuerza una sincronización completa · responde 202.

curl -X POST https://intelidata.net/api/v1/verificaciones \
  -H "Authorization: Bearer $INTELIDATA_API_KEY" \
  -H "Idempotency-Key: cartera-123-folio-1055497" \
  -H "Content-Type: application/json" \
  -d '{"folio_id":1055497}'

Tres números distintos

Es el error que más tiempo cuesta al integrar, porque no falla de forma obvia.

public_folio — el número que su abogado ve en el portal y en las certificaciones. No sirve para consultar la API.
folio_id — el identificador interno del folio. Es el que piden /sociedades/:folio_id y /verificaciones.
company_id — la fila de esa sociedad dentro de su cartera (UUID). Es el que piden las operaciones de cartera.

Los tres viajan juntos en cada fila de /cartera: tome de ahí el que necesite y no los deduzca uno del otro.

Por qué importa

El mismo número existe en dos registros distintos.

caso real

MARBLY ASSETS CORP.
  public_folio  780077      ← el que se ve en el portal
  folio_id      1823147     ← el que pide la API

# Con el número equivocado la API NO le devuelve
# datos de otra sociedad: los rechaza.
curl https://intelidata.net/api/v1/sociedades/780077
→ 422 {"code":"not_society"}

# porque el folio interno 780077 existe, pero es
# una finca — no una sociedad.

Cómo leer una sociedad

El campo de estatus oficial puede estar desactualizado; el asiento inscrito manda. Por eso cada fila trae las dos cosas y dice en cuál se apoya.

official_status — el estatus oficial publicado, tal cual.
situation — la lectura de Intelidata: label, source, que dice en qué se apoya: registered_seat (un asiento inscrito la sustenta), rp_status (solo el campo oficial), published_without_visible_seat (se publica un estatus terminal y no ubicamos el asiento que lo respalde) o not_published (no hay estatus publicado y no reconocimos un acto suficiente), basis con el asiento y su fecha, y differs_from_rp cuando ambos no coinciden.
registral_signals — señales sueltas (renuncia de agente, suspensión) con su evidencia.
entity_type — mercantil (sociedad) o personas (fundación de interés privado).
portfolio_state — active vigilada a diario, inactive conservada sin gastar monitoreo.
last_checked_at — cuándo la revisamos por última vez. Es la frescura real; no la confunda con la fecha del último cambio.

Nada de esto es un dictamen jurídico: es evidencia registral con su fuente citada.

Una fila de cartera

Recortada. company_id es su cartera, folio_id la API y public_folio el portal.

respuesta

{
  "company_id": "8f3c9d21-5e40-4a77-b2c1-93a5f0e7d418",
  "folio_id": 1823147,
  "public_folio": 780077,
  "name": "MARBLY ASSETS CORP.",
  "entity_type": "mercantil",
  "official_status": "SUSPENDIDO",
  "situation": {
    "key": "suspended",
    "label": "Suspendida",
    "source": "registered_seat",
    "rp_label": "SUSPENDIDO",
    "differs_from_rp": false,
    "basis": {
      "event": "suspension",
      "act": "ANOTACIÓN DE SUSPENSIÓN…",
      "seat_number": 1,
      "date": "2026-08-21"
    }
  },
  "portfolio_origin": "firm",
  "registral_signals": [
    { "kind": "resident_agent_resignation",
      "label": "Sin agente residente" }
  ],
  "portfolio_state": "active",
  "monitored": true,
  "last_checked_at": "2026-08-25T13:15:06Z"
}

Referencia

Todo bajo https://intelidata.net/api/v1 con Authorization: Bearer. Los errores llegan como {"error","code"}; los códigos comunes son invalid_api_key (401), method_not_allowed (405) y el 503 de la fuente cuando algo no está disponible — un 503 se reintenta, un 4xx no.

CARTERA
  GET    /cartera                      lista con filtros y paginación
         q, situation, official_status, entity (sociedad|fundacion),
         state, lifecycle, attention, properties, evidence, resolution,
         origin, limit (≤200, def. 100), offset
         incorporadas=recientes  las incorporadas en los últimos 30 días
         → { companies[], summary, pagination }
  POST   /cartera  {action:"import"}   hasta 10.000 filas, upsert no destructivo
  POST   /cartera  {action:"revisar"}  vuelve a leer las filas indicadas
         scope: selected | all_resolved | official_status
         (el valor histórico "audit" sigue aceptándose)
  PATCH  /cartera  ?id=<company_id>    etiquetas, notas, estado de la fila
         errores: invalid_items, too_many_items, invalid_selection,
                  company_not_found, company_not_resolved, company_inactive

SOCIEDADES
  GET    /sociedades/:folio_id         último dato + freshness; pide revisión si es viejo
         errores: invalid_folio_id (400), folio_not_found (404),
                  not_society (422 — el folio existe pero no es sociedad ni fundación)

VERIFICACIONES  (actualización inmediata — excepción, no rutina)
  POST   /verificaciones               requiere Idempotency-Key (8–200 car.) → 202 + job_id
  GET    /verificaciones/:job_id       polling; no vuelve a consultar la fuente
         errores: invalid_idempotency_key (400), idempotency_conflict (409),
                  429 si agotó el presupuesto de la hora o del día

SUSCRIPCIONES  (seguimiento de algo fuera de la cobertura automática)
  POST   /suscripciones                cadencia en minutos, tope 43.200 (30 días)
         sociedad: mínimo 60,  por omisión 1.440 (diaria)
         entrada:  mínimo 30,  por omisión 40
         rechazos: invalid_cadence, entry_key_required, not_society,
                   monitor_budget_hour | monitor_budget_day — el alta se
                   evalúa contra el presupuesto y devuelve projected vs limit
  GET    /suscripciones                PATCH /suscripciones?id=   DELETE /suscripciones?id=

HISTORIAL
  GET    /historial/:subscription_id   snapshots y eventos, append-only
         history_complete_since marca desde cuándo es completo — jamás retroactivo

LOTES
  POST   /lotes        GET /lotes/:batch_id        progreso de una relectura masiva

DOCUMENTOS
  GET    /documentos/:task_id          evidencia documental de una tarea

WEBHOOKS
  POST   /webhooks     GET /webhooks   PATCH /webhooks?id=   DELETE /webhooks?id=

Contrato del webhook

Cinco eventos disponibles: sociedad_cambio, entrada_cambio, sociedad_no_encontrada, entrada_no_encontrada y entrada_ambigua. Suscríbase a * para recibirlos todos.

La firma es v1=HMAC_SHA256(secreto, timestamp + "." + cuerpo_crudo) en hexadecimal. Fírmela sobre el cuerpo sin parsear: reserializar el JSON cambia el resultado.
Compare con timingSafeEqual, nunca con ===.
Rechace lo que llegue con X-Intelidata-Timestamp de más de cinco minutos: evita que alguien reenvíe una entrega vieja.
X-Intelidata-Delivery identifica el intento. Un reintento repite el mismo valor: proceso una sola vez por identificador.
Responda 2xx. Un fallo se reintenta hasta ocho veces con espera creciente; un 410 pausa el endpoint.

Lo que recibe

changes trae el antes y el después exactos.

payload

X-Intelidata-Event: entrada_cambio
X-Intelidata-Delivery: 4821
X-Intelidata-Timestamp: 1787654321
X-Intelidata-Signature: v1=9f2c…

{
  "delivery_id": "4821",
  "id": "6b1f6f0e-4a1e-4d2c-9a3b-2f5c8d7e1a04",
  "type": "entrada_cambio",
  "observed_at": "2026-08-25T13:15:06Z",
  "subscription": {
    "id": "1694ec89…",
    "target_type": "entrada",
    "folio_id": 1732589,
    "entry_key": "22095067",
    "label": null
  },
  "data":    { … estado actual … },
  "changes": { "changed": { "estado": {
      "before": "En Calificación",
      "after":  "Control de Calidad" } } }
}

Verificar la firma

Node y Python.

// Node — el cuerpo CRUDO, no el JSON parseado
const crypto = require('crypto');
function valida(secreto, headers, crudo) {
  const ts = headers['x-intelidata-timestamp'];
  if (!/^\d+$/.test(String(ts || ''))) return false;   // sin esto, Number("") es 0
  if (Math.abs(Date.now()/1000 - Number(ts)) > 300) return false;
  const esperada = 'v1=' + crypto
    .createHmac('sha256', secreto)
    .update(`${ts}.${crudo}`, 'utf8').digest('hex');
  const a = Buffer.from(esperada);
  const b = Buffer.from(headers['x-intelidata-signature'] || '');
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

# Python
import hmac, hashlib, time
def valida(secreto, headers, crudo: bytes) -> bool:
    ts = headers.get("X-Intelidata-Timestamp", "")
    if not ts.isdigit(): return False
    if abs(time.time() - int(ts)) > 300: return False
    esperada = "v1=" + hmac.new(
        secreto.encode(),
        ts.encode() + b"." + crudo,
        hashlib.sha256).hexdigest()
    return hmac.compare_digest(
        esperada, headers.get("X-Intelidata-Signature", ""))

Canales de entrega

Un endpoint pausado no recibe entregas: el cambio queda registrado en la sociedad, pero no se repone al reactivarlo — para recuperar ese periodo, consulte el historial. Un endpoint activo que falle sí se reintenta hasta 8 veces, y cada entrega va firmada: procese cada X-Intelidata-Delivery una sola vez (idempotencia).

Uso del servicio

Lo que su organización pide, separado del trabajo que Intelidata hace por su cuenta.

Consultas realizadas

Consultas oficiales que su organización provocó · el contador se reinicia cada mes.

este mes

Cargando uso…

Entre a su consola

Confirme su acceso

Falta una invitación

Actualizaciones recientes

Verificaciones

Canales de entrega

Requiere atención

Crear cartera desde el agente residente

Sociedades en seguimiento

Seguimientos externos

Historial observado

Cambios detectados

Última observación

Propiedades en seguimiento

Buscar en toda la base

Buscar bienes muebles

Buscar documentos históricos

Verificación completa

Auditorías de cartera

Correo de notificaciones

Probar la API · consulta de una sociedad

Nueva API key

Copie la API key ahora

Llaves de la organización

Conecte su sistema

1 · Fichas por nombre

2 · Consulta por ficha

1 · Fichas por nombre

Respuesta

2 · Consulta por ficha

Respuesta

consulta.estado

Horario, tiempos y límites

Errores

Conecte su sistema

1 · Listar su cartera

2 · Leer una sociedad

3 · Pedir una actualización inmediata

Tres números distintos

Por qué importa

Cómo leer una sociedad

Una fila de cartera

Referencia

Registrar webhook

Guarde el secreto de firma ahora

Contrato del webhook

Lo que recibe

Verificar la firma

Canales de entrega

Uso del servicio

Consultas realizadas