Pular para o conteúdo principal

WEBHOOK PERSONA JURIDICA

Esta documentación describe la estructura JSON que recibe tu servidor como respuesta a través del webhook preconfigurado en la aplicación cuando se aprueba un formulario de conocimiento de contrapartes de tipo Persona Jurídica.

📦 Estructura de la Respuesta

La respuesta contiene información detallada sobre la entidad consultada, organizada en secciones lógicas:

{
"informacionPrincipal": {
"tipoCliente": "Cliente",
"tipoSolicitud": "Vinculación",
"ciudad": "Colombia - Antioquia - Medellín",
"idSarlaft": 987654321,
"otroTipoCliente": "",
"esPersonaLegal": true
},
"autorizacionDatos": {
"autorizacionContacto": true,
"autorizacionDatos": true,
"autorizacionDatosSensibles": true,
"autorizacionIA": true
},
"personaJuridica": {
"razonSocial": "TECH SOLUTIONS S.A.",
"tipoEmpresa": "Privada",
"tipoSociedad": "S.A.",
"otroTipoSociedad": "",
"numeroIdentificacion": "000000000",
"fechaCorte": "2025-06-15",
"personaContactoFE": "CARLOS ANDRÉS LÓPEZ",
"telefonoFE": "1234567890",
"emailFE": "facturacion@techsolutions.com",
"email": "clopez@techsolutions.com",
"numeroCelular": "1234567890"
},
"representantesLegales": [
{
"tipoDocumento": "cc",
"numeroIdentificacion": "000000000",
"nombre": "JUAN PABLO RODRÍGUEZ",
"lugarExp": "Colombia - Bogotá D.C.",
"ciudad": "Colombia - Bogotá D.C.",
"direccion": "CALLE PRINCIPAL Y SECUNDARIA",
"telefono": "1234567890",
"email": "jrodriguez@techsolutions.com",
"esPrincipal": true,
"vinculoPersonaPEP": false,
"gradoPoderPublico": false,
"reconocimientoPublico": false,
"administraRecursosPublicos": false,
"cargoPep": "",
"fechaInicioPep": "",
"fechaFinPep": ""
}
],
"juntaDirectiva": [
{
"tipoDocumento": "cc",
"numeroIdentificacion": "000000000",
"nombre": "MARÍA FERNANDA GUTIÉRREZ",
"principalSuplente": "Principal",
"vinculoPersonaPEP": false,
"gradoPoderPublico": false,
"reconocimientoPublico": false,
"administraRecursosPublicos": true
}
],
"accionistasAsociados": [
{
"tipoDocumento": "cc",
"numeroIdentificacion": "000000000",
"razonSocial": "JUAN PABLO RODRÍGUEZ",
"porcentajeParticipacion": 60,
"vinvuloPersonaPEP": false,
"gradoPoderPublico": false,
"reconocimientoPublico": false,
"administraRecursosPublicos": false,
"cargoPep": "",
"fechaInicioPep": "",
"fechaFinPep": ""
},
{
"tipoDocumento": "cc",
"numeroIdentificacion": "000000000",
"razonSocial": "MARÍA FERNANDA GUTIÉRREZ",
"porcentajeParticipacion": 40,
"vinvuloPersonaPEP": false,
"gradoPoderPublico": false,
"reconocimientoPublico": false,
"administraRecursosPublicos": false,
"cargoPep": "",
"fechaInicioPep": "",
"fechaFinPep": ""
}
],
"beneficiariosFinales": [
{
"tipoDocumento": "cc",
"numeroIdentificacion": "000000000",
"razonSocial": "JUAN PABLO RODRÍGUEZ",
"vinvuloPersonaPEP": false,
"gradoPoderPublico": false,
"reconocimientoPublico": false,
"administraRecursosPublicos": false,
"cargoPep": "",
"fechaInicioPep": "",
"fechaFinPep": ""
}
],
"actividadEconomica": [
{
"principalActividadEconomica": "Tecnología",
"esPrincipal": true,
"codigoCiiu": "6201",
"descripcionActividad": "DESARROLLO DE SOFTWARE A LA MEDIDA",
"otraActividadEconomica": ""
}
],
"ubicacionOficina": [
{
"tipoDireccion": "Oficina Principal",
"nombreContacto": "CARLOS ANDRÉS LÓPEZ",
"direccion": "CALLE PRINCIPAL Y SECUNDARIA",
"ciudad": "Colombia - Antioquia - Medellín",
"departamento": "Antioquia",
"telefono": "1234567890",
"celular": "1234567890"
}
],
"informacionFinanciera": {
"regSimpleTributacion": true,
"resolucionRegSimple": "12345-2024",
"responsableIva": true,
"autorretenedorRENTA": false,
"resolucionAutorretenedorRENTA": "",
"granContribuyente": false,
"resolucionGranContribuyente": "",
"regTributarioEspecial": false,
"resolucionTributarioEspecial": "",
"exentoRetefuente": false,
"resolucionExentoRetefuente": "",
"impuestoConsumidor": false,
"autorretenedorICA": false,
"tarifaICA": "",
"vigiladoPor": false,
"vigiladoCual": "",
"ciudadDeclara": "MEDELLÍN"
},
"informacionBancaria": [
{
"entidadFinanciera": "BANCO DE BOGOTÁ",
"tipoCuenta": "Corriente",
"numeroCuenta": "987654321",
"sucursal": "MEDELLÍN",
"telefono": "1234567890",
"tipoBien": "Contratistas",
"condicionPago": "Contado"
}
],
"productosFinancieros": [
{
"tipoProducto": "CUENTA DE AHORROS",
"numeroProducto": "123456789",
"entidad": "CITIBANK",
"moneda": "USD",
"monto": 25000,
"pais": "Estados Unidos",
"ciudad": "Nueva York"
}
],
"operacionesInternacionales": [
{
"tipoTransaccion": "Exportaciones",
"otroTipoTransaccion": "No Aplica",
"pais": "USA",
"montoPromedio": 50000,
"tiempoOperacion": "3 años",
"frecuenciaOperacion": "Recurrente"
}
],
"referenciasComerciales": [
{
"tipoDocumento": "cc",
"numeroIdentificacion": "000000000",
"nombre": "PEDRO ANTONIO MARTÍNEZ",
"direccion": "CALLE PRINCIPAL Y SECUNDARIA",
"ciudad": "Colombia - Antioquia - Medellín",
"telefono": "1234567890"
}
],
"activosVirtuales": [
{
"tipoActivoVirtual": "CRIPTOMONEDA",
"moneda": "ETH",
"monto": 10000,
"ciudad": "Colombia - Antioquia"
}
],
"informacionOperativa": {
"estaZonaFranca": false,
"cualZonaFranca": "",
"calificadaComo": "PYME"
},
"informacionSeguridad": {
"tipoRelacion": "",
"certificacion": "[\"ISO27001\"]",
"perteneceGremio": "ANDI",
"tieneSistemaProteccionDatos": true,
"cualSistemaProteccionDatos": "POLÍTICAS INTERNAS",
"tieneSistemaProteccionLaft": true,
"cualSistemaProteccionLaft": "SOFTWARE ESPECIALIZADO",
"tienePoliticasPrevencion": true,
"tieneActivosVirtuales": true,
"cualActivosVirtuales": "CRIPTOMONEDAS",
"tieneRelacionExtranjero": true,
"cualPais": "Estados Unidos",
"calificadaComo": "MEDIANA EMPRESA",
"otraCertificacion": ""
},
"revisoresFiscal": [
{
"tipo": "revisorFiscal",
"nombreCompleto": "LUIS ALBERTO MORENO",
"tipoDocumento": "cc",
"numeroDocumento": "000000000",
"fechaExpedicion": "2024-01-10",
"lugarExpedicion": "Colombia - Antioquia",
"direccion": "CALLE PRINCIPAL Y SECUNDARIA",
"ciudad": "Colombia - Antioquia - Medellín",
"telefono": "1234567890",
"correo": "lmoreno@auditores.com",
"numeroTarjetaProfesional": "54321",
"vinculoPEP": false,
"gradoPoderPublico": false,
"reconocimientoPublico": false,
"administraRecursosPublicos": false
}
],
"informacionAmbiental": {
"tieneGestionAmbiental": true,
"cualGestionAmbiental": "RECICLAJE",
"cumpleRequerimientosSST": true
},
"sostenibilidad": {
"tieneCertificacion": true,
"cualCertificacion": "CARBONO NEUTRO",
"numeroCertificado": "CN-2024-123"
},
"declaracionFondos": {
"origenFondos": "VENTAS",
"actividadLicita": true,
"recursosNoDestinadosActividadesTerroristas": true,
"informacionVeraz": true,
"autorizacionTratamientoDatos": true,
"eximirClienteInformacionErronea": true
},
"declaracionesAdicionales": {
"listasInhibitorias": false,
"personaNaturalListasInhibitorias": false,
"personaPep": false,
"delitosTerrorismo": false
},
"declaracionesAdicionalesEmpresa": [
{
"DECLARACION PROPIA CREADA POR LA EMPRESA": true
},
{
"EN CASO AFIRMATIVO, CUAL O CUALES? ": "RESPUESTA A DECARACION PROPIA"
}
],
"datosDiligenciador": {
"tipoDocumento": "cc",
"numeroIdentificacion": "000000000",
"nombre": "ANA MARÍA GARCÍA",
"lugarExpedicion": "Colombia - Antioquia"
}
}

📋 Detalle Completo de la Estructura JSON

1. Información Principal

AtributoTipoDescripción
informacionPrincipal.idSarlaftBigIntID único del formulario SARLAFT
informacionPrincipal.tipoClienteStringTipo de cliente ("Cliente", "Proveedor", "Empleado", etc.)
informacionPrincipal.tipoSolicitudString"Vinculación"
informacionPrincipal.ciudadStringUbicación en formato "País-Departamento-Ciudad"
informacionPrincipal.otroTipoClienteStringEspecificación cuando tipoCliente es "Otro"
informacionPrincipal.esPersonaLegalBooleanTrue para personas jurídicas

2. Autorización de Datos

AtributoTipoDescripción
autorizacionDatos.autorizacionContactoBooleanPermite contacto por SMS, correo electrónico o cualquier otro medio físico o digital
autorizacionDatos.autorizacionDatosBooleanAutoriza tratamiento de datos básicos
autorizacionDatos.autorizacionDatosSensiblesBooleanAutoriza datos sensibles
autorizacionDatos.autorizacionIABooleanPermite análisis con diferentes tipos de software (P. ej. Automatización, Inteligencia artificial, Machine Learning, Deep Learning, etc.)

3. Persona Jurídica

AtributoTipoDescripción
personaJuridica.numeroIdentificacionStringNumero identificación principal
personaJuridica.razonSocialStringNombre legal completo
personaJuridica.emailStringEmail corporativo principal
personaJuridica.tipoEmpresaString"Privada", "Pública", "Mixta"
personaJuridica.tipoSociedadString"Anonima", "Limitada", "S.A.S"
personaJuridica.otroTipoSociedadStringEspecificación cuando tipoSociedad es "Otra"
personaJuridica.numeroCelularStringMóvil corporativo principal
personaJuridica.personaContactoFEStringNombre del contacto facturación
personaJuridica.telefonoFEStringTeléfono para facturación
personaJuridica.emailFEStringEmail para facturación electrónica
personaJuridica.fechaCorteDateFecha de corte para facturación electrónica

4. Representantes Legales (Array)

AtributoTipoDescripción
representantesLegales[].tipoDocumentoStringTipo de documento ("cc", "ce")
representantesLegales[].numeroIdentificacionStringNúmero documento
representantesLegales[].nombreStringNombre completo
representantesLegales[].lugarExpStringLugar expedición documento
representantesLegales[].ciudadStringCiudad residencia
representantesLegales[].direccionStringDirección residencia
representantesLegales[].telefonoStringTeléfono contacto
representantesLegales[].emailStringEmail contacto
representantesLegales[].esPrincipalBooleanTrue para representante principal
representantesLegales[].vinculoPersonaPEPBooleanIndica si tiene vinculos con personas PEP
representantesLegales[].gradoPoderPublicoBooleanIndica si tiene poder público
representantesLegales[].reconocimientoPublicoBooleanIndica si es públicamente reconocido
representantesLegales[].administraRecursosPublicosBooleanIndica si es Persona Expuesta Políticamente
representantesLegales[].cargoPepStringCargo si es PEP
representantesLegales[].fechaInicioPepStringFecha inicio cargo PEP
representantesLegales[].fechaFinPepStringFecha fin cargo PEP

5. Junta Directiva (Array)

AtributoTipoDescripción
juntaDirectiva[].tipoDocumentoStringTipo de documento ("cc", "ce")
juntaDirectiva[].numeroIdentificacionStringNúmero documento
juntaDirectiva[].nombreStringNombre completo
juntaDirectiva[].principalSuplenteString"Principal" o "Suplente"
juntaDirectiva[].vinculoPersonaPEPBooleanIndica si tiene vinculos con personas PEP
juntaDirectiva[].gradoPoderPublicoBooleanIndica si tiene poder público
juntaDirectiva[].reconocimientoPublicoBooleanIndica si es públicamente reconocido
juntaDirectiva[].administraRecursosPublicosBooleanIndica si es Persona Expuesta Políticamente

6. Accionistas/Asociados (Array)

AtributoTipoDescripción
accionistasAsociados[].tipoDocumentoStringTipo documento
accionistasAsociados[].numeroIdentificacionStringNúmero documento
accionistasAsociados[].razonSocialStringNombre o razón social
accionistasAsociados[].porcentajeParticipacionNumberPorcentaje participación
accionistasAsociados[].vinvuloPersonaPEPBooleanIndica si tiene vinculos con personas PEP
accionistasAsociados[].gradoPoderPublicoBooleanIndica si tiene poder público
accionistasAsociados[].reconocimientoPublicoBooleanIndica si es públicamente reconocido
accionistasAsociados[].administraRecursosPublicosBooleanIndica si es Persona Expuesta Políticamente
accionistasAsociados[].cargoPepStringCargo si es PEP
accionistasAsociados[].fechaInicioPepStringFecha inicio cargo PEP
accionistasAsociados[].fechaFinPepStringFecha fin cargo PEP

7. Beneficiarios Finales (Array)

AtributoTipoDescripción
beneficiariosFinales[].tipoDocumentoStringTipo documento
beneficiariosFinales[].numeroIdentificacionStringNúmero documento
beneficiariosFinales[].razonSocialStringNombre completo
beneficiariosFinales[].vinvuloPersonaPEPBooleanIndica si tiene vinculos con personas PEP
beneficiariosFinales[].gradoPoderPublicoBooleanIndica si tiene poder público
beneficiariosFinales[].reconocimientoPublicoBooleanIndica si es públicamente reconocido
beneficiariosFinales[].administraRecursosPublicosBooleanIndica si es Persona Expuesta Políticamente
beneficiariosFinales[].cargoPepStringCargo si es PEP
beneficiariosFinales[].fechaInicioPepStringFecha inicio cargo PEP
beneficiariosFinales[].fechaFinPepStringFecha fin cargo PEP

8. Actividad Económica (Array)

AtributoTipoDescripción
actividadEconomica[].principalActividadEconomicaStringSector principal
actividadEconomica[].esPrincipalBooleanTrue para actividad principal
actividadEconomica[].codigoCiiuStringCódigo CIIU
actividadEconomica[].descripcionActividadStringDescripción detallada
actividadEconomica[].otraActividadEconomicaStringOtras actividades

9. Ubicación Oficinas (Array)

AtributoTipoDescripción
ubicacionOficina[].tipoDireccionString"Oficina Principal", "Agencia", etc.
ubicacionOficina[].nombreContactoStringPersona de contacto
ubicacionOficina[].direccionStringDirección física
ubicacionOficina[].ciudadStringCiudad formato "País-Departamento-Ciudad"
ubicacionOficina[].departamentoStringDepartamento
ubicacionOficina[].telefonoStringTeléfono fijo
ubicacionOficina[].celularStringNúmero móvil

10. Información Financiera

AtributoTipoDescripción
informacionFinanciera.regSimpleTributacionBooleanRégimen simple de tributación
informacionFinanciera.resolucionRegSimpleStringNúmero resolución si aplica
informacionFinanciera.responsableIvaBooleanSi es responsable de IVA
informacionFinanciera.autorretenedorRENTABooleanSi es autorretenedor de renta
informacionFinanciera.resolucionAutorretenedorRENTAStringNúmero resolución autorretención
informacionFinanciera.granContribuyenteBooleanSi es gran contribuyente
informacionFinanciera.resolucionGranContribuyenteStringNúmero resolución gran contribuyente
informacionFinanciera.regTributarioEspecialBooleanSi aplica Régimen tributario especial
informacionFinanciera.resolucionTributarioEspecialStringResolución régimen especial
informacionFinanciera.exentoRetefuenteBooleanExención en retención fuente
informacionFinanciera.resolucionExentoRetefuenteStringResolución exención
informacionFinanciera.impuestoConsumidorBooleanSi aplica impuesto al consumo
informacionFinanciera.autorretenedorICABooleanSi es autorretenedor de ICA
informacionFinanciera.tarifaICAStringTarifa ICA aplicable
informacionFinanciera.vigiladoPorBooleanSi está bajo vigilancia especial
informacionFinanciera.vigiladoCualStringEntidad que vigila
informacionFinanciera.ciudadDeclaraStringCiudad de declaración tributaria

11. Información Bancaria (Array)

AtributoTipoDescripción
informacionBancaria[].entidadFinancieraStringNombre entidad bancaria
informacionBancaria[].tipoCuentaString"Corriente", "Ahorros", etc.
informacionBancaria[].numeroCuentaStringNúmero cuenta bancaria
informacionBancaria[].sucursalStringSucursal bancaria
informacionBancaria[].telefonoStringTeléfono contacto banco
informacionBancaria[].tipoBienStringTipo de bien/servicio asociado
informacionBancaria[].condicionPagoStringCondiciones de pago

12. Productos Financieros (Array)

AtributoTipoDescripción
productosFinancieros[].tipoProductoString"Cuenta Bancaria", "Tarjeta Crédito", etc.
productosFinancieros[].numeroProductoStringNúmero producto financiero
productosFinancieros[].entidadStringEntidad financiera
productosFinancieros[].monedaStringCódigo moneda (USD, EUR, etc.)
productosFinancieros[].montoNumberMonto en números enteros
productosFinancieros[].paisStringPaís producto financiero
productosFinancieros[].ciudadStringCiudad producto financiero

13. Operaciones Internacionales (Array)

AtributoTipoDescripción
operacionesInternacionales[].tipoTransaccionString"Importaciones", "Exportaciones", etc.
operacionesInternacionales[].otroTipoTransaccionStringEspecificación si tipo es "Otro"
operacionesInternacionales[].paisStringPaís
operacionesInternacionales[].montoPromedioNumberMonto promedio operaciones
operacionesInternacionales[].tiempoOperacionStringTiempo realizando operaciones
operacionesInternacionales[].frecuenciaOperacionString"Esporádica", "Recurrente"

14. Referencias Comerciales (Array)

AtributoTipoDescripción
referenciasComerciales[].tipoDocumentoStringTipo documento
referenciasComerciales[].numeroIdentificacionStringNúmero documento
referenciasComerciales[].nombreStringNombre completo
referenciasComerciales[].direccionStringDirección
referenciasComerciales[].ciudadStringCiudad
referenciasComerciales[].telefonoStringTeléfono contacto

15. Activos Virtuales (Array)

AtributoTipoDescripción
activosVistuales[].tipoActivoVirtualString"Criptomoneda", "Token", etc.
activosVistuales[].monedaStringCódigo activo (BTC, ETH, etc.)
activosVistuales[].montoNumberValor aproximado en USD
activosVistuales[].ciudadStringUbicación activo

16. Información Operativa

AtributoTipoDescripción
informacionOperativa.estaZonaFrancaBooleanSi opera en zona franca
informacionOperativa.cualZonaFrancaStringNombre zona franca si aplica
informacionOperativa.calificadaComoStringClasificación empresa

17. Información de Seguridad

AtributoTipoDescripción
informacionSeguridad.tipoRelacionStringTipo relación extranjero
informacionSeguridad.certificacionStringCertificaciones en formato JSON
informacionSeguridad.perteneceGremioStringGremio asociado
informacionSeguridad.tieneSistemaProteccionDatosBooleanSi tiene protección datos
informacionSeguridad.cualSistemaProteccionDatosStringDescripción sistema protección
informacionSeguridad.tieneSistemaProteccionLaftBooleanSi tiene sistema proteccion LA/FT
informacionSeguridad.cualSistemaProteccionLaftStringDescripción sistema proteccion LA/FT
informacionSeguridad.tienePoliticasPrevencionBooleanSi tiene políticas prevención
informacionSeguridad.tieneActivosVirtualesBooleanSi maneja activos virtuales
informacionSeguridad.cualActivosVirtualesStringTipo activos virtuales
informacionSeguridad.tieneRelacionExtranjeroBooleanSi tiene relación extranjero
informacionSeguridad.cualPaisStringPaís relación extranjera
informacionSeguridad.calificadaComoStringClasificación riesgo
informacionSeguridad.otraCertificacionStringOtras certificaciones

18. Revisores Fiscales (Array)

AtributoTipoDescripción
revisoresFiscal[].tipoString"revisorFiscal", "auditorExterno"
revisoresFiscal[].nombreCompletoStringNombre completo
revisoresFiscal[].tipoDocumentoStringTipo documento
revisoresFiscal[].numeroDocumentoStringNúmero documento
revisoresFiscal[].fechaExpedicionDateFecha expedición documento
revisoresFiscal[].lugarExpedicionStringLugar expedición
revisoresFiscal[].direccionStringDirección residencia
revisoresFiscal[].ciudadStringCiudad residencia
revisoresFiscal[].telefonoStringTeléfono contacto
revisoresFiscal[].correoStringEmail contacto
revisoresFiscal[].numeroTarjetaProfesionalStringNúmero tarjeta profesional
revisoresFiscal[].vinculoPEPBooleanIndica si tiene vinculos con personas PEP
revisoresFiscal[].gradoPoderPublicoBooleanIndica si tiene poder público
revisoresFiscal[].reconocimientoPublicoBooleanIndica si es públicamente reconocido
revisoresFiscal[].administraRecursosPublicosBooleanIndica si es Persona Expuesta Políticamente

19. Información Ambiental

AtributoTipoDescripción
informacionAmbiental.tieneGestionAmbientalBooleanSi tiene gestión ambiental
informacionAmbiental.cualGestionAmbientalStringDescripción gestión
informacionAmbiental.cumpleRequerimientosSSTBooleanCumple seguridad salud trabajo

20. Sostenibilidad

AtributoTipoDescripción
sostenibilidad.tieneCertificacionBooleanSi tiene certificación sostenibilidad
sostenibilidad.cualCertificacionStringTipo certificación
sostenibilidad.numeroCertificadoStringNúmero certificado

21. Declaración de Fondos

AtributoTipoDescripción
declaracionFondos.origenFondosString"Ahorros", "Utilidades", etc.
declaracionFondos.actividadLicitaBooleanConfirmación actividad lícita
declaracionFondos.recursosNoDestinadosActividadesTerroristasBooleanConfirmación fondos legales
declaracionFondos.informacionVerazBooleanConfirmación veracidad
declaracionFondos.autorizacionTratamientoDatosBooleanAutorización tratamiento
declaracionFondos.eximirClienteInformacionErroneaBooleanExención por información errónea

22. Declaraciones Adicionales

AtributoTipoDescripción
declaracionesAdicionales.listasInhibitoriasBooleanSi aparece en listas inhibitorias
declaracionesAdicionales.personaNaturalListasInhibitoriasBooleanSi personas naturales en listas inhibitorias
declaracionesAdicionales.personaPepBooleanSi hay PEPs vinculados
declaracionesAdicionales.delitosTerrorismoBooleanSi hay vínculos con terrorismo

23. Declaraciones Adicionales Empresa (Array)

Depende de las declaraciones creadas por el cliente

24. Datos del Diligenciador

AtributoTipoDescripción
datosDiligenciador.tipoDocumentoStringTipo documento
datosDiligenciador.numeroIdentificacionStringNúmero documento
datosDiligenciador.nombreStringNombre completo
datosDiligenciador.lugarExpedicionStringLugar expedición documento