Operação e suporte

Última atualização: 23/07/2026

Rotina diária

1. Verificar GET /api/v1/health.
2. Conferir a última sincronização Protheus e CNPJs com falha.
3. Verificar pendências novas no Validador NF.
4. Conferir dias aguardando validação.
5. Validar uma amostra de vendas no Analítico.
6. Confirmar que tablet e visão do vendedor estão acessíveis.

Rotina semanal

1. Revisar logs de integração e reprocessamentos.
2. Acompanhar volume de pendências por loja.
3. Verificar vendedores sem código de PDV, loja ou vigência.
4. Conferir feriados e ausências das próximas semanas.
5. Revisar metas que ainda estão em rascunho.
6. Registrar falhas repetidas e ações corretivas.

Rotina mensal

1. Antes da virada, revisar lojas, vendedores, férias, lotações e feriados.
2. Criar e publicar metas do mês seguinte.
3. Após o fechamento automático, conferir o log do mês anterior.
4. Comparar o Analítico com uma extração oficial do Protheus.
5. Resolver divergências de NF e concluir validações pendentes.
6. Gerar backup e guardar conforme a política de retenção definida.

Backup antes de operação de risco

É obrigatório fazer backup antes de:

• reset de dados;
• exclusão ou recarga histórica;
• importação massiva de metas;
• migration com transformação de dados;
• correção SQL manual.

Exemplo no servidor PostgreSQL:

pg_dump \
  --format=custom \
  --file="gv-dbai-$(date +%Y%m%d-%H%M).dump" \
  "$DATABASE_URL"

O comando deve ser executado em ambiente seguro, sem imprimir a URL do banco em atas, documentos ou gravações. A restauração deve ser testada periodicamente em uma base isolada.

Evidências para chamado

Ao abrir um chamado, informe:

• ambiente e URL;
• perfil do usuário, sem senha;
• data e hora com fuso;
• loja, vendedor, período e NF envolvidos;
• passos para reproduzir;
• resultado esperado e resultado observado;
• captura da tela sem dados sensíveis;
• identificador do log de integração, quando aplicável;
• resposta HTTP e request-id, se disponível.

Prioridade de incidentes

Diagnóstico rápido

Sessão expirada

Sintoma: respostas 401 ou tela sem permissão após atualização.
Ação esperada: o frontend limpa a sessão e redireciona para /login. Se não ocorrer, limpe o armazenamento do site, entre novamente e abra um chamado com a rota.

Protheus sem atualizar

1. Confirmar PROTHEUS_SYNC_ENABLED.
2. Consultar status e último log.
3. Se nenhum CNPJ conectou, o log deve estar como Falha, não Parcial.
4. Em Configurações > Integrações, informar a credencial atual e testar a conexão.
5. Salvar somente quando o teste for aceito.
6. Testar sincronização manual de um dia e um CNPJ.
7. Reprocessar o log somente depois de corrigir a causa.
8. Para vários períodos acumulados, usar Recuperar períodos com erro e acompanhar a cobertura de CNPJs no log. O lote ocorre em segundo plano, consolida períodos repetidos e para após três falhas consecutivas.

Divergência de total

1. Usar exatamente o mesmo período.
2. Conferir filtros de loja, vendedor, origem e estado.
3. Listar NFs excluídas de indicadores.
4. Verificar devoluções.
5. Conferir Validador NF e Analítico.
6. Comparar por chave documental, não apenas pelo total mensal.

Meta incorreta

1. Conferir loja e mês.
2. Verificar calendário da loja.
3. Verificar férias, ausências e lotações.
4. Abrir distribuição por vendedor e por dia.
5. Conferir se a meta foi publicada.

Tablet não sincroniza

1. Confirmar conexão.
2. Validar dispositivo e loja.
3. Consultar /tablet/sync-status.
4. Conferir quantidade de eventos com falha.
5. Não apagar dados locais antes de registrar evidências.

Segurança operacional

• Não compartilhar senhas em documentos ou gravações.
• Não usar conta de administrador para operação diária de loja.
• Inativar acessos quando o vínculo terminar.
• Registrar transferências e ausências em vez de alterar histórico.
• Não corrigir vendas diretamente no banco.
• Não executar reset em produção sem backup e autorização registrada.