beestock:admin:general:company_v2 [SZ Soluções Wiki]

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
====== Cadastro de Empresas-v2 ======

Localizada no menu **Administração > Gerais > Empresas**, esta tela permite criar, parametrizar e gerenciar as empresas (matrizes/holdings) do sistema BeeStock WMS. A empresa é a entidade central que agrupa configurações fiscais globais, regras operacionais e políticas de segurança aplicáveis às suas filiais associadas.

---

===== 1. Visão Geral e Listagem de Empresas =====

Ao acessar a funcionalidade, o usuário visualiza o grid consolidado com todas as empresas cadastradas no sistema.

{{:beestock:admin:general:0520_cadastro_empresas_listagem.png?direct&800|Listagem de Empresas}}

==== Funcionalidades da Tela Principal ====

  * **+ Incluir Empresa**: Botão de ação primária destacado em laranja, utilizado para cadastrar uma nova empresa no sistema.
  * **Barra de Filtros**: Permite filtrar rapidamente qualquer empresa digitando valores nas colunas do cabeçalho (Código, Nome, Razão Social, CNPJ, E-mail, Cidade, Estado).
  * **Exportação para Planilha**: Ícone do Excel no canto superior esquerdo do grid para exportar a listagem completa.
  * **Recarregar Grid**: Ícone circular de sincronização no canto superior direito do grid.
  * **Menu Ações**: Disponível em cada linha da tabela:
    * **Detalhes**: Exibe as informações em formato somente-leitura.
    * **Editar**: Abre o formulário completo para atualização cadastral e alteração de parâmetros nas 4 abas.
    * **Copiar**: Agiliza a implantação duplicando as configurações da empresa para um novo registro.
    * **Eliminar**: Remove o registro (somente permitido se não houver filiais ou movimentações vinculadas).

---

===== 2. Aba 1: Dados Cadastrais =====

Ao clicar em **+ Incluir Empresa** ou em **Ações > Editar**, o formulário é aberto exibindo primeiramente a aba **Dados**.

{{:beestock:admin:general:0521_cadastro_empresas_aba_dados.png?direct&800|Aba 1: Dados Cadastrais}}

==== Descrição dos Campos ====

^ Campo ^ Tipo ^ Obrigatório ^ Descrição e Finalidade ^
| **Código** | Numérico | Sim (Automático) | Identificador único da empresa gerado pelo banco de dados. Na edição, é exibido desabilitado para garantir a integridade referencial. |
| **Razão Social** | Texto | Sim (*) | Nome oficial da pessoa jurídica registrado na Junta Comercial e na Receita Federal. Utilizado na emissão de documentos fiscais e integrações. |
| **Nome / Nome Fantasia** | Texto | Sim (*) | Nome comercial ou marca da empresa. É o nome exibido nos seletores de topo do sistema, menus e relatórios operacionais. |
| **CNPJ** | Texto Mascarado | Sim (*) | Cadastro Nacional da Pessoa Jurídica no formato ''00.000.000/0000-00''. O sistema valida o dígito verificador para impedir cadastros incorretos. |
| **Inscrição Estadual** | Texto | Sim (*) | Registro fiscal perante a Secretaria da Fazenda (SEFAZ) do estado. Empresas isentas devem preencher como ''ISENTO''. |
| **Inscrição Municipal** | Texto | Não | Registro na prefeitura municipal, aplicável para prestadores de serviços de armazenagem e transporte. |
| **CEP** | Texto Mascarado | Sim (*) | Código de Endereçamento Postal. Ao digitar um CEP válido de 8 dígitos, o sistema realiza a busca automática de logradouro, bairro, cidade e estado via serviço ViaCEP. |
| **Rua / Logradouro** | Texto | Sim (*) | Nome da avenida, rua ou via pública da sede da empresa. Preenchido automaticamente pelo CEP. |
| **Número** | Texto | Sim (*) | Número do imóvel. Pode ser preenchido como ''S/N'' caso não haja numeração oficial. |
| **Complemento** | Texto | Não | Informações adicionais do endereço (ex: Bloco A, Sala 201, Galpão 3). |
| **Bairro** | Texto | Sim (*) | Bairro onde a empresa está instalada. Preenchido automaticamente pelo CEP. |
| **Cidade** | Texto | Sim (*) | Município da empresa. Preenchido automaticamente pelo CEP. |
| **Estado (UF)** | Texto / Sigla | Sim (*) | Unidade Federativa de 2 letras (ex: SP, SC, MG, RJ, PR). Preenchido automaticamente pelo CEP. |
| **Telefone** | Texto Mascarado | Não | Telefone comercial de contato principal. |
| **E-mail** | E-mail | Não | Endereço eletrônico corporativo para envio de notificações, relatórios e contatos administrativos. |

---

===== 3. Aba 2: Parâmetros Operacionais =====

A aba **Parâmetros** define o comportamento do estoque, precisão matemática das movimentações e comunicação com plataformas externas.

{{:beestock:admin:general:0522_cadastro_empresas_aba_parametros.png?direct&800|Aba 2: Parâmetros Operacionais}}

==== Detalhamento dos Parâmetros ====

=== 3.1. Quantidade Fracionada ===
  * **Conceito**: Controla se os produtos desta empresa podem ser movimentados com casas decimais (ex: quilos, metros, litros, m²).
  * **✓ Marcado (Sim)**: Permite registrar quantidades com vírgula ou ponto (ex: 1,5 kg, 2,75 m) nas rotinas de recebimento, conferência, estoque e expedição.
  * **✗ Desmarcado (Não)**: Obriga o uso estrito de números inteiros (1, 2, 3). Qualquer digitação de valor fracionado no coletor ou web será bloqueada pelo sistema.
  * **ℹ️ Informação:** Essencial para indústrias, químicos, têxteis e alimentos pesados na balança.

=== 3.2. Integração de Cadastros ===
  * **Conceito**: Define se as alterações cadastrais feitas manualmente na tela do BeeStock são enviadas de volta para o ERP.
  * **✓ Marcado (Sim)**: Qualquer novo cadastro ou alteração manual no BeeStock gera evento de integração para atualizar o ERP.
  * **✗ Desmarcado (Não)**: O BeeStock apenas consome cadastros do ERP, mantendo o ERP como a única fonte de verdade cadastral.
  * **ℹ️ Informação:** Recomendado manter Sim para operações com integração síncrona bidirecional.

=== 3.3. Tipo de Controle de Estoque ===
  * **Conceito**: Determina qual sistema possui a autoridade principal sobre o saldo de estoque físico dos armazéns.
  * **Opção BeeStock**: O saldo físico em tempo real do armazém governa as operações e reservas de pedidos, com autonomia total de lotes e endereçamento.
  * **Opção ERP**: O saldo físico depende de aprovação e conciliação síncrona com o ERP externo antes de liberar movimentações.
  * **ℹ️ Informação:** Na grande maioria das implantações de armazéns e CDs, seleciona-se BeeStock para garantir alta performance operacional.

=== 3.4. Servidor de Imagens (Image Hub) ===
  * **Conceito**: Endereço web do servidor onde ficam salvas as fotos dos produtos exibidas nos coletores de dados e telas de conferência.
  * **Utilização**: Informe a URL completa do serviço (ex: ''https://imagens.suaempresa.com.br''). Deixe em branco se a empresa não utilizar fotos em coletores.
  * **ℹ️ Informação:** O endereço deve ser acessível via rede Wi-Fi/VPN utilizada pelos coletores de dados no armazém.

---

===== 4. Aba 3: Segurança e Políticas de Senha =====

A aba **Segurança** gerencia as diretrizes de conformidade, proteção contra invasões e ciclo de vida das credenciais de acesso dos usuários vinculados a esta empresa.

{{:beestock:admin:general:0523_cadastro_empresas_aba_seguranca.png?direct&800|Aba 3: Parâmetros de Segurança}}

==== Detalhamento das Políticas ====

^ Parâmetro ^ Tipo ^ Valor Padrão ^ Regra de Negócio e Impacto ^
| **Validade da Senha (em dias)** | Numérico | 9999 | Quantidade máxima de dias até que o sistema exija que os usuários alterem sua senha de acesso. Quando o prazo vence, o usuário é direcionado para a tela de troca de senha no próximo login. Informar 9999 desativa a expiração forçada. Padrão recomendado: 30 a 90 dias. |
| **Histórico de Senhas Anteriores** | Numérico | 0 | Quantidade de senhas recentes que o usuário fica proibido de reutilizar ao definir uma nova senha. Exemplo: se configurado como 3, o colaborador não poderá repetir nenhuma de suas últimas 3 senhas anteriores. |
| **Limite de Tentativas de Login** | Numérico | 0 | Número máximo de erros consecutivos de senha permitidos no login. Ao atingir este limite, a conta do usuário é bloqueada preventivamente para impedir ataques de força bruta, exigindo desbloqueio por um administrador. |
| **Dias Máximos Sem Uso (Inatividade)** | Numérico | 0 | Quantidade máxima de dias contínuos sem login antes de desativar a conta do operador automaticamente por segurança (útil para colaboradores de férias longas ou desligados). |

---

===== 5. Aba 4: Logotipo e Identidade Visual =====

Permite carregar os elementos gráficos institucionais da empresa utilizados no portal web e nas impressões térmicas.

{{:beestock:admin:general:0524_cadastro_empresas_aba_logotipo.png?direct&800|Aba 4: Logotipos da Empresa}}

==== Campos Disponíveis ====

  * **Logotipo para Etiquetas Térmicas**:
    * Código gráfico vetorial (comandos ZPL/EPL) ou imagem monocromática convertida para impressão térmica rápida nas impressoras Zebra, Datamax ou Argox.
    * Utilizado no cabeçalho das etiquetas de produtos, volumes de expedição e caixas de consolidação.
  * **Logotipo Oficial da Empresa**:
    * Arquivo de imagem colorido oficial (PNG, JPG) para visualização em tela e relatórios gerenciais.
    * É renderizado automaticamente no topo do portal web do BeeStock, em relatórios executivos, espelhos de pedidos e notas de movimentação.

---

===== 6. Guia Passo a Passo: Cadastrando uma Nova Empresa =====

  - Acesse o menu lateral esquerdo em **Administração > Gerais > Empresas**.
  - Clique no botão laranja **+ Incluir Empresa**.
  - Na aba **Dados**:
    * Preencha a **Razão Social** e o **Nome Comercial**.
    * Informe o **CNPJ** (o sistema valida os dígitos automaticamente).
    * Preencha a **Inscrição Estadual** (ou ''ISENTO'').
    * Digite o **CEP** de 8 dígitos e aguarde o preenchimento automático do endereço.
    * Complete com o **Número** e complemento (se houver).
  - Na aba **Parâmetros**:
    * Defina se utilizará **Quantidade Fracionada** (Sim/Não).
    * Configure a **Integração de Cadastros** e o **Tipo de Controle de Estoque** (preferencialmente BeeStock).
    * Informe a URL do **Servidor de Imagens** se possuir catálogo de fotos.
  - Na aba **Segurança**:
    * Estabeleça as políticas de expiração de senhas, histórico e tentativas de login.
  - Na aba **Logotipo**:
    * Carregue os layouts gráficos da logomarca oficial e para etiquetas térmicas.
  - Clique no botão azul **Criar** no rodapé para finalizar o cadastro.

---

===== 7. Perguntas Frequentes (FAQ) & Dúvidas Respondidas =====

<div style="font-size: 0.9em; opacity: 0.95;">

^ Pergunta / Dúvida Operacional ^ Resposta Objetiva no Manual ^
| **Como permitir que produtos sejam movimentados com peso quebrado (quilos com vírgula)?** | Na aba **Parâmetros**, marque a opção **Quantidade Fracionada** como **Sim**. Isso autoriza o uso de casas decimais em recebimentos, estoques e expedição. |
| **O que fazer se o BeeStock travar o login de um usuário por erro de senha?** | Na aba **Segurança**, verifique a política de **Limite de Tentativas de Login**. Quando um usuário excede esse número, sua conta é bloqueada preventivamente contra ataques, exigindo que o administrador desbloqueie o cadastro em *Administração > Usuários*. |
| **Como desativar a exigência de troca periódica de senha dos operadores?** | Na aba **Segurança**, configure o campo **Validade da Senha (em dias)** com o valor ''9999''. |
| **Onde configurar o endereço do servidor para exibir fotos de produtos nos coletores?** | Na aba **Parâmetros**, preencha o campo **Servidor de Imagens (Image Hub)** com a URL completa do serviço (ex: ''https://imagens.suaempresa.com.br''). |
| **Qual a diferença entre controle de estoque BeeStock e ERP?** | Na aba **Parâmetros**, ao selecionar **BeeStock**, o WMS governa de forma autônoma os saldos físicos, reservas e validades em tempo real. Ao escolher **ERP**, cada movimentação depende de validação síncrona com o ERP externo. |
| **Por que a logomarca não sai impressa na etiqueta térmica?** | Na aba **Logotipo**, certifique-se de preencher o campo **Logotipo para Etiquetas Térmicas** com a arte gráfica convertida em formato aceito pela impressora térmica (ex: comandos ZPL). O campo de imagem colorida comum serve apenas para telas web e PDFs. |

</div>