Ficha Técnica - TMS Embarcador - Gestão de Fretes
Área: | Transportes (Embarcador) |
Assunto: | Gestão de Fretes |
Fase: | EXTRACAO |
Este assunto é composto por dois processos de extração, ou seja, são dois extratores que devem ser configurados, sendo:
Um para extração das despesas de frete.
Um para extração do lead time de frete.
A seguir serão apresentadas as opções de configuração destes extratores.
1. Análise das Despesas de Fretes
Programa Progress: | EMS0801.p |
Arquivo de Parâmetros: | EMS0801.xml |
Fato: | DIS_DTS_Freight_Expenses_Fact.TXT |
2. Análise do Lead Time de Fretes
Programa Progress: | EMS00802.p |
Arquivo de Parâmetros: | EMS00802.xml |
Fato: | DIS_DTS_Freight_LeadTime_Fact.TXT |
Opções do Arquivo de Parâmetros | Tipo Períodos | Os valores podem ser: “Informados” ou “Variáveis”. Informados: Variáveis: Importante: Se ficar gravado como padrão o período Informado para as atualizações diárias do BI, os valores do mesmo não serão atualizados. |
Regra Principal para Extração | É utilizada como base para extração somente a data de emissão da nota fiscal. Somente são consideradas para o BI as notas fiscais com cálculos de frete. | |
Regras Padrões de Negócio | Empresa | O código da empresa é buscado no cadastro de estabelecimento, que é atualizado pelo programa Manutenção de Estabelecimentos para Área de Materiais (CD0602). |
País, Estado e Cidade | Estas informações são extraídas com base no endereço de destino da nota fiscal. |
Relatórios de Inconsistências: INC_DIS_DTS_Freight_Expenses_Fact.TXT e INC_DIS_DTS_Freight_LeadTime_Fact.TXT
Estes relatórios são gerados somente quando encontradas inconsistências de integridade referencial na base de dados durante a extração. Se encontram no diretório ...\Datasul\bi\spool\EMS2.
Além dos relatórios de inconsistências, um outro arquivo referente à execução do extrator é também gerado no diretório temporário do Progress, definido através do parâmetro –T, no arquivo .pf disponibilizado para conexão. O nome do arquivo é formado pelo nome do extrator a qual se refere, com extensão .log.
Conferência das Informações
Relatórios de Conferência
Para validar as medidas do BI com o TMS Embarcador devem ser usados os seguintes relatórios no TMS:
spp\trp\sptr027 – para gerar o relatório com as medidas referentes aos valores de fretes de autônomos.
GT0124 – para parametrizar as medidas apresentadas no relatório GT0624 do TMS Embarcador.
GT0624 – para visualizar o relatório no EMS com as medidas referentes aos valores dos demais fretes (não autônomos).
Visão BI
Importante:
Os assuntos da área Gestão de Fretes tratam dados originados somente no TMS 4.01.
O BI considera somente registros de notas fiscais com cálculos de frete. Dessa forma notas fiscais que ainda não possuam cálculos de frete vinculados não serão apresentadas nas consultas do BI, no entanto, elas poderão estar visíveis no relatório de conferencia do TMS de acordo com o período selecionado.
Registros de notas fiscais que estejam cadastrados somente no TMS, sem referência da nota no EMS também não serão considerados pelo BI.
Caso os dados do relatório de conferência não apresentem valores para os campos de cálculo em determinados registros de notas fiscais, será necessária a validação por nota fiscal a partir do programa GT0703.
As medidas e dimensões devem ser configuradas afim de que se assemelhem às visões do BI para posteriormente serem confrontadas com os relatórios do TMS Embarcador.
Visão BI - 01 | Medidas | Dimensões |
Montar visão utilizando as medidas e dimensões mencionadas nas colunas ao lado. | Vl Frete Autônomo Prev | Estabelecimento – Código
|
Visão BI - 02 | Medidas | Dimensões |
Montar visão utilizando as medidas e dimensões mencionadas nas colunas ao lado. | Lead Time Interno | Estabelecimento – Código
|
Relatório de Conferência de Gestão de Fretes
Para construir o relatório, é necessário executar o programa GT0124.
Para criar um novo relatório, selecione o botão “Inclui nova ocorrência”.
Na tela Cadastros de Relatórios (GT0124B), devem ser informados o nome e a descrição para o novo relatório. Os campos das demais abas desse programa (Documentos, Visualização, Obs), não precisam ser alterados. Eles devem permanecer como apresentadas quando executado o programa.
Depois de criar o relatório para validação, para incluir os campos do relatório deve ser utilizado o botão “Incluir” do programa GT0124.
Na tela Cadastro de Campos, informe no campo Código Campo o nome dos campos que comporão o relatório ou utilize a opção de pesquisa para selecionar os campos.
Para totalizar os campos de valores, é necessário marcar a opção “Totalizar”.
É recomendada a construção de dois relatórios para a validação das medidas pelo GT0624, separando num deles somente as medidas de documento de frete e no outro as medidas de Cálculo e pré calculo.
A lista abaixo mostra todos os campos que devem compor o relatório. Essa lista mostra também a correspondência desses campos com as medidas da consulta do BI.
Relatório 1:
TMS Embarcador | Descrição no TMS | Medida BI |
Nota Fiscal.nr-nf | Número Nota | * CD_Sale_Forma_Bill_Number (Detalhamento BI) |
Nota Fiscal.cd-serie | Série | * CD_Sale_Forma_Bill_Series (Detalhamento BI) |
Nota Fiscal.cod-estabel | Estab Nota | * Estabelecimento – Código (Dimensão) |
Nota Fiscal.nm-rem | Nome Remetente | * Rementente (Dimensão) |
Nota Fiscal.cgc-rem | Cgc Remetente | * Não disponível no BI |
Nota Fiscal.nm-dest | Nome Destinatario | * Cliente/Fornecedor (Dimensão) |
Nota Fiscal.dt-emissao | Data Emissão | * Período (Dimensão) |
Nota Fiscal.dt-saida | Data Saída | * DT_Material_Out (Detalhamento BI) |
Nota Fiscal.dt-entrega | Data Entrega | * DT_Material_Delivery (Detalhamento BI) |
Nota Fiscal.cod-item | Código Item | * Item – Código (Dimensão) |
Nota Fiscal.id-tipo-frete-nf | Tipo Frete | * Não disponível no BI, importante para classificar os valores a seguir. |
Cálculo.vl-frete-precon | Valor Pré-Cálculo | Vl Frete Normal Prev Vl Frete Redespacho Prev Vl Diária Prev Vl Frete Reentregas Prev Vl Frete Devolução Prev * De acordo com a coluna tipo frete correspondente ao documento no TMS |
Cálculo.vl-icms-calc | ICMS
| Vl ICMS Normal Prev Vl ICMS Redespacho Prev Vl ICMS Diárias Prev Vl ICMS Reentregas Prev Vl ICMS Devolução Prev * De acordo com a coluna tipo frete correspondente ao documento no TMS *** Somente considera o Vl ISS quando Vl ICMS estiver em branco. |
Cálculo.vl-iss-calc | ISS |
Relatório 2:
TMS Embarcador | Descrição no TMS | Medida Datasul BI |
Nota Fiscal.nr-nf | Número Nota | * CD_Sale_Forma_Bill_Number (Detalhamento BI) |
Nota Fiscal.cd-serie | Série | * CD_Sale_Forma_Bill_Series (Detalhamento BI) |
Nota Fiscal.cod-estabel | Estab Nota | * Estabelecimento – Código (Dimensão) |
Nota Fiscal.nm-rem | Nome Remetente | * Rementente (Dimensão) |
Nota Fiscal.cgc-rem | Cgc Remetente | * Não disponível no BI |
Nota Fiscal.nm-dest | Nome Destinatario | * Cliente/Fornecedor (Dimensão) |
Nota Fiscal.dt-emissao | Data Emissão | * Período (Dimensão) |
Nota Fiscal.dt-saida | Data Saída | * DT_Material_Out (Detalhamento BI) |
Nota Fiscal.dt-entrega | Data Entrega | * DT_Material_Delivery (Detalhamento BI) |
Nota Fiscal.cod-item | Código Item | * Item – Código (Dimensão) |
Nota Fiscal.id-tipo-frete-nf | Tipo Frete | * Não disponível no BI, importante para classificar os valores a seguir. |
docto-frete.vl-conhecimento |
Valor Conhecimento | Vl Frete Normal Realizado Vl Frete Redespacho Realizado Vl Diaria Realizado Vl Frete Reentregas Realizado Vl Frete Devolução Realizado * De acordo com a coluna tipo frete correspondente ao documento no TMS |
docto-frete.vl-iss-ctrc
|
Vl ISS | Vl ICMS Normal Realizado Vl ICMS Redespacho Realizado Vl ICMS Diárias Realizado Vl ICMS Reentregas Realizado Vl ICMS Devolução Realizado * De acordo com a coluna tipo frete correspondente ao documento no TMS *** Somente considera o Vl ISS quando Vl ICMS estiver em branco. |
docto-frete.vl-icms-ctrc |
Vl ICMS | |
docto-frete.de-vl-pis |
Valor PIS
| Vl PIS/COFINS Normal Realizado Vl PIS/COFINS Redespacho Realizado Vl PIS/COFINS Diárias Realizado Vl PIS/COFINS Reentregas Realizado Vl PIS/COFINS Devolução Realizado * De acordo com a coluna tipo frete correspondente ao documento no TMS |
docto-frete.de-vl-cofins |
Valor Cofins |
Para gerar o relatório é necessário executar o programa GT0624 informando no campo Relatório o código do relatório criado no programa GT0124.
Nas abas Seleção, Clas/Param, Documentos e Impressão, serão apresentadas as opções pré-configuradas na criação do relatório e que podem ser modificadas para a execução.
Na aba “Documentos”, a opção recomendada de configuração é a de data início e fim de emissão de notas fiscais para filtrar as informações de acordo com a consulta do BI. Os campos Nota Fiscal e Emissão são referentes a Notas Fiscais que permitem esta configuração.
Validação entre BI e TMS
A validação dos dados apresentados no BI deve ser feita por amostragem e para isso é recomendado o uso do detalhamento e exportação dos dados para Excel.
Com os dados já detalhados na planilha Excel, é possível identificar detalhes de cada registro como número e série da nota fiscal, e com base nessas informações conferir os dados apresentados no relatório GT0624.
A relação dos campos a serem validados entre BI e TMS Embarcador está descrita acima, nas tabelas “Relatório 1” e “Relatório 2” do processo de construção do relatório GT0124.
Não existem relatórios padrões no ERP Datasul que sigam o mesmo critério do extrator de dados do BI.
Complemento da Validação BI X TMS
Para as medidas Vl Diária, Lead Time Interno, Lead Time Previsto, Lead Time Real, Lead Time Saída Previsto, Lead Time, é necessário analisar por nota fiscal, visto que o programa que emite o relatório de conferência não possui ainda estes campos disponíveis.
Para analisar por Nota Fiscal no BI, é necessário utilizar a ferramenta “Detalhamento (Drill through)”.
Para validar essas medidas, é necessário executar o programa GT0703, acessar a opção de pesquisa, para escolher a nota fiscal, ou informando o Remetente, a Série da Nota e o Número da Nota Fiscal a partir do item “Vá para”.
Na tela Pesquisa de Notas Fiscais, deve ser selecionada a aba “Número" e informar os parâmetros de número e serie da nota, estes podem ser encontrados no relatório de conferência apresentado anteriormente. Em seguida, selecionada a nota desejada e confirmada com o botão OK.
As medidas de Lead Time são diferenças entre datas, sendo que se o valor for negativo indica que o evento foi antecipado, o valor sendo “ZERO” o evento ocorreu na data prevista e o valor sendo positivo, o evento foi atrasado.
O Lead Time Interno é a diferença entre Saída – Emissão.
O Lead Time é o resultado do calculo de Realiz. Entrega Cliente - Previsão Entrega Cliente.
O Lead Time Previsto devemos utilizar a Previsão Entrega Cliente – Previsão Saída.
O Lead Time Real é a diferença entre a Realiz. Entrega Cliente e a Saída.
O Lead Time Saída Previsto é obtido da diferença entre a Saída e a Previsão Saída.
Validação de Fretes Realizados por Autônomos no TMS
Para validação das medidas referentes a fretes realizados por autônomos, é necessário executar o relatório de conferência “sptr027”, selecionar a aba “Seleção” e informar o período para impressão do relatório.
Será exibida uma mensagem com informação do caminho para o arquivo gerado.
No arquivo gerado,os valores das medidas do BI devem ser conferidas com as seguintes colunas:
Medida BI | Coluna Relatório |
Vl Frete Autônomo Prev | Vl.Frete Prev |
Vl Frete Autônomo | Vl.Frete Real |
Vl Impostos Autônomo | Vl.Impostos |
Vl INSS Empresa Autônomo | Vl.INSS Empresa |
Medida sem validação no TMS
Não existem outros relatórios padrões no ERP que sigam o mesmo critério do extrator de dados do BI para validar as seguintes medidas na sua totalização:
Qtde Embarques |
Quantidade Redespacho Prev |
Quantidade Diárias Prev |
Quantidade Reentregas Prev |
Quantidade Devolução Prev |
Quantidade Redespacho Realizado |
Quantidade Diárias Realizado |
Quantidade Reentregas Realizado |
Quantidade Devolução Realizado |
Vl Frete Total Prev |
Vl ICMS Total Prev |
Vl PIS/COFINS Total Prev |
Vl Frete Total Realizado |
Vl ICMS Total Realizado |
Vl PIS/COFINS Total Realizado |
Vl Produto |
Qtde Produto |
Cubagem Produto |
Peso Bruto Produto |
Peso Cubado Total Produto |
Vl PIS/COFINS Normal Prev |
Vl PIS/COFINS Redespacho Prev |
Vl PIS/COFINS Diárias Prev |
Vl PIS/COFINS Reentregas Prev |
Vl PIS/COFINS Devolução Prev |
Observação:
As medidas de “Quantidades” são contagens de registros realizadas no BI, portanto, não possuem validação equivalente no TMS.
As medidas Vl Produto, Qtde Produto, Cubagem Produto, Peso Bruto Produto, Peso Cubado Total Produto e valores de PIS/Cofins Previstos não possuem relatórios equivalentes no TMS que apresentem seus valores na mesma granularidade que o BI.
As medidas de “Valores” são somas de outros campos realizadas no BI, portanto, não possuem validação equivalente no TMS. Segue tabela com a composição de cada uma dessas medidas:
Medida | Composição |
Vl Frete Total Prev | Soma de (Vl Frete Normal Prev, Vl Frete Redespacho Prev, Vl Diaria Prev, Vl Frete Reentregas Prev, Vl Frete Devolução Prev, Vl Frete Autônomo Prev). |
Vl ICMS Total Prev | Soma de (Vl ICMS Normal Prev, Vl ICMS Redespacho Prev, Vl ICMS Diarias Prev, Vl ICMS Reentregas Prev, Vl ICMS Devolução Prev). |
Vl PIS/COFINS Total Prev | Soma de (Vl PIS/Cofins Normal Prev, Vl PIS/Cofins Redespacho Prev, Vl PIS/Cofins Diarias Prev, Vl PIS/Cofins Reentregas Prev, Vl PIS/Cofins Devolução Prev). |
Vl Frete Total Realizado | Soma de (Vl Frete Normal Realizado, Vl Frete Redespacho Realizado, Vl Diaria Realizado, Vl Frete Reentregas Realizado, Vl Frete Devolução Realizado, Vl Frete Autônomo). |
Vl ICMS Total Realizado | Soma de (Vl ICMS Normal Realizado, Vl ICMS Redespacho Realizado, Vl ICMS Diarias Realizado, Vl ICMS Reentregas Realizado, Vl ICMS Devolução Realizado). |
Vl PIS/COFINS Total Realizado | Soma de (Vl PIS/Cofins Normal Realizado, Vl PIS/Cofins Redespacho Realizado, Vl PIS/Cofins Diarias Realizado, Vl PIS/Cofins Reentregas Realizado, Vl PIS/Cofins Devolução Realizado). |