Guia de Uso do MDFe_Util v3.10c

Guia de Uso » Atualizações da DLL ^03-07-25

Sumário
1. Atualizações da DLL ^03-07-25

2. Caminho mais curto para gerar e autorizar um MDF-e
Próximo »

1. Atualizações da DLL ^03-07-25

Alterações da Nota Técnica 2025/001

• inclusão de novas regras de validação que passa a exigir a informação do NCM e informações de pagamento na seguinte situação:

"Tipo Emitente for igual a Prestador de Serviço de Transporte (tpEmit=1) ou transportador que emitirá CTe globalizado (tpEmit=3) ou Transportador Próprio que informou o Tipo de Transportador (tpEmi=2 com tag tpTransp informada) e MDFe possuir apenas um DF-e transportado no grupo infDoc."

• alteração no domínio das seguintes tags:

  • tpCarga (prodPred/tpCarga) - acréscimo do "12 - Granel Pressurizada";
    
  • tpComp (infPag/Comp/tpComp) - acréscimo do "04 - Frete";
    
  • tpValePed (valePed/disp/ValePed) - eliminação do "02 - Cupom" e "03 - Cartão") e acréscimo do "04 - Leitura de placa (pela placa de identificação veicular)"

• alteração na cardinalidade - a tag CIOT do grupo CIOT passou a ser opcional;

IMPORTANTE

A maioria das alterações desta NT são de alteração de regras de validação que não afetam a DLL, mas o reutilização do cStat=301 e 302 pode causar erro no envio quando o MDF-e for rejeitado com cStat=301 ou 302, pois a DLL vai tratar com um caso de denegação de uso ao invés de simples rejeição.
As alterações nos domínios e cardinalidade do XML requer a atualização do Schema XML, sendo importante que a DLL seja atualizada.

PRAZOS PARA IMPLEMENTAÇÃO DA NT 2025/001

• ambiente de homologação: Julho/2025
• ambiente de produção: Outubro/2025

Download disponíveis:

ATENÇÃO

Versão 3.10c PRELIMINAR - EM TESTES

Download da DLL MDFe_Util - versão 3.10c - julho/2025

Download Instalador da DLL MDFe_Util - versão 3.10c

Instalador da DLL - a melhor forma de registrar a DLL

O Instalador da DLL é a forma mais eficaz e simples de fazer o registro da DLL em qualquer versão do Windows.

Caso deseje fazer a instalação "silenciosa" sem a apresentação da caixa de diálogo do "innosetup" utilize a seguinte sintaxe:

MDFe_Util_v3.08b /verysilent /components="DLL" /DIR=".\teste"

indicar onde deseja que seja "copiado" a DLL e a pasta MDFe_Util em /DIR="PATH"

Versão anteriores:

Download da DLL MDFe_Util - versão 3.10 - novembro/2024

Download Instalador da DLL MDFe_Util - versão 3.10

Download da DLL MDFe_Util - versão 3.08e - maio/2024

Download Instalador da DLL MDFe_Util - versão 3.08e

Download da DLL MDFe_Util - versão 3.08b - julho/2022

Download Instalador da DLL MDFe_Util - versão 3.08b

Download da DLL MDFe_Util - versão 3.07a - maio/2021

Download Instalador da DLL MDFe_Util - versão 3.07a

Histórico de Atualizações:

• 3.0.10c - 2025-07-03

  • alteração para não tratar o cStat=301 e cStat=302 como denegação de uso no enviaMDFe
  • atualização dos schemas XML

• 3.0.10b - 2025-03-13

  • correção para gerar a tag idCSRT com 3 dígitos no infRespTec2

• 3.0.10a - 2025-01-08

  • correção da path de localização do SumatraPDF na visualização/impresssão do DANFE

• 3.10 - 2024-11-08

  • infCTe para aceitar o grupo de informação das NFe entregues na prestação parcial do CTe

  string infCTe_NT2024002(string chCTe, string SegCodBarra_Opc, string indReentrega_Opc, string infUnidTransp_Grupo_Opc, string peri_Grupo_Opc, string infEntregaParcial_Opc, string infNFePrestParcial_Opc)

  • informa chave da NFe entregues na prestação parcial do CTe

  string infNFePrestParcial(string chNFe)

• 3.09a - 2024-08-16

  • criaProcMDFe - tenta criar o proMDFe a partir do XML do MDF-e assinado com dados da consulta MDF-e

    string CriaProcMDFe(string siglaWS, ref string MDFeAssinado, out string protocolo, out int resultado, string nomeCertificado, out string msgResultado, string proxy, string usuario, string senha)

  • Alterações no DAMDFE

    . [RELACIONADFE] - indica que os DFe do MDF-e devem ser relacionados no DAMDFE;

    . mostra o RNTRC do veículo próprio no DAMDFE;

    . corrige formatação de valores no DAMDFE;

• 3.08e - 2024-05-06

  • eliminação da validação do tipo autorizador do nRec

• 3.08d - 2024-04-19

  • correção no tratamento de caracteres multibyte no processo de compactação gZip

• 3.08c - 2023-02-16

  • Formatação de milhar das Qtdes de NFe, CTe, MDFe, qCarga
  • correção do MontaProcMDFe para aceitar a versão = 3.00

• 3.08b - 2022-07-29

  • alteração complementar para forçar o digest method = sha1 no processo de assinatura digital

• 3.08a - 2022-06-02

  • alteração para forçar o digest method = sha1 no processo de assinatura digital
  • atualização do schema XML do modal rodoviário (Schemas NT 2022.001 [v1.03])

• 3.08 - 2022-03-09

  • Evento de Confirmação do serviço de Transporte

  • Evento de Alteração do Pagamento do Serviço de Transporte

  • Acréscimo das tag NroContrato e vContratoGlobal no grupo de informação do contrato.

  • Acréscimo das tag indAntecipaAdiant e tpAntecip no grupo de informação do pagamento.

• 3.0.7b - 2021-11-16

  • alteração para geração do DAMDFE emitido em contingência que se encontra autorizado.

• 3.0.7a - 2021-05-26 - NT 2021/002

  • alteração para vAdiant não ser gerada quando valor <=0 no grupo infPag

  string infPag_NT2021002(string xNome_Opc, string CPF, string CNPJ, string idEstrangeiro, string Comp, double vContrato, string indPag, string infPrazo, string codBanco, string codAgencia, string CNPJIPEF, string PIX,string indAltoDesemp_Opc, double vAdiant)

• 3.0.7 - 2021-05-02 - NT 2021/002

  • acréscimo das tags: vAdiant no grupo infPag

  string infPag_NT2021002(string xNome_Opc, string CPF, string CNPJ, string idEstrangeiro, string Comp, double vContrato, string indPag, string infPrazo, string codBanco, string codAgencia, string CNPJIPEF, string PIX,string indAltoDesemp_Opc, double vAdiant)

• 3.0.6 - 2021-03-23 - NT 2021/001

  • acréscimo da tag: tpValePed no grupo disp

  string disp_NT2021001(string CNPJForn,string CNPJPg,string CPFPg, string nCompra, string vValePed, string tpValePed)

  • acréscimo da tag: categCombVeic no grupo valePed

  string valePed_NT2021001(string disp,string categCombVeic_Opc)

  • alteração no tratamento do valePed no grupo infANTT

  string infANTT_NT2021001(string RNTRC_Opc, string infCIOT_Grupo_Opc, string valePed_Grupo_Opc, string infContratnte_Grupo_Opc, string infPag_Grupo_Opc)

  • acréscimo das tags: PIX e indAltoDesemp no grupo infPag

  string infPag_NT2021001(string xNome_Opc, string CPF, string CNPJ, string idEstrangeiro, string Comp, double vContrato, string indPag, string infPrazo, string codBanco, string codAgencia, string CNPJIPEF, string PIX,string indAltoDesemp_Opc)

  • alteração para não gerar a tag UF quando não informada

  string veicPrincipal_v3(string cInt_Opc, string placa, string RENAVAM_Opc, string tara, string capKG_Opc, string capM3_Opc, string prop_Grupo_Opc, string condutor_Grupo, string tpRod, string tpCar, string UF)

  • alteração para não gerar a tag UF quando não informada

  string veicReboque_v3(string cInt_Opc, string placa, string RENAVAM_Opc, string tara, string capKG, string capM3_Opc, string prop_Grupo_Opc, string tpCar, string UF)

• 3.0.5c - 2020-08-11

  • correção na validação de CPF que é válido como CNPJ quando informado com 14 dígitos

• 3.0.5b - 2020-07-14

  • correção na exibição dos dados do vale pedágio do DAMDFE

• 3.0.5a - 2020-03-12

  • correção na geração do evento incPagtoOper
  • alteração para sempre gerar o grupo infPag no grupo infANTT
  • alteração para sempre gerar a tag indPag no grupo infPag

• 3.0.5 - 2020-02-25

  • novas funcionalidades para gerar o grupo prodPred (produto predominante)

  string prodPred(string tpCarga, string xProd, string cEAN_Opc, string NCM_Opc, string infLotacao_Opc)

  string infLotacao(string LC_CEP, double LC_latitude, double LC_longitude, string LD_CEP, double LD_latitude, double LD_longitude)

  • nova funcionalidade para consolidar o MDF-e com o grupo prodPred (produto predominante)

  string MDFe_NT2020001(string versao, string Id, string ide, string emit, string infModal,string infDoc, string seg_Opc, string tot, string lacres_Opc string autXML_Opc, string infAdic_Opc, string infRespTec_Opc, string infMDFeSupl_Opc, string prodPred_Opc)

  • nova funcionalidade para gerar o grupo informação do Contratante com as novas tags xNome e idEstrangeiro

  string infCont_NT2020001(string xNome_Opc, string CPF, string CNPJ, string idEstrangeiro)

  • nova funcionalidade para gerar o grupo infPag (informação do pagamento)

  string infPag(string xNome_Opc, string CPF, string CNPJ, string idEstrangeiro, string Comp, double vContrato, string indPag, string infPrazo, string codBanco, string codAgencia, string CNPJIPEF)

  string Comp(string tpComp, double vComp, string xComp_Opc)

  string infPrazo(string nParcela_Opc,DateTime dVenc_Opc, double vParcela)

  • nova funcionalidade para consolidar o grupo infANTT com o grupo infPag (informação do pagamento)

  string infANTT_NT2020001(string RNTRC_Opc, string infCIOT_Grupo_Opc, string valePed_Grupo_Opc, string infContratnte_Grupo_Opc, string infPag_Grupo_Opc)

  • novo evento para inclusão de pagamento de TAC-Agregado ou equiparado ocorrido no final do período de viagens realizadas

  string incPagtoOper(string siglaWS, int tipoAmbiente, string nomeCertificado, string versao, out string msgDados, out string msgRetWS, out int resultado, out string msgResultado, string chaveMDFe, string nProt, int qtdViagens, int nroViagem, string infPag_Opc, string dhEvento, int nSeq, out string nProtPagtoOper, out string dProtPagtoOper, string proxy, string usuario, string senha, string licenca)

• 3.0.4f - 2020-02-01

  • correção no DAMDFE do modal aquaviário

• 3.0.4e - 2019-10-14

  • acrescentado opção para gerar pdf do DAMDFE do modal aquaviário

• 3.0.4d - 2019-09-19

  • geração do PDF do DAMDFE do modal áereo
  • tratamento quando inexistir infAdic no XML para gerar o DAMDFE

• 3.0.4c - 2019-09-19

  • geração do PDF do DAMDFE do modal rodoviário

  int geraPdfDAMDFE(string XML, string logo, string visualizar, string parametros, out string msgResultado)

• 3.0.4b - 2019-07-25

  • correção da validação da licença no enviaMDFe

• 3.0.4a - 2019-07-25

  • nova funcionalidade para gerar o grupo ide com as novas tags indCanalVerde e indCarregaPosterior

  string ide_v3a(int cUF, int tpAmb, int tpEmit, string tpTransp_Opc,int mod, int serie, int nMDF, int cMDF, int cDV, string modal, string dhEmi, int tpEmis, int procEmi, string verProc, string UFIni, string UFFim, string infMunCarrega_Grupo, string infPercurso_Grupo_Opc, string dhIniViagem_Opc, string indCanalVerde_Opc, string indCarregaPosterior_Opc)

  • nova funcionalidade para gerar o grupo infMDFeSupl (qrCode)

  string infMDFeSupl(string URL, string chaveMDFe, int tpAmb, string nomeCertificado, out string qrCode, out int resultado, out string msgResultado)

  • nova funcionalidade para consolidar o MDF-e aceitando o grupo infMDFeSupl (qrCode)

  string MDFe_v3a(string versao, string Id, string ide, string emit, string infModal,string infDoc, string seg_Opc, string tot, string lacres_Opc string autXML_Opc, string infAdic_Opc, string infRespTec_Opc, string infMDFeSupl_Opc)

  • nova funcionalidade para gerar a tag hashCSRT do grupo infRespTec a partir da chave de acesso do MDFe

  string infRespTec2(string CNPJ, string xContato, string email, string fone, string idCSRT, string CSRT_Opc, string chaveMDFe_Opc)

  • implementado WS de envio Sincrono de MDFe

  string EnviaMDFeSincrono(string siglaWS, string MDFE, string nomeCertificado, string versao, string MDFe, out string msgDados, out string msgRetWS, out integer cStat, out string msgResultado, out string protocolo, out string nroProtocolo, out string dhProtocolo, out string MDFeAssnado, string proxy, string usuario, string senha, string licenca)

  • implementado o evento de inclusão de DF-e

  string IncDFeMDFe( string siglaWS, int tipoAmbiente, string nomeCertificado, string versao, out string msgDados, out string msgRetWS, out int resultado, out string msgResultado, string chaveMDFe, string nProt, string cMunCarrega, string xMunCarrega, string infDoc, string dhEvento, int nSeq, out string nProtocoloInc, out string dProtocoloInc, string proxy, string usuario, string senha, string licenca)

  string infDoc_v3a(string cMunDescarga, string xMunDescarga, string chNFe)

• 3.0.3b - 2018-10-04

  • alteração para aceitar cUF=99 no evento de encerramento de MDF-e

• 3.0.3a - 2018-09-20

  • correção na validação do CNPJ nos casos em que o 11 dígitos da direita do CNPJ é CPF válido

• 3.0.3 - 2018-08-28 - implementação das alterações previstas na NT 2018.002

  • aceitar o uso do CPF (emissor PF) no WS do MDF-e
  • aceitar CPF na geração do grupo emit do MDF-e

  • grupo infEntregaParcial

    string infEntregaParcial(string qtdTotal, string qtdParcial)

  • grupo infCTe_NT2018002 alterado para aceitar infEntregaParcial

    string infCTe_NT2018002(string chCTe, string SegCodBarra_Opc, string indReentrega_Opc, string infUnidTransp_Grupo_Opc, string peri_Grupo_Opc, string infEntregaParcial_Opc)

  • grupo infRespTec

    string infRespTec(string CNPJ, string xContato, string email, string fone, string idCSRT_Opc, string hashCSRT_Opc)

  • grupo MDFe_NT2018002 para aceitar infRespTec

    string MDFe_NT2018002(string versao, string Id, string ide, string emit, string infModal,string infDoc, string seg_Opc, string tot, string lacres_Opc string autXML_Opc, string infAdic_Opc, string infRespTec_Opc)

  • aceitar CPF na cricao da chave de acesso - CriaChaveDFe

  • não aceitar espaço em branco no proxy
  • atualização do schema XML (NT 2018/002)

• 3.0.2 - 2018-01-14

  • alteração para suportar o TLS 1.2

• 3.0.1c - 2017-05-18

  • correção para gerar a tag nLacre no grupo lacRod
  • alteração para elminar os caracteres especiais de quebra de linha da assinatura nos XML obtidos no distNSU
  • correção para gerar as tags CNPJPg e CPFPg no grupo disp

• 3.0.1b - 2017-04-12

  • correção da tag infMDFe para infMDFeTransp no grupo de documentos vinculados
  • Atualização do pacote de scehma XML
  • correção para não gerar a tag CNPJ da seguradora quando não for informado o CNPJ
  • correção para não gerar a tag RNTRC do grupo infANTT quando não for informado o RNTRC
  • correção para gerar a tag de grupo do lacres rodoviários como lacRodo ao invés de lacRod

• 3.01a - 2017-03-10

  • correção da seguinte funcionalidade:

    string infMunDescarga(string cMunDescarga, string xMunDescarga, string infCTe_Grupo_Opc, string infNFe_Grupo_Opc, string infMDFe_Grupo_Opc)

• 3.01 - 2017-03-10

  • acrécismo das seguintes funcionalidades:

    string veicPrincipal_v3(string cInt_Opc, string placa, string RENAVAM_Opc, string tara, string capKG_Opc, string capM3_Opc, string prop_Grupo_Opc, string condutor_Grupo, string tpRod, string tpCar, string UF)

    string veicReboque_v3(string cInt_Opc, string placa, string RENAVAM_Opc, string tara, string capKG, string capM3_Opc, string prop_Grupo_Opc, string tpCar, string UF)

• 3.00 - 2017-02-24

  • atualização para a versão 3.00 do leiate do MDF-e e Web Services
  • disponibilização do WS de distribuição de MDF-e;

• 1.2a - 2015-07-10

  • atualização de schema XML - PL_MDFe_100a_NT032015.zip;
  • alteração das URL dos WS;

DESATIVAÇÃO DAS URL ATUAIS EM 01/10/2015

A SEFAZ/RS deve desativar as URL atuais da NF-e, CT-e e MDF-e em 01/10/2015. Assim, a atualização da versão da DLL é imprescindível.

• 1.2 - 2015-01-03

  • atualização do schema XML para NT_2015/001
    
  • acréscimo da funcionalidade para consultar os MDF-e não encerrados string ConsMDFeNaoEnc(string siglaWS, string siglaUF, int tipoAmbiente, string nomeCertificado, string versao, out string msgDados, out string msgRetWS, out int resultado, out string msgResultado, string CNPJ, string cUF, int qtdeMDFe, string proxy, string usuario, string senha, string licenca)

• 1.1b - 2014-02-21

  • correção para informar o nSeq correto no XML do pedido de inclusão do condutor quando o nSeq for > 1 no IncCondutorMDFe

• 1.1a - 2013-12-19

  • alteração para a tag qCarga do grupo tot ser gerada com 4 dígitos;

• 1.00a - 2013-11-07

  • atualização do schema XML para NT_2013/004
    
  • acréscimo das seguintes funcionalidades para geração do modal rodoviário:
    string prop_v10a(string CPF, string CNPJ, string RNTRC, string xNome, string IE_Opc, string UF_Opc, int tpProp)
    string veicPrincipal_v10a(string cInt_Opc, string placa, string tara, string capKG_Opc, string capM3_Opc, string prop_Grupo_Opc, string condutor_Grupo, string tpRod, string tpCar, string UF)
    string veicReboque_v10a(string cInt_Opc, string placa, string tara, string capKG, string capM3_Opc, string prop_Grupo_Opc, string tpCar, string UF)
    
  • acréscimo de novo evento de inclusão de condutor
    string IncCondutorMDFe(string siglaWS, int tipoAmbiente, string nomeCertificado, string versao, out string msgDados, out string msgRetWS, out int resultado, out string msgResultado, string chaveMDFe, string nProtocolo, string CPF, string xNome, string dhEvento, int nSeq, out string nProtocoloInc, out string dProtocoloInc, string proxy, string usuario, string senha, string licenca);

• 1.00 - 2013-06-03

  • atualização do schema XML para NT_2013/002
  • alteração do nome da tag para veicPrincipal para veicTracao
  • acréscimo de novas funcionalidades para geração do grupo infUnidTransp
    string infUnidTransp(string tpUnidTransp, string idUnidTransp, string lacUnidTransp_Opc, string infUnidCarga_Opc, string qtdRat_Opc)
    string lacUnidTransp(string nLacre)
    string infUnidCarga(string tpUnidCarga, string idUnidCarga, string lacUnidCarga_Opc, string qtdRat_Opc)
    string lacUnidCarga(string nLacre)
    string infNFNovo(string CNPJ, string UF, string nNF, string serie, DateTime dEmi, double vNF, string PIN_Opc, string infUnidTransp_Opc)
    string infNFeNovo(string chNFe, string SegCodBarra_Opc, string infUnidTransp_Opc)
    string infCTNovo(string nCT, string serie, string subser_Opc, DateTime dEmi, double vCarga, string infUnidTransp_Opc)
    string infCTeNovo(string chCTe, string SegCodBarra_Opc, string infUnidTransp_Opc)
    

• 0.00b - 2013-03-20

  • atualização do schema XML - NT 2013/001

• 0.00a - 2012-11-27

  • correção do tratamento do retorno do evento de cancelamento e encerramento.
  • correção na geração da tag cMDF para considerar os zeros não significativos.

• 0.00 - 2012-10-15 - versão preliminar

1. Atualizações da DLL ^03-07-25
Sumário

Próximo »
2. Caminho mais curto para gerar e autorizar um MDF-e

Copyright © FlexDocs Documentos Eletrônicos - 2015-2025 - Todos os direitos reservados

Generated by TypeFriendly 0.1.3 by Invenzzia