| Ambos lados da revisão anterior Revisão anterior Próxima revisão | Revisão anterior |
| beestock:admin:general:company_v2 [13/10/2026 03:03] – Ramon Paulino Mendes | beestock:admin:general:company_v2 [13/10/2026 04:49] (atual) – Atualização da página beestock:admin:general:company_v2 via Assistente BeeStock Ramon Paulino Mendes |
|---|
| {{ :beestock:admin:general:daf-logo.svg |}}====== Cadastro de Empresas-v2 ====== | ====== Cadastro de Empresas-v2 ====== |
| |
| <WRAP center round info 95%> | 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. |
| **Documentação Oficial BeeStock WMS — Versão Aprimorada (v2)**\\ | |
| Esta página apresenta o manual completo e atualizado do módulo de **Cadastro de Empresas**, refletindo os novos parâmetros operacionais, regras de segurança e boas práticas de UX/UI.\\ | |
| //Nota: O manual original legado permanece preservado em [[beestock:admin:general:company|Cadastro de Empresas (v1)]].// | |
| </WRAP> | |
| | |
| 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. | |
| |
| --- | --- |
| Ao acessar a funcionalidade, o usuário visualiza o grid consolidado com todas as empresas cadastradas no sistema. | Ao acessar a funcionalidade, o usuário visualiza o grid consolidado com todas as empresas cadastradas no sistema. |
| |
| {{:beestock:admin:general:01_listagem_empresas.png?direct&800|Listagem de Empresas}} | {{:beestock:admin:general:0520_cadastro_empresas_listagem.png?direct&800|Listagem de Empresas}} |
| //Localização do arquivo de imagem no servidor: ''/home/ramon/WMS_DEV/prints_manual_empresa_v2/01_listagem_empresas.png''// | |
| |
| ==== Funcionalidades da Tela Principal ==== | ==== Funcionalidades da Tela Principal ==== |
| * **Menu Ações**: Disponível em cada linha da tabela: | * **Menu Ações**: Disponível em cada linha da tabela: |
| * **Detalhes**: Exibe as informações em formato somente-leitura. | * **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. | * **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. | * **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). | * **Eliminar**: Remove o registro (somente permitido se não houver filiais ou movimentações vinculadas). |
| Ao clicar em **+ Incluir Empresa** ou em **Ações > Editar**, o formulário é aberto exibindo primeiramente a aba **Dados**. | Ao clicar em **+ Incluir Empresa** ou em **Ações > Editar**, o formulário é aberto exibindo primeiramente a aba **Dados**. |
| |
| {{:beestock:admin:general:02_aba_dados.png?direct&800|Aba 1: Dados Cadastrais}} | {{:beestock:admin:general:0521_cadastro_empresas_aba_dados.png?direct&800|Aba 1: Dados Cadastrais}} |
| //Localização do arquivo de imagem no servidor: ''/home/ramon/WMS_DEV/prints_manual_empresa_v2/02_aba_dados.png''// | |
| |
| ==== Descrição dos Campos ==== | ==== Descrição dos Campos ==== |
| | **Bairro** | Texto | Sim (*) | Bairro onde a empresa está instalada. Preenchido automaticamente pelo CEP. | | | **Bairro** | Texto | Sim (*) | Bairro onde a empresa está instalada. Preenchido automaticamente pelo CEP. | |
| | **Cidade** | Texto | Sim (*) | Município da empresa. 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, MG, RJ, PR). 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. | | | **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. | | | **E-mail** | E-mail | Não | Endereço eletrônico corporativo para envio de notificações, relatórios e contatos administrativos. | |
| A aba **Parâmetros** define o comportamento do estoque, precisão matemática das movimentações e comunicação com plataformas externas. | 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:03_aba_parametros.png?direct&800|Aba 2: Parâmetros Operacionais}} | {{:beestock:admin:general:0522_cadastro_empresas_aba_parametros.png?direct&800|Aba 2: Parâmetros Operacionais}} |
| //Localização do arquivo de imagem no servidor: ''/home/ramon/WMS_DEV/prints_manual_empresa_v2/03_aba_parametros.png''// | |
| |
| ==== Detalhamento dos Parâmetros ==== | ==== Detalhamento dos Parâmetros ==== |
| |
| === 3.1. Quantidade Fracionada (fractionalQuantity) === | === 3.1. Quantidade Fracionada === |
| * **Conceito**: Define se os produtos desta empresa podem ser movimentados com casas decimais (ex: quilos, metros, litros, m²). | * **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. | * **✓ 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. | * **✗ 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. |
| * **ℹ️ Boas Práticas**: Obrigatório para indústrias, segmentos têxteis, químicos e alimentos comercializados a granel ou por pesagem. | * **ℹ️ Informação:** Essencial para indústrias, químicos, têxteis e alimentos pesados na balança. |
| |
| === 3.2. Integração de Cadastros (formIntegrations) === | === 3.2. Integração de Cadastros === |
| * **Conceito**: Habilita a gravação e auditoria transacional dos eventos de sincronização de cadastros (produtos, clientes, fornecedores e estoques) entre o BeeStock e o ERP/TMS externo. | * **Conceito**: Define se as alterações cadastrais feitas manualmente na tela do BeeStock são enviadas de volta para o ERP. |
| * **✓ Marcado (Sim)**: O sistema registra o histórico completo de payloads enviados e recebidos nas tabelas de integração, facilitando a identificação de falhas ou dados faltantes. | * **✓ Marcado (Sim)**: Qualquer novo cadastro ou alteração manual no BeeStock gera evento de integração para atualizar o ERP. |
| * **✗ Desmarcado (Não)**: Executa as atualizações cadastrais diretamente sem gravar logs intermediários de auditoria. | * **✗ Desmarcado (Não)**: O BeeStock apenas consome cadastros do ERP, mantendo o ERP como a única fonte de verdade cadastral. |
| * **ℹ️ Boas Práticas**: Recomendado manter sempre **Sim** para operações que utilizam mensageria de integração (APIs, filas ou banco intermediário). | * **ℹ️ Informação:** Recomendado manter Sim para operações com integração síncrona bidirecional. |
| |
| === 3.3. Tipo de Controle de Estoque (stockControlType) === | === 3.3. Tipo de Controle de Estoque === |
| * **Conceito**: Define quem detém a autoridade mandatória e a responsabilidade primária pelo cálculo e saldo de estoque. | * **Conceito**: Determina qual sistema possui a autoridade principal sobre o saldo de estoque físico dos armazéns. |
| * **Opção BeeStock**: O WMS BeeStock gerencia com autonomia total todas as alocações físicas, reservas de pedidos, lotes, validades e endereçamento. Ideal para operações que demandam agilidade operacional sem travas de ERP em tempo real. | * **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 sistema consulta e valida a disponibilidade diretamente contra o estoque central do ERP antes de autorizar movimentações no armazém. | * **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. |
| * **ℹ️ Boas Práticas**: Na grande maioria das implantações de armazéns e CDs, seleciona-se **BeeStock** para garantir independência e alto desempenho operacional. | * **ℹ️ Informação:** Na grande maioria das implantações de armazéns e CDs, seleciona-se BeeStock para garantir alta performance operacional. |
| |
| === 3.4. Host Image Hub (imageHubHostAddress) === | === 3.4. Servidor de Imagens (Image Hub) === |
| * **Conceito**: Endereço IP ou hostname com porta do servidor central de imagens e mídias do BeeStock (ex: ''http://192.168.18.5:8080/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**: Fornece as fotos dos produtos para exibição na tela dos coletores de dados Android durante a separação guiada, bem como layouts gráficos de etiquetas. | * **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. |
| * **ℹ️ Boas Práticas**: Deve ser configurado com uma URL acessível pela rede Wi-Fi/VPN utilizada pelos operadores no armazém. | * **ℹ️ Informação:** O endereço deve ser acessível via rede Wi-Fi/VPN utilizada pelos coletores de dados no armazém. |
| |
| --- | --- |
| 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. | 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:04_aba_parametros_seguranca.png?direct&800|Aba 3: Parâmetros de Segurança}} | {{:beestock:admin:general:0523_cadastro_empresas_aba_seguranca.png?direct&800|Aba 3: Parâmetros de Segurança}} |
| //Localização do arquivo de imagem no servidor: ''/home/ramon/WMS_DEV/prints_manual_empresa_v2/04_aba_parametros_seguranca.png''// | |
| |
| ==== Detalhamento das Políticas ==== | ==== Detalhamento das Políticas ==== |
| |
| ^ Parâmetro ^ Tipo ^ Valor Padrão ^ Regra de Negócio e Impacto ^ | ^ Parâmetro ^ Tipo ^ Valor Padrão ^ Regra de Negócio e Impacto ^ |
| | **Validade Senha (Dias)**\\ //(daysOfPasswordValidity)// | Numérico | 9999 | Define a quantidade máxima de dias que uma senha pode ser utilizada antes de expirar obrigatoriamente. 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. | | | **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. | |
| | **Número de Senhas Únicas**\\ //(passwordHistoryLimit)// | Numérico | 0 | Limite de histórico de senhas antigas armazenadas. Impede que o usuário reutilize as últimas //N// senhas já cadastradas. Exemplo: se configurado como 3, o colaborador não poderá repetir nenhuma de suas últimas 3 senhas. | | | **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. | |
| | **Quantidade de Tentativas**\\ //(quantityAttempt)// | 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. | | | **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**\\ //(daysWithoutUsing)// | Numérico | 0 | Quantidade máxima de dias contínuos de inatividade permitidos. Se uma conta não registrar nenhum login por mais tempo que o estipulado, é desativada por segurança (útil para colaboradores de férias longas ou desligados). | | | **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). | |
| |
| --- | --- |
| Permite carregar os elementos gráficos institucionais da empresa utilizados no portal web e nas impressões térmicas. | Permite carregar os elementos gráficos institucionais da empresa utilizados no portal web e nas impressões térmicas. |
| |
| {{:beestock:admin:general:05_aba_logotipo.png?direct&800|Aba 4: Logotipos da Empresa}} | {{:beestock:admin:general:0524_cadastro_empresas_aba_logotipo.png?direct&800|Aba 4: Logotipos da Empresa}} |
| //Localização do arquivo de imagem no servidor: ''/home/ramon/WMS_DEV/prints_manual_empresa_v2/05_aba_logotipo.png''// | |
| |
| ==== Campos Disponíveis ==== | ==== Campos Disponíveis ==== |
| |
| * **Logotipo da Empresa em formato de Etiqueta (logoCompanyLabel)**: | * **Logotipo para Etiquetas Térmicas**: |
| * Campo de upload/informação da arte gráfica monocromática convertida para impressão térmica (Zebra ZPL, Datamax, Argox). | * 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 térmicas de produtos, volumes de expedição e caixas de consolidação. | * Utilizado no cabeçalho das etiquetas de produtos, volumes de expedição e caixas de consolidação. |
| * **Logotipo (logoCompany)**: | * **Logotipo Oficial da Empresa**: |
| * Arquivo de imagem colorido oficial (PNG, JPG) para visualização em tela e documentos administrativos. | * Arquivo de imagem colorido oficial (PNG, JPG) para visualização em tela e relatórios gerenciais. |
| * É renderizado automaticamente no topo do portal do BeeStock, em relatórios gerenciais, espelhos de pedidos e notas de movimentação. | * É renderizado automaticamente no topo do portal web do BeeStock, em relatórios executivos, espelhos de pedidos e notas de movimentação. |
| |
| --- | --- |
| * Complete com o **Número** e complemento (se houver). | * Complete com o **Número** e complemento (se houver). |
| - Na aba **Parâmetros**: | - Na aba **Parâmetros**: |
| * Configure se a operação utiliza **Quantidade Fracionada** (Sim/Não). | * Defina se utilizará **Quantidade Fracionada** (Sim/Não). |
| * Defina a auditoria de **Integração de Cadastros** (Sim/Não). | * Configure a **Integração de Cadastros** e o **Tipo de Controle de Estoque** (preferencialmente BeeStock). |
| * Indique o **Tipo de Controle de Estoque** (padrão: //BeeStock//). | * Informe a URL do **Servidor de Imagens** se possuir catálogo de fotos. |
| * Preencha a URL do **Host Image Hub** se os coletores utilizarem imagens na separação. | |
| - Na aba **Segurança**: | - Na aba **Segurança**: |
| * Ajuste os dias de validade de senha e tentativas máximas de login conforme a política de segurança da sua empresa. | * Estabeleça as políticas de expiração de senhas, histórico e tentativas de login. |
| - Na aba **Logotipo**: | - Na aba **Logotipo**: |
| * Faça o upload da imagem corporativa nos formatos suportados. | * Carregue os layouts gráficos da logomarca oficial e para etiquetas térmicas. |
| - Clique no botão **Criar** (ou **Atualizar**). | - Clique no botão azul **Criar** no rodapé para finalizar o cadastro. |
| - O sistema exibirá a notificação de confirmação e retornará para a listagem com o novo registro disponível. | |
| |
| --- | --- |
| |
| <WRAP center round info 40%> | ===== 7. Perguntas Frequentes (FAQ) & Dúvidas Respondidas ===== |
| **Ainda ficou com alguma dúvida sobre o Cadastro de Empresas?**\\ | |
| Entre em contato com o Suporte Técnico BeeStock ou deixe sua sugestão.\\ | <div style="font-size: 0.9em; opacity: 0.95;"> |
| {{SZ_FEEDBACK}} | |
| </WRAP> | ^ 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> |
| |