01. DADOS GERAIS
Produto: | TOTVS Logística TMS |
---|---|
Linha de Produto: | Linha Protheus |
Segmento: | Logística |
Módulo: | TOTVS Logística TMS |
Função: | TMSAE55 - Notas Fiscais |
Ticket: | Não se aplica. |
Requisito/Story/Issue (informe o requisito relacionado) : | DLOGTMS02-16662 |
02. SITUAÇÃO/REQUISITO
Implementar novas funcionalidades de obtenção do valor do frete e placas do(s) veículo(s) na importação do XML da NFe cliente e a opção de geração de Viagem Modelo 3 no EDI automático, quando agrupado por placa de veículo.
A rotina padrão permite que o sistema gere automaticamente os lotes de Notas Fiscais do cliente, bem como, inclua os documentos com base no EDI recebido e na configuração de seu perfil.
A rotina padrão não possuía campos para placas dos veículos e reboques. Na importação do XML, não era tratado o valor do frete (composição do frete no EDI - tabela DET), o processo era possível apenas pela importação de arquivos TXT configurados no configurador de EDI (comumente utilizado o padrão Proceda) ou através de preenchimento manual na rotina de lote EDI.
03. SOLUÇÃO
Efetuado ajustes nas rotinas referente ao processo de EDI Automático com as seguintes implementações:
- Permitir a utilização do frete sugerido pelo cliente, quando este for recebido via XML, utilizando-se da tag vFrete da NF - sempre será considerado o valor do frete com impostos;
- Permitir a obtenção da Placa (veículo e reboque, se houver e até o 3º reboque).
- Permitir a geração de uma viagem de Entrega (Viagem Modelo 3) através do processo de EDI Automático quando lote de NFs (tabela DTP) agrupado por placa.
- Inclusão do parâmetro do "Objeto do XML" no ponto de entrada TME80ALT.
Importante
As alterações de dicionário de dados estarão disponíveis a partir do release 12.1.33.
04. PRECONDIÇÕES
Para a inclusão da viagem automaticamente:
Necessário ambiente com Viagem Modelo 3 configurada/funcional, caso contrário a viagem não será gerada.
Cadastros
Assim como no padrão, deve haver cadastro de Contrato de Cliente e Perfil de Cliente para o cliente devedor de frete.
Parâmetros
Para a utilização do processo de melhoria no EDI automático deverão ser avaliados/configurados os seguintes parâmetros:
- MV_ROTGENT
- MV_VEIGEN
- MV_MOTGEN
- MV_PROGEN
* Avaliar preenchimento das unidades de medida (B1_UM) e segunda unidade medida (B1_SEGUM) além da tabela MG no cadastro de Tabelas (SX5). - MV_CGCTRAN
* Recomenda-se a utilização do parâmetro = .T.
Importante
Para a inclusão da Viagem Modelo 3 automaticamente :
- Será gerado apenas viagem com Serviço de Transporte de ENTREGA.
- A viagem criada será do tipo Planejada.
- Deverá ser informado a Rota através do parâmetro MV_ROTGENT.
- Caso não seja informada a placa do veículo no arquivo XML, o sistema irá considerar o veículo e motorista genéricos conforme configuração dos parâmetros MV_VEIGEN e MV_MOTGEN.
Placa no XML
Padrão de obtenção da placa:
Segundo a Nota Técnica nº 2016.002, versão 1.61. :
Para operações estaduais, não deve-se informar tags de placa.
"Grupo X. Transporte da NF-e CampoSeq Modelo Regra de Validação Aplic. Msg Efeito Descrição Erro X02-20 55 Se operação interestadual(idDest=2), não informar os Grupos Veiculo Transporte (id:X18; veicTransp) e Grupo Reboque (id: X22) Obs1: a critério de cada UF, a regra de validação acima também pode ser aplicada nas operações internas (idDest=1) se cMun (id:C10) do Emitente <> cMun (id: E10) do Destinatário Obs.2: Esta regra não se aplica a emissão da NFA-e. Obrig 868 Rej. Rejeição: Grupos Veiculo Transporte e Reboque não devem ser informados"
Portanto, é incorreto por Lei inserir placa do veículo na NF, podendo conter somente na observação da NF-e.
Para contorno desta NT, pode ser utilizado o ponto de entrada TME80ALT, cujo o exemplo trata da placa contida na tag de observação da Danfe.
04. DEMAIS INFORMAÇÕES
Para uso desta funcionalidade, deve ser utilizado:
- Pacote: 008954 - Para atualização de dicionário de dados.
- Fontes atualizados das rotinas envolvidas, conforme mencionado no cabeçalho desta documentação.
Ajuste Dicionário
Assim como no padrão, para a inclusão automática dos clientes na tabela SA1 (Clientes) é importante ajustar o inicializador padrão (X3_RELAÇÃO) dos campos abaixo:
SA1_COD = GetSx8Num("SA1","A1_COD")
SA1_LOJA = "01"
DETALHAMENTO DA ATUALIZAÇÃO DE DICIONÁRIO CONFORME ABAS
Criação e Alteração de Campos.
Tabela DE5 (EDI - Notas Fiscais):
Campo | DE5_EDILOT |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Lote EDI Aut |
Descrição | Lote EDI Automático |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | 0=Nao utiliza;1=Por processamento;2=Por destinatario;3=Por Placa Veiculo |
When | |
Relação | "0" |
Val. Sistema | Pertence("0123") |
Help | Informa se no EDI automático, caso o cliente utilize, será criado lotes por: 1=Por processamento, 2=Por destinatário ou 3=Por Placa Veiculo. |
Campo | DE5_EDIFRT |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Frt. EDI Aut |
Descrição | Frete EDI Automatico |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | 0=Nao utiliza;1=Assume Frete CIF/FOB;2=Somente Informativo;3=Assume apenas CIF;4=Assume apenas FOB |
When | |
Relação | "0" |
Val. Sistema | Pertence("01234") |
Help | Informa se o valor do frete será 1=Assume Frete ou 2=Somente Informativo. |
Campo | DE5_PLACA |
Tipo | Caractere |
Tamanho | 8 |
Decimal | 0 |
Formato | @! |
Título | Placa Veíc. |
Descrição | Placa Veículo Tracionador |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | |
Val. Sistema | TMSAE55VLD() |
Help | Placa Veículo Tracionador |
Campo | DE5_PLARB1 |
Tipo | Caractere |
Tamanho | 8 |
Decimal | 0 |
Formato | @! |
Título | Placa Reboq1 |
Descrição | Placa 1º Reboque |
Usado | Sim |
Obrigatório | |
Browse | Não |
Opções | |
When | |
Relação | |
Val. Sistema | TMSAE55Vld() |
Help | Placa 1º Reboque - Tag XML InfNfe:Reboque:Placa {1} |
Campo | DE5_PLARB2 |
Tipo | Caractere |
Tamanho | 8 |
Decimal | 0 |
Formato | @! |
Título | Placa Reboq2 |
Descrição | Placa 2º Reboque |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | |
Val. Sistema | TMSAE55Vld() |
Help | Placa 2º Reboque - TAG XML InfNfe:Reboque:Placa {2} |
Campo | DE5_PLARB3 |
Tipo | Caractere |
Tamanho | 8 |
Decimal | 0 |
Formato | @! |
Título | Placa Reboq3 |
Descrição | Placa 3º Reboque |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | |
Val. Sistema | TMSAE55Vld() |
Help | Placa 3º Reboque - TAG XML InfNfe:Reboque:Placa {3} |
Tabela DUO (Perfil do Cliente ):
Campo | DUO_EDILOT |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Lote EDI Aut |
Descrição | Lote EDI Automático |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | 0=Nao utiliza;1=Por processamento;2=Por destinatario;3=Por Placa Veiculo |
When | |
Relação | "0" |
Val. Sistema | Pertence("0123") |
Help | Informa se no EDI automático, caso o cliente utilize, será criado lotes por: 1=Por processamento, 2=Por destinatário ou 3=Por Placa Veiculo. |
Campo | DUO_EDIFRT |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Frt. EDI Aut |
Descrição | Frete EDI Automatico |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | 0=Nao utiliza;1=Assume Frete CIF/FOB;2=Somente Informativo;3=Assume Apenas CIF;4=Assume apenas FOB |
When | |
Relação | "0" |
Val. Sistema | Pertence("01234") |
Help | Informa se o valor do frete será 1=Assume Frete ou 2=Somente Informativo. |
Campo | DUO_EDIVGE |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Viag.EDI Aut |
Descrição | Viagem EDI Automático |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | 0=Não Utiliza;1=Gera Viagem |
When | |
Relação | "0" |
Val. Sistema | Pertence("01") |
Help | Define se gera a viagem na execução do EDI Automático. ATENÇÃO: Recomendável utilizar o Lote EDI Automático (DUO_EDIAUT) com a opção 3-Por Placa Vei. |
Campo | DUO_EDIFRX |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Frt. EDI XML |
Descrição | Frete EDI XML |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | 1=Sim;2=Não |
When | |
Relação | "2" |
Val. Sistema | TmsA480Vld() |
Help | Indica a utilização da Tag InfNfe:total:vFrete como valor do frete (com imposto) na nota importada pela importação de XML (TMSAE080). |
Campo | DUO_EDICMP |
Tipo | Caractere |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Comp.Frt.XML |
Descrição | Componente Frete XML |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | |
Val. Sistema | TmsA480Vld() |
Help | Indica o componente a ser inserido o valor do frete quando este for importado do XML da NF. |
05. ASSUNTOS RELACIONADOS