Pular para o conteúdo principal

WEBHOOK PERSONA NATURAL

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 Natural.

📦 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": false
  },
  "autorizacionDatos": {
    "autorizacionContacto": true,
    "autorizacionDatos": true,
    "autorizacionDatosSensibles": true,
    "autorizacionIA": true
  },
  "personaNatural": {
    "tipoDocumento": "cc",
    "numeroIdentificacion": "00000000",
    "nombre": "MARÍA FERNANDA GÓMEZ RESTREPO",
    "fechaExpDocumento": "6/20/2010",
    "fechaNacimiento": "5/15/1985",
    "lugarNacimiento": "Colombia - Antioquia - Medellín",
    "ocupacion": "DESARROLLADOR DE SOFTWARE",
    "profesion": "INGENIERA DE SISTEMAS",
    "ciudadResidencia": "Colombia - Antioquia - Medellín",
    "celular": "+571234567890",
    "telefono": "1234567890",
    "email": "mfgomez@empresa.com",
    "lugarExpedicion": "Colombia - Medellín",
    "direccionResidencia": "CALLE PRINCIPAL Y SECUNDARIA",
    "administraRecursosPublicos": false,
    "reconocimientoPublico": false,
    "gradoPoderPublico": false,
    "vinculoPEP": false,
    "cargoPep": "",
    "fechaInicioPep": "",
    "fechaFinPep": "",
    "emailFE": "mfgomez@empresa.com",
    "personaContactoFE": "MARÍA GÓMEZ",
    "telefonoFE": "1234567890",
    "fechaCorte": "Mon Jun 10 00:00:00 COT 2025"    
  },
  "actividadEconomica": [
    {
      "principalActividadEconomica": "Tecnología",
      "esPrincipal": true,
      "codigoCiiu": "6201",
      "descripcionActividad": "DESARROLLO DE SOFTWARE",
      "otraActividadEconomica": ""
    },
    {
      "principalActividadEconomica": "Consultoría",
      "esPrincipal": false,
      "codigoCiiu": "6202",
      "descripcionActividad": "CONSULTORÍA EN SISTEMAS DE INFORMACIÓN",
      "otraActividadEconomica": "",
    }
  ],
  "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": "Carrera 20 # 30-40",
      "ciudad": "Colombia - Antioquia - Medellín",
      "telefono": "1234567890"
    }
  ],
  "activosVirtuales": [
    {
      "tipoActivoVirtual": "CRIPTOMONEDA",
      "moneda": "ETH",
      "monto": 10000,
      "ciudad": "Colombia - Antioquia"
    }
  ],
  "informacionFinanciera": {
    "regSimpleTributacion": false,
    "resolucionRegSimple": "",
    "autorretenedorRENTA": false,
    "responsableIva": true,
    "ciudadDeclara": "MEDELLIN",
    "resolucionExentoRetefuente": "",
    "impuestoConsumidor": false,
    "exentoRetefuente": false,
    "resolucionGranContribuyente": "",
    "granContribuyente": false,
    "resolucionTributarioEspecial": "",
    "regTributarioEspecial": false,
    "vigiladoPor": false,
    "resolucionAutorretenedorRENTA": "",
    "tarifaICA": "",
    "vigiladoCual": "",
    "autorretenedorICA": false
  },
  "declaracionFondos": {
    "origenFondos": "Ahorros personales",
    "autorizacionTratamientoDatos": true,
    "eximirClienteInformacionErronea": true,
    "actividadLicita": true,
    "recursosNoDestinadosActividadesTerroristas": true,
    "informacionVeraz": true
  },
  "declaracionesAdicionales": {
    "personaNaturalListasInhibitorias": false,
    "delitosTerrorismo": false,
    "personaPep": false,
    "listasInhibitorias": false
  },
  "declaracionesAdicionalesEmpresa": [
    {
      "DECLARACION PROPIA CREADA POR LA EMPRESA": true
    },
    {
      "EN CASO AFIRMATIVO, CUAL O CUALES? ": "RESPUESTA A DECARACION PROPIA"
    }
  ],
  "datosDiligenciador": {
    "tipoDocumento": "cc",
    "lugarExpedicion": "Colombia - Medellín",
    "numeroIdentificacion": "000000000",
    "nombre": "MARÍA FERNANDA GÓMEZ"
  }
}

📋 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 Natural​

AtributoTipoDescripción
personaNatural.tipoDocumentoStringTipo de documento ("cc", "ce", etc.)
personaNatural.numeroIdentificacionStringNúmero de identificación principal
personaNatural.nombreStringNombre completo
personaNatural.fechaExpDocumentoStringFecha de expedición del documento
personaNatural.fechaNacimientoStringFecha de nacimiento
personaNatural.lugarNacimientoStringLugar de nacimiento en formato "País - Departamento - Ciudad"
personaNatural.ocupacionStringOcupación principal
personaNatural.profesionStringProfesión
personaNatural.ciudadResidenciaStringCiudad de residencia en formato "País - Departamento - Ciudad"
personaNatural.celularStringNúmero de celular
personaNatural.telefonoStringTeléfono fijo
personaNatural.emailStringCorreo electrónico principal
personaNatural.lugarExpedicionStringLugar de expedición del documento
personaNatural.direccionResidenciaStringDirección de residencia
personaNatural.administraRecursosPublicosBooleanIndica si administra recursos públicos
personaNatural.reconocimientoPublicoBooleanIndica si es públicamente reconocido
personaNatural.gradoPoderPublicoBooleanIndica si tiene poder público
personaNatural.vinculoPEPBooleanIndica si tiene vínculo con personas PEP
personaNatural.cargoPepStringCargo si es PEP
personaNatural.fechaInicioPepStringFecha de inicio del cargo PEP
personaNatural.fechaFinPepStringFecha de finalización del cargo PEP
personaNatural.emailFEStringCorreo electrónico para facturación electrónica
personaNatural.personaContactoFEStringNombre del contacto para facturación electrónica
personaNatural.telefonoFEStringTeléfono para facturación electrónica
personaNatural.fechaCorteStringFecha de corte para facturación electrónica

4. 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

5. 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

6. 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

7. 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"

8. Referencias Comerciales (Array)​

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

9. 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

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. 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

12. 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

14. Declaraciones Adicionales Empresa (Array)​

Depende de las declaraciones creadas por el cliente

14. Datos del Diligenciador​

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