Essa é uma revisão anterior do documento!
Cadastro de Empresas-v2
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 Cadastro de Empresas (v1).
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.
—
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.
Localização do arquivo de imagem no servidor: /home/ramon/WMS_DEV/prints_manual_empresa_v2/01_listagem_empresas.png
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.
- 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.
Localização do arquivo de imagem no servidor: /home/ramon/WMS_DEV/prints_manual_empresa_v2/02_aba_dados.png
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, MG, RJ, PR). Preenchido automaticamente pelo CEP. |
| Telefone | Texto Mascarado | Não | Telefone comercial de contato principal. |
| 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.
Localização do arquivo de imagem no servidor: /home/ramon/WMS_DEV/prints_manual_empresa_v2/03_aba_parametros.png
Detalhamento dos Parâmetros
3.1. Quantidade Fracionada (fractionalQuantity)
- Conceito: Define 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.
- ℹ️ Boas Práticas: Obrigatório para indústrias, segmentos têxteis, químicos e alimentos comercializados a granel ou por pesagem.
3.2. Integração de Cadastros (formIntegrations)
- 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.
- ✓ 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.
- ✗ Desmarcado (Não): Executa as atualizações cadastrais diretamente sem gravar logs intermediários de auditoria.
- ℹ️ Boas Práticas: Recomendado manter sempre Sim para operações que utilizam mensageria de integração (APIs, filas ou banco intermediário).
3.3. Tipo de Controle de Estoque (stockControlType)
- Conceito: Define quem detém a autoridade mandatória e a responsabilidade primária pelo cálculo e saldo de estoque.
- 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.
- ℹ️ 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.
3.4. Host Image Hub (imageHubHostAddress)
- 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). - 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.
- ℹ️ Boas Práticas: Deve ser configurado com uma URL acessível pela rede Wi-Fi/VPN utilizada pelos operadores 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.
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
| 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. |
| 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. |
| 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. |
| 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). |
—
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.
Localização do arquivo de imagem no servidor: /home/ramon/WMS_DEV/prints_manual_empresa_v2/05_aba_logotipo.png
Campos Disponíveis
- Logotipo da Empresa em formato de Etiqueta (logoCompanyLabel):
- Campo de upload/informação da arte gráfica monocromática convertida para impressão térmica (Zebra ZPL, Datamax, Argox).
- Utilizado no cabeçalho das etiquetas térmicas de produtos, volumes de expedição e caixas de consolidação.
- Logotipo (logoCompany):
- Arquivo de imagem colorido oficial (PNG, JPG) para visualização em tela e documentos administrativos.
- É renderizado automaticamente no topo do portal do BeeStock, em relatórios gerenciais, 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:
- Configure se a operação utiliza Quantidade Fracionada (Sim/Não).
- Defina a auditoria de Integração de Cadastros (Sim/Não).
- Indique o Tipo de Controle de Estoque (padrão: BeeStock).
- Preencha a URL do Host Image Hub se os coletores utilizarem imagens na separação.
- 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.
- Na aba Logotipo:
- Faça o upload da imagem corporativa nos formatos suportados.
- Clique no botão Criar (ou Atualizar).
- O sistema exibirá a notificação de confirmação e retornará para a listagem com o novo registro disponível.
—
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.
Enviar Feedback