Una sociedad nueva, una razón social distinta o una matrícula cancelada suelen marcar el momento de llamar, o de frenar el crédito. La API vigila las cuentas de su CRM, le avisa del cambio en el registro mercantil (RUES, Confecámaras) y lista las sociedades nuevas, siempre a nivel de empresa.
Son eventos de cambio del registro, no actos de un boletín. Cada uno se fecha el día en que el cambio aparece por primera vez en los datos, no el de su inscripción en la cámara de comercio, y ninguno es anterior a octubre de 2026. Cubren el nombre, el estado y el tipo de sociedad.
| Cambio | event_type | Por qué le importa a ventas |
|---|---|---|
| Sociedad nueva en el registro | new_incorporation | Necesita banco, contador, seguros, software y proveedores desde el primer día |
| Nueva razón social | name_change | Un cambio de marca reabre contratos, facturación y sistemas |
| Nuevo tipo de sociedad (por ejemplo, de Ltda. a S.A.S.) | legal_form_change | Una transformación suele ir con una reorganización de la empresa |
| Matrícula cancelada | dissolution | Frene la venta a crédito, proteja la factura y limpie el CRM |
| Sociedad fusionada | merger | Dos listas de clientes o de proveedores pasan a ser una |
| En liquidación o en reorganización (se leen del nombre) | liquidation, insolvency | Frene el crédito y revise lo que le deben |
Al 19 de octubre de 2026 el flujo de Colombia traía eventos new_incorporation; los demás tipos aparecen cuando la fuente publica un cambio. Sin dirección ni capital en el registro abierto, no hay eventos de domicilio ni de capital.
Resuelva cada cuenta a su ficha con el NIT, suscríbala y guarde el identificador de su CRM como label: vuelve en cada aviso. Suscribir no consume créditos.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
# Sus cuentas, como las tiene el CRM: NIT e identificador interno
cuentas = [('900843898-9', 'crm-1001'), ('899999068-1', 'crm-1002')]
for nit, crm_id in cuentas:
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'CO', 'company_number': nit})
r.raise_for_status()
hits = r.json()['data']
if not hits:
continue
requests.post(f'{BASE}/monitor', headers=H, json={
'company_id': hits[0]['id'],
'country': 'CO',
'label': crm_id, # vuelve en cada aviso
'events': ['corporate_event', 'status_change', 'dissolution'],
'webhook_url': 'https://su-dominio.co/hooks/prometiam',
}).raise_for_status()
Cada aviso llega firmado: la cabecera X-Prometiam-Signature lleva sha256= y el HMAC-SHA256 del cuerpo con el webhook_secret que devuelve POST /monitor. Verifique la firma antes de crear la tarea para el ejecutivo comercial. El webhook está en todos los planes y los avisos también se leen en GET /monitor, así que un proceso nocturno también sirve. La prueba gratuita vigila 3 sociedades, Starter 25, Professional 250 y Scale 2.500.
import hashlib, hmac
def firma_valida(cuerpo: bytes, cabecera: str, webhook_secret: str) -> bool:
esperada = 'sha256=' + hmac.new(webhook_secret.encode(), cuerpo, hashlib.sha256).hexdigest()
return hmac.compare_digest(cabecera, esperada)
# en su endpoint: firma_valida(request.get_data(), request.headers['X-Prometiam-Signature'], SECRETO)
Sin company_number ni company_name, GET /company-events/search es el flujo de eventos del país, del más reciente al más antiguo y filtrable por event_type. Cubre como mucho los últimos 31 días (7 si no indica date_from; una fecha más antigua se rechaza con un 400): un proceso diario que lo lea y se quede con las sociedades de su segmento encuentra las cuentas que todavía no vigila.
# Todas las sociedades que han aparecido en el registro desde el 1 de octubre, la más reciente primero curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=CO&event_type=new_incorporation&date_from=2026-10-01&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Cada llamada cuesta 2 créditos por hasta 100 eventos y se pagina con next_cursor, que se envía en cursor. event_date es el día en que la sociedad entró en los datos; su fecha de constitución va en event_detail ("founded 2026-10-01") y en founding_date de la ficha.
founded_after lista las sociedades matriculadas desde una fecha, sin poner nombre. Cada ficha trae founding_date, la actividad CIIU Rev. 4 A.C. de 4 dígitos (activity_code) con su título (activity_description) y el departamento de la cámara de comercio (region, por ejemplo BOGOTÁ D.C.). La búsqueda no filtra por actividad ni por departamento: lo hace usted sobre cada página de 100, que cuesta 1 crédito.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'CO', 'founded_after': '2026-10-01', 'limit': 100})
r.raise_for_status()
for s in r.json()['data']:
# informática (CIIU 62) en Bogotá; siga con pagination.next_cursor para la página siguiente
if (s['activity_code'] or '').startswith('62') and s['region'] == 'BOGOTÁ D.C.':
print(s['company_number'], s['company_name'], s['founding_date'])
Una sociedad entra en la lista cuando la fuente la publica (data_as_of, en meta). registry_details.last_renewal_year dice cuándo renovó su matrícula, útil para detectar cuentas que dejaron de renovar.
vat= se rechaza) y sin avisos de insolvencia: Colombia no es uno de los dieciséis mercados de insolvencia. La liquidación y la reorganización se leen del nombre y se sirven como estado.Vigilar no consume créditos. Una búsqueda de empresas o una ficha cuesta 1 crédito y una búsqueda de eventos, 2; los errores no cuestan nada. Starter cuesta € 9,99 al mes con 1.000 créditos, Professional € 29,99 con 10.000 y Scale € 99,99 con 50.000. La prueba gratuita dura 14 días con 500 créditos: se requiere una tarjeta y no se cobra nada durante la prueba; después sigue Starter, salvo que cancele. Vea los precios.
Contains data from Confecámaras (Registro Único Empresarial y Social, RUES), via the Portal de Datos Abiertos www.datos.gov.co, licensed CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/). Modified by Prometiam; the Colombian records are offered under CC BY-SA 4.0. Los registros colombianos se ofrecen bajo la licencia CC BY-SA 4.0 (con compartir igual): puede copiarlos, reutilizarlos y redistribuirlos, también con fines comerciales, citando la fuente y manteniendo la misma licencia.
Empezar la prueba gratuita de 14 días · Documentación de la API
La prueba dura 14 días e incluye 500 créditos. Se requiere una tarjeta; durante la prueba no se cobra nada y después se aplica el plan Starter (9,99 € al mes), salvo que cancele.