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
- É 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.
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:
English
Español
English
Español


