Manual do Usuário · Nucci Center Cargo · Análise de Ocorrências

1 · Sobre o sistema

O Sistema de Análise de Ocorrências da Nucci Center Cargo é uma ferramenta web que ajuda a equipe a integrar dois sistemas de ocorrências de entrega:

O modelo principal Nucci Center Cargo (sistema interno Proceda) — com 77 ocorrências cadastradas
O modelo do e-commerce TRILOG/CCM — com 97 ocorrências de pedidos online

O sistema mostra o que precisa ser feito para que os dois sistemas falem entre si via integração SSW, sem perder eventos nem disparar regras erradas.

📊 Em números Das 97 ocorrências do e-commerce: 19 já estão cobertas pelo Nucci, 10 precisam de ajustes em registros existentes, e 68 precisam ser cadastradas como novas. Há também 47 problemas internos na base Nucci (ID Real duplicado, EPIs misturados, typos, ocorrências críticas inativas) que precisam ser corrigidos antes da integração.

2 · Como acessar

O sistema fica em:

https://nucci.chronyx.com.br

Funciona em qualquer navegador moderno (Chrome, Firefox, Edge, Safari). Não precisa instalar nada, não precisa login. Tudo rodando seguro com HTTPS.

✓ Funciona offline Se você baixar a página (Ctrl+S → "Página da web, completa"), o sistema continua funcionando sem internet. Os dados estão embutidos no HTML.

3 · A interface

Sidebar à esquerda

Menu lateral fixo com 9 abas. Em telas pequenas (mobile/tablet), o menu vira hamburger no canto superior esquerdo do header.

Aba	O que tem
✓ Plano de Ação	Aba inicial. Diagnóstico geral + 3 passos para integrar + validador de arquivo
📄 Resumo Executivo	Visão de alto nível, ideal para gestão
⚠ Auditoria Principal	47 problemas encontrados na base Nucci atual
🛒 Auditoria E-commerce	102 problemas na base TRILOG/CCM
❓ Ambiguidades	32 ocorrências com nomes diferentes mas mesma função
+ Gaps a Cadastrar	78 ocorrências que precisam ser inseridas/ajustadas
🔄 Comparação	Tabela completa lado a lado
📦 Modelo Principal	Lista das 77 ocorrências cadastradas no Nucci
▦ Modelo E-commerce	Lista das 97 ocorrências do TRILOG/CCM
⬇ Exportações	9 arquivos Excel para download

Header (topo)

Logo + título + botão "Exportações" no canto direito (atalho rápido).

4 · Plano de Ação — 3 passos

É a aba mais importante. Resume tudo que precisa ser feito.

Diagnóstico (cabeçalho)

5 KPIs no topo:

Modelo Principal: 77 — ocorrências cadastradas no Nucci
Modelo E-commerce: 97 — ocorrências do TRILOG/CCM
Já cobertas: 19 — equivalência semântica clara
Cobertura parcial: 10 — requer ajustes
A cadastrar: 68 — gap absoluto

Logo abaixo: comparativo visual das duas bases, com status global (Pronto / Não pronto para integrar) e diagnóstico em uma linha.

Corrigir o modelo do E-commerce

O modelo TRILOG/CCM tem 9 divergências SSW (descrição local diferente da SSW real), 14 erros (descrições truncadas em 40 caracteres) e 77 atenções (sem mapeamento SSW, sem flags de fluxo, asterisco órfão).

Clique no badge "102 problemas" pra ver tudo detalhado em uma tabela com filtros.

Baixe os arquivos por severidade (Crítico, Erro, Atenção, Info) para tratar com a equipe responsável pelo TRILOG/CCM.

Sanear o modelo Nucci atual

A base Nucci Center Cargo tem 9 críticos (IDs Real duplicados em 19/101 e 821/822, EPIs misturados em 821-825), 5 typos (DUPLICIDDADE→DUPLICIDADE, MARCADORIA→MERCADORIA, CTC→CTRC, COBRACA→COBRANÇA), e 32 atenções.

Pontos importantes para reativar:

ID 91 — Entrega Programada/Agendamento (fluxo central de e-commerce)
ID 826 — Entrega em atraso por falha da transportadora (KPI de SLA)
ID 24 — Entrega barrada pelo remetente
ID 37 — CTRC emitido para efeito de cobrança (corrigir typo + reativar)

Cadastrar 68 novos + ajustar 10 existentes no Nucci

Botão grande vermelho "⬇ Baixar Plano de Cadastro" faz o download do arquivo nucci_cadastrar.xlsx com 3 abas:

CADASTRAR (68 novos) — INSERT direto, com todos os campos do modelo Proceda
AJUSTAR (10 existentes) — UPDATE em registros que já existem (reativar/renomear/mapear SSW)
INSTRUÇÕES — guia rápido para o time de TI

🔗 Regra de ouro da integração O ID Real (SSW) no Nucci precisa ser igual ao COD do e-commerce. Quando o sistema do e-commerce dispara, por exemplo, COD 31 (1ª tentativa de entrega), o Nucci só reconhece se houver uma ocorrência cadastrada com ID Real = 31. O plano de cadastro já mapeia isso para todos os 78 itens.

5 · Auditorias

Há duas abas de auditoria — uma para cada lado da integração:

Auditoria Principal (Nucci)

47 problemas internos da base Nucci atual, agrupados por severidade:

🔴 9 Crítico — bloqueantes (ID Real duplicado, EPIs misturados)
🟠 5 Erro — ortografia (typos)
🟡 32 Atenção — configuração subótima (inativos críticos, ID Real=0)
🔵 1 Info — observações de organização

Auditoria E-commerce

102 problemas no modelo TRILOG/CCM:

🔴 9 Crítico — divergências SSW (descrição local diferente da SSW)
🟠 14 Erro — descrições truncadas + PROCESSO inconsistente
🟡 77 Atenção — sem mapeamento SSW, sem flags, asterisco órfão
🔵 2 Info — gaps de numeração

Cada item da tabela mostra:

Severidade (badge colorido)
Categoria (tipo de problema)
IDs afetados (códigos clicáveis)
Descrição estruturada (mini-tabela ou callout, dependendo da categoria)

📋 Mini-tabelas comparativas Nas divergências SSW, aparece uma tabela LOCAL × SSW com a descrição lado a lado, deixando claro o que precisa alinhar. Em descrições truncadas, aparece Atual → Sugerida.

6 · Ambiguidades

32 ocorrências do e-commerce que têm a mesma funcionalidade que ocorrências da Nucci, mas estão escritas com nomes diferentes.

Distribuição

Confiança	Qtd	Significado
🟢 Alta	20	Mesma funcionalidade — usar o ID Nucci existente
🟡 Média	11	Sobreposição parcial — analisar caso a caso
⚪ Baixa	1	Não é ambiguidade real (gap legítimo)

Como ler cada card

Cada ambiguidade aparece como um cartão lado-a-lado:

Esquerda (vermelho): ocorrência do e-commerce — COD, descrição, tipo, processo
Centro: seta de comparação ⇄
Direita (azul): ocorrência equivalente no Nucci — ID, descrição, situação, ativo
Observação: análise técnica do que se sabe sobre o par
Ação recomendada: o que fazer

Exemplo de alta confiança

E-com COD 1 "MERCADORIA ENTREGUE"  ⇄  Nucci ID 1 "ENTREGA EFETUADA"

Observação: ambos representam a entrega concluída ao destinatário.
Ação: usar Nucci ID 1. Considerar padronizar a descrição.

⚠ Ambiguidade ≠ duplicação Algumas ambiguidades aparentes são opostos (ex.: COD 14 "ENTREGA PARCIAL EFETUADA" × Nucci 71 "CLIENTE NÃO RECEBE PARCIAL"). Nesses casos, é correto manter ambos os registros separados.

7 · Exportações

Total: 9 arquivos Excel, todos com logo Nucci e padrão de cores.

Auditoria do E-commerce (4 arquivos)

Arquivo	Severidade	Itens
`ecommerce_critico.xlsx`	🔴 Crítico	9
`ecommerce_erro.xlsx`	🟠 Erro	14
`ecommerce_atencao.xlsx`	🟡 Atenção	77
`ecommerce_info.xlsx`	🔵 Info	2

Auditoria do Nucci (4 arquivos)

Arquivo	Severidade	Itens
`nucci_principal_critico.xlsx`	🔴 Crítico	9
`nucci_principal_erro.xlsx`	🟠 Erro	5
`nucci_principal_atencao.xlsx`	🟡 Atenção	32
`nucci_principal_info.xlsx`	🔵 Info	1

Plano de Cadastro (1 arquivo, 3 abas)

nucci_cadastrar.xlsx — o arquivo principal que o time de TI usa para importar no Proceda:

Aba	Conteúdo	Operação
CADASTRAR (68 novos)	14 colunas no formato Proceda	INSERT
AJUSTAR (10 existentes)	Antes/depois de cada campo a alterar	UPDATE
INSTRUÇÕES	Guia para o time de TI	Leitura

8 · Validador de Arquivo Proceda

Depois que o time de TI importar os 68 novos cadastros + os 10 ajustes no Proceda, exporta o novo arquivo .xls e valida automaticamente nesta seção.

Como usar

Vá para a aba ✓ Plano de Ação
Role até a seção "Validar arquivo Proceda" no final
Arraste o arquivo na zona de drop, ou clique em "selecionar arquivo"
Aguarde a análise automática

Resultado: nota de qualidade 0–100

Score	Status	Significado
90–100	🟢 Pronto	Pode integrar e-commerce
75–89	🟡 Quase lá	Resolver alertas amarelos
50–74	🟠 Insuficiente	Aplicar correções listadas
0–49	🔴 Reprovado	Refazer correções

10 verificações automáticas

Volume de registros (≥145)
Estrutura de colunas (14 colunas Proceda)
ID Real único (sem duplicatas)
Domínio limpo (sem EPIs)
Ortografia (sem typos conhecidos)
Inativos críticos reativados (IDs 91 e 826)
Padrão da Situação ("NNN - Descrição")
Cobertura do e-commerce (≥90%)
Mapeamento SSW (sem ativos com Real=0)
Sem cadastro acoplado (sem múltiplos "DEPOSITADO TERMINAL X")

Edição interativa

Se o arquivo tiver problemas, clique em qualquer check com a seta ▸. Vai abrir um painel embaixo com:

Cada linha problemática listada (ID + Descrição)
Campo editável com o valor atual
Botão "Sugestão: X" para preencher automaticamente o valor recomendado
Botão verde "Salvar" para aplicar a correção
Botão "⚡ Aceitar todas as sugestões" para correção em massa

Após salvar, a validação roda automaticamente e o score atualiza com diff visível (ex.: "▲ +12 pontos").

Download do arquivo corrigido

Quando houver alterações, aparece um botão "⬇ Baixar arquivo corrigido (.xls)" no card de score. O arquivo gerado é compatível com o formato Proceda original e pode ser reimportado.

🔒 Privacidade Tudo é processado localmente no navegador. Nada é enviado para servidores. Útil para arquivos com dados internos da empresa.

9 · Como integrar (para o time de TI)

Fluxo completo

Baixar nucci_cadastrar.xlsx da seção Exportações
Aba CADASTRAR → cada linha é um INSERT no Proceda
Aba AJUSTAR → cada linha é um UPDATE no ID indicado, modificando apenas os campos que têm valor "novo"
Após importação, exportar o novo arquivo do Proceda
Validar nesta plataforma para garantir que está 100% correto
Configurar a integração SSW (campo ID Real = COD do e-commerce)

Exemplo SQL (referência)

-- Aba CADASTRAR vira INSERTs (68 vezes)
INSERT INTO ocorrencias (
  id, descricao, id_real, tipo, processo, situacao,
  ativo, finaliza, mobile, ...
) VALUES (
  110, 'AGUARDANDO AGENDAMENTO DO CLIENTE', 35, 'CLIENTE',
  'AGENDAMENTO', '160 - Agendado', 'Sim', 'Não', 'Não', ...
);

-- Aba AJUSTAR vira UPDATEs (10 vezes)
UPDATE ocorrencias SET ativo='Sim', id_real=15 WHERE id=91;
UPDATE ocorrencias SET id_real=4 WHERE id=29;
UPDATE ocorrencias
   SET ativo='Sim',
       descricao='CTRC EMITIDO PARA EFEITO DE COBRANCA',
       id_real=93
 WHERE id=37;

Observações importantes

IDs sugeridos para os 68 novos começam em 110. Se algum desses já estiver em uso na base atual, ajustar para o próximo livre.
Os campos Cobra Reentrega e Paga Entrega ficam em Não por padrão de segurança — ajustar conforme regra comercial.
Os campos Finaliza, Mobile, Resp. Cliente, Resp. Transportador, Gera RNC seguem padrão observado em ocorrências similares já existentes.

10 · Glossário

Proceda

Sistema interno de gestão de ocorrências da Nucci Center Cargo. Modelo principal com 77 ocorrências cadastradas.

TRILOG / CCM

Sistema de e-commerce que gera as ocorrências de pedidos online. 97 ocorrências.

SSW

Padrão de integração entre transportadoras e e-commerces no Brasil. Define códigos numéricos para eventos (entrega efetuada, recusa, devolução, etc).

ID Real

Campo no modelo Proceda que armazena o código SSW correspondente. Tem que ser igual ao COD do e-commerce para a integração funcionar.

CTRC

Conhecimento de Transporte Rodoviário de Cargas. Documento fiscal padrão do transporte rodoviário no Brasil. NÃO é "CTC" (typo comum).

RNC

Registro de Não Conformidade. Indica que uma ocorrência gera um documento de não conformidade no sistema.

EPI's

Equipamentos de Proteção Individual (capacete, óculos, luva, farda, bota). NÃO são ocorrências de entrega — devem ficar em tabela separada.

EXISTS / PARTIAL / MISSING

Status de mapeamento de cada ocorrência do e-commerce: EXISTS (já existe equivalente), PARTIAL (existe similar mas precisa ajuste), MISSING (gap real).

Fluxo COLETA

Conjunto de eventos relacionados à coleta da mercadoria no remetente (agendamento, comandada, 1ª/2ª/3ª tentativa, realizada, cancelada). Não existe no Nucci atual.

Cadastro acoplado

Anti-padrão onde uma única operação (ex.: "depositado terminal") é cadastrada como múltiplas ocorrências distintas (uma por filial), em vez de uma ocorrência genérica com a filial como parâmetro.

11 · Perguntas frequentes

Por que tem 78 itens no plano de cadastro se são só 68 faltantes?

São 68 cadastros novos (INSERT) + 10 ajustes em registros já existentes (UPDATE). O arquivo separa essas duas operações em abas distintas (CADASTRAR e AJUSTAR).

Posso confiar 100% que os 68 são realmente novos?

Sim. Foi feita uma busca exaustiva de cada um dos 68 contra TODA a base Nucci (77 ativos+inativos) usando 4 estratégias de matching (Jaccard, sinônimos do domínio, substring, radicais). Os 18 candidatos com score moderado foram revisados manualmente e descartados. Resultado: 100% confirmados como gaps reais.

Por que aparecem typos como "CTC" e "DUPLICIDDADE"?

São erros de digitação já presentes na base atual da Nucci. O sistema apenas detecta e sugere a correção. Após o saneamento (Passo 2), eles desaparecem.

O que acontece se eu não corrigir os critícos antes da integração?

ID Real duplicado: eventos vindos do SSW caem em ocorrência aleatória. EPIs misturados: não quebra nada, mas polui relatórios. Divergências SSW no e-commerce: evento dispara em ocorrência errada (ex.: SSW publica 71 "GELO TROCADO" e o e-commerce entende "RETIRA COLETA EFETUADA").

Se eu mudar o ID Real de uma ocorrência existente, quebra o histórico?

Pode quebrar integrações antigas que usavam o valor anterior. Por isso a aba "AJUSTAR" precisa ser revisada com o time. Em casos de dúvida, criar duplicata (manter o registro antigo intacto) é mais seguro.

Como sei se a integração está funcionando depois da importação?

Use o validador Proceda nesta plataforma. Score >= 90 = pronto. O validador checa cobertura, mapeamento SSW, integridade e mais 10 itens.

Onde está hospedado o sistema?

Em servidor próprio (Zeus, infraestrutura Chronyx). Domínio: nucci.chronyx.com.br. HTTPS via Let's Encrypt, renovação automática.

Posso baixar este manual?

Sim. Use Ctrl+P (imprimir) → "Salvar como PDF". O CSS está otimizado para impressão (sumário lateral é ocultado automaticamente).