Perguntas
Frequentes
Encontre respostas para suas dúvidas
Callback de Análise de Riscos (Report Risk)
Este FAQ aborda as questões mais comuns sobre o processo de callback (retorno de dados) para a análise de Riscos do Relatório (endpoint /insurance/report/callback/risk).
1- Visão Geral
O Callback de Risks (Riscos) é o serviço responsável por entregar o resultado completo da análise do relatório.
API de Exemplo:
-
Produção
- Validation
Frequência: Os dados são enviados de forma particionada (por área/talhão) e assíncrona, conforme o processamento de cada análise (item) é concluído.
Atualização: Caso um item (code) já tenha sido enviado anteriormente para o mesmo relatório (reportId), o novo envio atualizará os valores existentes no banco de dados.
Tempo Limite: O endpoint de recebimento do callback deve ter um timeout configurado para 30 segundos.
O risco é visualizado em:
Página 1 – Análises e Indicadores de Risco
-
Callback: RISK
Cabeçalho:
-
Borda superior com imagem de fundo
-
Logo Cyan
-
Conformidade Geoambiental – (Nome da empresa)
Título: Conferência de Conformidade Geoambiental
Tabela de Análises:
2 - Estrutura do Payload
Além de retornar a Callback de RISK para o risco do relatório socioambiental — considerando tanto o risco geral quanto o risco por análise —, também será retornado para o risco do relatório de monitoramento.”
-
EXEMPLO:
{
"reportRequestId": 3755,
"reportVersion": 1,
"createdAt": "2025-05-07 20:04:17",
"risk": "HIGH"
"riskList": [
{
"code": "GEOGRAPHIC_LOCATION_ANALYSIS",
"risk": "HIGH"
"notes": "Área contratada está em mais de um município"
},
{
"code": "SLAVE_LABOR_LIST",
"risk": "HIGH"
"notes": "CPF/CNPJ está no Cadastro de Empregadores que tenham submetido trabalhadores a condições análogas à de escravo"
},
{
"code": "INDIGENOUS_LANDS_OVERLAP",
"risk": "HIGH"
"notes": "> ou igual 1% da área"
},
{
"code": "QUILOMBOS_OVERLAP",
"risk": "HIGH"
"notes": "> ou igual 1% da área"
},
{
"code": "AGRARIAN_REFORM_SETTLEMENTS_OVERLAP",
"risk": "HIGH"
"notes": "> ou igual 1% da área"
},
{
"code": "PROTECTED_AREA_OVERLAP",
"risk": "HIGH"
"notes": "> ou igual 20% da área"
},
{
"code": "IBAMA_EMBARGO_LIST_CAR",
"risk": "HIGH"
"notes": "> ou igual 1% da área"
},
{
"code": "ICMBIO_EMBARGO_LIST_CAR",
"risk": "HIGH"
"notes": "> ou igual 1% da área"
},
{
"code": "PRIVATE_NATURAL_PROPERTY_RESERVE",
"value": "HIGH"
"notes": "> ou igual 1% da área"
},
{
"code": "LEGAL_RESERVE",
"value": "HIGH"
"notes": "> ou igual 20% da área"
},
{
"code": "BIOME",
"value": "HIGH"
"notes": "> ou igual 1% da área"
},
{
"code": "PERMANENT_PROTECTION_AREA",
"value": "HIGH"
"notes": "> ou igual 1% da área"
},
{
"code": "RURAL_ENVIRONMENTAL_REGISTRY_ENROLLMENT",
"value": "HIGH"
"notes": "> ou igual 1% da área"
},
{
"code": "LABOR_DEBT_BY_CPF",
"value": "HIGH"
"notes": "Situação do débito trabalhista por CPF."
},
{
"code": "LABOR_DEBT_BY_CNPJ",
"value": "HIGH"
"notes": "Situação do débito trabalhista por CNPJ."
}
]
}
3 - Catálogo de Itens de Risco Disponíveis
Abaixo estão listados os códigos (code) disponíveis, categorizados pelo tipo de análise, e suas respectivas descrições e estruturas de dados.
IBAMA_EMBARGO_LIST_CAR
-
DESCRIPTION:
-
Embargos do IBAMA (CAR) na área.
-
ICMBIO_EMBARGO_LIST_CAR
-
DESCRIPTION:
-
Embargos do ICMBio (CAR) na área.
-
STATE_EMBARGO_LIST
-
DESCRIPTION:
-
Embargos de órgãos ambientais estaduais.
-
SLAVE_LABOR_LIST
-
DESCRIPTION:
-
Ocorrência de Trabalho Escravo.
-
LABOR_DEBT_BY_CPF/CNPJ
-
DESCRIPTION:
-
Débito Trabalhista (TST) associado.
-
PROTECTED_AREA_OVERLAP
-
DESCRIPTION:
-
Sobreposição com Áreas Protegidas (geral).
-
INDIGENOUS_LANDS_OVERLAP
-
DESCRIPTION:
-
Sobreposição com Terras Indígenas.
-
QUILOMBOS_OVERLAP
-
DESCRIPTION:
-
Sobreposição com Territórios Quilombolas.
-
RURAL_ENVIRONMENTAL_REGISTRY_ENROLLMENT
-
DESCRIPTION:
-
Status de inscrição do CAR (Cadastro Ambiental Rural).
-
OVERLAP_WITH_FULL_PROTECTION_CONSERVATION_UNITS
-
DESCRIPTION:
-
Sobreposição com Unidades de Conservação de Uso Sustentável.
-
PERMANENT_PROTECTION_AREA
-
DESCRIPTION:
-
Análise e Geometria da Área de Preservação Permanente (APP).
-
LEGAL_RESERVE
-
DESCRIPTION:
-
Análise e Geometria da Reserva Legal.
-
BIOME
-
DESCRIPTION:
-
Bioma predominante na área.
-
VEGETATION_OVERLAP
-
DESCRIPTION:
-
Sobreposição com áreas de vegetação nativa.
-
FLOODING_SUSCEPTIBILITY_AREA
-
DESCRIPTION:
-
Mapeamento de áreas com susceptibilidade a inundações.
-
DEFORESTATION_NEW_AREAS
-
DESCRIPTION:
-
Identificação de novos desmatamentos na área.
-
LAND_USE
-
DESCRIPTION:
-
Mapeamento do uso do solo na área.
-
ELEVATION_GEOMETRY
-
DESCRIPTION:
-
Geometria, imagem de declividade (SLOPE), curvas de nível (CONTOUR_CURVES).
-
LOCATION_OVERLAP
-
DESCRIPTION:
-
Listagem de municípios com intersecção com a área.
-
DENSE_VEGETATION
-
DESCRIPTION:
-
Análise de presença de vegetação densa.
-
CLIMATOLOGY_DAILY
-
DESCRIPTION:
-
Média histórica (30 anos) de chuva e temperatura.
-
CLIMATE_DAILY
-
DESCRIPTION:
-
Dados diários reais de chuva e temperatura da safra atual.
-
GROWTH_STAGE
-
DESCRIPTION:
-
Estimativa das datas dos estádios fenológicos.
-
CROP_BIOMASS
-
DESCRIPTION:
-
Evolução da biomassa (NDVI Diário) da safra atual.
-
PREVIOUS_FROST/HAIL
-
DESCRIPTION:
-
Histórico de Geada/Granizo dos últimos 5 anos.
-
FROST/HAIL_FORECAST
-
DESCRIPTION:
-
Previsão de Geada/Granizo para os próximos 5 dias.
-
HISTORICAL_NDVI
-
DESCRIPTION:
-
Evolução do Índice de Vegetação dos últimos 5 anos.
-
ZARC_TABLE
-
DESCRIPTION:
-
Tabela de janela de plantio (ZARC) em decêndios.
-
TRACKING_NDVI
-
DESCRIPTION:
-
Monitoramento da safra atual (imagem de histórico e marcações).
-
ZARC_SOIL_0_TO_60CM
-
DESCRIPTION:
-
Avaliação geoespacial do tipo de solo por profundidade.
-
