- Created by Rosana Fagundes dos Santos Matos, last modified on Aug 25, 2025
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 9 Next »
Produto: Maxinsight

O objetivo do documento abaixo é fornecer as informações detalhadas sobre as tabelas disponíveis no DW. Seguindo o conceito de Fatos e Dimensões, será possível consultar e relacionar as tabelas, com o objetivo de disponibilizar os dados que são apresentados nos painéis do MaxGestão.
O documento está dividido em duas partes (1 - Fatos , 2 - Dimensões).
1 - Fatos
1.1 - fato_carteira (informações dos clientes das carteiras dos representantes)
1.2 - fato_pedido_realizado (informações gerais dos pedidos realizados)
1.3 - fato_pedido_previsto (informações gerais dos pedidos previstos)
1.4 - fato_km_cliente (informações gerais das quilometragens percorridas)
1.5 - fato_km_total (informações gerais das quilometragens percorridas entre os eventos)
1.6 - fato_eventos (informações gerais dos eventos realizados)
1.7 - fato_fornecedores_emissao (informações de vendas por fornecedores na visão de emissão dos pedidos)
1.8 - fato_fornecedores_faturamento (informações de vendas por fornecedores na visão de data de faturamento dos pedidos)
1.9 - fato_positivados (informações gerais dos clientes com positivação)
1.10 - fato_faturamento (informações gerais de vendas faturadas)
1.11 - fato_diasuteis (informações dos dias úteis registrados no calendário anual)
1.12 - fato_atendimento (Informações dos atendimentos realizados)
1.13 - fato_planejamento_visitas (Informações de rotas planejadas)
1.14 - fato_planejamento_entregas (Informações de entregas planejadas)
1.15 - fato_entregas_realizadas (Informações de entregas realizadas)
2 - Dimensões
2.1 - dim_gerente (informações dos Gerentes)
2.2 - dim_cliente (informações dos Clientes)
2.3 - dim_vendedores (informações dos Vendedores)
2.4 - dim_supervisores (informações dos Supervisores)
2.5 - dim_filial (informações das Filiais)
2.6 - dim_produto (informações dos produtos)
2.7 - dim_pedido (informações dos pedidos)
2.8 - dim_nota_fiscal (informações das notas fiscais)
2.9 - dim_acessodados (informações de acessos liberados)
2.10 - dim_carteira_cli_por_vendedor (informações agrupadas dos clientes da carteira do vendedor)
2.11 - dim_cliente_localizacao (informações de geolocalização dos clientes)
2.12 - dim_data (informações de data)
2.13 - dim_data_faturamento (informações de data de pedidos faturados)
2.14 - dim_eventos_positivados (informações dos eventos com positivação)
2.15 - dim_eventos_qtd_cli_carteira (informações de eventos dos clientes da carteira do vendedor)
2.16 - dim_eventos_qtde_agendamentos (informações de quantidade de clientes agendados e visitados)
2.17 - dim_eventos_qtde_equipes (informações agrupadas da quantidade de equipes nos eventos)
2.18 - dim_eventos_sequencia_prevista (informações de sequência prevista das visitas)
2.19 - dim_eventos_tabela_agendados (informações gerais dos clientes agendados)
2.20 - dim_acessoentidades (informações das entidadades cadastradas por perfil de usuário)
2.21 - dim_fornecedor (Informações dos Fornecedores)
1 - Fatos
1.1 - fato_carteira
| Tabela | FATO_CARTEIRA | ||||
|---|---|---|---|---|---|
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data_completa | date | N | Data e hora do pedido | ||
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_supervisor | varchar | 256 | N | Código do Supervisor | |
| qtde_clientes | float | 8 | N | Quantidade de clientes da carteira do Vendedor | |
| qtd_vendedores | float | 8 | N | Quantidade de Vendedores | |
| qtd_clientes_positivados | float | 8 | N | Quantidade de Clientes positivados | |
Tabela utilizada para armazenar os dados de quantidade e positivação de clientes da carteira do vendedor.
- Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_supervisores)
- Faça a junção por vendedor (fato_carteira.codigo_vendedor -> dim_vendedores.codigo_vendedor).
- Faça a junção por supervisor (fato_carteira.codigo_supervisor -> dim_supervisores.codigo_supervisor).
1.2 - fato_pedido_realizado
| Tabela | FATO_PEDIDO_REALIZADO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data_completa | date | N | Data e hora da realização do pedido | ||
| condvenda | int | 4 | N | Tipo de venda - Normal, bonificada, futura etc. (1 – Venda, 5 – Bonificação, 7 - Venda Futura, 11 – Troca, 13 – NF Manifesto (Saída), 14 – Venda Manifesto (ProntaEntrega), 24 – Bonificação (Pronta-Entrega). | |
| codigo_filial | varchar | 256 | N | Código da Filial | |
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_supervisor | varchar | 256 | N | Código do Supervisor | |
| codigo_produto | varchar | 256 | N | Código do Produto | |
| codigo_depto | varchar | 256 | N | Código do Departamento | |
| codigo_secao | varchar | 256 | N | Código da Seção | |
| codigo_fornecedor | varchar | 256 | N | Código do Fornecedor | |
| codigo_categoria | varchar | 256 | N | Código da Categoria | |
| qtdpedidorealizado | int | 4 | N | Quantidade de pedidos realizados | |
| valor_realizado | float | 8 | N | Valor do pedido realizado | |
| vlatend | float | 8 | N | Valor atendido | |
| vlvendaprev | float | 8 | N | Valor previsto do pedido | |
| vlbonific | float | 8 | N | Valor de bonificação | |
| vlpedido | float | 8 | N | Valor do pedido | |
| numped | int | 4 | N | Número do pedido | |
| aguardando | varchar | 256 | N | Se o pedido está aguardando autorização do supervisor | |
| numpederp | int | 4 | N | Número do pedido do ERP. | |
Tabela utilizada para armazenar os valores de pedidos realizados, seguindo o conceito da visão de emissão de pedido do painel geral do MaxGestão.
- Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_supervisores, dim_filial, dim_cliente, dim_produto) , podendo verificar qual fornecedor está com os acessos liberados através da (dim_acessodados).
- Faça a junção por vendedor (fato_pedido_realizado.codigo_vendedor -> dim_vendedores.codigo_vendedor).
- Faça a junção por supervisor (fato_pedido_realizado.codigo_supervisor -> dim_supervisores.codigo_supervisor).
- Faça a junção por filial(fato_pedido_realizado.codigo_filial -> dim_filial.codigo_filial).
- Faça a junção por cliente(fato_pedido_realizado.codigo_cliente -> dim_cliente.codigo_cliente).
- Faça a junção por produto(fato_pedido_realizado.codigo_produto -> dim_produto.codigo_produto).
- Para verificar por fornecedores, adicione no WHERE fato_pedido_realizado.codigo_fornecedor in (select key_dados from dim_acessodados where codigo_dados = ‘99’)
1.3 - fato_pedido_previsto
| Tabela | FATO_PEDIDO_PREVISTO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data_completa | date | N | Data e hora do pedido | ||
| codigo_filial | varchar | 256 | N | Código da Filial | |
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_supervisor | varchar | 256 | N | Código do Supervisor | |
| tipopedido | numeric | 18 | N | Tipo de pedido (1 - Pedido, 2 - Orçamento) | |
| condvenda | numeric | 18 | N | Tipo de venda - Normal, bonificada, futura etc. (1 – Venda, 5 – Bonificação, 7 - Venda Futura, 11 – Troca, 13 – NF Manifesto (Saída), 14 – Venda Manifesto (ProntaEntrega), 24 – Bonificação (Pronta-Entrega). | |
| vlatend | float | 8 | N | Valor atendido | |
| vlvendaprev | float | 8 | N | Valor de venda prevista | |
| vlbonific | float | 8 | N | Valor de bonificação | |
| aguardando | varchar | 256 | N | Se o pedido está aguardando autorização do Supervisor | |
| codusuario | varchar | 256 | N | Código do usuário na Máxima | |
| status | int | 4 | N | Status do Pedido 1 - Enviado para API 2 - Enviado para ERP 3 - Recebido pelo ERP 4 - Processado pelo ERP 5 - Erro de Processamento no ERP 6 - Pedido Bloqueado para Envio ao ERP 7 - Pedido Bloqueado/Cancelado 8 - Pedido Pendente de Autorização 9 - Pedido Aprovado 10 - Pedido Negado 11 - Pedido Gravado no Força de Vendas (FV) 12 - Cancelamento de Pedido 13 - Carregamento Não Importado 14 - Erro de Integração com ERP 15 - Cancelamento de Pedido no ERP | |
| numped | numeric | 18 | N | Número do pedido | |
| numpederp | numeric | 18 | N | Número do pedido no ERP. | |
| tipocritica | numeric | 10 | N | Tipo de crítica (0 = Sucesso, 1 = Alerta, 2 = Erro, 3 = Cancelado, 4 = Aguardando Autorização Preço, 5 = Autorização Preço Aceita, 6 = Autorização Preço Negada, 7 = Processando, 8 = Aguardando Assinatura, 9 = Falha No WebService, 10 = Aguardando Autorização Lucratividade, 11 = Autorização Lucratividade Aceita, 12 = Autorização Lucratividade Negada, 13 = Aguardando Autorização Geral, 14 = Autorização Geral Aceita, 15 = Autorização Geral Negada, 16 = Pedidos Enviado Para Nuvem, 17 = Pedido Bloqueado Nuvem, 18 = Pedido Cancelado Nuvem, 19 = Aguardando Autorização Bonificação, 20 = Autorização Bonificação Aceita, 21 = Autorização Bonificação Negada, 22 = Aguardando Autorização Pedido Troca, 23 = Autorizacao Pedido Troca Aceita, 24 = Autorizacao Pedido Troca Negada, 25 = Aguardando Autorização SaldoCC Negativo, 26 = Autorização SaldoCC Negativo Aceita, 27 = Autorização SaldoCC Negativo Negada, 28 = Aguardando Autorização Lucratividade Fornecedor, 29 = Autorização Lucratividade Fornecedor Aceita, 30 = Autorização Lucratividade Fornecedor Negada, 31 = Aguardando Autorização Cliente Bloqueado, 32 = Autorizacao Cliente Bloqueado Aceita, 33 = Autorizacao Cliente Bloqueado Negada, 34 = Aguardando Autorização Cliente Limite Excedido, 35 = Autorizacao Cliente Limite Excedido Aceita, 36 = Autorizacao Cliente Limite Excedido Negada, 37 = Erro Token Link MaxPag, 38 = Aguardando Link MaxPag, 39 = Aguardando Preenchimento Link MaxPag, 40 = Erro Geração Link MaxPag, 41 = Erro Colunas MaxPag, 42 = Erro Processamento MaxPag, 43 = Pre-Pagamento Autorizado MaxPag, 44 = Em Processamento MaxPag, 45 = Autorizado MaxPag, 46 = Cancelado MaxPag, 47 = Não Autorizado MaxPag, 48 = Validade Incorreta MaxPag, 49 = Autorização Pendente, 50 = Autorização de Item Bonificado Aceita, 51 = Autorização de Item Bonificado Negada ) | |
| posicao | string | 256 | N | Status do Pedido (L – Liberado, C – Cancelado, F - Faturado, B - Bloqueado, null - Pedido não existe no histórico) | |
Tabela utilizada para armazenar dados dos pedidos previstos.
- Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_supervisores, dim_filial, dim_cliente) .
- Faça a junção por vendedor (fato_pedido_previsto.codigo_vendedor -> dim_vendedores.codigo_vendedor).
- Faça a junção por supervisor (fato_pedido_previsto.codigo_supervisor -> dim_supervisores.codigo_supervisor).
- Faça a junção por filial(fato_pedido_previsto.codigo_filial -> dim_filial.codigo_filial).
- Faça a junção por cliente(fato_pedido_previsto.codigo_cliente -> dim_cliente.codigo_cliente).
1.4 - fato_km_cliente
| Tabela | FATO_KM_CLIENTE | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
| evento_distancia | float | 8 | N | Distância total do evento | |
| data_hora_evento | timestamp | N | Data e hora do evento | ||
Tabela utilizada para armazenar dados da distância percorrida por cliente.
- Relacione e agrupe a fato com a dimensão( dim_cliente) .
- Faça a junção por cliente(fato_km_cliente.codigo_cliente -> dim_cliente.codigo_cliente).
1.5 - fato_km_total
| Tabela | FATO_KM_TOTAL | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data_completa | timestamp | N | Data e hora do evento | ||
| codigo_cliente_maxima | varchar | 256 | N | Código do Cliente na Máxima | |
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_usuario | varchar | 256 | N | Código do usuário na Máxima | |
| codigo_supervisor | varchar | 256 | N | Código do Supervisor | |
| tipo_distancia | varchar | 256 | N | Tipo de distância percorrida (RASTRO ou TRABALHADO) | |
| valor_distancia | float | 8 | N | Somatório total da distância percorrida | |
| total_acuracia | float | 8 | N | Precisão na captura do KM Trabalhado | |
Tabela utilizada para armazenar dados da distância total percorrida(RASTRO e TRABALHADO).
- Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_supervisores) .
- Faça a junção por vendedor (fato_km_total.codigo_vendedor -> dim_vendedores.codigo_vendedor).
- Faça a junção por supervisor (fato_km_total.codigo_supervisor -> dim_supervisores.codigo_supervisor).
1.6 - fato_eventos
| Tabela | FATO_EVENTOS | ||||
|---|---|---|---|---|---|
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| id | varchar | 256 | N | Id do evento | |
| id_apk | numeric | 256 | N | Id do evento gerado na APK | |
| tipo_evento | varchar | 256 | N | Tipo do Evento(CHECKIN - CHECKOUT - PEDIDO - PEDIDOBLOQUEADO - JUSTIFICATIVANAOVENDA) | |
| rastro_id_apk | numeric | 8 | N | Id único gerado a cada rastro | |
| codigo_produto_maxima | numeric | 8 | N | Código Produto da máxima (1 - MaxGestão) | |
| codigo_cliente_maxima | varchar | 256 | N | Código do cliente na Máxima | |
| informacoes_adicionais | varchar | 256 | N | Observações inseridas no evento | |
| codigo_usuario | varchar | 256 | N | Código usuário na Máxima | |
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_supervisor | varchar | 256 | N | Código do Supervisor | |
| latitude | float | 8 | N | Latitude do Rastro | |
| longitude | float | 8 | N | Longitude do Rastro | |
| data_hora_captura | timestamp | N | Data e hora da captura do rastro | ||
| data_hora_captura_tz | timestamp | N | Data e hora da captura do rastro(- 03:00) | ||
| velocidade | numeric | 18 | N | Velocidade da captura | |
| acuracia | numeric | 18 | N | Precisão(em metros) na captura do KM Trabalhado | |
| distancia | numeric | 18 | N | Distância percorrida | |
| modo_aviao | bool | N | Se o modo avião estava ativado (F ou V) | ||
| economia_energia | bool | N | Se o modo de economia de bateria estava ativado (F ou V) | ||
| gps | bool | N | Se o GPS estava ativado (F ou V) | ||
| wifi | bool | N | Se o Wifi estava ativado (F ou V) | ||
| dadosmoveis | bool | N | Se os dados móveis estava ativado (F ou V) | ||
| bateria | varchar | 256 | N | Porcentagem da Bateria | |
| numeroversao | varchar | 256 | N | Versão da APK do MaxPedido | |
| codigo_cliente | varchar | 256 | N | Código do Cliente visitado | |
| checkincheckout_codigo_vinculacao | varchar | 18 | N | Código de vinculação do Checkin e Checkout | |
| data_hora_evento | timestamp | N | Data e hora do evento | ||
| data_hora_evento_tz | timestamp | N | Data e hora do evento(-03:00) | ||
| motivo_justificativa | varchar | 256 | N | Justificativa de Venda e não venda | |
| data_abertura | timestamp | N | Data da abertura do aparelho | ||
| data_abertura_tz | timestamp | N | Data da abertura do aparelho(-03:00) | ||
| data_fechamento | timestamp | N | Data de fechamento do aparelho | ||
| data_fechamento_tz | timestamp | N | Data de fechamento do aparelho(-03:00) | ||
| justificativa_nao_venda_codigovinculacao | varchar | 18 | N | Código de vinculação da Justificativa de Não venda | |
| data_inicio_pedido | timestamp | N | Data de início do pedido | ||
| data_inicio_pedido_tz | timestamp | N | Data de início do pedido(-03:00) | ||
| data_fim_pedido | timestamp | N | Data do fim do pedido | ||
| data_fim_pedido_tz | timestamp | N | Data do fim do pedido(-03:00) | ||
| numero_pedido | numeric | 18 | N | Número do pedido | |
| numero_pedido_rca | numeric | 18 | N | Número do pedido do Vendedor | |
| conteudo | varchar | 256 | N | Informação completa do rastro | |
| pedido_codigo_vinculacao | varchar | 18 | N | Refere-se ao código de vinculação do pedido | |
Tabela utilizada para armazenar todas as informações de eventos(CHECKIN - CHECKOUT - PEDIDO - PEDIDOBLOQUEADO - JUSTIFICATIVANAOVENDA).
- Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_supervisores, dim cliente, dim_cliente_localizacao(Para verificar Latitude e Longitude)) .
- Faça a junção por vendedor (fato_eventos.codigo_vendedor -> dim_vendedores.codigo_vendedor).
- Faça a junção por supervisor (fato_eventos.codigo_supervisor -> dim_supervisores.codigo_supervisor).
- Faça a junção por cliente (fato_eventos.codigo_cliente -> dim_cliente.codigo_cliente).
- Faça a junção por cliente para verificar latitude e longitude (fato_eventos.codigo_cliente -> dim_cliente_localizacao.codigo_cliente).
1.7 - fato_fornecedores_emissao
| Tabela | FATO_FORNECEDORES_EMISSAO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data_completa | date | N | Data da venda por Fornecedor por emissão do pedido | ||
| codigo_fornecedor | varchar | 256 | N | Código do Fornecedor | |
| codigo_supervisor | varchar | 256 | N | Código do Supervisor | |
| codigo_filial | varchar | 256 | N | Código da Filial | |
| vldevolucao | float | 8 | N | Valor de devolução por Fornecedor por emissão do pedido | |
Tabela utilizada para armazenar as informações de vendas por fornecedor no conceito de Emissão de pedido.
- Relacione e agrupe a fato com as dimensões(dim_supervisores, dim_filial) , podendo verifica qual fornecedor está com os acessos liberados através da (dim_acessodados).
- Faça a junção por supervisor (fato_fornecedores_emissao.codigo_supervisor -> dim_supervisores.codigo_supervisor).
- Faça a junção por filial(fato_fornecedores_emissao.codigo_filial -> dim_filial.codigo_filial).
- Para verificar por fornecedores, adicione no WHERE fato_fornecedores_emissao.codigo_fornecedor in(select key_dados from dim_acessodados where codigo_dados = ‘99’)
1.8 - fato_fornecedores_faturamento
| Tabela | FATO_FORNECEDORES_FATURAMENTO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data_completa | date | N | Data da venda por Fornecedor por data de faturamento | ||
| codigo_fornecedor | varchar | 256 | N | Código do Fornecedor | |
| codigo_supervisor | varchar | 256 | N | Código do Supervisor | |
| codigo_filial | varchar | 256 | N | Código da Filial | |
| vldevolucao | float | 8 | N | Valor de devolução por Fornecedor por data de faturamento | |
Tabela utilizada para armazenar as informações de vendas por fornecedor no conceito de Data de faturamento do pedido.
- Relacione e agrupe a fato com as dimensões(dim_supervisores, dim_filial) , podendo verificar qual fornecedor está com os acessos liberados através da (dim_acessodados).
- Faça a junção por supervisor (fato_fornecedores_faturamento.codigo_supervisor -> dim_supervisores.codigo_supervisor).
- Faça a junção por filial(fato_fornecedores_faturamento.codigo_filial -> dim_filial.codigo_filial).
- Para verificar por fornecedores, adicione no WHERE fato_fornecedores_faturamento.codigo_fornecedor in (select key_dados from dim_acessodados where codigo_dados = ‘99’)
1.9 - fato_positivados
| Tabela | FATO_POSITIVADOS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_supervisor | varchar | 256 | N | Código do Supervisor | |
| codigo_gerente | varchar | 256 | N | Código do Gerente | |
| qtd_produtos | float | 8 | N | Quantidade de produtos | |
| qtd_clientes | float | 8 | N | Quantidade de clientes positivados | |
| data_completa | date | N | Data da positivação | ||
Tabela utilizada para armazenar informações de quantidade de clientes e produtos positivados, seja por gerente, supervisor ou vendedor.
- Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_supervisores, dim_gerente) .
- Faça a junção por vendedor (fato_positivados.codigo_vendedor -> dim_vendedores.codigo_vendedor).
- Faça a junção por supervisor (fato_positivados.codigo_supervisor -> dim_supervisores.codigo_supervisor).
- Faça a junção por gerente (fato_positivados.codigo_gerente -> dim_supervisores.codigo_gerente).
1.10 - fato_faturamento
| Tabela | FATO_FATURAMENTO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
| codigo_vendedor | varchar | 256 | N | Código do vendedor | |
| codigo_produto | varchar | 256 | N | Código do Produto | |
| data_completa | date | N | Data completa do faturamento | ||
| codigo_filial | varchar | 256 | N | Código da Filial | |
| data_pedido | date | N | Data do pedido | ||
| data_faturamento | date | N | Data faturamento | ||
| numero_nota_fiscal | numeric | 18 | N | Número da Nota Fiscal | |
| valor_ipi_bonific | float | 8 | N | Valor de IPI bonificado | |
| peso_bruto | float | 8 | N | Indica Peso Bruto | |
| qtde_venda | float | 8 | N | Quantidade vendida | |
| valor_ipi | float | 8 | N | Valor de IPI | |
| qtde_contabil | float | 8 | N | Quantidade contábil | |
| numero_itens | numeric | 10 | N | Número de itens | |
| sub_total | float | 8 | N | Sub total | |
| valor_bonific_unit | float | 8 | N | Valor de bonificação | |
| valor_tabela_unit | float | 8 | N | Valor de tabela do Pedido | |
| valor_custo_fin_unit | float | 8 | N | Valor do custo financeiro | |
| valor_venda_unit | float | 8 | N | Valor unitário de venda do pedido | |
| st_unit | float | 8 | N | Valor unitário de ST | |
| valor_repasse_unit | float | 8 | N | Valor unitário de repasse do pedido | |
Tabela utilizada para armazenar todas as informações de vendas faturadas, na visão de Data de faturamento do pedido do Painel geral do MaxGestão.
OBS: A fato foi criada para substituir a fato_faturamento que possui o mesmo dicionário de dados.
- Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_supervisores, dim_filial, dim_cliente, dim_produto) , podendo verifica qual fornecedor está com os acessos liberados através da (dim_acessodados).
- Faça a junção por vendedor (fato_faturamento.codigo_vendedor -> dim_vendedores.codigo_vendedor).
- Faça a junção por supervisor (fato_faturamento.codigo_supervisor -> dim_supervisores.codigo_supervisor).
- Faça a junção por filial(fato_faturamento.codigo_filial -> dim_filial.codigo_filial).
- Faça a junção por cliente(fato_faturamento.codigo_cliente -> dim_cliente.codigo_cliente).
- Faça a junção por produto(fato_faturamento.codigo_produto -> dim_produto.codigo_produto).
- Para verificar por fornecedores, adicione no WHERE fato_faturamento.codigo_fornecedor in (select key_dados from dim_acessodados where codigo_dados = ‘99’)
1.11 - fato_diasuteis
| Tabela | FATO_DIASUTEIS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data | date | N | Dias úteis no calendário anual | ||
Tabela utilizada para armazenar as informações de dias úteis.
1.12 - fato_atendimento
| Tabela | FATO_ATENDIMENTO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| sequencia_realizada | int | 4 | N | Sequência do atendimento realizado | |
| horario_atendimento_evento_tz | timestamp | N | Data e hora do atendimento (-03:00) | ||
| horario_atendimento_evento | timestamp | N | Data e hora do atendimento | ||
| data_atendimento | date | N | Data do atendimento | ||
| horainicio_atendimento | varchar | 256 | N | Hora de início do atendimento | |
| horafim_atendimento | varchar | 256 | N | Hora de fim do atendimento | |
| tempo_atendimento | varchar | 256 | N | Tempo do atendimento | |
| tempo_deslocamento | varchar | 256 | N | Tempo de deslocamento | |
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_usuario | varchar | 256 | N | Código do usuário na Máxima | |
| numero_pedido | numeric | 18 | N | Número do pedido | |
| codigo_justificativa | varchar | 256 | N | Código de Justificativa de não venda | |
Tabela utilizada para armazenar as informações de atendimento usando validação do painel de auditório do maxGestão.
- Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_cliente)
- Faça a junção por vendedor (fato_atendimento.codigo_vendedor -> dim_vendedores.codigo_vendedor).
- Faça a junção por cliente(fato_atendimento.codigo_cliente -> dim_cliente.codigo_cliente).
1.13 - fato_planejamento_visitas
| Tabela | FATO_DIASUTEIS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data | varchar | 256 | N | Data da visita planejada | |
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
| id_rota | numeric | 18 | N | Identificador da rota cadastrada | |
| sequencia | numeric | 4 | N | Sequência da rota cadastrada | |
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
Tabela utilizada para armazenar as informações do agendamento de visitas de clientes.
- Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_cliente)
- Faça a junção por vendedor (fato_atendimento.codigo_vendedor -> dim_vendedores.codigo_vendedor).
- Faça a junção por cliente(fato_atendimento.codigo_cliente -> dim_cliente.codigo_cliente).
1.14 - fato_planejamento_entrega
| Tabela | FATO_PLANEJAMENTO_ENTREGAS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_carregamento | numeric | 18 | N | Código do carregamento | |
| codigo_entrega | numeric | 18 | N | Código da entrega cadastrada | |
| data_saida_carregamento | date | N | Data da saida do carregamento | ||
| codigo_cliente | varchar | 256 | N | Código do cliente | |
| codigo_rota_cliente | varchar | 256 | N | Código da rota cadastrada do cliente | |
| codigo_motorista | varchar | 256 | N | Código do Motorista | |
| filial_pedido | varchar | 256 | N | Código da Filial | |
| seq_prevista | int | 4 | N | Número da sequência da entrega planejada | |
| situacao_entrega | varchar | 256 | N | Situação da entrega (FN- | |
| distancia_planejada | float | 8 | N | Distância planejada em KM | |
Tabela utilizada para armazenar as informações do agendamento de entregas nos clientes realizada no maxMotorista/maxRoteirizador.
Relacione e agrupe a fato com as dimensões(dim_filial, dim_cliente)
Faça a junção por vendedor (fato_planejamento_entregas.filial_pedido -> dim_filial.codigo_filial).
Faça a junção por cliente(fato_planejamento_entregas.codigo_cliente -> dim_cliente.codigo_cliente).
1.15 - fato_entregas_realizadas
| Tabela | FATO_ENTREGAS_REALIZADAS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_carregamento | numeric | 18 | N | Código do carregamento | |
| codigo_entrega | numeric | 18 | N | Código da entrega cadastrada | |
| data_saida_carregamento | date | N | Data da saída do carregamento | ||
| codigo_cliente | varchar | 256 | N | Código do cliente | |
| codigo_rota_cliente | varchar | 256 | N | Código da rota cadastrada do cliente | |
| codigo_motorista | varchar | 256 | N | Código do Motorista | |
| filial_pedido | varchar | 256 | N | Código da Filial | |
| data_inicio_descarga | date | N | Data início da descarga | ||
| data_fim_descarga | date | N | Data final da descarga | ||
| data_inicio_romaneio | date | N | Data início do romaneio | ||
| data_fim_romaneio | date | N | Data final do romaneio | ||
| tempo_entrega_em_minutos | float | 8 | N | Tempo de entrega em minutos | |
| seq_realizada | int | 4 | N | Número da sequência da entrega realizada | |
| situacao_entrega | varchar | 256 | N | Situação da entrega (FN- | |
Tabela utilizada para armazenar as informações da realização de entregas nos clientes realizada no maxMotorista.
Relacione e agrupe a fato com as dimensões(dim_filial, dim_cliente)
Faça a junção por vendedor (fato_planejamento_entregas.filial_pedido -> dim_filial.codigo_filial).
Faça a junção por cliente(fato_planejamento_entregas.codigo_cliente -> dim_cliente.codigo_cliente).
1.16 - fato_entregas
| Tabela | FATO_ENTREGAS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_motorista | varchar | 256 | N | Código ou matrícula do motorista responsável pela entrega | |
| numero_carregamento | varchar | 256 | N | Número do carregamento associado à entrega | |
| id_entrega | bigint | N | PK | Identificador único da entrega | |
| total_registradas | bigint | N | Quantidade de entregas registradas com status válidos | ||
| entregues | bigint | N | Quantidade de entregas concluídas com sucesso | ||
| devolucao_parcial | bigint | N | Quantidade de entregas com devolução parcial | ||
| devolucao_total | bigint | N | Quantidade de entregas com devolução total | ||
| reentrega | bigint | N | Quantidade de entregas reenviadas (reentrega) | ||
| checkin | bigint | N | Quantidade de entregas com registro de check-in no cliente | ||
| finalizada | bigint | N | Quantidade de entregas finalizadas | ||
| pendente | bigint | N | Quantidade de entregas pendentes de conclusão | ||
| espera | bigint | N | Quantidade de entregas em estado de espera | ||
| recebimento_pendente | bigint | N | Quantidade de entregas aguardando recebimento pelo cliente | ||
| solicitada_devolucao | bigint | N | Quantidade de entregas com solicitação de devolução registrada | ||
| tem_carregamento | varchar | 256 | N | Indica se existe carregamento associado à entrega (campo auxiliar) | |
| seq_motorista_dtsaida | integer | N | Sequência da saída do motorista no dia, usada para ordenação | ||
| codigo_cliente | varchar | 256 | N | Código do cliente para o qual a entrega foi feita | |
| data_inicio_descarga | date | N | Data e hora do início da descarga no local de entrega | ||
| data_termino_descarga | date | N | Data e hora de término da descarga no local de entrega | ||
| tempo_entrega | numeric | 18 | N | Tempo total da entrega em minutos (diferença entre início e fim da descarga) | |
| data_inicio_checkin | date | N | Data e hora em que o motorista fez check-in no local do cliente | ||
| tolerancia_raio_entrega | numeric | 18,2 | N | Distância máxima tolerada (em metros) entre ponto de check-in e localização prevista | |
| raio_entrega | numeric | 18,2 | N | Distância real (em metros) entre check-in e ponto previsto da entrega | |
| latitude_cliente | varchar | 256 | N | Latitude prevista do endereço de entrega do cliente | |
| longitude_cliente | varchar | 256 | N | Longitude prevista do endereço de entrega do cliente | |
| latitude_checkin | varchar | 256 | N | Latitude em que o motorista fez o check-in | |
| longitude_checkin | varchar | 256 | N | Longitude em que o motorista fez o check-in | |
Tabela utilizada para armazenar as informações da realização de entregas nos clientes realizadas no maxMotorista.
A tabela permite análises detalhadas sobre o comportamento e qualidade das entregas, como tempo de descarga, check-ins realizados,
devoluções, reentregas e distância entre o ponto previsto e o check-in.
OBS: Esta fato se conecta diretamente com os dados de carregamento e pedidos realizados,
permitindo cruzamentos com dados operacionais e logísticos.
- Para visualizar informações usuários do tipo “Motorista”, usar dim_usuario_motorista. Tipo = ‘M’
Relacione e agrupe a fato com as dimensões (dim_cliente, dim_empregado, dim_veiculo, dim_usuario_motorista.id_motorista, dim_situacao_entrega)
Faça a junção por cliente → (fato_entregas.codigo_cliente → dim_cliente.codigo_cliente)
Faça a junção por empregado → (fato_entregas.codigo_motorista → dim_empregado.matricula)
Faça a junção por veículo → (fato_carregamentos.codigo_veiculo → dim_veiculo.codigo_veiculo)
Faça a junção por motorista → (fato_entregas.codigo_motorista → dim_usuario_motorista.id_motorista)
Faça a junção por situação de entrega → (fato_entregas.id_situacao_entrega → dim_situacao_entrega.id)
Relacione e com a fato_carregamentos
Faça a junção por carregamento → (fato_entregas. numero_carregamento → fato_carregamentos.numero_carregamento)
Faça a junção por situação do romaneio via fato_carregamentos → (fato_carregamentos.id_situacao_romaneio → dim_situacao_romaneio.id)
Faça a junção por destino de carregamento via fato_carregamentos → (fato_carregamentos.id_destino_carregamento → dim_destino_carregamento.id)
Exemplos de uso:
Verificar entregas que ultrapassaram o raio de tolerância:
WHERE raio_entrega > tolerancia_raio_entrega
1.17 - fato_carregamentos
| Tabela | FATO_CARREGAMENTOS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| numero_carregamento | varchar | 256 | N | Identificador do carregamento | |
| codigo_veiculo | varchar | 256 | N | Código do veículo utilizado no carregamento | |
| codigo_motorista | varchar | 256 | N | Matrícula do motorista responsável | |
| id_romaneio | bigint | N | Identificador do romaneio vinculado ao carregamento | ||
| codigo_rota_principal | varchar | 256 | N | Código da rota principal associada ao carregamento | |
| codigo_funcionario_montagem | varchar | 256 | N | Funcionário que realizou a montagem do carregamento | |
| codigo_funcionario_cancelamento | numeric | 18 | N | Funcionário que cancelou o carregamento, se houver | |
| codigo_ajudante1 | varchar | 256 | N | Código do primeiro ajudante | |
| codigo_ajudante2 | varchar | 256 | N | Código do segundo ajudante | |
| codigo_ajudante3 | varchar | 256 | N | Código do terceiro ajudante | |
| data_saida_carregamento | date | N | Data de saída programada do carregamento | ||
| data_saida_veiculo | date | N | Data de saída real do veículo | ||
| data_faturamento | date | N | Data de faturamento do carregamento | ||
| dia_dtsaida | varchar | 256 | N | Dia da saída do carregamento | |
| mes_dtsaida | varchar | 256 | N | Mês da saída do carregamento | |
| ano_dtsaida | varchar | 256 | N | Ano da saída do carregamento | |
| data_inicio_romaneio | date | N | Data de início do romaneio | ||
| data_fim_romaneio | date | N | Data de término do romaneio | ||
| data_fechamento_carregamento | date | N | Data em que o carregamento foi finalizado no sistema | ||
| data_montagem | date | N | Data da montagem física do carregamento | ||
| hora_montagem | numeric | 2 | N | Hora da montagem do carregamento | |
| minuto_montagem | numeric | 2 | N | Minuto da montagem do carregamento | |
| segundo_montagem | numeric | 2 | N | Segundo da montagem do carregamento | |
| id_situacao_romaneio | integer | N | Chave da situação do romaneio, referenciando a dimensão | ||
| seq_motorista_dtsaida | integer | N | Ordem de saída do motorista no dia | ||
| id_destino_carregamento | integer | N | Chave do destino do carregamento, referenciando a dimensão | ||
| observacao_destino | varchar | 256 | N | Observações livres sobre o destino do carregamento | |
| numero_notas_carregamento | integer | N | Número total de notas fiscais no carregamento | ||
| valor_diaria | numeric | 18,2 | N | Valor da diária paga ao motorista ou ajudantes | |
| quantidade_diaria | numeric | 18,2 | N | Quantidade de diárias atribuídas | |
| peso_total_carregamento | numeric | 18,2 | N | Peso total das mercadorias no carregamento (kg) | |
| volume_total_carregamento | numeric | 18,2 | N | Volume total das mercadorias no carregamento (m³) | |
| valor_total_carregamento | numeric | 18,2 | N | Valor total em reais das mercadorias carregadas | |
| numero_entregas | integer | N | Número total de entregas do carregamento | ||
| quantidade_itens | integer | N | Quantidade total de itens no carregamento | ||
| observacao_faturamento | varchar | 256 | N | Observações relacionadas ao faturamento do carregamento | |
Tabela utilizada para armazenar as informações dos carregamentos,
vinculando motoristas, veículos, destinos, horários, notas fiscais e custos operacionais.
A tabela permite análises operacionais sobre o processo de carregamento, montagem e faturamento,
incluindo controle de ajudantes, tempo de montagem, origem e destino.
Relacionamentos para uso analítico:
Relacione com as dimensões (dim_veiculo, dim_empregado, dim_destino_carregamento, dim_situacao_romaneio)
Faça a junção por veículo: (fato_carregamento. codigo_veiculo → dim_veiculo.codigo_veiculo)
Faça a junção por empregado para motorista e ajudantes → (
Motorista: (fato_carregamentos.codigo_motorista → dim_empregado.matricula)
Ajudante1: (fato_carregamentos. codigo_ajudante1 → dim_empregado.matricula)
Ajudante2: (fato_carregamentos. codigo_ajudante2 → dim_empregado.matricula)
Ajudante3: (fato_carregamentos. codigo_ajudante3 → dim_empregado.matricula)
Faça a junção por Destino do carregamento: (fato_carregamentos. id_destino_carregamento → dim_destino_carregamento.id)
Faça a junção por Situação do Romaneio: (fato_carregamentos.id_situacao_romaneio → dim_situacao_romaneio.id)
Relacione com a fato_entregas
Faça a junção por carregamento → (fato_carregamentos.numero_carregamento → fato_entregas. numero_carregamento)
1.18 - fato_devolucao
| Tabela | FATO_DEVOLUCAO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data_entrada | date | N | Data de entrada | ||
| numero_nota_fiscal | numeric | 18 | N | Número da nota fiscal | |
| codigo_cliente | varchar | 256 | N | Código do cliente | |
| codigo_vendedor | varchar | 256 | N | Código do vendedor | |
| codigo_filial | varchar | 256 | N | Código da filial | |
| codigo_supervisor | varchar | 256 | N | Código do supervisor | |
| vldevolucao | float | N | Valor da devolução | ||
| quantidade_nf | numeric | 18 | N | Quantidade de notas fiscais devolvidas | |
| quantidade_itens | float | N | Quantidades de itens devolvidos | ||
| quantidade_clientes_devol | varchar | 256 | N | Quantidade de clientes | |
Tabela utilizada para armazenar as informações de devolução.
Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_cliente)
Faça a junção por vendedor (fato_devolucao.codigo_vendedor -> dim_vendedores.codigo_vendedor).
Faça a junção por cliente(fato_devolucao.codigo_cliente -> dim_cliente.codigo_cliente).
1.19 - fato_estoque
| Tabela | FATO_ESTOQUE | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_fornecedor | varchar | 256 | N | Código do fornecedor | |
| id_posicao_estoque | int | N | Posição do estoque (1, 2) | ||
| posicao_estoque | varchar | 256 | N | Código do cliente 1 - Operante 2 - Bloqueado | |
| data_entrada | date | N | Data de entrada | ||
| data_saida | date | N | Data de saída | ||
| id_distribuidor | varchar | 256 | N | Identificador único do distribuidor | |
| filial | varchar | 256 | N | Código da filial | |
| codigo_armazem | varchar | 256 | N | Código do armazém | |
| id_produto | varchar | 256 | N | Código do produto | |
| quantidade | int | 256 | N | Quantidade em estoque | |
| codigo_cliente | varchar | 256 | N | Código do cliente | |
Tabela utilizada para armazenar as informações sobre estoque.
Relacione e agrupe a fato com as dimensões(dim_fornecedor, dim_produto, dim_cliente)
Faça a junção por fornecedor (fato_estoque.codigo_fornecedor -> dim_fornecedor.codigo_fornecedor).
Faça a junção por produto(fato_estoque.id_produto -> dim_produto.codigo_produto).
Faça a junção por cliente(fato_estoque.codigo_cliente -> dim_cliente.codigo_cliente).
1.20 - fato_item_devolucao
| Tabela | FATO_ITEM_DEVOLUCAO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data_devolucao | date | N | Data de devolução | ||
| numero_nota_fiscal | numeric | 18 | N | Número nota fiscal | |
| codigo_cliente | varchar | 256 | N | Código do cliente | |
| codigo_filial | varchar | 256 | N | Código filial | |
| codigo_fornecedor | varchar | 256 | N | Código do fornecedor | |
| codigo_vendedor | varchar | 256 | N | Código do vendedor | |
| codigo_supervisor | varchar | 256 | N | Código do supervisor | |
| codigo_produto | varchar | 256 | N | Código do produto | |
| codigo_barras | varchar | 256 | N | Código de barras | |
| codigo_fabrica | varchar | 256 | N | Código de fábrica | |
| quantidade_devolvida | float | 8 | N | Quantidade devolvida | |
| valor_devolucao | float | 8 | Valor devolvido | ||
Tabela utilizada para armazenar as informações dos itens das devoluções.
Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_cliente, dim produto, dim_fornecedor, filial)
Faça a junção por vendedor (fato_item_devolucao.codigo_vendedor -> dim_vendedores.codigo_vendedor).
Faça a junção por cliente (fato_item_devolucao.codigo_cliente -> dim_cliente.codigo_cliente).
Faça a junção por produto (fato_item_devolucao.codigo_produto -> dim_produto.codigo_produto).
Faça a junção por filial(fato_item_devolucao.codigo_filial -> dim_filial.codigo_filial).
1.21 - fato_item_faturamento
| Tabela | FATO_ITEM_FATURAMENTO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data_faturamento | date | N | Date de faturamento | ||
| data_pedido | date | N | Data do pedido | ||
| numero_nota_fiscal | numeric | 18 | N | Número da nota fiscal | |
| codigo_cliente | varchar | 256 | N | Código do cliente | |
| codigo_filial | varchar | 256 | N | Código da filial | |
| codigo_fornecedor | varchar | 256 | N | Código do fornecedor | |
| codigo_vendedor | varchar | 256 | N | Código do vendedor | |
| codigo_supervisor | varchar | 256 | N | Código do supervisor | |
| codigo_produto | varchar | 256 | N | Código do produto | |
| codigo_barras | varchar | 256 | N | Código de barras | |
| codigo_fabrica | varchar | 256 | N | Código de fábrica | |
| qt_vendida | int | Quantidade vendida | |||
| qt_cortada | int | Quantidade cortada | |||
| qt_faturada | int | Quantidade faturada | |||
| preco_tabela | float | 8 | Preço tabela | ||
| preco_venda | float | 8 | Preço venda | ||
| valor_desconto | float | 8 | Valor desconto | ||
| peso_bruto | numeric | 18,2 | Peso bruto | ||
| numero_pedido | bigint | Número pedido | |||
Tabela utilizada para armazenar as informações dos itens faturados.
Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_supervisores, dim_filial, dim_cliente, dim_produto).
Faça a junção por vendedor (fato_item_faturamento.codigo_vendedor -> dim_vendedores.codigo_vendedor).
Faça a junção por supervisor (fato_item_faturamento.codigo_supervisor -> dim_supervisores.codigo_supervisor).
Faça a junção por filial(fato_item_faturamento.codigo_filial -> dim_filial.codigo_filial).
Faça a junção por cliente(fato_item_faturamento.codigo_cliente -> dim_cliente.codigo_cliente).
Faça a junção por produto(fato_item_faturamento.codigo_produto -> dim_produto.codigo_produto).
1.22 - fato_metas_clientes
| Tabela | FATO_METAS_CLIENTES | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data | date | N | Data inicial da meta*** | ||
| codigo_vendedor | varchar | 256 | N | Código do vendedor | |
| codigo_rota | varchar | 256 | N | Código da rota | |
| codigo_cliente | varchar | 256 | N | Código do cliente | |
| valor_planejado | float | 8 | N | Valor planejado | |
Tabela utilizada para armazenar as informações de metas por cliente.
Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_cliente)
Faça a junção por vendedor (fato_metas_clientes.codigo_vendedor -> dim_vendedores.codigo_vendedor).
Faça a junção por cliente (fato_metas_clientes.codigo_cliente -> dim_cliente.codigo_cliente).
1.23 - fato_nota_devolucao
| Tabela | FATO_NOTA_DEVOLUCAO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data | date | N | Data da nota | ||
| numnota | numeric | 18 | N | Número nota fiscal | |
| numnota_devolucao | numeric | 18 | N | Número nota fiscal de devolução | |
| valor_devolucao | varchar | 256 | N | Valor da devolução | |
| motivo | varchar | 256 | N | Motivo da devolução | |
| codigo_vendedor | varchar | 256 | N | Código do vendedor | |
| codigo_produto | varchar | 256 | N | Código do produto | |
| codigo_cliente | varchar | 256 | N | Código do cliente | |
| codigo_fornecedor | varchar | 256 | N | Código do fornecedor | |
| codigo_filial | varchar | 256 | N | Código da filial | |
Tabela utilizada para armazenar as informações sobre notas de devolução.
Relacione e agrupe a fato com as dimensões(dim_vendedores, dim_cliente, dim_produto)
Faça a junção por vendedor (fato_nota_devolucao.codigo_vendedor -> dim_vendedores.codigo_vendedor).
Faça a junção por cliente (fato_nota_devolucao.codigo_cliente -> dim_cliente.codigo_cliente).
Faça a junção por produto(fato_nota_devolucao.codigo_produto -> dim_produto.codigo_produto).
1.24 - fato_visitas_realizadas
| Tabela | FATO_VISITAS_REALIZADAS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| data | date | N | Data da visita | ||
| codigo_cliente | varchar | 256 | N | Código do cliente | |
| id_rota | varchar | 256 | N | Identificador da rota | |
| sequencia_realizada | int | N | Sequência da visita | ||
| motivo | varchar | 256 | N | Motivo de não venda, caso não tenha ocorrido venda. | |
Tabela utilizada para armazenar as informações sobre notas de devolução.
Relacione e agrupe a fato com as dimensões (dim_vendedores, dim_cliente)
Faça a junção por vendedor (fato_visitas_realizadas.codigo_vendedor -> dim_vendedores.codigo_vendedor).
Faça a junção por cliente (fato_visitas_realizadas.codigo_cliente -> dim_cliente.codigo_cliente).
2 - Dimensões
2.1 - dim_gerente
| Tabela | DIM_GERENTE | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_gerente | varchar | 256 | N | Código do Gerente | |
| nome_gerente | varchar | 256 | N | Nome do Gerente | |
| codigo_filial | varchar | 256 | N | Código da Filial | |
Tabela utilizada para armazenar as informações dos gerentes.
- Colunas utilizadas para agrupamento e ligação com as fatos -> (codigo_gerente, codigo_filial).
2.2 - dim_cliente
| Tabela | DIM_CLIENTE | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
| codigo_cliente_principal | varchar | 256 | N | Código do Cliente Principal | |
| codigo_vendedor1 | varchar | 256 | N | Código do Vendedor1 | |
| codigo_vendedor2 | varchar | 256 | N | Código do Vendedor2 | |
| codigo_vendedor3 | varchar | 256 | N | Código do Vendedor3 | |
| fantasia | varchar | 256 | N | Nome fantasia da empresa (Pessoa Jurídica). | |
| razaosocial | varchar | 256 | N | Razão Social | |
| cnpj | varchar | 256 | N | CNPJ do Cliente | |
| tipo_documento | varchar | 256 | N | Indica se é um CNPJ ou CPF no campo cnpj | |
| cidade | varchar | 256 | N | Cidade | |
| endereco | varchar | 256 | N | Endereço | |
| uf | varchar | 256 | N | Estado | |
| bairro | varchar | 256 | N | Bairro | |
| cep | varchar | 256 | N | Cep | |
| codpraca | varchar | 256 | N | Código da Praça | |
| praca | varchar | 256 | N | Nome da Praça | |
| tipofj | varchar | 256 | N | Indica se é pessoa Física ou Jurídica (F ou J) | |
| regiao | varchar | 256 | N | Nome da Região | |
| codigo_atividade1 | varchar | 256 | N | Código da Atividade do Cliente | |
| latitude | varchar | 256 | N | Latitude do Cliente | |
| longitude | varchar | 256 | N | Longitude do Cliente | |
| id_distribuidor | varchar | 256 | N | Identificador único do Distribuidor (CNPJ da filial) | |
| codigo_filial | varchar | 256 | N | Código da filial. | |
| data_exclusao | date | N | Data da exclusão lógica. | ||
Tabela utilizada para armazenar as informações dos clientes.
- Coluna utilizada para agrupamento e ligação com as fatos ou dimensões -> (codigo_cliente).
- Colunas utilizadas para agrupamento e ligação com as fatos ou dimensões -> (codigo_vendedor1, codigo_vendedor2, codigo_vendedor3).
2.3 - dim_vendedores
| Tabela | DIM_VENDEDORES | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_filial | varchar | 256 | N | Código da Filial | |
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_usuario | varchar | 256 | N | Código do usuário na Máxima | |
| nome_vendedor | varchar | 256 | N | Nome do Vendedor | |
| nome_supervisor | varchar | 256 | N | Nome do Supervisor | |
| codigo_coordenador | varchar | 256 | N | Código do Coordenador | |
| nome_coordenador | varchar | 256 | N | Nome do Coordenador | |
| codigo_gerente | varchar | 256 | N | Código do Gerente | |
| nome_gerente | varchar | 256 | N | Nome do Gerente | |
| codigo_supervisor | varchar | 256 | N | Código do Supervisor | |
| id_distribuidor | varchar | 256 | N | Identificador único do Distribuidor | |
Tabela utilizada para armazenar as informações dos vendedores.
- Colunas utilizadas para agrupamento e ligação com as fatos -> (codigo_vendedor, codigo_supervisor,codigo_coordenador,codigo_gerente, codigo_filial, codigo_usuario).
2.4 - dim_supervisores
| Tabela | DIM_SUPERVISORES | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_supervisor | varchar | 256 | N | Código do Supervisor | |
| nome_supervisor | varchar | 256 | N | Nome do Supervisor | |
| codigo_coordenador | varchar | 256 | N | Código do Coordenador | |
| nome_coordenador | varchar | 256 | N | Nome do Coordenador | |
| codigo_gerente | varchar | 256 | N | Código do Gerente | |
| nome_gerente | varchar | 256 | N | Nome do Gerente | |
| codigo_filial | varchar | 256 | N | Código da Filial do Supervisor | |
| id_distribuidor | varchar | 256 | N | Identificador único do distribuidor | |
Tabela utilizada para armazenar as informações dos supervisores.
- Colunas utilizadas para agrupamento e ligação com as fatos -> (codigo_supervisor,codigo_coordenador,codigo_gerente, codigo_filial).
2.5 - dim_filial
| Tabela | DIM_FILIAL | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_filial | varchar | 256 | N | Código da Filial | |
| codigo_grupo_filial | varchar | 256 | N | Código do Grupo de Filial | |
| razaosocial | varchar | 256 | N | Razão Social | |
| cgc | varchar | 256 | N | Número do CNPJ | |
| tipo_documento | varchar | 256 | N | CNPJ | |
| endereco | varchar | 256 | N | Endereço | |
| bairro | varchar | 256 | N | Bairro | |
| cidade | varchar | 256 | N | Cidade | |
| uf | varchar | 256 | N | Estado | |
| cep | varchar | 256 | N | Cep | |
Tabela utilizada para armazenar as informações das filiais.
- Coluna principal para agrupamento e ligação com as fatos -> (codigo_filia, codigo_grupo_filial).
2.6 - dim_produto
| Tabela | DIM_PRODUTO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_produto | varchar | 256 | N | Código do Produto | |
| descricao_produto | varchar | 256 | N | Descrição do Produto | |
| codigo_fornecedor | varchar | 256 | N | Código do Fornecedor | |
| descricao_fornecedor | varchar | 256 | N | Descrição do Fornecedor | |
| codigo_distrib | varchar | 256 | N | Distribuidora | |
| codigo_depto | varchar | 256 | N | Código do Departamento | |
| descricao_depto | varchar | 256 | N | Descrição do Departamento | |
| codigo_secao | varchar | 256 | N | Código da Seção | |
| descricao_secao | varchar | 256 | N | Descrição da Seção | |
| codigo_marca | varchar | 256 | N | Código da Marca | |
| descricao_marca | varchar | 256 | N | Descrição da Marca | |
| codigo_fabrica | varchar | 256 | N | Código de Fábrica do Produto | |
| codigo_categoria | varchar | 256 | N | Código da Categoria | |
| categoria | varchar | 256 | N | Descrição da Categoria | |
| codigo_auxiliar | varchar | 256 | N | Código de Barras | |
| id_distribuidor | varchar | 256 | N | Identificador único do Distribuidor (CNPJ da filial) | |
| codigo_filial | varchar | 256 | N | Código da filial. | |
| diretorio_foto | varchar | 256 | N | URL com a foto do produto. | |
Tabela utilizada para armazenar as informações de produtos.
- Coluna principal para agrupamento e ligação com as fatos -> (codigo_produto).
2.7 - dim_pedido
| Tabela | DIM_PEDIDO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| numero_pedido | numeric | 18 | N | Número do pedido do ERP | |
| data_saida | date | N | Data da saída do pedido | ||
| data_faturamento | date | N | Data do faturamento do pedido | ||
| observacao | varchar | 256 | N | Observação | |
| condvenda | float | 8 | N | Tipo de venda - Normal, bonificada, futura etc. (1 – Venda, 5 – Bonificação, 7 - Venda Futura, 11 – Troca, 13 – NF Manifesto (Saída), 14 – Venda Manifesto (ProntaEntrega), 24 – Bonificação (Pronta-Entrega). | |
| id_pedido | numeric | 18 | N | Número pedido na máxima | |
Tabela utilizada para armazenar as informações dos pedidos (Data de emissão e do faturamento do pedido).
- Coluna principal para agrupamento e ligação com as fatos -> (numero_pedido).
2.8 - dim_nota_fiscal
| Tabela | DIM_NOTA_FISCAL | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| numero_pedido | numeric | 18 | N | Número do pedido | |
| numero_nota_fiscal | numeric | 18 | N | Número da Nota fiscal | |
| numero_serie_nota_fiscal | varchar | 256 | N | Número de Série | |
| codigo_operacao | varchar | 256 | N | Código do tipo de operação 0 - Registro incluído 1 - Registro atualizado 2 - Registro excluído | |
| tipo_operacao | varchar | 256 | N | Descrição da operação S - Saída SB - Saída Bonificação | |
| codigo_fiscal | varchar | 256 | N | Código Fiscal | |
| data_saida | date | N | Data de Saída da nota | ||
| datavedata_saidanda | date | N | Data de Saída da nota | ||
| data_faturamento | date | N | Data de Faturamento da nota | ||
| observacao | varchar | 256 | N | Observação | |
Tabela utilizada para armazenar as informações de NF’S e NUMPED’S.
- Coluna principal para agrupamento e ligação com as fatos -> (numero_pedido).
2.8 - dim_gerente
| Tabela | DIM_GERENTE | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_gerente | varchar | 256 | N | Código do Gerente | |
| nome_gerente | varchar | 256 | N | Nome do Gerente | |
| codigo_filial | varchar | 256 | N | Código da Filial | |
Tabela utilizada para armazenar as informações dos gerentes.
- Coluna principal para agrupamento e ligação com as fatos -> (codigo_gerente).
2.9 - dim_acessodados
| Tabela | DIM_ACESSODADOS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_usuario | varchar | 256 | N | Código usuário na Máxima | |
| codigo_dados | varchar | 256 | N | Enumerador que denomina o tipo de entidade (1 - PLANO DE PAGAMENTO, 2 - COBRANÇA, 3 - DEPARTAMENTO, 4 - SEÇÃO, 5 - SUPERVISOR, 6 - FILIAL, 7 - REGIÃO, 99- FORNECEDOR) | |
| key_dados | varchar | 256 | N | Código da Entidade | |
Tabela utilizada para armazenar as informações de entidades e suas respectivas chaves de acesso.
- Coluna principal para agrupamento e ligação com as fatos -> (key_dados, codigo_dados, codigo_usuario).
OBS: Tabela utilizada preferencialmente em subselect, para retorno das informações de acesso a dados.
2.10 - dim_carteira_cli_por_vendedor
| Tabela | DIM_CARTEIRA_CLI_POR_VENDEDOR | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| nome_vendedor | varchar | 256 | N | Nome do Vendedor | |
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
| codigo_usuario | varchar | 256 | N | Código do usuário na Máxima | |
Tabela utilizada para armazenar as informações da quantidade de clientes na carteira por vendedor.
- Coluna principal para agrupamento e ligação com as fatos -> (codigo_vendedor).
2.11 - dim_cliente_localizacao
| Tabela | DIM_CLIENTE_LOCALIZACAO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
| fantasia | varchar | 256 | N | Nome fantasia da empresa (Pessoa Jurídica). | |
| razaosocial | varchar | 256 | N | Razão Social | |
| cidade | varchar | 256 | N | Cidade | |
| bairro | varchar | 256 | N | Bairro | |
| endereco | varchar | 256 | N | Endereço | |
| estado | varchar | 256 | N | UF | |
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| tipo_fj | varchar | 256 | N | Pessoa Física ou Jurídica (F ou J) | |
| latitude | varchar | 256 | N | Latitude do Cliente | |
| longitude | varchar | 256 | N | Longitude do Cliente | |
| latitude_roteirizador | varchar | 256 | N | Latitude do Cliente do roteirizador | |
| longitude_roteirizador | varchar | 256 | N | Longitude do Cliente do roteirizador | |
Tabela utilizada para armazenar as informações de Geolocalização dos clientes, e suas denominações.
- Colunas para ligação com as fatos -> (codigo_vendedor, codigo_cliente).
2.12 - dim_data
| Tabela | DIM_DATA | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| ano | int | 4 | N | Ano | |
| mes | int | 4 | N | Mês | |
| dia | int | 4 | N | Dia do Mês | |
| data_completa | date | N | Data completa(dia, mês, ano) | ||
Tabela utilizada para armazenar as informações de Data(dia, mês e ano) a partir do dia 01/06/2022.
OBS: Pode ser utilizada para realizar ligações e busca de datas específicas, utilizando subselect.
2.13 - dim_data_faturamento
| Tabela | DIM_DATA_FATURAMENTO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| ano | int | 4 | N | Ano | |
| mes | int | 4 | N | Mês | |
| dia | int | 4 | N | Dia do Mês | |
| datacompleta | date | N | Data completa do faturamento(dia, mês, ano) | ||
Tabela utilizada para armazenar as informações de Data(dia, mês e ano) referente a data de faturamento.
OBS: Pode ser utilizada para realizar ligações e busca de datas específicas de faturamento, utilizando subselect.
2.14 - dim_eventos_positivados
| Tabela | DIM_EVENTOS_POSITIVADOS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_supervisor | varchar | 256 | N | Código do Supervisor | |
| codigo_usuario | varchar | 256 | N | Código do usuário na Máxima | |
| positivados | numeric | 18 | N | Quantidade de positivados | |
Tabela utilizada para armazenar as informações de eventos que houveram positivação(somatório de positivados), e suas respectivas entidades.
- Colunas para ligação com as fatos -> (codigo_vendedor, codigo_supervisor, codigo_usuario).
2.15 - dim_eventos_qtd_cli_carteira
| Tabela | DIM_EVENTOS_QTD_CLI_CARTEIRA | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| nome_vendedor | varchar | 256 | N | Nome do Vendedor | |
| qtd_cli_carteira | numeric | 18 | N | Quantidade de clientes na carteira do Vendedor | |
Tabela utilizada para armazenar as informações de quantidade de clientes da carteira relacionados a eventos realizados.
- Coluna principal para agrupamento e ligação com as fatos -> (codigo_vendedor).
1.16 - dim_eventos_qtde_agendamentos
| Tabela | DIM_EVENTOS_QTDE_AGENDAMENTOS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_usuario | varchar | 256 | N | Código do usuário na Máxima | |
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
| agendado | varchar | 256 | N | Verifica se o cliente está agendado ou não (S ou N) | |
| sequencia | int | 4 | N | Sequência prevista | |
| dataini | date | N | Data início | ||
| dataterm | date | N | Data fim | ||
| tipoagenda | varchar | 256 | N | Rotina do tipo de agenda (COMPMOV, COMPALT, COMPHIST, COMP) | |
Tabela utilizada para armazenar as informações de eventos agendados, e a sequência prevista dos eventos.
- Colunas para ligação com as fatos -> (codigo_vendedor, codigo_usuario,codigo_cliente).
2.17 - dim_eventos_qtde_equipes
| Tabela | DIM_EVENTOS_QTDE_EQUIPES | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| qtdequipe | numeric | 18 | N | Quantidade de Equipes | |
| qtdvendedores | numeric | 18 | N | Quantidade de Vendedores | |
| qtdsupervs | numeric | 18 | N | Quantidade de Supervisores | |
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
Tabela utilizada para armazenar as informações de eventos, apresentando um total de supervisores e vendedores.
- Coluna principal para agrupamento e ligação com as fatos -> (codigo_vendedor).
1.18 - dim_eventos_sequencia_prevista
| Tabela | DIM_EVENTOS_SEQUENCIA_PREVISTA | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_usuario | varchar | 256 | N | Código do usuário na Máxima | |
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
| total_em_ordem | numeric | 18 | N | Total de clientes na ordem prevista | |
| total_fora_ordem | numeric | 18 | N | Total de clientes fora da ordem prevista | |
| porce_ordem | numeric | 18 | N | Porcentagem de visitados na Ordem Prevista | |
Tabela utilizada para armazenar as informações de sequência previstas, e as porcentagens calculadas com base na sequência.
- Colunas para ligação com as fatos -> (codigo_vendedor, codigo_usuario,codigo_cliente).
2.19 - dim_eventos_tabela_agendados
| Tabela | DIM_EVENTOS_TABELA_AGENDADOS | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_vendedor | varchar | 256 | N | Código do Vendedor | |
| codigo_usuario | varchar | 256 | N | Código do usuário na Máxima | |
| data_inicio | date | N | Data ínicio do agendamento | ||
| data_fim | date | N | Data fim do agendamento | ||
| data_visita | date | N | Data da visita | ||
| codigo_cliente | varchar | 256 | N | Código do Cliente | |
Tabela utilizada para armazenar as informações de visitas realizadas, e suas respectivas datas.
- Colunas para ligação com as fatos -> (codigo_vendedor, codigo_usuario,codigo_cliente).
2.20 - dim_acessoentidades
| Tabela | DIM_ACESSOENTIDADES | ||||
|---|---|---|---|---|---|
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_usuario | varchar | 256 | N | Código do Usuário | |
| codigo_entidade | varchar | 256 | N | Código da entidades Regiões - codigo_entidade = 1 Fornecedor - codigo_entidade = 2 Departamento - codigo_entidade = 3 Seções - codigo_entidade = 4 Transportadoras - codigo_entidade = 5 | |
| chave_entidade | varchar | 256 | N | Código da entidades (Regiões se codigo_entidade = 1, Fornecedor se codigo_entidade = 2,Departamento se codigo_entidade = 3, Seções se codigo_entidade = 4, Transportadoras se codigo_entidade = 5) | |
| codigo_operacao | varchar | 256 | N | Código do tipo de operação 0 - Registro incluído 1 - Registro atualizado 2 - Registro excluído | |
Tabela utilizada para verificação das entidades cadastradas por perfil de usuário.
- Coluna para ligação com as fatos ou dimensões ->(codigo_usuario).
2.21 - dim_fornecedor
| Tabela | DIM_FORNECEDOR | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_fornecedor | varchar | 256 | N | Código do Fornecedor | |
| fornecedor | varchar | 256 | N | Descrição do Fornecedor | |
| fantasia | varchar | 256 | N | Nome Fantasia do Fornecedor | |
| cnpj | varchar | 256 | N | CNPJ do Fornecedor | |
| tipo_documento | varchar | 256 | N | TIpo documento (CNPJ ou CPF) | |
| cidade | varchar | 256 | N | Cidade | |
| estado | varchar | 256 | N | Estado | |
| id_distribuidor | varchar | 256 | N | Identificador único do Distribuidor | |
Tabela utilizada para armazenar as informações dos fornecedores.
- Coluna para ligação com as fatos ou dimensões ->(codigo_fornecedor).
2.22 - dim_empregado
| Tabela | DIM_EMPREGADO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| matricula | NUMERIC | N | Identificador único do empregado (para motoristas, tipo M, equivale ao código do motorista) | ||
| codigo_filial | VARCHAR | N | Código da filial onde o empregado está lotado | ||
| nome | VARCHAR | N | Nome completo do empregado | ||
| codigo_setor | VARCHAR | N | Código do setor do empregado | ||
| VARCHAR | N | E-mail institucional ou de contato do empregado | |||
| codigo_veiculo | VARCHAR | N | Código do veículo associado ao empregado (se aplicável) | ||
| nome_guerra | VARCHAR | N | Nome de guerra ou nome abreviado do empregado | ||
| telefone | VARCHAR | N | Número de telefone fixo do empregado | ||
| celular | VARCHAR | N | Número de celular do empregado | ||
| tipo | VARCHAR | N | Tipo do empregado (ex: M-motorista, etc) | ||
| data_validade_cnh | DATE | N | Data de validade da CNH do motorista | ||
| cpf | VARCHAR | N | CPF do empregado | ||
| situacao | VARCHAR | N | Situação funcional do empregado (A-ativo, I-inativo, etc) | ||
| data_exclusao | DATE | N | Data em que o empregado foi excluído do sistema (se aplicável) | ||
| codigo_usuario | VARCHAR | N | Código do usuário associado ao empregado | ||
| tipo_motorista | VARCHAR | N | Tipo de motorista M - Motorista X - Motorista agregado ou terceirizado | ||
| endereco | VARCHAR | N | Endereço residencial do empregado | ||
| bairro | VARCHAR | N | Bairro do endereço do empregado | ||
| cidade | VARCHAR | N | Cidade do endereço do empregado | ||
| estado | VARCHAR | N | Estado do endereço do empregado | ||
| excluido | VARCHAR | N | Indicador de exclusão lógica (S/N) | ||
Tabela de referência com informações cadastrais de todos os empregados da empresa, incluindo motoristas, encarregados e auxiliares.
Pode ser usada para enriquecer fatos operacionais com nome, tipo, endereço, contato e status de exclusão.
Coluna para ligação com as fatos ou dimensões: dim_empregado.matricula
Faça a junção com fato_entregas: (dim_empregado.matricula = fato_entregas.codigo_motorista)
Faça a junção por empregado para motorista e ajudantes → (
Motorista: (dim_empregado.matricula → fato_carregamentos.codigo_motorista)
Ajudante1: (dim_empregado.matricula → fato_carregamentos. codigo_ajudante1)
Ajudante2: (dim_empregado.matricula → fato_carregamentos. codigo_ajudante2 )
Ajudante3: (dim_empregado.matricula → fato_carregamentos. codigo_ajudante3 )
2.23 - dim_veiculo
| Tabela | DIM_VEICULO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_veiculo | varchar | N | Identificador único do veículo | ||
| descricao | varchar | N | Descrição do veículo | ||
| placa | varchar | N | Placa do veículo | ||
| marca | varchar | N | Marca do veículo | ||
| quantidade_palete | numeric | N | Capacidade de paletes do veículo | ||
| volume | numeric | N | Volume útil do veículo (m³) | ||
| peso_carga_kg | numeric | N | Peso máximo de carga do veículo (kg) | ||
| situacao | varchar | N | Situação do veículo (ativo, inativo, etc) | ||
| tipo_veiculo | varchar | N | Tipo do veículo (caminhão, van, etc) | ||
| proprio | varchar | N | Indicador se o veículo é próprio (S/N) | ||
| codigo_filial | varchar | N | Código da filial à qual o veículo pertence | ||
| altura | numeric | N | Altura do veículo (metros) | ||
| largura | numeric | N | Largura do veículo (metros) | ||
| comprimento | numeric | N | Comprimento do veículo (metros) | ||
| observacao | varchar | N | Campo de observações gerais sobre o veículo | ||
| rastreado | varchar | N | Indica se o veículo é rastreado (S/N) | ||
| codigo_localizacao | varchar | N | Código da localização atual ou padrão do veículo | ||
| uf_placa_veiculo | varchar | N | Estado da placa do veículo | ||
| cidade_placa_veiculo | varchar | N | Cidade da placa do veículo | ||
| veiculo_generico | varchar | N | Indicador de uso como veículo genérico (S/N) | ||
| codigo_rota_principal | numeric | N | Código da rota principal associada ao veículo | ||
| excluido | varchar | N | Indicador de exclusão lógica (S/N) | ||
Tabela de referência dos veículos utilizados nos carregamentos, contendo especificações como placa,
marca, capacidade de carga, volume e rastreamento.
Faça a junção com fato_carregamentos: (dim_veiculo.codigo_veiculo → fato_carregametnos. codigo_veiculo)
2.24 - dim_usuario_motorista
| Tabela | DIM_USUARIO_MOTORISTA | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| id | numeric | N | Identificador único do usuário | ||
| login | varchar | N | Login de acesso do usuário no sistema | ||
| nome | varchar | N | Nome completo do usuário | ||
| data_cadastro | date | N | Data em que o usuário foi cadastrado no sistema | ||
| excluido | varchar | N | Indicador de exclusão lógica (S/N) | ||
| id_empregado | numeric | N | Referência ao empregado vinculado (matrícula) | ||
| tipo | varchar | N | Tipo de usuário (ex: motorista, encarregado, etc) | ||
| preferencias_rotas | varchar | N | Preferências de rotas configuradas para o usuário | ||
| apelido | varchar | N | Apelido ou nome de guerra do usuário | ||
| carreteiro | varchar | N | Indica se o usuário é carreteiro (S/N) | ||
| data_ultimo_logon | date | N | Data do último login do usuário | ||
| encarregado | numeric | N | ID do encarregado associado (se aplicável) | ||
| id_arquivo | numeric | N | ID do arquivo associado (se aplicável) | ||
| id_jornada | numeric | N | ID da jornada associada (se aplicável) | ||
| id_motorista | varchar | N | Código do motorista (utilizado em joins com fato_entregas) | ||
| telefone | varchar | N | Telefone do usuário | ||
| id_usuario_maxima | varchar | N | Identificador do usuário na plataforma Maxima | ||
| qtd_dias_busca_painel | varchar | N | Quantidade de dias configurados para busca no painel | ||
| tipo_usuario | varchar | N | Classificação do tipo de usuário | ||
| varchar | N | E-mail do usuário | |||
| cargo | varchar | N | Cargo ou função do usuário | ||
Tabela que armazena os dados dos usuários do aplicativo MaxGestão que exercem a função de motorista ou operadores logísticos.
Faça a junção com fato_entregas: (dim_usuario_motorista.id_motorista → fato_entregas.codigo_motorista)
2.25 - dim_ramo_atividade
| Tabela | DIM_RAMO_ATIVIDADE | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_atividade | varchar | 256 | N | Código da atividade econômica conforme cadastro da empresa | |
| ramo_atividade | varchar | 256 | N | Descrição textual do ramo de atividade | |
| percentual_desconto | numeric | 18,4 | N | Percentual de desconto aplicado para o ramo de atividade | |
| calcula_st | varchar | 256 | N | Indicador se a Substituição Tributária (ST) é calculada (S/N) | |
| codigo_atividade_principal | varchar | 256 | N | Código da atividade principal associada à atividade secundária | |
| excluido | varchar | 256 | N | Indicador se o registro foi logicamente excluído (S = sim, N = não) | |
Tabela com os ramos de atividade dos clientes (ex: mercado, restaurante, padaria), permitindo segmentações e agrupamentos.
Faça a junção por clientes: (dim_cliente.codigo_atividade → dim_ramo_atividade.codigo_atividade)
Observação: Indiretamente relacionada às fato_entregas pelo cliente (fato_entregas.codigo_cliente)
2.26 - dim_situacao_entrega
| Tabela | DIM_SITUACAO_ENTREGA | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| id | varchar | 256 | N | Código da situação da entrega EN - ENTREGUE DT - DEVOLUCAO TOTAL DP - DEVOLUÇÃO PARCIAL RE - REENTREGA CK - CHECKIN FN - FINALIZADA PD - PENDENTE EP - ESPERA RP - RECEBIMENTO PENDENTE SD - SOLICITADA DEVOLUÇÃO | |
| situacao_entrega | varchar | 256 | N | Descrição legível da situação da entrega | |
Tabela que traduz os códigos de situação de entrega.
Faça a junção com fato_entregas: (dim_situacao_entrega.id → fato_entregas.id_situacao_entrega)
2.27 - dim_situacao_romaneio
| Tabela | DIM_SITUACAO_ROMANEIO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| id | integer | N | Identificador incremental da situação do romaneio 1 - INICIADO 2 - FINALIZADO 3 - FECHADO 4 - CANCELADO 5 - ABERTO | ||
| situacao_romaneio | varchar | 256 | N | Descrição da situação do romaneio | |
Tabela de domínio para as situações do romaneio logístico.
Faça a junção com fato_carregamentos: (dim_situacao_romaneio.id → fato_carregamentos.id_situacao_romaneio)
2.28 - dim_destino_carregamento
| Tabela | DIM_DESTINO_CARREGAMENTO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| id | integer | N | Identificador incremental do destino de carregamento | ||
| destino_carregamento | varchar | 256 | N | Descrição do destino do carregamento | |
Tabela de referência dos destinos utilizados nos carregamentos, com ID gerado automaticamente.
Faça a junção com fato_carregamentos: (dim_destino_carregamento.id → fato_carregamentos.id_destino_carregamento)
2.29 - dim_atividade_fornecedor
| Tabela | DIM_ATIVIDADE_FORNECEDOR | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_atividade | varchar | 256 | N | Identificador incremental do destino de carregamento | |
| codigo_fornecedor | varchar | 256 | N | Descrição do destino do carregamento | |
| descricao_atividade_fornecedor | varchar | 256 | N | Descrição da atividade do fornecedor | |
| codigo_cliente | varchar | 256 | N | Código do cliente | |
| codigo_atividade_cliente | varchar | 256 | N | Código da atividade do cliente | |
Tabela de referência das atividades dos fornecedores.
Faça a junção com dim_fornecedor: (dim_atividade_fornecedor.codigo_fornecedor → dim_fornecedor.codigo_fornecedor)
Faça a junção com dim_cliente: (dim_atividade_fornecedor.codigo_cliente → dim_cliente.codigo_cliente)
2.30 - dim_grupo_filial
| Tabela | DIM_GRUPO_FILIAL | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_grupo_filial | varchar | 256 | N | Código do grupo de filial | |
| nome_grupo_filial | varchar | 256 | N | Descrição do grupo de filial | |
Tabela de referência dos grupos de filiais.
Faça a junção com dim_filial: (dim_grupo_filial.codigo_grupo_filial → dim_filial.codigo_grupo_filial)
2.31 - dim_industria_relacao_fornecedor
| Tabela | DIM_INDUSTRIA_RELACAO_FORNECEDOR | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_fornecedor | varchar | 256 | N | Código do fornecedor | |
| fornecedor | varchar | 256 | N | Descrição do fornecedor | |
| codigo_industria | varchar | 256 | N | Código da indústria | |
| industria | varchar | 256 | N | Descrição da indústria | |
| cnpj | varchar | 256 | N | CNPJ | |
Tabela que relaciona fornecedores e industrias.
Faça a junção com dim_fornecedor: (dim_industria_relacao_fornecedor.codigo_fornecedor → dim_fornecedor.codigo_fornecedor)
Faça a junção com dim_industria: (dim_industria_relacao_fornecedor.codigo_industria → dim_industria.codigo_industria)
2.32 - dim_industria
| Tabela | DIM_INDUSTRIA | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_industria | varchar | 256 | N | Código da indústria | |
| industria | varchar | 256 | N | Descrição da indústria | |
| cnpj | varchar | 256 | N | CNPJ da indústria | |
Tabela de referências de indústrias.
Faça a junção com dim_industria_relacao_fornecedor: (dim_industria.codigo_industria → dim_industria_relacao_fornecedor.codigo_industria)
2.33 - dim_motivo_justificativa
| Tabela | DIM_MOTIVO_JUSTIFICATIVA | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| id | int | N | Identificador do motivo de justificativa | ||
| descricao | varchar | 256 | N | Descrição do motivo de justificativa | |
| codigo_operacao | varchar | 256 | N | Código do tipo de operação 0 - Registro incluído 1 - Registro atualizado 2 - Registro excluído | |
Tabela de referências dos motivos de justificativa de visita.
Faça a junção com atendimentos: (dim_motivo_justificativa.id → fato_atendimento.codigo_justificativa
Faça a junção com eventos: (dim_motivo_justificativa.id → fato_eventos.justificativa_nao_venda_codigovinculacao
2.34 - dim_usuario
| Tabela | DIM_USUARIO | ||||
| Coluna | Tipo | Tamanho | Obrigatório | PK | Observação | 
| codigo_usuario | bigint | N | Código único do usuário Máxima. | ||
| codigo_vendedor | varchar | 80 | N | Código do vendedor vinculado. | |
| nome_usuario | varchar | 256 | N | Nome do usuário. | |
| data_cadastro | date | Data de cadastro do usuário. | |||
| data_exclusao | date | Data de Exclusão do usuário. | |||
| status | varchar | 20 | Status do usuário. A - Ativo I - Inativo | ||
Tabela de referências dos usuários da Máxima.
Faça a junção com vendedores: (dim_usuario.codigo_vendedor → dim_vendedores.codigo_vendedor)
Notas de versão
| Data | Versão anterior | Versão atual | Alteração | Motivo | 
| 25/04/2025 | 1.2 | 1.3 | fato_pedido_realizado estava com a coluna numpederp como INT(4), alterada para numeric(18) | Correção | 
| 13/05/2025 | 1.3 | 1.4 | 
 
 
 
 
 
 
 | MAXINDV-216 – informações para Dashboards do maxMotorista | 
| 20/05/2025 | 1.4 | 1.5 | 
 | Atualizar o Layout com fatos e dimensões disponíveis Observação: não houve alteração dos dados em produção, apenas adequação do Layout | 
| 30/05/2025 | 1.5 | 1.6 | 
 | |
| 11/06/2025 | 1.6 | 1.7 | 
 | |
| 21/08/2025 | 1.7 | 1.8 | 
 | 
Artigo revisado por Thiago Oliveira
- No labels

