Quem Somos
Perguntas Frequentes
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."
}
]
}
AGRO ANALYTICS E INFRAESTRUTURA
Monitoramento de Incêndio
Alertas antecipados e rotas otimizadas por meio de câmeras e satélites em áreas de risco.
Nossas soluções para o agro
Callback de Análise de Riscos
SUMÁRIO
-
Visão Geral
-
Estrutura do Payload
-
Catálogo de Itens de Risco Disponíveis
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:
5 - Resumo de Erros e Troubleshooting (FAQ)
"
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.
-
1 - Como acessar o Portal do Suporte
Resposta: Você pode acessar o Portal do Suporte clicando aqui. Ou se preferir, pode acessar o Portal quando logado no dashboard Cyan, clicando no ícone de engrenagem (configurações) no canto inferior da barra lateral, e em seguida, em “Suporte” e “Portal de Suporte”.
2 - Como relatar um problema ou BUG?
Resposta: No Portal do Suporte, clique em “Relatar um problema”. É importante descrever com clareza sobre o problema que está enfrentando. A equipe de suporte receberá seu chamado e responderá o mais rápido possível.
3 - Como solicitar suporte técnico?
Resposta: No Portal do Suporte, clique em “Suporte Técnico”. Informe sua unidade e descreva o contexto da solicitação. Este chamado pode ser usado para solicitação de implementações, como códigos de caminhões, nomes no relatório de incêndio, e até mesmo integrações.
Para problemas mais específicos, selecione a opção “Outras questões”, ou sugira melhorias, clicando em “Sugerir melhoria”.
4 - Níveis de prioridade
Resposta: Ao criar um ticket, o usuário deve selecionar o nível de prioridade da solicitação, de acordo com a urgência e impacto da demanda. A equipe de T.I realizará uma análise criteriosa, em colaboração com a equipe de Produto, para validar a prioridade informada. Caso a prioridade selecionada pelo usuário não esteja condizente com o impacto real da solicitação, o tempo de resolução esperado pode ser diferente. Os níveis de prioridade, tempos estimados de resolução e exemplos de situações são descritos abaixo:
Tempo máximo para a primeira resposta: 2 horas (horário comercial)
-
Muito Alto (Highest)
-
A solicitação é extremamente urgente e crítica, necessitando atenção imediata, pois está causando ou pode causar interrupções significativas em serviços essenciais.
-
Tempo para resolução: Até 5 horas (horário comercial).
-
-
Alto (High)
-
A solicitação é importante e deve ser tratada com prioridade, mas não compromete imediatamente as operações críticas da equipe de T.I.
-
Tempo para resolução: De 1 a 2 dias (horário comercial).
-
-
Médio (Medium)
-
A solicitação é de impacto moderado e não necessita de uma resposta imediata. Pode ser atendida sem comprometer o fluxo de trabalho.
-
Tempo para resolução: De 3 a 7 dias (horário comercial).
-
-
Baixo (Low)
-
A solicitação é de baixa prioridade, com impacto pequeno ou nulo no dia a dia da usabilidade.
-
Tempo para resolução: De 10 a 30 dias (horário comercial).
-
-
Muito Baixo (Lowest)
-
A solicitação é de prioridade mínima, geralmente de impacto insignificante ou que pode ser atendida em janelas específicas de menor atividade.
-
Tempo para resolução: Até 60 dias (horário comercial).
-
5 - Diferenças entre problemas internos do Cyan e problemas de máquina/rede do usuário
Resposta: Aqui estão algumas maneiras de diferenciar entre problemas internos do site e questões relacionadas à máquina ou rede do usuário.
Problemas Internos do Site:
-
Os problemas internos do site geralmente afetam todos os usuários, não apenas um.
-
Mensagens de erro específicas do site, como "Solicitação Incorreta" ou "Erro 404", indicam que o problema está do lado do Cyan.
-
Se outros sites estão funcionando corretamente e apenas um está apresentando problemas, é provável que o problema seja interno ao site do Cyan.
-
Falta de dados (como áreas da unidade em branco nos mapas do Cyan ou gráficos em branco).
Problemas de Máquina ou Rede do Usuário:
-
Se o problema ocorre em um único dispositivo, é mais provável que seja um problema local.
-
Problemas de conexão com a internet, como uma rede lenta ou intermitente, podem ser indicativos de problemas na rede do usuário.
-
Mensagens de erro genéricas, como "Sem conexão com a internet" ou "Página não pode ser exibida", geralmente apontam para problemas do lado do usuário.
-
Páginas do Cyan com erros de carregamento.
-
Falha ao reproduzir vídeos (como o de imagens de satélite no módulo de ‘Previsão’) no dashboard.
Para identificar a origem do problema, o usuário pode tentar acessar o site de diferentes dispositivos ou redes. Se o problema persistir em todos os dispositivos ou redes, é mais provável que seja um problema interno do site. Se o problema ocorrer apenas em um dispositivo ou rede específica, é provável que seja um problema local. É importante contatar a equipe de T.I da usina para validar erros internos e resolvê-los. Se após essa validação, for constatado que o erro é do Cyan, é recomendado abrir um ticket pelo Portal do Suporte.
6 - Horário do Suporte e contatos
-
Suporte Comercial: segunda a domingo, em horário comercial.
-
Suporte de TI: segunda a sexta, em horário comercial.
Portal do Suporte
Quem Somos
Suporte e Ajuda
Perguntas Frequentes
Portal do Suporte
Quer uma solução completa para uma gestão mais eficiente?
Preencha o formulário para que um especialista da Cyan entre em contato com você.
@2026 CYAN ANALYTICS
Rua República do Iraque, 40, conj. 309 - Jardim Oswald Cruz
São José dos Campos - SP
CEP: 12216-540
Avenida Luiz Eduardo Toledo Prado – Vila do Golfe
Torre Empresarial II, nº 870 – Salas 308/309
Ribeirão Preto - SP
CEP: 14.027-250
Atendimento
De segunda a sexta das 8h às 17h
Sábados das 9h às 14h
+55 11 94168-8856
+55 11 3842-9444
+55 11 5583-0652
