Checklist de Chamado — Sistemas Delphi Desktop

---
title: Checklist de Chamado — Sistemas Delphi Desktop
slug: checklist-sistemas-delphi-desktop
categoria: user_manual
visibilidade: public
tipo: checklist
publico: "Suporte 1º nível e Suporte 2º nível"
chamado: "0000581549"
---

# Checklist de Chamado — Sistemas Delphi Desktop

> 🖥️ **Vale para:** os sistemas Delphi desktop da Teorema. Hoje: Gestão Administrativa, Gestão de Pessoal / eSocial, Gestão Fisco-Contábil e Balcão - Caixa - OS. Outros sistemas entram nesta lista conforme forem incluídos.
> 📘 **Complementa:** [Boas Práticas de Chamados — Suporte e 2º Nível](https://docs.teorema.inf.br/doc/01a15a59-2018-72b5-858c-9be04c546c64). As 4 regras gerais continuam valendo.
> 🎯 **Objetivo:** o 2º nível chega **na tela certa, no registro certo, na base certa** sem precisar voltar ao cliente

---

## ⏱️ Em 30 segundos

| | Bloco | O que não pode faltar |
|:---:|---|---|
| 🗂️ | **Identificação** | Número da empresa, base do cliente e a transação (chave do registro) |
| 🧭 | **Menu** | O caminho completo até a tela. É o item que **mais falta** nos chamados |
| 🐞 | **Se for erro** | Desde quando, o que mudou, se simulou em teste, se é uma máquina só |
| 🛠️ | **Se for alteração** | Específica ou melhoria geral? Replicável? **Qual a justificativa?** |

---

## 🗂️ 1. Identificação — sem isso o 2º nível não reproduz

| Item | Como informar | ⚠️ Cuidado |
|---|---|---|
| 🏢 **Número da empresa** | Código da empresa no sistema | Clientes com várias empresas: diga **qual**. O erro pode existir só numa delas |
| 💾 **Base do cliente** | Base atual enviada ao FTP, com data | Base antiga mostra o problema de outra época |
| 🔢 **Chave do registro** | Em movimentos, normalmente a **transação**. Em cadastros, o código (item, cliente, funcionário) | "A nota da semana passada" não identifica registro nenhum |

> 💡 **Por que a transação importa:** com ela, o 2º nível abre o registro exato na base em
> segundos. Sem ela, começa procurando, e pode encontrar outro registro parecido.

---

## 🧭 2. Indicação do menu — o item que mais falta

Informe o **caminho completo** até a tela, do módulo ao campo ou botão, separado por `>`.

| ❌ Chega assim | ✅ Deve chegar assim |
|---|---|
| "Na tela de itens" | Gestão Administrativa: **Cadastros > Itens de Estoque > Itens (F2) > Aba 1 Classificação > 4 Adicionais > Dados Principais > Integração** |
| "No recálculo" | Caminho do menu **até a tela** + nome do **botão** usado (ex.: botão "Recalcular" no detalhe do item) |

- [ ] 🧭 Caminho do menu completo, do módulo até a tela
- [ ] 🔘 Nome do botão, aba ou campo onde o problema acontece
- [ ] 🖼️ Print da tela **com o menu visível**, como complemento ao caminho escrito

> ⚠️ **Por que escrito e não só print:** o mesmo nome de tela existe em módulos diferentes.
> O caminho escrito tira a dúvida, e a busca do Jarvis encontra chamados antigos da mesma
> tela.

---

## 🐞 3. Se for um erro

Algo mudou para o erro aparecer. Descubra o quê:

| Pergunta | Por que importa |
|---|---|
| 📅 **A partir de quando passou a acontecer?** | Separa um erro novo de um antigo que só agora foi notado |
| ⬆️ **Houve atualização do sistema** nesse período? | Aponta para uma mudança nossa: informe a versão anterior e a atual |
| 💻 **Algum evento diferente?** Máquina formatada, troca de computador, rede, Windows, impressora | Muitos "erros do sistema" começam num evento do ambiente |
| 🧪 **Conseguiu simular em um ambiente de teste?** | Simulou: é do sistema ou da base. Não simulou: é do ambiente do cliente |
| 🖥️ **Acontece só em uma máquina?** | Uma máquina só leva ao ambiente; todas levam ao sistema ou à base |

> 🧪 **Simular em teste vale mais que qualquer print.** Se simulou, descreva os passos. Se
> não simulou, diga o que tentou.

---

## 🛠️ 4. Se for uma alteração de sistema

| Pergunta | O que responder |
|---|---|
| 🎯 **É algo específico ou uma melhoria geral?** | Específico: atende só este cliente. Geral: melhora o sistema para todos |
| 🔁 **O Agente acredita que a alteração é replicável?** | Outros clientes usariam? Cite quais, se souber |
| 📝 **Qual a justificativa?** | O **problema de negócio** que o cliente quer resolver, e não só a solução que ele pediu |

### 📝 Por que a justificativa é tão importante

Muitas vezes o cliente pede uma **solução** sem perceber que a funcionalidade já pode existir
por outro caminho. Com a **justificativa**, o 2º nível e o desenvolvimento conseguem sugerir
uma alternativa. Às vezes nem é preciso alterar nada.

| | Pedido do cliente | Justificativa (o problema real) |
|---|---|---|
| ❌ **Sem justificativa** | "Colocar um menu de opções no botão Recalcular" | *(não informada)* |
| ✅ **Com justificativa** | "Colocar um menu de opções no botão Recalcular" | "O recálculo de ICMS/PIS/COFINS/IPI também altera IBS e CBS, que precisam ficar como vieram no XML do fornecedor" |

> 💡 Com a justificativa, a pergunta muda de *"como fazer o menu?"* para *"como recalcular
> sem mexer no IBS/CBS?"*. Essa segunda pergunta pode ter outra resposta, talvez mais simples.

- [ ] 🎯 Indicado se é específico do cliente ou melhoria geral
- [ ] 🔁 Opinião do Agente sobre se a alteração é replicável
- [ ] 📝 Justificativa: o problema de negócio, com um exemplo real do dia a dia do cliente
- [ ] ✒️ Aprovação formal do solicitante (regra geral de alteração)

---

## ✅ Checklist completo — copie para o chamado

```
SISTEMAS DELPHI DESKTOP — dados para o 2º nível
[ ] Sistema / módulo: 
[ ] Número da empresa: 
[ ] Base do cliente (data): 
[ ] Chave do registro (transação ou código): 
[ ] Menu completo (Módulo > ... > Tela > botão/campo): 
[ ] ERRO - desde quando: 
[ ] ERRO - atualização do sistema / máquina formatada / outro evento: 
[ ] ERRO - simulou em ambiente de teste? (passos): 
[ ] ERRO - acontece só em uma máquina?: 
[ ] ALTERAÇÃO - específica do cliente ou melhoria geral: 
[ ] ALTERAÇÃO - replicável para outros clientes? (opinião do Agente): 
[ ] ALTERAÇÃO - justificativa (problema de negócio): 
```

---

## 📚 Manuais relacionados

| 📖 Manual | Para quê |
|---|---|
| [Boas Práticas de Chamados — Suporte e 2º Nível](https://docs.teorema.inf.br/doc/01a15a59-2018-72b5-858c-9be04c546c64) | As 4 regras gerais: resumo, coerência, problema e encaminhamento |
| [Atendimento Suporte Tecnico](https://docs.teorema.inf.br/doc/a9ead47a-64dd-11f1-9f2f-0242ac1a0002) | Teste na última release, envio da base atualizada ao FTP e o que o 2º nível deve receber |
| [Atualização de Versão do Teorema](https://docs.teorema.inf.br/doc/5ad30d86-64dc-11f1-b438-0242ac1a0002) | Gerar backup e restaurar a base de dados |

---

> 🔒 **Fonte de verdade:** este documento no Jarvis/Redline.