Manual de Integração Versão 1.0
Conteúdo 1 Obtendo e Instalando o MD-e... 4 1.1 Obtendo o Instalador... 4 1.2 Instalando Componentes... 4 1.3 Instalando o MD-e... 4 2 Padrões de Arquivos... 7 2.1 Arquivos de Manifestação do Destinatário... 7 2.1.1 Evento Confirmação da Operação... 8 2.1.2 Evento Ciência da Operação... 9 2.1.3 Evento Desconhecimento da Operação... 9 2.1.4 Evento Operação Não Realizada... 9 2.2 Download de Arquivos por Destinatário... 10 2.3 Arquivo Consulta e Downloads de Documentos por Destinatário, Transportadora e Terceiros... 11 3 Padrão de Pastas (Diretórios)... 11 3.1 Pasta Autorizadas... 12 3.2 Pasta Processados... 12 3.3 Pasta Remessas... 13 4 Funcionalidades do NSMD-e... 13 4.1 Processamento do MD-e no sistema... 13 4.1.1 Retornos em caso de processo realizado com sucesso... 13 2
4.1.2 Retornos em caso de erro ao realizar o processo... 14 5 Informações Úteis... 14 5.1 Retorno de Processamento da Sefaz (XML)... 14 5.1.1 Motivos do Retorno... 15 5.2 Retorno de Processamento da Sefaz (.txt)... 15 5.2.1 Manifestos... 15 5.2.2 Download... 16 5.2.3 Consulta de Notas Destinatário... 16 3
1 Obtendo e Instalando o MD-e 1.1 Obtendo o Instalador Para realizar o download do MD-e acesse o link a seguir: http:// 1.2 Instalando Componentes O MD-e possui como requisitos mínimos a instalação do Microsoft Framework.NET 2.0, Framework.NET 4.0 e da Máquina Virtual Java (JVM). Para fazer o download e instalação desses itens, utilize os links abaixo e siga as instruções fornecidas nas páginas: Framework.NET 2.0: http://www.microsoft.com/pt-br/download/details.aspx?id=22 Framework.NET 4.0: http://www.microsoft.com/pt-br/download/details.aspx?id=17851 JAVA (JVM): http://www.java.com/pt_br/ 1.3 Instalando o MD-e A tela a seguir irá aparecer indicando o início da instalação, clique em Avançar: 4
Figura 1 - Início da Instalação do Sistema NS MD-e Na próxima tela, leia e aceite os termos de contrato. Depois de selecionar o local, clique em Avançar: Figura 2 Termos de contrato do NS MD-e Na próxima tela, selecione o local onde deseja instalar o sistema. Este local será o diretório raiz do sistema. Depois de selecionar o local, clique em Avançar: 5
Figura 2 - Seleção do Diretório de Instalação do MD-e Obs.: É aconselhável que o Manifesto do Destinatário seja instalado dentro da pasta do sistema da software house. Clique em Instalar na próxima tela: Figura 3 - Confirmação de Instalação do MD-e 6
A próxima tela mostrará o processo de instalação: 2 Padrões de Arquivos Figura 4 - Processo de Instalação do MD-e O sistema NS MD-e utiliza arquivos de texto simples (.txt) pra comunicação com o sistema ERP da empresa. 2.1 Arquivos de Manifestação do Destinatário Esse processo permite que o destinatário da NF-e confirme ou não a sua participação na operação fiscal envolvendo o seu CNPJ, e se manifeste sobre as informações prestadas no documento fiscal emitido pelo seu fornecedor. Esta manifestação deve ser realizada por meio de quatro eventos fiscais. 7
Estes arquivos seguem o mesmo padrão. Todos possuem cinco linhas com as seguintes informações: Na parte superior, você terá o Cabeçalho do arquivo Na coluna A são os Identificadores da Confirmação, Na coluna B, C02 e D são os Identificadores do Ambiente e Emitente. A coluna Grifada no txt é a única que mudará nos eventos de manifestação Exemplo códigos do Evento: 210200 Confirmação da Operação 210210 Ciência da Operação 210220 Desconhecimento da Operação 210240 Operação não Realizada 2.1.1 Evento Confirmação da Operação O evento de Confirmação da Operação pelo destinatário confirma a operação e o recebimento da mercadoria (para as operações com circulação de mercadoria). Quando houver devolução total ou parcial das mercadorias com a emissão de uma Nota Fiscal de devolução, é esse o evento que deve ser usado. Abaixo um exemplo de como ficaria um arquivo de Confirmação da Operação fictício: 8
2.1.2 Evento Ciência da Operação Através deste evento, o destinatário declara ter ciência sobre uma determinada operação destinada ao seu CNPJ. Abaixo um exemplo de como ficaria um arquivo de Ciência da Operação fictício: 2.1.3 Evento Desconhecimento da Operação O Destinatário usa o evento Desconhecimento da Operação para informar ao fisco que não reconhece uma determinada operação destinada ao seu CNPJ. Abaixo um exemplo de como ficaria um arquivo de Desconhecimento da Operação fictício: 2.1.4 Evento Operação Não Realizada Este evento permite ao destinatário registrar a declaração de Operação não Realizada para a operação, inclusive com um texto de informação complementar da 9
justificativa desta informação. Essa manifestação indica também que não foi emitida uma Nota Fiscal de devolução. Abaixo um exemplo de como ficaria um arquivo de Operação Não Realizada fictício: 2.2 Download de Arquivos por Destinatário O download do XML pelo destinatário só pode ser realizado para NF-e que possuam registro de "Ciência da Operação" e/ou "Confirmação da Operação". Neste caso o arquivo txt tem um layout deferente. O txt possui quatro linhas com as seguintes informações: Deve ser informado o caminho para salvar o XML da nota, como está grifado no exemplo abaixo: A primeira linha é o cabeçalho do arquivo e terá sempre o valor padrão igual a DOWNLOAD 1 ; A segunda linha possui os dados de versão e definição do evento do download com os seguintes valores: A + 1.00 + DOWNLOAD DE NFE A Terceira linha possui os dados de identificação da NFe que será feito o download, com os seguintes valores: B + ambiente + chave de acesso + caminho para salvar o XML 10
A quarta linha possui os dados do emitente da nota com os seguintes valores: C02 + CNPJ do emitente nota Abaixo um exemplo de como ficaria um arquivo de download: 2.3 Arquivo Consulta e Downloads de Documentos por Destinatário, Transportadora e Terceiros Agora também será permitido realizar a consulta das notas e realizar o Download de forma automática dos XMLs pela Transportadora ou por Terceiros. Leia o Manual: http:///site/_arquivos/_manuais/3/consultaedownloadsdfe.pdf 3 Padrão de Pastas (Diretórios) O MD-e contém uma série de pastas que são instaladas junto com o sistema, não podendo haver alteração em sua estrutura. 11
Cada pasta possui uma finalidade específica para o sistema conforme descrito abaixo: 3.1 Pasta Autorizadas Esta pasta contém os arquivos XML que o SEFAZ retorna para o sistema referente a cada manifesto autorizado e cancelado. Cada arquivo possui, no final de seus registros, as informações fornecidas pela SEFAZ referente ao recebimento e processamento das notas. 3.2 Pasta Processados Sempre que um arquivo de texto é lido dentro da pasta remessas o sistema move automaticamente o arquivo para dentro desta pasta. Nestes 12
arquivos é adicionado ao final de seus registros, uma linha contendo o registro RP que contém dados sobre o retorno de processamento da nota fornecido pela SEFAZ. Desta forma o sistema ERP da software House pode fazer a leitura do.txt retornado. Para mais informações sobre esses dados, verifica o capítulo de informações úteis. 3.3 Pasta Remessas Dentro desta pasta devem ser colocados os arquivos.txt consulta de documentos, ciência da operação, confirmação da operação, desconhecimento da operação, operação não realizada e download do xml, gerado pelo sistema ERP da software House. Estas pastas ficam localizadas no diretório raiz do sistema (C:\NSMDe). 4 Funcionalidades do NSMD-e 4.1 Processamento do MD-e no sistema O sistema realiza as funções de validação, assinatura e transmissão do manifesto e impressão do DACTE toda a vez que é executado e encontra um arquivo de notas na pasta remessas. Os passos necessários podem ser descritos então na seguinte ordem: Gerar o arquivo de manifesto dentro da pasta remessas Executar o MDe.exe 4.1.1 Retornos em caso de processo realizado com sucesso Em caso de sucesso no processo de transmissão do manifesto o sistema exibe na tela o DACTE para impressão. 13
4.1.2 Retornos em caso de erro ao realizar o processo Quando ocorrer algum erro durante o processo de transmissão do manifesto o sistema automaticamente encerra o processo e exibe em tela a mensagem informando o respectivo erro. O sistema aguarda que o usuário leia e confirme a mensagem. O sistema fica aberto aguardando que o erro seja resolvido e que o manifesto seja exportada para a pasta remessas novamente para recomeçar o processo. Visual Basic 6: Shell ( C:\NSMDe\MDe.exe 1 ) Java Process p = Runtime.getRuntime().exec("C:\\NSMDe\\MDe.exe 1"); Delphi WinExec ('C:\NSMDe\MDe.exe 1', 1); VB.NET Dim p as Process = new Process() p.startinfo.filename = C:\NSMDe\MDe.exe p.startinfo.arguments = "1" p.start(); p.waitforexit(); 5 Informações Úteis 5.1 Retorno de Processamento da Sefaz (XML) Os arquivos XML contidos dentro da pasta autorizados possuem algumas informações que são fornecidas pelo sistema da Sefaz. Este capítulo 14
descreve algumas dessas informações que podem ser de utilizadas pela Software House. 5.1.1 Motivos do Retorno Uma das informações mais úteis fornecidas pelo sistema da Sefaz é o motivo de retorno do manifesto. O campo que contém este valor é o campo <xmotivo>. Dentro dos motivos de retorno os mais comuns são: Autorizado Uso do MD-e: quando o manifesto é recebida pela Sefaz e a impressão do DACTE é autorizada; Rejeição: este motivo virá sempre seguido do motivo pelo qual o manifesto foi rejeitado. Exemplo: se o motivo for Rejeição: Duplicidade de MD-e, significa que o manifesto foi rejeitado, pois já estava no banco de dados da Sefaz quando foi enviada. Obs.: Sempre que ocorrer alguma rejeição o sistema mostrará uma mensagem informando que a nota foi rejeitada e o motivo do mesmo. 5.2 Retorno de Processamento da Sefaz (.txt) O Manifesto do Destinatário também guarda algumas informações de retorno da Sefaz nos arquivos de texto referentes aos manifestos processados. 5.2.1 Manifestos Os arquivos txt s dos manifestos contidos dentro da pasta processados possuem no final de seus registros, o registro RP que contém as seguinte informações de retorno: RP + protocolo de autorização + digest value + cod. Retorno + descrição do retorno + chave de acesso Cada campo é separado dentro do registro pelo carácter pipe ( ). Ex.: para o registro RP: 15
RP 143130002906104 135 Evento registrado e vinculado a NFe 43130507364617000135550000000011311000011311 2013-05-16T19:38:50-03:00 RP + Informação do Protocolo do Evento + Código do status da resposta + Descrição do status da resposta + Chave de Acesso do MD-e vinculada ao evento + Data e hora do processamento. 5.2.2 Download Os arquivos de download ficam armazenados dentro da pasta que você definir no seu txt, mas neste caso não grava no txt as informações de retorno de processamento. 5.2.3 Consulta de Notas Destinatário Neste caso gravará uma mensagem de retorno com as informações da nota consultada. Possui no final de seus registros, o registro RPN (Retorno de processamento de notas) que contém a seguintes informações de retorno: RPN + NSU da nota + chave de acesso + CPF ou CNPJ do emitente + Nome do emitente + Código da IE + data da emissão + tipo da operação + valor da nota + situação da nota + situação da manifestação + digest value + data da autorização Cada campo é separado dentro do registro pelo carácter pipe ( ). Exemplo de RPN: RPN 980808924 43140587958674000181558900050522071841282908 18063092000114 MAR CIO LUIS GARCIA 170124606 21/05/2014 1 252,00 1 0 rcrfa+la+6vebzaclhprnmlrhwq= 21/05/2014 11:39:27 16
No txt consulta de notas também vai registrar o RPF (retorno de processamento finalizado) que terá as informações de quantos retornos terá de RPN (RETORNO PROCESSAMENTO NOTAS), RPC (RETORNO PROCESSAMENTO CANCELAMENTOS) e RPE (RETORNO PROCESSAMENTO EVENTOS) Chamando o NSMD-e a partir do seu Sistema O MD-e pode ser integrado com qualquer sistema em ambiente Windows, independente da linguagem em que foi desenvolvido. Abaixo segue alguns exemplos de como chamar o executável do emissor diretamente pelo sistema ERP: Visual Basic 6: Shell ( C:\NSMDe\OperacoesMDe.exe ) Java Process p = Runtime.getRuntime().exec("C:\\NSMDe\\OperacoesMDe.exe"); Delphi WinExec ('C:\NSMDe\OperacoesMDe.exe', 1); VB.NET Dim p as Process = new Process() p.startinfo.filename = C:\NSMDe\MDe.exe p.start(); 17