Migrando da versão 2017/01 para 2019/01

Na versão 2019/01 da MDFeLibrary foram feitas alterações para suportar as mudanças do MOC (Manual de Orientação do Contribuinte) versão 3.00a.

Implementado o QRCode

A partir de 07/10/2019, passa a ser obrigatório o preenchimento da tag qrCodMDFe referente ao QRCode (vide schema abaixo).

qrCodMDFe

Na MDFeLibrary, esta tag encontra-se na estrutura tMDFe.sQrcode.

Por motivos de entendimento vamos dividir esta tag em 3 partes distintas, sendo:

  • URL para acessar o MDF-e, seguido do caractere “?”. As url’s podem ser consultadas no link https://dfe-portal.svrs.rs.gov.br/Mdfe/Servicos.
  • Chave de acesso do MDF-e precedida da string “chMDFe=”. A chave de acesso pode ser gerada utilizando a função MDFeGeraChave.
  • Identificação do ambiente que está sendo usado (1 – Produção; 2 – Homologação), precedido da string “&tpAmb=”.

Concatenado essas partes, teremos uma string parecida com a seguinte:

http://dfe-portal.svrs.rs.gov.br/mdfe/QRCode?chMDFe=43181207312871000190580010000334041421310776&tpAmb=1

Sugerimos aos desenvolvedores que controlem a geração do código numérico que compõe a chave de acesso (icMDFe) ou, assim que gerar pela primeira vez a chave do MDF-e, extraia a parte referente ao código randômico e armazene para, caso seja necessário gerar novamente a chave de acesso, seja possível informar o parâmetro {icMDFe}.

Caso seja necessário gerar novamente a chave e o parâmetro {icMDFe} não for informado, um novo icMDFe randômico será gerada para montar a chave e, eventualmente ocasionará divergência entre a chave informada na tag qrCodMDFe e a chave utilizada no MDF-e (tag cMDF do nó ide).