Suporte Okai

Aplica-se a: Consulta de status de reguladores, fontes oficiais, coleta, ingestão, atualização da Biblioteca de Normas, indexação da busca e abertura de chamado com evidências.

Status mostra a cadeia, não só a presença da norma

Use o status de reguladores e fontes quando uma publicação oficial parece não ter chegado à Okai, quando precisa explicar uma diferença de datas ou quando quer saber se a base está sendo atualizada antes de abrir um chamado. O status ajuda a separar ausência real de dado, atraso de coleta, processamento pendente, falha de fonte ou restrição do seu workspace.

Uma norma não aparece instantaneamente em todo o produto. Primeiro ela precisa existir na fonte oficial acompanhada, depois ser coletada, validada e cadastrada conforme o pipeline aplicável, disponibilizada na Biblioteca e indexada para pesquisa e filtros. Cada etapa pode ter cadência e sinal próprio.

A consulta de status é útil justamente porque muda a pergunta. Em vez de partir de 'a Okai não tem esta norma', você consegue investigar: a fonte é acompanhada, a publicação já saiu no canal oficial, a última atualização cobre a data da publicação, a Biblioteca recebeu o item e a busca já foi atualizada.

Ponto de partida correto: Trate o portal, diário, página de normas, API ou repositório oficial do regulador como referência primária. Notícia, newsletter, rede social, clipping e cópia em site de terceiros podem indicar uma mudança, mas não substituem o link oficial na investigação.

O que conferir no status

Ao abrir a área de status, leia os campos como pistas da etapa em que a informação está. O nome do regulador sozinho não basta: fontes diferentes do mesmo órgão podem ter cadências diferentes, conteúdos diferentes e disponibilidade diferente.

• Regulador ou fonte acompanhada: confirma se aquela origem faz parte do escopo monitorado pela Okai.
• Canal da fonte: diferencia diário oficial, página institucional, sistema próprio, repositório de atos, API, boletim ou outro endereço usado como origem.
• Última coleta ou atualização concluída: indica até que ponto a origem foi verificada com sucesso.
• Status operacional: ajuda a identificar fonte normal, fonte instável, atraso conhecido, indisponibilidade externa, erro de coleta ou manutenção planejada.
• Escopo do conteúdo: mostra se a fonte cobre todos os atos do regulador ou apenas um subconjunto, como normas, comunicados, consultas públicas, ofícios ou materiais técnicos.
• Observações de atraso: explicam mudanças recentes na fonte, instabilidade do portal, alteração de layout, volume atípico de publicações ou necessidade de revisão antes de liberar dados.

Mesmo regulador, fontes diferentes: Não conclua que todo o regulador está atualizado só porque uma fonte dele está saudável. Um órgão pode publicar normas em mais de um canal, e o item procurado pode pertencer a uma fonte específica ainda em processamento ou fora do escopo monitorado.

Antes de concluir que a norma está ausente

1. Confirme a publicação na origem oficial: Abra o link oficial do regulador e verifique número, tipo documental, data de publicação, título e, quando existir, página ou edição do diário. Se só há referência indireta, acompanhe como sinal preliminar, não como ausência comprovada na Okai.
2. Localize a fonte correta no status: Procure pelo regulador e pelo canal usado para aquela publicação. Quando houver mais de uma fonte, escolha a que corresponde ao documento oficial encontrado, não apenas a primeira fonte com nome parecido.
3. Compare a data oficial com a última atualização: Se a publicação saiu depois da última coleta concluída, o cenário mais provável é atraso natural de atualização. Se a coleta já cobre a data e o item ainda não aparece, avance para Biblioteca, busca e escopo.
4. Pesquise na Biblioteca com filtros limpos: Remova filtros antigos e procure por número, ano, regulador e tipo. Teste também variações simples de formatação, como barra, hífen, zeros à esquerda ou ano separado. Isso evita confundir filtro residual com ausência de dado.
5. Separe Biblioteca de busca global: Se o item aparece ao navegar ou abrir a Biblioteca, mas não aparece na busca, o problema provável está na indexação ou nos filtros de pesquisa. Se não aparece em nenhum caminho, investigue fonte, ingestão, classificação, permissão e escopo.
6. Confira workspace, coleções e perfil: Ambiente ativo, permissões, coleções habilitadas e escopo do workspace podem alterar o que fica visível. Teste com o mesmo contexto em que a lacuna foi percebida antes de comparar resultados com outra pessoa.

Data operacional não muda a data normativa: A data de coleta, importação ou indexação serve para diagnosticar a atualização da Okai. Ela não substitui data de publicação, vigência, revogação ou prazo definido no texto oficial.

Como interpretar cenários comuns

A mesma queixa, 'não encontrei a norma', pode ter causas diferentes. Use os sinais abaixo para escolher o próximo passo sem mascarar o problema.

• A fonte está acompanhada, mas a última atualização é anterior à publicação oficial: aguarde a próxima atualização indicada ou acompanhe o status, pois a publicação ainda não entrou na janela processada.
• A fonte está instável ou indisponível: registre o link oficial e o horário da tentativa. O atraso pode estar no portal do regulador ou em mudança de acesso, não na busca.
• A coleta cobre a data da publicação, mas a Biblioteca não mostra o item: trate como possível lacuna de ingestão, curadoria, classificação ou escopo da fonte.
• A Biblioteca mostra o item, mas a busca não encontra: investigue indexação, filtros, termos pesquisados e permissões antes de abrir chamado como norma ausente.
• A busca encontra um item com tipo, regulador ou relação incompatível: não corrija por rótulo visual nem use equivalência improvisada. Reúna evidências para revisão do dado ou da classificação.
• O documento aparece em notícia, mas não na fonte oficial: acompanhe a publicação oficial. A Okai precisa de origem rastreável para sustentar o cadastro regulatório.
• Outro workspace encontra a norma e o seu não: compare escopo, coleções habilitadas, permissões e ambiente ativo antes de tratar como falha geral da base.

A diferença entre atraso e erro: Atraso é quando a cadeia ainda não passou pela etapa necessária. Erro é quando a etapa deveria ter coberto a publicação e mesmo assim o item está ausente, incorreto ou inacessível no contexto adequado.

Evidências que tornam o chamado útil

Abra chamado quando a investigação indicar lacuna persistente, divergência de metadado, fonte oficial já coberta pela atualização ou comportamento diferente entre Biblioteca e busca. Um chamado bom permite reproduzir o caso sem adivinhar qual fonte, filtro ou documento estava em análise.

• Regulador, fonte oficial e link direto para a publicação ou página do ato.
• Número, ano, tipo documental, título e data de publicação informados na fonte oficial.
• Status observado da fonte, incluindo última atualização concluída e qualquer aviso de atraso ou indisponibilidade.
• Termos pesquisados, filtros usados, workspace ativo e caminho testado no produto.
• Resultado esperado e resultado encontrado: ausente, item errado, metadado divergente, busca sem retorno ou Biblioteca diferente da busca.
• Impacto prático: prazo próximo, análise bloqueada, comunicação pendente, evidência regulatória ou necessidade de confirmar uma atualização específica.

Não use atalho visual para resolver dado errado: Se a norma entrou com tipo, regulador, relação ou fonte incorreta, a correção precisa acontecer no dado, na curadoria, no importador, na replicação ou no contrato adequado. Trocar texto na tela ou tratar um tipo como sinônimo de outro aumenta o risco de erro em análises futuras.

Depois da correção ou atualização

Quando uma atualização for concluída ou o suporte indicar correção, valide a cadeia inteira novamente. A confirmação não termina quando o item aparece uma vez; ele precisa estar encontrável pelo caminho certo, com metadados coerentes e fonte rastreável.

1. Abra o detalhe da norma: Confira regulador, tipo, número, datas, ementa, relações e fonte oficial antes de usar o item em análise ou comunicação.
2. Repita a busca original: Use os mesmos termos e filtros que falharam antes. Se a Biblioteca foi corrigida, mas a busca ainda não retornou o item, o diagnóstico muda para indexação ou filtro.
3. Atualize a trilha interna: Se a ausência bloqueou uma tarefa, análise ou resposta, registre quando a norma ficou disponível e qual evidência oficial foi usada para fechar a pendência.

Sinal de fechamento: O caso fica pronto para encerrar quando a fonte oficial está identificada, o status explica a janela de atualização, a norma aparece no contexto esperado e os metadados sustentam a decisão que você precisava tomar.