Configurador de Tipo de Documento - V2

O Configurador de Tipo de Documento é o cérebro de roteamento inteligente e automação operacional do BeeStock WMS. É através deste módulo que o sistema decide, de forma 100% autônoma e sem necessidade de triagem manual, qual Tipo de Documento (ex: Pedido de Venda - PDV, Recebimento - REC, Devolução - DEV, Transferência - TRA) deve governar uma carga que chega integrada do ERP.

Sempre que uma nota fiscal, ordem de compra, pedido comercial ou devolução é transmitido pela API ao BeeStock, o motor de regras avalia a combinação exata de atributos da carga:

Filial Operacional e Tipo de Movimentação (Entrada ou Saída);
Depósito Físico de Destino/Origem;
Cliente ou Fornecedor envolvido;
Transportadora e Tipo de Frete/Entrega (CIF, FOB, Retira);
Grupo de Estoque das mercadorias;
Operação Fiscal / CFOP (código fiscal específico ou coringa * para todos).

Assim que uma correspondência é encontrada, o BeeStock associa o documento ao Tipo de Documento correspondente, disparando instantaneamente as regras de alocação de saldo, geração de ondas de separação, impressão de etiquetas e exigências de conferência física!

—

A tela principal exibe o catálogo completo de regras ativas e inativas parametrizadas no sistema, com suporte a busca rápida, ordenação por qualquer coluna e exportação CSV.

Coluna	Descrição e Papel na Regra
Filial	Filial onde a regra de roteamento se aplica.
Tipo Movimentação	Sentido logístico da carga: Entrada (Recebimento) ou Saída (Expedição).
Depósito	Depósito físico associado à operação.
Fornecedor / Cliente	Razão social ou código do parceiro comercial vinculado à regra (exibido conforme o tipo de movimentação).
Transportadora	Empresa de transporte responsável pelo frete.
Tipo de Entrega	Modalidade de frete configurada (ex: `CIF`, `FOB`, `Retira`, `Frota Própria`).
Grupo de Estoque	Família ou categoria contábil dos itens que acionam a regra.
Operação Fiscal (CFOP)	Código fiscal específico (ex: `5102`, `6108`) ou `*` (asterisco) para abranger todas as operações fiscais.
Tipo de Documento	O Tipo de Documento que o BeeStock atribuirá automaticamente quando os critérios acima forem satisfeitos.
Status	Indicador visual de ativação da regra: Ativo (verde) ou Inativo (cinza).
Ações	Menu de contexto para Editar, Duplicar (Copiar), Ativar/Inativar ou Excluir a regra.

—

Para cadastrar uma nova regra de roteamento:

Passo 1: Acessar o Configurador
- No menu principal do BeeStock, navegue em: Cadastros ➔ Gerais ➔ Configurador de Tipo de Documento.
- Clique no botão verde superior direito Novo (com ícone +).
Passo 2: Preencher os Critérios de Roteamento
- Selecione a Filial onde a regra terá validade.
- Selecione o Tipo de Movimentação (Entrada para compras/recebimentos ou Saída para vendas/expedição).
- Escolha o Depósito físico aplicável.
- Conforme o tipo de movimentação escolhido, selecione o Fornecedor (na Entrada) ou o Cliente (na Saída), ou deixe livre para abranger todos.
- Opcionalmente, defina a Transportadora, o Tipo de Entrega e o Grupo de Estoque.
Passo 3: Configurar a Operação Fiscal / CFOP
- Digite o código CFOP específico (ex: 5102) ou clique no botão Todos para preencher o asterisco *, cobrindo qualquer operação fiscal.
Passo 4: Selecionar o Tipo de Documento de Destino
- No campo Tipo de Documento, escolha a parametrização que regerá esta carga (ex: PDV - Pedido de Venda).
Passo 5: Definir o Status e Salvar
- Mantenha o Status como Ativo e adicione uma Observação operacional se desejar.
- Clique no botão Criar no rodapé para gravar a regra.

—

A tabela a seguir descreve a função de cada campo do formulário e seu impacto nas rotinas do armazém:

Campo	Tipo	Obrigatório	Descrição e Regras de Negócio
Filial	Seleção	Sim	Define a filial física do BeeStock onde a regra terá vigência. Cada filial possui seu catálogo de depósitos e tipos de documentos específicos.
Tipo Movimentação	Seleção	Sim	Entrada: Roteia documentos de recebimento de fornecedores, devoluções de clientes ou transferências recebidas.\\Saída: Roteia pedidos de venda comercial, remessas industriais ou transferências enviadas.
Depósito	Seleção	Sim	Depósito físico do armazém onde os itens serão movimentados. Caso a carga integrada aponte para outro depósito, a regra não será acionada.
Fornecedor / Cliente	Seleção	Não	Filtro dinâmico: quando o Tipo de Movimentação for `Entrada`, lista os fornecedores cadastrados; quando for `Saída`, lista os clientes. Deixe em branco se a regra valer para qualquer parceiro comercial.
Transportadora	Seleção	Não	Permite especializar o fluxo por transportadora (ex: regras específicas para transportadoras aéreas, expressas ou com exigência de paletização dedicada).
Tipo de Entrega	Seleção	Não	Modalidade de frete (CIF, FOB, Retira Balcão, etc.). Permite que pedidos CIF tenham separação prioritária frente a pedidos FOB com agendamento de coleta.
Grupo de Estoque	Seleção	Não	Categoria contábil/física do produto (ex: Matéria-Prima, Produto Acabado, Embalagens). Permite rotear fluxos distintos por categoria de mercadoria.
Operação Fiscal (CFOP)	Texto + Ação	Sim	Código Fiscal de Operações e Prestações da SEFAZ (ex: `5102`, `6108`, `5405`). O botão Todos preenche automaticamente o caractere `*`, criando uma regra ampla que acolhe qualquer CFOP.
Tipo de Documento	Seleção	Sim	O Tipo de Documento final (previamente cadastrado em Tipos de Documentos) que receberá e executará os pedidos enquadrados nesta regra.
Status	Seleção	Sim	Ativo: A regra é avaliada ativamente na integração de documentos.\\Inativo: A regra fica desabilitada e é ignorada pelo motor de roteamento.
Observação	Texto Livre	Não	Campo descritivo para notas operacionais da equipe de TI / logística (ex: Regra de Vendas Varejo CD Joinville - Criada em Out/2026).

—

Em implantações com múltiplos centros de distribuição, dezenas de CFOPs e centenas de depósitos, cadastrar regras uma a uma pode ser demorado. O BeeStock disponibiliza o recurso de Importação em Lote:

1. Abrir o Assistente: Na tela de listagem, clique no botão Criar novas regras em lote (com ícone de elo/link).
2. Preparar a Planilha: Monte um arquivo no formato CSV ou Excel (.xlsx) estruturado com as colunas correspondentes:
- Filial, TipoMovimentacao, Deposito, FornecedorCliente, Transportadora, TipoEntrega, GrupoEstoque, CFOP, TipoDocumento, Status, Observacao.
3. Arrastar ou Selecionar o Arquivo: Arraste o arquivo diretamente para a área tracejada de upload ou clique para navegar e selecionar em seu computador.
4. Processamento e Validação Automática:
- O BeeStock analisa linha por linha antes de gravar.
- Caso algum código de filial, depósito ou tipo de documento não exista no banco de dados, o assistente indica a linha exata e a divergência encontrada, permitindo a correção imediata.
5. Conclusão: Todas as regras válidas são criadas instantaneamente no sistema e entram em vigor para as próximas integrações.

—

Regra Específica vs Regra Coringa (*): O motor de roteamento do BeeStock sempre avalia as regras da mais específica para a mais abrangente. Portanto, configure regras pontuais (ex: Cliente Específico + CFOP 5102 ➔ Tipo Especial) e mantenha uma regra genérica ao final (Qualquer Cliente + CFOP * ➔ PDV Padrão) como rede de segurança.
Evite Duplicidade de Critérios: Não cadastre duas regras com exatamente a mesma combinação de filtros para o mesmo Tipo de Movimentação na mesma Filial, pois isso gera ambiguidade no roteador.
Inativação em vez de Exclusão: Quando uma operação comercial for encerrada (ex: um contrato com cliente ou transportadora), prefira alterar o status da regra para Inativo em vez de excluí-la, preservando o histórico auditável de movimentações antigas.
Testes em Homologação: Antes de aplicar uma nova regra em lote no ambiente principal, crie um documento de teste na base de desenvolvimento para assegurar que o tipo de documento atribuído foi exatamente o esperado.

—

Pergunta / Dúvida Operacional	Resposta Objetiva no Manual
Como criar uma regra geral de vendas que atenda a todos os clientes e todas as operações fiscais?	No Configurador, selecione a Filial, Tipo de Movimentação como Saída, o Depósito aplicável, deixe Cliente e Transportadora em branco, clique no botão Todos no campo Operação Fiscal para preencher com o asterisco ``, e selecione o Tipo de Documento PDV*.
O que acontece quando mais de uma regra bate com os dados da nota fiscal integrada?	O motor de roteamento do BeeStock opera com hierarquia de especificidade: regras que possuem filtros exatos (ex: Cliente Específico + CFOP pontual) têm precedência sobre regras genéricas com coringa `*`.
Como importar centenas de regras de filiais e CFOPs de uma só vez?	Na listagem do Configurador, clique no botão Criar novas regras em lote e arraste a planilha CSV estruturada com as colunas necessárias. O sistema valida linha a linha antes de salvar.
O que fazer quando uma regra antiga não deve mais ser utilizada mas possui histórico?	Em vez de excluir a regra, altere seu campo Status para Inativo. Isso desativa a regra imediatamente no roteador e preserva todo o histórico para auditoria.
Por que um pedido importado do ERP caiu em um Tipo de Documento inesperado?	Verifique se não existe uma regra mais específica cadastrada com o mesmo CFOP, Depósito ou Transportadora daquele pedido, ou se a regra padrão desejada está com status Ativo.