Commit 16af9d

2026-10-02 21:10:25 Felipe Madril: -/-
/dev/null .. 12_4 - parâmetros.md
@@ 0,0 1,244 @@
+ # Configurações
+
+ A tela de **Parâmetros** reúne os **parâmetros operacionais** das Ordens de Serviço, dos Chamados, do Financeiro e das Vendas, como o controle das **situações (status)** disponíveis, as regras de conclusão da OS, alertas e texto padrão, o acionamento dos recursos adicionais e a emissão de notas fiscais, além das informações do desenvolvedor e suporte do sistema.
+
+ Acesse pelo menu **Configurações › Parâmetros**. A tela tem as abas **Ordem de Serviço**, **Chamados**, **Financeiro**, **Vendas** *(Novo)*, **Integrações** e **Sobre**.
+
+ > Requer a permissão **"Empresa e parâmetros"**. Com **Visualizar**, a tela abre **somente para consulta** — os campos ficam desabilitados, o botão de salvar some e um aviso no topo informa isso. Para alterar, é preciso **Editar**. Veja [[12_1 - Usuários|12_1 - Usuários]].
+
+ > O grupo **Configurações** do menu reúne **Usuários**, **Assinatura** (o antigo *Meu Plano*), **Empresa** (o antigo *Estabelecimento*) e **Parâmetros** (esta tela).
+
+ ---
+ # Ordem de Serviço
+ ## Parâmetros da OS
+
+ | Configuração | Efeito |
+ |---|---|
+ | **Próximo número da OS** | Número que a próxima OS criada receberá. Serve para continuar uma numeração vinda de outro sistema ou reiniciar a contagem. Não aceita valor menor que o maior número já gravado — ao informar um número abaixo dele, o sistema ajusta para o seguinte, evitando OS com número repetido |
+ | **Modelo de demanda** | Define o que o estabelecimento atende: **Produto/Equipamento**, **Serviço** ou **Ambos**. Determina os campos apresentados na abertura da OS e do chamado (veja abaixo) |
+ | **Ocultar preços na impressão** | Esconde os valores no recibo, orçamento e termo de entrega |
+ | **Número de série obrigatório** | Exige o preenchimento ao criar uma OS |
+ | **Data de fabricação obrigatória** | Exige a data de fabricação ao criar uma OS |
+ | **CPF/CNPJ do cliente obrigatório** | Exige que o cliente tenha CPF ou CNPJ cadastrado |
+ | **Previsão de entrega obrigatória** | Exige a data de previsão de entrega na criação da OS |
+
+ ### Regras de conclusão da OS *(Novo)*
+
+ O que a OS precisa ter para o botão **Concluir OS** levá-la à situação **"Concluído"**. Faltando algo marcado, a OS não é concluída e a tela avisa o que precisa ser informado.
+
+ | Regra | Exige na OS |
+ |---|---|
+ | **Informar valor na OS** | Total maior que zero |
+ | **Informar serviços** | Ao menos um serviço lançado |
+ | **Informar peças** | Ao menos uma peça lançada |
+ | **Informar forma de pagamento** | Forma de pagamento escolhida |
+ | **Exigir assinatura** *(Novo)* | A **assinatura (ou rubrica)** do cliente incluída na OS |
+
+ > A assinatura é colhida na própria OS — desenhada com o mouse, a caneta ou o dedo. Veja [[05 - Ordens de Serviço|05 - Ordens de Serviço]].
+
+ > Com o **Controle Financeiro** ligado e a situação "Concluído" marcada para gerar receita ou despesa, valor e forma de pagamento são exigidos mesmo sem as regras marcadas.
+
+ ---
+
+ ### Situações da OS
+
+ Controle quais **situações (status)** ficam disponíveis para uso nas Ordens de Serviço, defina uma **descrição personalizada** para cada uma e quais **bloqueiam a edição** da OS:
+
+ - **Utilizar** — habilita/desabilita a situação para seleção nas OS. Se **nenhuma** situação estiver marcada como "Utilizar", todas as situações ativas do sistema ficam disponíveis.
+ - **Descrição personalizada** — texto alternativo exibido no lugar do nome padrão da situação (ex.: renomear "Em reparo" para "Em manutenção").
+ - **Situação do chamado** — situação de chamado que acompanha esta situação da OS (veja abaixo). *Disponível apenas com a Central de Chamados ativa.*
+ - **Bloqueia edição** — impede alterações na OS enquanto ela estiver nessa situação (ex.: *Concluída/Entregue*). Só é possível marcar esta opção se a situação estiver habilitada em "Utilizar".
+ - **Baixa estoque** *(Novo)* — a OS que entra nessa situação **dá saída das peças que consumiu** (veja abaixo). Como o "Bloqueia edição", só pode ser marcada em situação habilitada em "Utilizar".
+
+
+ > Apenas o **administrador** do sistema consegue mudar a situação de uma OS bloqueada para desbloqueá-la.
+
+ > **A situação "Cancelado" é fixa.** Ela aparece na lista marcada como **Fixa**, com **"Utilizar"** e **"Bloqueia edição"** sempre ligados e travados, sem "Baixa estoque" (o cancelamento **estorna** as peças), sem geração de receita ou despesa e com o **vínculo de chamado fixo** em **"Cancelado"**. Dela, **só a descrição personalizada é configurável** — quem a aplica é o botão **Cancelar OS**, que exige o motivo, e a volta é a **reabertura** da OS pelo administrador. Veja [[05 - Ordens de Serviço|05 - Ordens de Serviço]].
+
+ > **A situação "Concluído" também é fixa.** Marcada como **Fixa**, tem **"Utilizar"** e **"Bloqueia edição"** sempre ligados e travados. Nela continuam configuráveis a **descrição personalizada**, a **baixa de estoque** e a geração de receita e despesa. O **vínculo com a situação de chamado é fixo**: com a Central de Chamados ligada, a OS concluída leva o chamado que a gerou para **"Concluído"**. Quem a aplica é o botão **Concluir OS**, que confere as regras de conclusão, e a volta é a **reabertura** pelo administrador, com motivo obrigatório.
+
+ #### Baixa de estoque pela OS
+
+ Marcando **Baixa estoque** em uma situação, toda OS que chegar nela dá saída, do cadastro de peças, das **peças vinculadas ao cadastro** que ela consumiu — na quantidade lançada na própria OS. Peça digitada livremente na OS, sem vínculo com o cadastro, não movimenta estoque.
+
+ | Situação | O que acontece |
+ |---|---|
+ | A OS chega a uma situação que baixa | As peças saem do estoque |
+ | A OS passa por uma **segunda** situação que também baixa | Nada é repetido — a baixa é uma só por OS |
+ | Peças são **acrescentadas ou aumentadas** depois da baixa | Só a **diferença** sai do estoque |
+ | A OS **volta** para uma situação que não baixa | **Não** há estorno: a peça já foi usada no atendimento |
+ | A OS é **cancelada** | O que saiu é **devolvido** ao estoque |
+
+ - O **saldo pode ficar negativo** se a OS consumir mais do que havia no cadastro. É intencional: travar em zero esconderia que o estoque estava errado. O negativo aparece destacado nas telas e no alerta de estoque mínimo.
+ - A opção nasce **desligada** para todos — quem já operava sem baixa continua assim até configurar.
+
+ > Sem essa configuração o saldo só muda por digitação, mas continua sendo usado pelo **alerta de estoque mínimo** e pelos **relatórios**. Veja [[10_2 - Controle Estoque|10_2 - Controle Estoque]].
+
+ #### Vínculo com a situação do chamado
+
+ Com a **Central de Chamados** ativa, cada situação da OS ganha a coluna **Situação do chamado**. Escolhendo uma situação ali, toda OS que passar para essa situação leva o **chamado que a gerou** para a situação vinculada, mantendo os dois lados na mesma posição do fluxo.
+
+ - As opções oferecidas são as **situações de chamado cadastradas** pelo estabelecimento: as descrições personalizadas de cada situação base, agrupadas por ela — ou a própria situação base, quando ela não tem descrição cadastrada.
+ - O padrão é **Não vincular**: a situação da OS não mexe no chamado.
+ - **Renomear** uma descrição personalizada não desfaz o vínculo; **excluí-la** desfaz automaticamente.
+ - Desligar a Central de Chamados **esconde a coluna e suspende o efeito**, mas preserva os vínculos já cadastrados — eles voltam a valer ao religar o recurso.
+
+ > A mudança de situação feita pela OS entra no **histórico do chamado**. Veja [[04 - Central de Chamados|04 - Central de Chamados]].
+
+ ### Alertas e Texto Padrão
+
+ - **Alerta de Atraso (dias)** — OS sem atualização por esse número de dias passam a ser marcadas como atrasadas (destaque visual nas listagens).
+ - **Aviso de OS agendada (minutos antes)** *(Novo)* — quantos minutos antes da data e hora agendadas o **especialista vinculado à OS** recebe uma notificação do agendamento. Use **0** para não notificar. Veja [[13 - Notificações|13 - Notificações]].
+ - **Nota padrão de orçamento** — texto preenchido no **orçamento** da OS ao emitir o documento. Veja [[05_1 - Impressão|05_1 - Impressão]].
+
+ Clique em **Salvar Configurações** para gravar as alterações. O botão vale para as abas *Ordem de Serviço*, *Chamados* e *Financeiro*; a aba *Vendas* tem o seu próprio botão.
+
+ ---
+
+ ### Modelo de demanda
+
+ | Modelo | Como a OS e o chamado são abertos |
+ |---|---|
+ | **Produto/Equipamento** | Pede marca, produto, número de série e data de fabricação |
+ | **Serviço** | Pede as **categorias de serviço solicitadas** e a descrição do serviço, no lugar dos dados do equipamento |
+ | **Ambos** | O modelo é escolhido em cada OS ou chamado |
+
+ ---
+
+ # Chamados
+ ## Central de Chamados
+
+ > Recurso adicional. Ao acionar, o valor mensal passa a ser somado à cobrança e aparece em [[12_2 - Assinatura (Meu Plano)|12_2 - Assinatura (Meu Plano)]].
+
+ O bloco **Central de Chamados** mostra o valor mensal do recurso e o liga e desliga. Com ele desligado, as configurações descritas abaixo ficam ocultas, as permissões da Central de Chamados aparecem desabilitadas no cadastro de usuários e o menu **Central de Chamados** continua visível, **com cadeado** *(Novo)*: ao abri-lo, uma tela explica que o recurso não está contratado e onde ligá-lo. **Desligar não apaga os dados já cadastrados**.
+
+ > **Recurso em uso não se desliga** *(Novo)*. Depois que o estabelecimento registra chamados, a chave fica travada e o bloco mostra o aviso *"Recurso em uso — não pode mais ser desligado"*, com a quantidade de registros. Desligar esconderia esses registros e deixaria o histórico pela metade.
+
+ Com o recurso ativo, ficam disponíveis:
+
+ ### Visibilidade para o Especialista
+ - **Listar chamados não vinculados** — ligado, o especialista vê também os chamados ainda sem especialista, além dos dele. Desligado, ele vê apenas os chamados vinculados a ele e os que a alocação automática está ofertando a ele.
+
+ ### Alocação Automática
+ Os três tempos que regem a busca por um especialista, informados em **segundos**:
+
+ | Tempo | Efeito | Padrão |
+ |---|---|---|
+ | **Tempo padrão de retentativas** | Intervalo entre uma oferta e a próxima tentativa, quando o especialista não responde | 45 s |
+ | **Tempo máximo de busca por técnico** | Tempo máximo procurando um especialista; esgotado, a busca automática para | 300 s |
+ | **Tempo total de espera pelo cliente** | Tempo total que o cliente aguarda até ser atendido | 900 s |
+
+ > Os tempos são encadeados: a retentativa cabe dentro da busca, e a busca dentro da espera do cliente. Ao salvar, os tempos menores são ajustados para cima automaticamente.
+
+ > Quem entra na busca é definido no cadastro do especialista: a **disponibilidade** (ligada e desligada pelos períodos cadastrados), as **categorias** e as **regiões atendidas**. Veja [[04_1 - Alocação Automática|04_1 - Alocação Automática]] e [[12_1 - Usuários|12_1 - Usuários]].
+
+ ### Situações de Chamado
+ As situações base do chamado são fixas (*Aberto*, *Em atendimento*, *Concluído* e *Cancelado*). Para cada uma delas é possível:
+
+ - cadastrar quantas **descrições personalizadas** quiser (ex.: "Aberto" = *Solicitado*, *Aguardando operador*, *Despachado*);
+ - escolher a **cor de destaque** exibida na listagem e no quadro kanban.
+
+ > As situações cadastradas aqui são as opções oferecidas no **vínculo com as situações da OS** (veja *Vínculo com a situação do chamado*, acima). Uma descrição excluída aqui desfaz os vínculos que apontavam para ela.
+
+ Veja [[04 - Central de Chamados|04 - Central de Chamados]] e [[04_1 - Alocação Automática|04_1 - Alocação Automática]].
+
+ ---
+
+ # Financeiro
+ ## Controle Financeiro
+
+ > Recurso adicional. Ao acionar, o valor mensal passa a ser somado à cobrança e aparece em [[12_2 - Assinatura (Meu Plano)|12_2 - Assinatura (Meu Plano)]] como **Financeiro Avançado**.
+
+ O bloco **Controle Financeiro** mostra o valor mensal do recurso e o liga e desliga. O recurso traz os menus **Financeiro › Lançamentos**, **Vendas › Comissões**, **Vendas › PDV** *(Novo)* e **Vendas › Pedidos** *(Novo)*. Com ele desligado, as configurações descritas abaixo ficam ocultas, as permissões desses menus aparecem desabilitadas no cadastro de usuários e os menus continuam visíveis, **com cadeado** *(Novo)*, levando à tela que explica onde ligar o recurso. **Desligar não apaga os lançamentos já cadastrados**.
+
+ > Ligar o recurso não basta: libere em [[12_1 - Usuários|12_1 - Usuários]] as permissões de **Lançamentos**, **Comissões**, **PDV** e **Pedidos** (visualizar e editar) para quem deve acessar esses menus. Sem elas, os menus não aparecem nem para quem tem os demais acessos financeiros.
+
+ > **Recurso em uso não se desliga** *(Novo)*. Depois que o estabelecimento registra lançamentos, comissões, faturas, vendas no PDV ou pedidos, a chave fica travada e o bloco mostra o aviso *"Recurso em uso — não pode mais ser desligado"*, com a quantidade de registros. Se alguém tentar desligar, as demais configurações são salvas e um aviso no topo informa que o recurso continuou ligado.
+
+ ### Vínculo dos lançamentos com a OS
+
+ Define o que acontece com a OS quando o lançamento é editado:
+
+ | Vínculo | Efeito |
+ |---|---|
+ | **Cópia** *(padrão)* | O lançamento é uma cópia do que a OS tinha na geração. A edição vale só para ele — valor, descrição e data são livres, e a OS fica como está. A partir da primeira edição, o lançamento para de acompanhar a OS |
+ | **Sincronizado** | Lançamento e OS andam juntos: mudar o valor da **receita** acerta o valor da OS, com a diferença registrada nela como **taxa** (a mais) ou **desconto** (a menos). Descrição e data continuam sendo as da OS |
+
+ > No sincronizado, o acerto na OS vale para a **receita**. A **despesa** é editável nos dois modos, mas a OS não absorve diferença de custo — taxa e desconto mexem no valor cobrado, não no custo. Ao editar uma despesa de OS, a OS passa a **informar** que o custo dela foi alterado e aponta para *Lançamentos › Despesas*, onde fica o valor que vale. Os lançamentos **avulsos** seguem totalmente editáveis nos dois modos.
+
+ ### Geração de lançamentos pelas situações da OS
+
+ O quadro lista as situações da OS com duas marcações independentes — o momento de reconhecer o custo não é necessariamente o da receita:
+
+ - **Gera receita** — a OS que entra nessa situação recebe um lançamento em *Lançamentos › Receitas*, com a descrição *Cobrança da OS nº*, o **valor total da OS** e a **data da mudança de situação** (lida do histórico da OS).
+ - **Gera despesa** — a OS recebe os lançamentos de custo em *Lançamentos › Despesas*: um com **peças e serviços** e, havendo especialista vinculado, um de **comissão** e um de **hora técnica** por especialista, cada um com ele como favorecido.
+
+ Regras da geração:
+
+ - Ao salvar, as OS que **já estão** na situação marcada também são lançadas, com a data do histórico.
+ - É **um conjunto por OS**: passar por uma segunda situação marcada não gera outro, e o lançamento excluído à mão não volta.
+ - **Sair da situação não desfaz** os lançamentos. A **OS cancelada**, sim, retira o que ainda não foi baixado.
+ - Enquanto não baixado nem editado, o lançamento **acompanha a OS**.
+
+ > A **descrição personalizada** e o **uso** de cada situação continuam sendo definidos na aba *Ordem de Serviço*.
+
+ Veja [[09_1 - Lançamentos|09_1 - Lançamentos]], [[08_5 - Comissões|08_5 - Comissões]], [[08_2 - PDV|08_2 - PDV]] e [[08_3 - Pedidos|08_3 - Pedidos]].
+
+ ---
+
+ # Vendas *(Novo)*
+
+ A aba **Vendas** guarda os parâmetros da **emissão de notas fiscais** — NF-e e NFC-e das peças e NFS-e dos serviços — das vendas do **PDV**, dos **Pedidos** e do faturamento da **OS**. A transmissão à SEFAZ e às prefeituras é feita por um **serviço parceiro de emissão**, integrado ao sistema.
+
+ ::: info
+ **Em fase de homologação.** A emissão está sendo liberada aos poucos. Para os estabelecimentos ainda não liberados, a aba abre **somente para consulta**, com o aviso *"Emissão de notas fiscais — em breve"*: nada pode ser gravado, nem o certificado, e a emissão não pode ser ligada.
+ :::
+
+ A aba tem formulários próprios e o botão **Salvar parâmetros de vendas** — o **Salvar Configurações** das outras abas não vale para ela.
+
+ | Bloco | O que se configura |
+ |---|---|
+ | **Emissão de notas fiscais** | Liga e desliga a emissão e escolhe o **ambiente**: *Homologação (teste)*, sem valor fiscal, ou *Produção*. Mostra se a empresa já está cadastrada no serviço parceiro |
+ | **Certificado digital A1** | Envio do arquivo .pfx/.p12 do e-CNPJ com a senha, e a situação dele (*Válido*, *Vence em N dia(s)*, *Vencido*) |
+ | **Dados do emitente** | Regime tributário, regime especial (NFS-e), CNAE, inscrições estadual e municipal e código IBGE da cidade (com **Buscar pelo CEP**). CNPJ, razão social e endereço vêm da **Empresa** |
+ | **NF-e**, **NFC-e** e **NFS-e** | Liga cada tipo de nota, com série, próximo número e emissão automática; CSC na NFC-e; código do serviço, ISS e acesso à prefeitura na NFS-e |
+ | **Padrões da venda** | Perfil tributário padrão, natureza da operação, nota das peças no Pedido, envio da nota por e-mail ao cliente e informações complementares |
+
+ > As notas saem das vendas do PDV e dos Pedidos, que fazem parte do **Financeiro Avançado**. Com ele desligado, a aba avisa isso.
+
+ O passo a passo de cada bloco, os cadastros que a nota usa e o acompanhamento das notas estão em [[08_4 - Notas Fiscais|08_4 - Notas Fiscais]]. A tributação das peças é cadastrada em [[10_5 - Perfis Tributários|10_5 - Perfis Tributários]].
+
+ ---
+
+ # Integrações
+
+ A aba **Integrações** é a vitrine das integrações com outros sistemas. Cada uma aparece como um **cartão** com o nome, o que ela faz e a situação atual; clicar no cartão abre a página da integração, onde ela é ligada e configurada.
+
+ | Situação do cartão | O que significa |
+ |---|---|
+ | **Desligada** | O recurso não foi acionado |
+ | **Falta conectar** | Recurso ligado, mas a autorização com o outro sistema ainda não foi feita |
+ | **Conectada** | Ligada e autorizada — sincronizando |
+ | **Com erro** | A última tentativa falhou; a página da integração mostra o motivo |
+
+ > As integrações **fazem parte do plano** e não geram cobrança adicional. Novas integrações aparecem nesta aba automaticamente conforme forem liberadas.
+
+ Veja [[12_4_1 - Integrações|12_4_1 - Integrações]] e [[12_4_1_1 - Olist|12_4_1_1 - Olist]].
+
+ ---
+
+ # Sobre
+ ## Informações do sistema
+
+ Na coluna direita da tela ficam disponíveis, apenas para consulta:
+
+ - **Identidade do sistema** — logotipo e versão instalada (atualmente a **3.5**).
+ - **Informações da Empresa** — dados de contato da EOS Sistemas.
+ - **Ajuda** — link para a **Documentação de Ajuda** (wiki do sistema).
+ - **Documentos Legais** — acesso aos **Termos de Uso** e à **Política de Privacidade**.
+
+ ---
+
+ ## Configurações relacionadas em outras telas
+
+ Os dados cadastrais da empresa, logo, e a vinculação de estabelecimentos (multi unidade) ficam na tela **Configurações › Empresa** — veja [[12_3 - Empresa (Estabelecimento)|12_3 - Empresa (Estabelecimento)]]. O plano contratado, cobranças e recursos são geridos em **Configurações › Assinatura** — veja [[12_2 - Assinatura (Meu Plano)|12_2 - Assinatura (Meu Plano)]].
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9