Visión General
La API de Antilavado AI expone funcionalidades críticas de cumplimiento normativo, extracción de documentos inteligente (IDP) y análisis de riesgo mediante Inteligencia Artificial Generativa.
Autenticación
Todas las peticiones deben incluir el header de autorización.
Authorization: Bearer YOUR_API_KEYMonitor de Tiempo
GET/api/time
Verifica la disponibilidad del servicio y la hora del servidor.
Compliance Core
Búsqueda en Listas Negras
POST/api/buscar-lista-negra
Consulta simultánea en listas SAT (69-B), UIF, OFAC, FBI e Interpol.
| Campo | Tipo | Descripción |
|---|---|---|
| nombre | string | Nombre completo o Razón Social. |
| rfc | string | RFC (Opcional si se envía nombre). |
| buscarConGemini | boolean | Activar validación con IA. |
| estricto | boolean | Forzar búsqueda profunda. |
Ejemplo Request
{
"nombre": "NEMESIO OSEGUERA CERVANTES",
"rfc": "OECN660717",
"buscarConGemini": true,
"estricto": true
}Ejemplo Response
{
"resultadosSP": [
{
"Nombre_En_Lista": "NEMESIO OSEGUERA CERVANTES",
"Lista": "OFAC - SDNTK",
"Tipo_Riesgo": "Narcotráfico",
"Confianza": "100%",
"ID_Registro": "OFAC-12345"
}
],
"investigacionGemini": [
{
"Nombre": "NEMESIO OSEGUERA CERVANTES",
"RFC": "OECN660717",
"Tipo_Riesgo": "Narcotráfico",
"investigacion": [
{
"titulo": "Líder del CJNG sancionado por OFAC",
"url": "https://home.treasury.gov/...",
"resumen": "El Departamento del Tesoro sanciona a..."
}
]
}
],
"resumen": {
"total_resultados_sp": 1,
"resultados_alto_riesgo": 1,
"investigaciones_realizadas": 1,
"gemini_activado": true
}
}Registrar Cliente
POST/api/guardar-cliente
Almacena un expediente KYC validado (Física, Moral o Fideicomiso).
Ejemplo Request
{
"nombre": "Juan Perez",
"rfc": "XAXX010101000",
"email": "juan@example.com",
"telefono": "5512345678",
"actividad_economica": "Comercio al por menor",
"analisis_ia": true
}Ejemplo Response
{
"success": true,
"id": "client_uuid_12345",
"idAgrupador": "client_uuid_12345",
"riesgo_detectado": false,
"nivel_riesgo": "Bajo"
}Análisis de Riesgo IA
POST/api/analizar-riesgo-ia
Evalúa perfiles complejos utilizando Gemini para detectar inconsistencias no obvias.
Ejemplo Request
{
"nombre": "Empresa Fantasma SA",
"actividad": "Venta de facturas",
"historial": "Reciente creación, direcciones múltiples",
"socios": ["Prestansombres Uno", "Prestansombres Dos"],
"ingresos_declarados": "0"
}Ejemplo Response
{
"resumen_ejecutivo": "La empresa presenta indicadores de alto riesgo compatibles con EFOS...",
"nivel_riesgo_ia": "CRITICO",
"score_riesgo_ia": 95,
"razones_riesgo": [
"Coincidencia con tipología de empresa fachada",
"Socios sin historial comercial verificable"
],
"recomendacion_accion": "RECHAZAR"
}Registro Ventas Manuales
POST/api/guardar-venta-manual
Endpoint para integración con POS externos.
Ejemplo Request
{
"fraccId": "FRACC-001",
"folio": "F-2025",
"fecha": "2025-02-11T12:00:00Z",
"rfc": "XAXX010101000",
"nombre": "Venta Público General",
"subTotal": 1500.50,
"formaPago": "01",
"rfcEmisor": "EMI880101ABC"
}Ejemplo Response
{
"success": true,
"uuid": "sale_uuid_12345678-1234...",
"total": 1740.58
}Servicios de Extracción (IDP)
Estos endpoints aceptan documentos (PDF/Imagen) y devuelven JSON estructurado.
multipart/form-data o JSON con
base64Image.
Identificación Oficial
POST/api/extraer-identificacion-oficial
Extrae datos de INE (frontal/reverso) o Pasaporte.
Ejemplo Request
{
"image": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
"apiKey": "sk_..."
}Ejemplo Response
{
"tipo_documento_detectado": "INE",
"precision": "ALTA",
"nombre_titular": "JUAN PEREZ LOPEZ",
"rfc": "PELJ800101HDF...",
"curp": "PELJ800101HDF...",
"clave_elector": "PELJ800101...",
"vigencia": "2028",
"calle": "AV REFORMA",
"codigo_postal": "06600"
}Comprobante de Domicilio
POST/api/extraer-comprobante-domicilio-dedicado
Procesa recibos de luz (CFE), agua, teléfono o estados de cuenta bancarios para validar vigencia y dirección.
Ejemplo Request
{
"image": "data:application/pdf;base64,JVBERi0xLjQK...",
"apiKey": "sk_..."
}Ejemplo Response
{
"tipo_documento_detectado": "CFE",
"precision": "ALTA",
"nombre_titular": "JUAN PEREZ",
"calle": "CALLE FALSA",
"numero_exterior": "123",
"colonia": "JUAREZ",
"codigo_postal": "06600",
"municipio": "CUAUHTEMOC",
"estado": "CIUDAD DE MEXICO",
"fecha_emision_documento": "15/01/2024"
}Datos Fiscales (CSF)
POST/api/extraer-constancia-fiscal-dedicado
OCR especializado para la Constancia de Situación Fiscal del SAT. Devuelve Régimen, CP, RFC y Razón Social.
Ejemplo Response
{
"success": true,
"data": {
"rfc": "ABC123456T1A",
"razon_social": "PATITO SA DE CV",
"cp": "11560",
"regimenez_fiscales": ["601 - General de Ley"],
"fecha_inicio_operaciones": "2010-05-20"
}
}Legal Empresarial
POST/api/extraer-legal-empresarial-dedicado
Analiza Actas Constitutivas y Poderes Notariales. Identifica representantes, facultades y objeto social.
Ejemplo Response
{
"success": true,
"data": {
"nombre_empresa": "PATITO SA DE CV",
"fecha_constitucion": "2015-02-15",
"objeto_social_principal": "Compra venta de materiales...",
"socios": [
{ "nombre": "Juan Perez", "porcentaje": "50%" },
{ "nombre": "Maria Lopez", "porcentaje": "50%" }
],
"representantes_legales": ["Juan Perez"]
}
}Legal Extranjero
POST/api/extraer-existencia-legal-extranjero
Procesa documentos de apostilla o registros mercantiles internacionales.
Ejemplo Request
{
"image": "data:application/pdf;base64,...",
"nationality": "Estados Unidos",
"apiKey": "sk_..."
}Ejemplo Response
{
"success": true,
"data": {
"nombre_entidad": "Global Holdings LLC",
"numero_registro": "DE-12345678",
"fecha_registro": "2020-01-01",
"estado_legal": "Active / Good Standing",
"coincide_con_nacionalidad_declarada": true
}
}Otros Endpoint de Extracción
- POST
/api/extraer-curp-dedicado- Valida formatos de CURP. - POST
/api/extraer-cedula-moral-dedicado- Cédula Fiscal (CIF) Moral. - POST
/api/extraer-id-fiscal-extranjero-dedicado- Tax ID USA/Otros.
Herramientas Especializadas
Consulta Genérica Gemini
POST/api/consultar-gemini
Envía un prompt libre al motor LLM con contexto de cumplimiento.
Ejemplo Request
{
"prompt": "¿Es riesgoso operar con empresas en paraísos fiscales?",
"apiKey": "sk_..."
}Ejemplo Response
{
"status": "success",
"response": "Sí, operar con paraísos fiscales aumenta el riesgo de LD/FT...",
"timestamp": "2025-02-11T12:00:00Z"
}Análisis de Estado de Cuenta
POST/api/analizar-estado-cuenta
Detecta patrones transaccionales, flujos inusuales y promedios mensuales en PDFs bancarios.
Ejemplo Response
{
"status": "success",
"data": {
"banco": "BBVA",
"periodo": "ENERO 2024",
"depositos_totales": 150000.00,
"retiros_totales": 120000.00,
"alertas": ["Depósito inusual de $50,000 en efectivo"]
}
}OCR Vision Raw
POST/api/extract-text-vision
Devuelve el texto crudo extraído por Google Vision API sin estructuración.
Ejemplo Response
{
"success": true,
"data": {
"text": "INSTITUTO NACIONAL ELECTORAL...",
"fullTextAnnotation": { ... }
}
}