Enrichment

Rotas para o enriquecimento de dados cadastrais.

O mostQI Enrichment oferece a capacidade de obter dados de múltiplas fontes por meio de consultas únicas (queries), utilizando parâmetros como CPF, CNPJ ou numeração única de processo judicial.

Essas consultas possibilitam a obtenção de um conjunto diversificado de informações provenientes de várias fontes (datasets), que auxiliam no combate à fraude e no enriquecimento dos dados cadastrais e dispõe de duas formas de consumo: síncrona e assíncrona.

:::highlight blue 📌
Para criação de consulta personalizada, entre em contato com o suporte através do e-mail suporte@most.com.br.
:::

Dataset

Um dataset é um conjunto estruturado de dados, frequentemente utilizado para análise e processamento. Em nosso contexto, um dataset pode ser coletado em tempo real a partir de fontes públicas (datasets on-demand) ou pode consistir em dados capturados previamente e atualizados periodicamente (datasets de atualização regular). Esses conjuntos de dados são organizados de forma a permitir fácil acesso e manipulação, facilitando a extração de informações relevantes para diversas aplicações.

Query

Uma query é uma composição personalizada que integra um ou múltiplos datasets para um mesmo contexto (por exemplo, pessoa física, pessoa jurídica, documento fiscal). Com uma única consulta e fornecendo um único conjunto de parâmetros de entrada, nosso sistema realiza internamente várias consultas a diferentes datasets. O resultado é então compilado e retornado em uma estrutura unificada, facilitando a obtenção de informações abrangentes e detalhadas de maneira eficiente e simplificada.

Estrutura unificada do resultado

O resultado da consulta ao Enrichment inclui um objeto result, que contém os dados de identificação, o nome e status do processo (consolidando os status dos datasets da query consultada), além dos parâmetros de entrada utilizados na chamada. Também há um array datasets, que lista os itens relacionados a cada conjunto de dados. Cada dataset possui sua própria identificação e status, e seus dados são retornados no objeto data. A estrutura do objeto data varia conforme o contexto e a natureza de cada dataset.

{
    "result": {
        "processId": "009a7d10-a1ba-437e-a46f-b945bafb77a8",
        "tier": "query_name_xxx",
        "query": "query_name_xxx",
        "status": "PROCESS_STATUS",
        "parameters": {
            "parameter": "XXXXXXXXXXX"
        },
        "datasets": [
            {
                "name": "dataset_name_xxx",
                "code": "dataset_code_xxxx",
                "status": "DATASET_STATUS",
                "fromCache": false,
                "errors": [],
                "data": [
                    ...
                ]
            },
            {
                "name": "dataset_name_yyyy",
                "code": "dataset_code_yyyy",
                "status": "DATASET_STATUS",
                "fromCache": false,
                "errors": [],
                "data": [
                    ...
                ]
            }
        ]
    },
    "requestId": "TPun6by1uEWYnbAPfjxYp",
    "elapsedMilliseconds": 49267,
    "status": {
        "message": "Ok",
        "code": "200",
        "errors": []
    }
}