Árvore de páginas

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:
Quando selecionado, deverão ser preenchidos os campos “Data Início” e “Data Término" para que o usuário possa escolher a faixa de datas. É utilizada para fazer a carga inicial de dados no BI e também para extrair períodos específicos fora do realizado no dia-a-dia.

Variáveis:
Quando selecionado, deverão ser preenchidos os campos “Intervalo Inicia (dias)” e “Intervalo Final (dias)”. Esta opção é utilizada na atualização diária automática do BI. Sua parametrização é realizada em número de dias. Os dias utilizados serão sempre calculados com base na data atual da execução do processo de extração. Exemplo: Se a data do sistema no momento da Extração for 15/01/2003, e o "Intervalo Inicial" for preenchido como -15 e o "Intervalo Final" for preenchido com zero (0), o sistema de ETL irá buscar as informações no ERP com data de início de 01/01/2003 até 15/01/2003.

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
Vl Frete Autônomo
Vl Impostos Autônomo
Vl INSS Empresa Autônomo
Vl Frete Normal Prev
Vl ICMS Normal Prev
Vl Frete Redespacho Prev
Vl ICMS Redespacho Prev
Vl Diária Prev
Vl ICMS Diárias Prev
Vl Frete Reentregas Prev
Vl ICMS Reentregas Prev
Vl Frete Devolução Prev
Vl ICMS Devolução Prev
Vl Frete Normal Realizado
Vl ICMS Normal Realizado
Vl Frete Redespacho Realizado
Vl ICMS Redespacho Realizado
Vl Diaria Realizado
Vl ICMS Diárias Realizado
Vl Frete Reentregas Realizado
Vl ICMS Reentregas Realizado
Vl Frete Devolução Realizado
Vl ICMS Devolução Realizado
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

Estabelecimento – Código
Ano
Mês
Data
Item - 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
Lead Time Previsto
Lead Time Real
Lead Time Saída Previsto
Lead Time
Vl Diária

Estabelecimento – Código
Ano
Mês
Data

 

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”.

Importante:
É 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.

Importante:
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).