Geração automática de MDF-e
Conceito
Essa documentação tem como objetivo descrever as parametrizações necessárias para a geração automática de MDF-e de saída para o modal rodoviário. Trata-se de um processo que não é nativo do sistema, ou seja, cada cliente deve configurar as regras com base no cenário da sua empresa.
Características do MDF-e Automático:
- apenas para modal rodoviário;
- MDF-e com base em NF-es ou CT-es de saída;
- características necessárias para que o documento seja adicionado ao MDF-e:
- deve estar fechado no ERP (E140NFV.SITNFV = 2);
- deve estar com a situação autorizada ou autorizada em contingência (E140IDE.SITDOE in 3,16);
- não estar em outro MDF-e.
Esta solução permite que, através de um ponto de regra identificado pelo cliente como sendo o ponto de geração de MDF-e (fechamento de um documento ou alteração da sua situação para Autorizado), seja feita a emissão do mesmo de forma automática. O processo definido pelo cliente, então, chama a função de programador GerarMDFeSaidaAutomatico, que traz as informações dos identificadores de regra citados mais abaixo para geração do MDF-e. Essa busca se dá através do campo/chave ChaveMDFeAuto.
Parametrização
Primeiro configure a sugestão automática dos locais de passagem no MDF-e. Essa informação é necessária para atender a legislação do Manifesto (onde é chamado de percurso) para o modal rodoviário. Para isso, parametrize os locais de passagem na tela F000PER (Cadastros > Mercado e Suprimentos > Percursos do MDF-e) e defina um como sendo o padrão. Feito isso, se o campo Rotas automáticas da tela F145EBQ estiver preenchido, os locais de passagem serão atualizados automaticamente nas telas de geração de MDF-e (F145EBQ, F145GSM e F440MDF).
Exemplo
- UF Origem: SC
- UF Destino: MG
- Padrão (S/N): S
- Estados passagem (Sequência/UF):
- 1/PR
- 2/SP
Além disso, para gerar o MDF-e automaticamente, é importante que na tela F070FVE seja informada uma série para a geração do MDF-e no campo Série MDF-e padrão.
Após, configure a função de programador GerarMDFeSaidaAutomatico vinculada a uma regra no identificador de regras VEN-140NEIMPBO. O identificador irá executar após a autorização da nota fiscal eletrônica.
Poderá ser utilizada a regra abaixo, onde foi feito um cursor na tabela de informações do documento eletrônico (E140IDE) que busca automaticamente pelas chaves dos documentos eletrônicos autorizados via web service.
Exemplo
Definir numero numebq;
Definir alfa ListaChvDoe;
Definir alfa ChaveMDFeAuto;
Definir alfa GerarXml;
Definir alfa NumEbqAlfa;
Definir alfa MensagemUsuario;
Definir numero VSCODEMP;
Definir numero VSCODFIL;
Definir alfa VSCODSNF;
Definir numero VSNUMNFV;
Definir alfa ChvDoe;
Definir alfa VCURSOR;
Definir alfa VSQL;
Inicio
ChaveMDFeAuto = "1234"; @ Campo de chave a ser utilizado a critério do usuário.@
@ O valor informado nesse campo estará disponível em todos os IRs do MDF-e Automático.@
GerarXml = "S"; @ Indica a geração automática do XML ao gerar o MDF-e @
SQL_Criar(VCURSOR);
VSQL = "SELECT CHVDOE " +
" FROM E140IDE " +
" WHERE CODEMP = :VSCODEMP " +
" AND CODFIL = :VSCODFIL " +
" AND CODSNF = :VSCODSNF " +
" AND NUMNFV = :VSNUMNFV";
SQL_DefinirComando(VCURSOR, VSQL);
SQL_DEFINIRINTEIRO(VCURSOR, "VSCODEMP", VSCODEMP);
SQL_DEFINIRINTEIRO(VCURSOR, "VSCODFIL", VSCODFIL);
SQL_DEFINIRALFA(VCURSOR, "VSCODSNF", VSCODSNF);
SQL_DEFINIRINTEIRO(VCURSOR, "VSNUMNFV", VSNUMNFV);
SQL_AbrirCursor(VCURSOR);
Se (SQL_EOF(VCURSOR) = 0)
Inicio
SQL_RETORNARALFA(VCURSOR, "CHVDOE", ChvDoe);
Fim;
ListaChvDoe = "'" + ChvDoe + "'";
GerarMDFeSaidaAutomatico(VSCODEMP, VSCODFIL, ChaveMDFeAuto, ListaChvDoe, GerarXml,
NumEbq);
Fim;
Observações
- Caso haja documentos informados tanto no parâmetro ListaChvDoe quanto na regra do identificador VEN-140MDFEA00, o sistema irá priorizar os documentos informados na regra do identificador VEN-140MDFEA00.
- Quando for passado uma chave do documento eletrônico para o parâmetro ListaChvDoe da função GerarMDFeSaidaAutomatico, deve-se sempre adicionar um apóstrofe entre a chave. Caso não seja adicionado pode ocorrer erro de banco de dados.
Importante
A indicação de utilização do identificador de regras VEN-140NEIMPBO deve levar em considerações características com relação a Performance do processo. Em maiores volumetrias de processamento, a utilização deste identificador de regras poderá causar problemas de travamento e baixa performance. Neste caso, é possível fazer a utilização de um processo agendado que faça a chamada da função GerarMDFeSaidaAutomatico, localize as NF-e autorizadas na base de dados (E140IDE) e faça a execução do processo (poderão ser utilizadas tabelas de usuário para correto controle das NF-e que precisam ter o MDF-e gerado). Para maiores informações sobre Performance em rotinas e sobre o identificador de regras, consulte a Documentação do sistema e Artigos da Base de Conhecimento do Suporte.
- É recomendável não retornar mensagens ao utilizar esse identificador por meio do web service, pois ele é executado no retorno do documento para o ERP. Se a regra retornar alguma mensagem, como por exemplo, uma função de Geralog ou Mensagem, o processo de retorno será bloqueado.
- Na versão 1.00 da NT 2024.001, a partir de 08/04/2024 é obrigatório informar ao menos um veículo de reboque quando o modal for rodoviária e o tipo de rodado do veículo informado for cavalo mecânico. Também não permite vincular um documento fiscal ao MDF-e com data de emissão menor que seis meses.
Por fim, configure as regras na tela F098REG para atender cada cenário específico do MDF-e, conforme a lista abaixo:
- VEN-140MDFEA00 - MDF-e Automático - Documentos Fiscais para Emissão do MDF-e;
- VEN-140MDFEA01 - MDF-e Automático - Dados Gerais;
- VEN-140MDFEA02 - MDF-e Automático - Rotas;
- VEN-140MDFEA03 - MDF-e Automático - Lacres;
- VEN-140MDFEA04 - MDF-e Automático - Vale Pedágio;
- VEN-140MDFEA05 - MDF-e Automático - Seguro de Carga;
- VEN-140MDFEA06 - MDF-e Automático - Unidades de Transporte e Unidades de Carga;
- VEN-140MDFEA07 - MDF-e Automático - Produto Perigoso.
Importante
Entre os identificadores citados acima, apenas o identificador VEN-140MDFEA01 é obrigatório para cadastrar as informações obrigatórias de tipo de carga, código da transportadora, unidade de medida, placa do veículo e motorista. Os demais identificadores citados são opcionais e podem ser utilizados conforme necessidade.
Destaca-se, ainda, que as variáveis e os exemplos de regra podem ser encontrados na documentação de cada IR.
Sugestão
As sugestões são carregadas com base nas informações dos documentos fiscais informados no MDF-e (chamada da função GerarMDFeSaidaAutomatico ou identificador de regra VEN-140MDFEA00).
Campos dos quadros gerais:
| Nome | Sugestão |
| Motorista | Do documento fiscal: E140NFV.CodMtr do primeiro documento encontrado |
| Placa Veículo | Do documento fiscal: E140NFV.PlaVei do primeiro documento encontrado |
| Condição Pagamento | Do documento fiscal: E140NFV.CodCpg do primeiro documento encontrado |
| Transportadora | Do documento fiscal: E140NFV.CodTra do primeiro documento encontrado |
| Peso Bruto | Somatório dos documentos: E140NFV.PesBru |
| Peso Líquido | Somatório dos documentos: E140NFV.PesLiq |
| Valor Líquido | Somatório dos documentos: E140NFV.VlrLiq |
| Data/Hora de Emissão | Data/Hora atual |
| Data/Hora de Saída | Se a data/hora de saída do primeiro documento for maior que data/hora atual, utiliza a do documento; caso contrário utiliza a data/hora atual |
| Tipo Emitente | Se não for informado, verifica se há CT-e informado na lista de documentos e gera com tipo emitente 1 - Prestador de Serviço de Transporte; caso contrário gera com tipo 2 - Transportador de Carga Própria |
É possível alterá-los por meio do identificador de regras VEN-140MDFEA01.
Rotas:
| Tipo | Sugestão |
| Carga | Endereço do Cadastro da Filial |
| Descarga | Endereço de entrega do cliente do Documento Fiscal (considera a Seq. de Entrega do documento, caso informada) |
| Passagem | Busca no Cadastro de Percurso do MDF-e (F000PER), utilizando a Carga e a Descarga como Origem e Destino |
| Local de Descarregamento de Notas Fiscais | Cada documento informado estará relacionado ao seu local de descarregamento |
É possível gerar a rota através do identificador de regras VEN-140MDFEA02 (Rotas). Ao utilizá-lo, as informações sugeridas para rota são desconsideradas, sendo necessário informar todos os itens que compõem uma rota (carga, passagem, descarga e local de descarregamento de nota fiscal).
Exemplo prático:
- cadastro da função de programador:
A condição utilizada como exemplo acima é a seguinte: foi feita a emissão das notas fiscais 516, 517, 518 e 519. As notas 516 e 517 foram emitidas para o cliente 1 e as notas 518 e 519 para o cliente 42. Assim, quando houver valores na tabela E140NFV será feita a emissão do MDF-e.
- cadastro dos identificadores de regra para sugestão das informações:
Como gerar o MDF-e automatico com Informação posterior de Composição
- Será necessário vincular a função de programador GerarMDFeSaidaAutomatico a um Processo Automático ou Regra.
A função por sua vez irá chamar a Execução dos Identificadores de Regras:
| Identificador | Obrig. | Finalidade |
|---|---|---|
| VEN-140MDFEA00 | Sim | Define quais NF-es/CT-es compõem o MDF-e (lista VenNLisDoc). Também é responsável por indicar Carregamento Posterior via VenAIndPos = "S". Se ausente, a função usa o parâmetro ListaChvDoe diretamente. Se Definido não é necessário informar composição de Documentos |
| VEN-140MDFEA01 | Sim | Informa os dados gerais: transportadora, placa, motorista, tipo de carga, unidade de medida, tipo do emitente e carregamento posterior (VenAIndPos). |
| VEN-140MDFEA02 | Não | Define o percurso (carga, passagem, descarga) com CEP e UF. Se ausente, o sistema sugere rotas pelo cadastro F000PER. |
| VEN-140MDFEA03 | Não | Informa os lacres do manifesto. |
| VEN-140MDFEA04 | Não | Informa vales-pedágio (fornecedor, comprovante, valor). |
| VEN-140MDFEA05 | Não | Informa seguro de carga (seguradora, apólice, averbações). |
| VEN-140MDFEA06 | Não | Define unidades de transporte e de carga (containers, pallets) com seus lacres. |
| VEN-140MDFEA07 | Não | Informa dados de produto perigoso (número ONU, classe de risco, embalagem, volumes). |
Conforme pode ser verificado na tabela acima, o Identificador de Regras VEN-140MDFEA00 será responsável por informar ao sistema se haverá carregamento posterior ou não, por meio da variável VenAIndPos.
Além disso, será necessário utilizar os demais Identificadores de Regras aplicáveis à rotina do cliente.
Após a geração, o cliente deverá fechar e emitir o MDF-e por meio da tela F145EBQ.
Com o MDF-e já autorizado, será possível realizar a inclusão do Documento Posterior por meio da aba Rotas, utilizando o botão Inclusão DF-e. É importante informar apenas documentos previamente autorizados.
Em resumo:
- O cliente precisará atualizar para a versão de liberação desta issue.
- O cliente precisará ajustar a chamada da função de programador GerarMDFeSaidaAutomatico para execução em uma Regra ou Processo Automático.
- O cliente precisará ajustar os Identificadores disponibilizados na documentação: documentação de MDF-e automática, principalmente o identificador VEN-140MDFEA00, responsável por informar ao sistema se haverá carregamento posterior ou não.
- Emitir e autorizar o documento gerado.
- Informar as composições posteriores e realizar suas emissões.
English
Español
English
Español


