Saltar al contenido principal
Los reportes de BIL provienen del Buró de Investigaciones Legales y resumen los resultados de las investigaciones legales para una entidad. Úsalos cuando tu integración necesite revisar hallazgos de riesgo legal, conservar el reporte original del proveedor o mostrar el PDF del reporte en tu propio producto. Los datos de BIL se obtienen ejecutando una extracción de BIL. La extracción busca en BIL usando el nombre de la entidad, almacena los datos parseados del reporte y adjunta los archivos XML y PDF originales del reporte.

​
Cómo funcionan los reportes de BIL

  1. Inicia una extracción de BIL para la entidad.
  2. Consulta la extracción hasta que alcance un estado terminal.
  3. Lista los reportes de BIL de la entidad.
  4. Obtén el reporte por ID cuando necesites los datos completos del reporte o las referencias a los archivos.
  5. Descarga el archivo XML o PDF mediante la API de archivos.

​
Requisitos

La entidad debe tener un nombre. Las búsquedas en BIL son por nombre, por lo que la extracción no puede ejecutarse para una entidad sin nombre. BIL es una fuente de datos premium. Antes de que el extractor bil pueda ejecutarse vía API, tu organización debe tener un acuerdo firmado que reconozca la responsabilidad por los cargos de BIL, incluidos los cargos causados por errores o solicitudes duplicadas. Sin ese acuerdo, POST /extractions devuelve un error de validación con la violación:
Si ves este error y la entidad ya tiene nombre, contacta a tu CSM o a Soporte de Syntage para completar el acuerdo de BIL antes de crear extracciones de BIL vía API. Para detalles de implementación, consulta los ejemplos de solicitudes de extracción.
CampoDescripción
fechaFecha y hora reportadas por BIL para el reporte generado.
investigadoNombre consultado y reportado por BIL.
folioFolio del reporte de BIL.
gradoMaximoGrado máximo devuelto por BIL para el reporte.
dataRespuesta XML de BIL parseada. La estructura sigue la respuesta del proveedor y puede variar según el contenido del reporte.
xmlFileRecurso de archivo para la respuesta XML original.
pdfFileRecurso de archivo para el reporte PDF de BIL.
Para detalles del endpoint, consulta la referencia de la API de reportes de BIL.