DLOGTMS02-21192 DT TDA por CEP ou Região.

01. DADOS GERAIS

Produto:	TOTVS Logística TMS
Linha de Produto:	Linha Protheus
Segmento:	Logística
Módulo:	TOTVS Logística TMS
Função:	TMSA010 - Tabela de frete TMSA010A - Cadastro tabela de frete TMSA011 - Ajuste da tabela de frete TMSA030 - Componente de frete TMSA040 - Cotação de frete TMSA050 - Entrada Dc. Cliente TMSA080 - Tabela de Tarifas TMSA130 - Configuração da tabela de Frete TMSA135 - Cadastro de TDA x Cep / Região TMSA200 - Calculo do Frete TMSA480 - Perfil do Cliente TMSA500 - Manutenção de Documentos TMSXFUNA - Função Genérica TMSXFUNB - Função Genérica
País:	Brasil
Ticket:	Não se aplica.
Requisito/Story/Issue (informe o requisito relacionado) :	DLOGTMS02-20659 DLOGTMS02-21192

02. SITUAÇÃO/REQUISITO

Implementar novo tipo de TDA (Taxa de difícil acesso) para um determinado CEP ou para uma região.

03. SOLUÇÃO

Implementado a nova funcionalidade para cobrança do TDA (Taxa de difícil acesso) através do cadastro de CEP de Entrega ou de uma determinada Região.

Foram implementadas as seguintes melhorias:

Novo Tipo de Componente de Frete:

Disponibilizado nova opção de Calcula Sobre no cadastro de Componente 18 - TDA x Região.
Regras do Componente:
- Este tipo de componente de frete não permitirá o uso de sub-faixa.
- Este novo componente não poderá ser rateado.

Componente de Frete x TDA por CEP / Região:

Disponibilizado nova rotina de cadastro de Componente de frete x TDA por CEP / Região (TMSA135). Nesta rotina será realizado o vínculo entre o novo tipo de componente de frete de TDA por Região versus CEP ou Região e o valor a ser cobrado.
Através do processo de Componente versus TDA por CEP / Região será possível configurar:
- Cobrança por Faixa de CEP com CEP inicial e CEP final;
- Cobrança por Região onde deverá ser informado um código de região (DUY);
- Cobrança por CEP especifico onde deverá ser informado o mesmo CEP para inicio e fim;
- Configurar o Tipo de Cobrança para o item podendo ser:
  - 1 - Fixo - Valor fixo para o componente de TDA;
  - 2 - Percentual - Será cobrado o percentual informado no campo Valor (DNA_VALOR) baseado nos demais componentes de frete da tabela.
- Valor - de frete a ser cobrado para o item (CEP ou Região).

Configuração da tabela de frete

O tipo de componente 18 - TDA x Região deverá ser sempre o último componente a ser cadastrado na configuração da tabela de frete.

Perfil do cliente

Novo campo no cadastro do perfil do cliente TDA por Reg. (DUO_TDAREG) que será base para utilização da nova funcionalidade no momento do calculo do frete. As opções disponíveis para o campo são: 1= Sim, 2= Não.

Cotação de Frete / Entrada Dc. Cliente (Preview) / Calculo de Frete / Manutenção de Documentos

No momento do calculo do frete o sistema verificará se o devedor do frete possui o perfil configurado com a opção TDA por Região igual a sim, e se a configuração da tabela de frete utilizada possui o componente 18 - TDA por Região. Se sim o sistema irá realizar o calculo do componente de acordo com o cadastro de componente de frete x TDA por CEP / Região.

Fluxo do processo TDA por CEP / Região:

Importante:

As alterações de dicionário de dados estarão disponíveis a partir do release 12.1.2210

04. DEMAIS INFORMAÇÕES

Para uso desta funcionalidade, deve ser utilizado:

Pacote: 010628 - TMS - DLOGTMS02-20661 - NOVO TDA;
Fontes atualizados das rotinas envolvidas, mencionadas no item 01. desta documentação;
Configuração do perfil do cliente com a opção TDA por Região igual a 1=Sim;
Cadastro do novo componente de frete 18 - TDA por Região;
Vínculo do componente com a Configuração da tabela frete;
Cadastro de Componente de frete x TDA por CEP / Região (TMSA135);
Realizar o calculo de frete através das rotinas:
- Cotação de frete (TMSA040);
- Entrada Dc Cliente, preview (TMSA050);
- Calculo de frete (TMSA200)
- Manutenção de Documentos (TMSA500).

DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS

Criação de Consulta Padrão:

Alias	Tipo	Coluna	Descrição	Contém
DT3TDA	1	DB	Comp. Frete por TDA	DT3
DT3TDA	2	01	Componente
DT3TDA	3	01	Componente	DT3_CODPAS
DT3TDA	4	02	Descricao	DT3_DESCRI
DT3TDA	5			DT3->DT3_CODPAS
DT3TDA	6			DT3->DT3_TIPFAI == "18"

Criação de tabelas:

Tabela	Descrição
DN9	Componente x TDA por Região
DNA	TDA por Região

Criação de Campos.

Tabela DN9 ( Componente x TDA por Região):

Campo	DN9_CODPAS
Tipo	Caracter
Tamanho	2
Decimal	0
Formato	@!
Título	Componente
Descrição	Componente
Usado	Sim
Obrigatório	Sim
Browse	Sim
Opções
When
Relação
Val. Sistema	ExistCpo("DT3",M->DN9_CODPAS) .And. Existchav("DN9")
Help	Componente de frete

Campo	DN9_DESCRI
Tipo	Caracter
Tamanho	20
Decimal	0
Formato	@!
Título	Descrição
Descrição	Descrição do Componente
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação	If(!INCLUI,Posicione("DT3",1,xFilial("DT3")+DN9->DN9_CODPAS,"DT3_DESCRI")," ")
Ini. Browse	Posicione("DT3",1,xFilial("DT3")+DN9->DN9_CODPAS,"DT3_DESCRI")
Help	Descrição do Componente de Frete

Tabela DNA (TDA por Região):

Campo	DNA_FILIAL
Tipo	Caracter
Tamanho	2
Decimal	0
Formato
Título	Filial
Descrição	Filial do Sistema
Usado	Não
Obrigatório	Não
Browse	Sim
Grupo Campo	033
Help	Filial do Sistema.

Campo	DNA_CODPAS
Tipo	Caractere
Tamanho	2
Decimal	0
Formato	@!
Título	Componente
Descrição	Componente
Usado	Sim
Obrigatório	Sim
Browse	Não
Help	Componente de frete

Campo	DNA_ITEM
Tipo	Caracter
Tamanho	4
Decimal	0
Formato	@!
Título	Item
Descrição	Item
Usado	Sim
Obrigatório	Sim
Browse	Não
Help	Item

Campo	DNA_CEPINI
Tipo	Caractere
Tamanho	8
Decimal	0
Formato	@R 99999-999
Título	Cep Inicial
Descrição	Cep Inicial
Usado	Sim
Obrigatório	Não
Browse	Não
Valid	Tms135Cep()
Help	CEP inicial da faixa de CEP para cobrança do TDA.

Campo	DNA_CEPATE
Tipo	Caracter
Tamanho	8
Decimal	0
Formato	@R 99999-999
Título	Cep Final
Descrição	Cep Final
Usado	Sim
Obrigatório	Não
Browse	Não
Valid	Tms135Cep()
Help	CEP final da faixa de CEP para cobrança do TDA.

Campo	DNA_CODREG
Tipo	Caracter
Tamanho	6
Decimal	0
Formato	@!
Título	Cód. Região
Descrição	Código Região
Usado	Sim
Obrigatório	Não
Browse	Não
Val. Sistema	ExistCpo("DUY",,1)
Help	Código da região para cobrança do TDA.

Campo	DNA_DESREG
Tipo	Caracter
Tamanho	30
Decimal	0
Formato	@!
Título	Desc. Região
Descrição	Descrição Região
Usado	Sim
Obrigatório	Não
Browse	Não
Relação	Posicione("DUY",1,xFilial("DUY")+DNA->DNA_CODREG,"DUY_DESCRI")
Help	Descrição da região.

Campo	DNA_TIPCOB
Tipo	Caracter
Tamanho	1
Decimal	0
Formato	@!
Título	Tipo Cobranç
Descrição	Tipo Cobrança
Usado	Sim
Obrigatório	Sim
Browse	Não
Opções	1=Fixo;2=Percentual
Relação	"1"
Val. Sistema	Pertence("12")
Help	Tipo de cobrança do TDA por Região. 1 = Fixo; 2 = Percentual sobre os demais componentes de frete com exceção dos outros tipos de TDA.

Campo	DNA_VALOR
Tipo	Numérico
Tamanho	14
Decimal	2
Formato	@E 99,999,999,999.99
Título	Valor
Descrição	Valor
Usado	Sim
Obrigatório	Sim
Browse	Não
Val. Sistema	Positivo()
Help	Valor da cobrança.

Tabela DUO (Perfil do Cliente ):

Campo	DUO_TDAREG
Tipo	Caracter
Tamanho	1
Decimal	0
Formato	@!
Título	TDA por Reg.
Descrição	TDA por Região
Usado	Não
Obrigatório	Não
Browse	Não
Opções	1=Sim;2=Não
Relação	"2"
Val. Sistema	Pertence("12")
Help	Utiliza TDA por região. 1 = Sim; 2 = Não.

Tabela DT3 (Componente de frete):

Campo	DT3_FAIXA2
When	TMSA030Wh()

Criação de gatilhos

DN9:

X7_Campo	X7_Sequencia	X7_Regra	X7_CDOMIN	X7_Alias	X7_Ordem	X7_Chave
DN9_CODPAS	001	DT3->DT3_DESCRI	DN9_DESCRI	DT3	1	xFilial("DT3")+M->DN9_CODPAS

DNA:

X7_Campo	X7_Sequencia	X7_Regra	X7_CDOMIN	X7_Alias	X7_Ordem	X7_Chave	X7_Condic
DNA_CODREG	001	DUY->DUY_DESCRI	DNA_DESREG	DUY	1	xFilial()+M->DNA_CODREG	!EMPTY(M->DNA_CODREG)

Relacionamento entre tabelas:

DNA:

X9_Tabela de Origem	X9_Tabela de Destino	X9_Campo(s) da tabela de Origem	X9_Campo(s) da tabela de Destino
DUY	DNA	DUY_GRPVEN	DNA_CODREG

DN9:

X9_Tabela de Origem	X9_Tabela de Destino	X9_Campo(s) da tabela de Origem	X9_Campo(s) da tabela de Destino
DT3	DN9	DT3_CODPAS	DN9_CODPAS

Criação de índices:

DN9:

Índice	Ordem	Chave	Descrição
DN9	1	DN9_FILIAL+DN9_CODPAS	Componente

DNA:

Índice	Ordem	Chave	Descrição
DNA	1	DNA_FILIAL+DNA_CODPAS+DNA_CODREG	Componente

05. ASSUNTOS RELACIONADOS

Árvore de páginas

DLOGTMS02-21192 DT TDA por CEP ou Região.

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

03. SOLUÇÃO

04. DEMAIS INFORMAÇÕES

DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS

05. ASSUNTOS RELACIONADOS