Páginas filhas
  • ER_MDFe_v3.00

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

 Este documento é material de especificação dos requisitos de manutenção, trata-se de conteúdo extremamente técnico.                                                             

 Informações Gerais

 

Especificação

Produto

TSS

Módulo

MDF-e

Segmento Executor

Serviços

Chamado

MSERV-3533 

País

( X ) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Objetivo

Demonstrar as implementações necessárias para atender a o Manual de Orientações do Contribuinte versão 3.00 do MDF-e. 

Esta nota técnica tem como objetivo a apresentação da nova versão do Web Service da SEFAZ denominado MDFeDistribuicaoDFe  versão 3.00 que disponibilizará para os atores do MDF-e informações e documentos fiscais eletrônicos de seu interesse.  
A distribuição será realizada para terceiros informados no conteúdo do MDF-e no grupo de pessoas autorizadas a acessar o XML (tag:autXML). 
Prazos para entrada em vigência da Nota Técnica: 
  • Ambiente de Homologação: 03/10/2016;
  • Ambiente de Produção: 12/12/2016;
  • Data final da vigência da versão 1.00: 05/06/2017;

Este Manual tem por objetivo a definição das especificações e critérios técnicos necessários para a integração entre os Portais das Secretarias de Fazendas das Unidades Federadas, Receita Federal do Brasil - RFB, Superintendência da Zona Franca de Manaus – SUFRAMA, e os sistemas das empresas emissoras do Manifesto Eletrônico de Documentos Fiscais – MDF-e. Prazos para entrada em vigência da Nota Técnica: 

  • Ambiente de Homologação:   
  • Ambiente de Produção:   
  • Data final da vigência da versão 1.00:   


Definição da Regra de Negócio

O MDF-e sofreu alteração em seu leiaute.

A versão 3.00 introduz novas validações do campo de Data de Emissão para o formato UTC completo com a informação do TimeZone, consulte o Manual de Orientações do Contribuinte, versão 3.00 de Outubro de 2016 para verificação das alterações do modelo 58. É imprescindível a leitura completa deste manual para entendimento das alterações pertinentes à versão 3.00.

Web Services e Métodos TSS

Serão utilizados os métodos dos Web Services abaixo:

 

Web Service SPEDCFGNFESOAP

  •  Método CFGMDFE

 

 Método de configuração dos parâmetros do Manifesto Eletrônico de Documentos Fiscais (MDF-e)

Os parâmetros de entrada do método são: 

Parâmetros de entrada:

<soap:Body>

<USERTOKEN>STRING</USERTOKEN>

  <ID_ENT>STRING</ID_ENT>

  <AMBIENTEMDFE>INTEGER</AMBIENTEMDFE>

  <VERSAOMDFE>STRING</VERSAOMDFE>

  <MODALIDADEMDFE>INTEGER</MODALIDADEMDFE>

  <VERMDFELAYOUT>STRING</VERMDFELAYOUT>

  <VERMDFELAYEVEN>STRING</VERMDFELAYEVEN>

  <SEQLOTEMDFE>INTEGER</SEQLOTEMDFE>

  <HORAVERAOMDFE>STRING</HORAVERAOMDFE>

  < HORARIOMDFE >STRING</ HORARIOMDFE >

</soap:Body>

 

Parâmetro

Tipo

Tam.

Ocor.

Descrição

 CFGMDFE - - 1-1 Tag raiz.

USERTOKEN

Alfanumérico

6

1-1

Token de bilhetagem para execução do   serviço TOTVS.

ID_ENT

Alfanumérico

6

1-1

Código da entidade.

AMBIENTEMDFE

Inteiro

1

1-1

Identificação do Ambiente do MDF-e:

 1-Produção ou 2-Homologação.

VERSAOMDFE

Alfanumérico

1-4

1-1

Versão do Layout do MDF-e :

1.00 - 3.00

MODALIDADEMDFE

Inteiro

1

1-1

Modalidade de Transmissão do MDF-e:

1-Normal ou 2-Contingência

VERMDFELAYOUT

Alfanumérico

1-4

1-1

Versão do leiaute específico do evento:

1.00 - 3.00

VERMDFELAYEVEN

Alfanumérico

1-4

1-1

Versão do leiaute geral do evento:

1.00 - 3.00

SEQLOTEMDFE

Inteiro

--

0-1

Número sequencial do lote do MDF-e

HORAVERAOMDFE

Alfanumérico

1

1-1

Identificação de Horário de Verão:

1-Sim ou 2-Não

HORARIOMDFE

Alfanumérico

1

1-1

Identificação do Horário:

1-Fernando de Noronha; 2-Brasília ;3-Manaus e 4-Acre

 

Os parâmetros de saída do método são:

 

<soap:Body>

 <CFGMDFERESULT>

  <AMBIENTEMDFE>STRING</AMBIENTEMDFE>

  <MODALIDADEMDFE>STRING</MODALIDADEMDFE>

  < HORARIOMDFE >STRING</ HORARIOMDFE >

  <HORAVERAOMDFE>STRING</HORAVERAOMDFE>

  <SEQLOTEMDFE>INTEGER</SEQLOTEMDFE>

  <VERMDFELAYEVEN>STRING</VERMDFELAYEVEN>

  <VERMDFELAYOUT>STRING</VERMDFELAYOUT>

  <VERSAOMDFE>STRING</VERSAOMDFE>

 </CFGMDFERESULT>

</soap:Body>                                            


Parâmetro

PAI

Tam.

Tipo

Ocor. 

Descrição

 CFGMDFERESULT     

AMBIENTEMDFE

CFGMDFERESULT

-

A

 1-1

Identificação do Ambiente:

1-Produção ou 2-Homologação.

HORARIOMDFE

CFGMDFERESULT

-

A

 1-1

Horário inválido. Valores válidos:
  1-Fernando de Noronha, 2-Brasilia, 3-Manaus e 4-Acre

HORAVERAOMDFE

CFGMDFERESULT

 

 A

 1-1

Horário de verão inválido. Valores válidos:
  1-Sim e 2-Não

MODALIDADEMDFE

CFGMDFERESULT

-

 A

 1-1

Identificação do Ambiente do MDF-e:

1-Produção ou 2-Homologação.

SEQLOTEMDFE

CFGMDFERESULT

-

I

 1-1

Número sequencial do lote do MDF-e

VERMDFELAYEVEN

CFGMDFERESULT

1-4

A

 1-1

Versão do leiaute geral do evento:

1.00 - 3.00

VERMDFELAYOUT

CFGMDFERESULT

1-4

A

 1-1

Versão do leiaute específico do evento:

1.00 - 3.00

VERSAOMDFE

CFGMDFERESULT

1-4

A

 1-1

Versão do Layout do MDF-e :

1.00 - 3.00

 

Soap Fault

Fault

Descrição

Invalid Token

O parâmetro “USERTOKEN” foi passado incorretamente.

1

Código da entidade inválida.

2

Código da entidade em branco.

3

Código do ambiente inválido. Valores válidos: 0-Configuração,1-Produção e 2-Homologação.

4

Versão do MDF-e inválida.

5

Modalidade inválida para MDF-e. Valores válidos: 0-Configuração,1-Normal,2-Contingência.

6

Versão do leiaute especifico do evento inválida.

7

Versão do leiaute geral dos eventos inválida.

8

Horário de verão   inválido. Valores válidos: 1-Sim e 2-Não

9

Horário inválido. Valores válidos: 1-Fernando de Noronha, 2-Brasilia, 3-Manaus e 4-Acre

 

Web Service NFESBRA

 

  • Método REMESSA

 

Método destinado à remessa de documentos fiscais eletrônicos. Este método recebe o XML do documento e assegura a transmissão para a SEFAZ.

 

Os parâmetros de entrada do método são:

 

<soap:Body>
   <USERTOKEN>STRING</USERTOKEN>
   <ID_ENT>STRING</ID_ENT>
   <NFE>
      <NOTAS>
         <NFES>
            <ID>STRING</ID>
            <XML>BASE64BINARY</XML>
         </NFES>

         <NFES>

            <ID>STRING</ID>

            <XML>BASE64BINARY</XML>

         </NFES>

      </NOTAS>
   </NFE>

Definição da Regra de Negócio

Serão utilizados os métodos do Web Service MANIFESTACAODESTINATARIO.

Através do método SINCRONIZARDOCUMENTOS será possível sincronizar os seguintes documentos fiscais eletrônicos emitidos para a entidade solicitada, desde que esteja autorizado a acessar o XML (tag autXML MDFe): 

  • MDF-e;
  • Evento de Cancelamento do MDF-e;
  • Evento de Encerramento do MDF-e;
  • Evento de Inclusão de Condutor do MDF-e.

 

Para identificar que a sincronização se refere ao MDF-e (modelo 58), foi criado o parâmetro MODELO neste método.

O parâmetro MODELO será disponibilizado também através do método CONFIGURARPARAMETROS, a fim de diferenciar as configurações de ambiente e versão para a Manifestação do Destinatário (MD-e, modelo 55) e Manifesto Eletrônico de Documentos Fiscais (MDF-e, modelo 58).

Através dos métodos MONITORARDOCUMENTOS e RETORNARDOCUMENTO serão disponibilizadas informações relacionadas ao MDF-e e seus eventos já sincronizados.

 

Web Service MANIFESTACAODESTINATARIO

  • Método CONFIGURARPARAMETROS

Configura e retorna os parâmetros para a manifestação do destinatário.

 

Os parâmetros de entrada do método são:

<soap:Body>

  <USERTOKEN>STRING</USERTOKEN>

  <ID_ENT>STRING</ID_ENT>

  <AMBIENTE>STRING</AMBIENTE>

  <VERSAO>STRING</VERSAO>

  <ULTNSU>STRING</ULTNSU>

  <MODELO>STRING</MODELO>

</soap:Body>

 

NomePaiTipoTam.Ocor.Observações
CONFIGURARPARAMETROS
---1-1Tag raiz.
USERTOKENCONFIGURARPARAMETROSA51-1Deverá ser preenchido com o valor “TOTVS”.
ID_ENTCONFIGURARPARAMETROSA61-1ID da entidade a ser utilizada.
AMBIENTECONFIGURARPARAMETROSA10-1

Ambiente utilizado na sincronização de documentos.

 Os valores possíveis são:

1 – Produção;

2 –Homologação.

VERSAOCONFIGURARPARAMETROSA40-1

Versão utilizada na sincronização de documentos.

 Os valores possíveis são:

1.00 - NF-e / MDF-e

ULTNSUCONFIGURARPARAMETROSA150-1

Ultimo NSU da sincronização de documentos.

MODELOCONFIGURARPARAMETROSA20-1

Modelo de documento utilizado na sincronização do documento.

Os valores possíveis são:

55- NF-e;

58 – MDF-e.
 

Caso não seja informado, será utilizado o valor “55” como padrão, realizando assim a configuração da Manifestação do Destinatário – MD-e.

 

Os parâmetros de saída do método são:

 

<soap:Body>

  <USERTOKEN>STRING</USERTOKEN>

  <ID_ENT>STRING</ID_ENT>

  <AMBIENTE>STRING</AMBIENTE>

  <VERSAO>STRING</VERSAO>

  <ULTNSU>STRING</ULTNSU>

  <MODELO>STRING</MODELO>

</soap:Body>

 

NomePaiTipoTam.Ocor.Observações
CONFIGURARPARAMETROSRESULT---1-1Tag raiz.
AMBIENTECONFIGURARPARAMETROSRESULTA11-1

Ambiente utilizado na sincronização de documentos.

 Os valores possíveis são:

1 – Produção;

2 – Homologação.
ID_ENTCONFIGURARPARAMETROSRESULTA61-1ID da entidade a ser utilizada.
VERSAOCONFIGURARPARAMETROSRESULTA41-1Versão utilizada na sincronização de documentos.
ULTNSUCONFIGURARPARAMETROSRESULTA150-1Ultimo NSU da sincronização de documentos
MODELOCONFIGURARPARAMETROSRESULTA20-1

Modelo de documento configurado utilizado na sincronização do documento

58 – MDF-e.

55 - NF-e.

 

Soap Fault

FaultObservações
Invalid TokenO parâmetro USERTOKEN foi passado incorretamente.
001Código de entidade inválido.
002Código de entidade em branco.
003Falha no processamento do método.

 

  • Método SINCRONIZARDOCUMENTOS

Sincroniza junto com a Sefaz a base de dados do TSSS através de documentos que tenham como destinatário a entidade solicitada.

 

Os parâmetros de entrada do método são:

 

<soap:Body>
 <USERTOKEN>STRING</USERTOKEN>
 <ID_ENT>STRING</ID_ENT>
 <INDNFE>STRING</INDNFE>
 <INDEMI>STRING</INDEMI>
 <MODELO>STRING</MODELO> 
</soap:Body>

 

Nome
Pai
Tipo
Tam.
Ocor.
Observações
SINCRONIZARDOCUMENTOS---1-1Tag raiz.
USERTOKENSINCRONIZARDOCUMENTOSA51-1Deverá ser preenchido com o valor “TOTVS”.
ID_ENTSINCRONIZARDOCUMENTOSA61-1ID da entidade a ser utilizada.
INDNFESINCRONIZARDOCUMENTOSA10-1

Indicação para quais NF-e sincronizar.

Os valores possíveis são:

0 – Todas as NF-e;

1 – Somente as NF-e que ainda não tiveram manifestação do destinatário;

2 – Idem opção 1 incluindo também as NF-e que não tiveram Ciência da Operação declarada.

Caso não seja informado, será utilizado o valor “0” como padrão.

Para modelo 58, parâmetro será desconsiderado.
INDEMISINCRONIZARDOCUMENTOSA10-1

Indicação para quais emitentes buscar as NF-e para sincronizar.

Os valores possíveis são:

0 – Todos os emitentes;

1 – Apenas emitentes aonde a raiz do CNPJ seja diferente do destinatário (evitando transferências entre filiais).

Caso não seja informado, será utilizado o valor “0” como padrão.

Para modelo 58, parâmetro será desconsiderado
MODELOSINCRONIZARDOCUMENTOSA20-1

Modelo de documento a ser sincronizado.

58 – MDF-e.

55- NF-e.

Caso não seja informado, será utilizado o valor “55” como padrão, realizando assim a sincronização da Manifestação do Destinatário – MD-e.

 

Os parâmetros de saída do método são:

 

<SINCRONIZARDOCUMENTOSRESULT>

 <AMBIENTE>STRING</AMBIENTE>

 <DOCUMENTOS>

      <SINCDOCUMENTOSINFO>

            <CANCNSU>STRING</CANCNSU>

            <CHAVE>STRING</CHAVE>

            </SITCONF>STRING</SITCONF>

       </SINCDOCUMENTOSINFO>

      <SINCDOCUMENTOSINFO>

            <CANCNSU>STRING</CANCNSU>

            <CHAVE>STRING</CHAVE>

            </SITCONF>STRING</SITCONF>

       </SINCDOCUMENTOSINFO>

  </DOCUMENTOS>

 <IDENT>STRING</IDENT>

 <INDCONT>STRING</INDCONT>

</SINCRONIZARDOCUMENTOSRESULT>

 

Nome
Pai
Tipo
Tam.
Ocor.
Observações
SINCRONIZARDOCUMENTOSRESULT---1-1Tag raiz
AMBIENTESINCRONIZARDOCUMENTOSRESULTA21-1

Identificação do Ambiente consultado:

1 - Produção;

2 - Homologação
DOCUMENTOSSINCRONIZARDOCUMENTOSRESULT--0-1Tag raiz para os documentos sincronizados.
SINCDOCUMENTOSINFODOCUMENTOS--0-NTag raíz para as informações de um documento sincronizado
CANCNSUSINCDOCUMENTOSINFOA150-1NSU de cancelamento.
CHAVESINCDOCUMENTOSINFOA441-1Chave de acesso do documento sincronizado.
SITCONFSINCDOCUMENTOSINFOA11-1

Código da situação da confirmação da manifestação do documento.

Os valores possíveis são:

0 – Sem manifestação do destinatário;

1 – Confirmada operação;

2 – Desconhecida;

 3 – Operação não realizada;

4 – Ciência.

Para modelo 58, parâmetro sempre retornará 0
CODEVENTOSINCDOCUMENTOSINFOA61-1Tipo do Evento.
IDENTSINCRONIZARDOCUMENTOSRESULTA61-1ID da Entidade utilizada.
INDCONTSINCRONIZARDOCUMENTOSRESULTA1-40-1

Indicador de continuação:

0 - SEFAZ não possui mais documentos para o CNPJ informado;

1 - SEFAZ possui mais documentos para o CNPJ informado, ou ainda não avaliou a totalidade da sua base de dados.

 

Soap Fault

FaultObservações
Invalid TokenO parâmetro USERTOKEN foi passado incorretamente.
001Código de entidade inválido.
002Código de entidade em branco.
003Falha no processamento do método.

 

  • Método RETORNARDOCUMENTO

Retorna todas as informações sobre um documento sincronizado anteriormente.

 

Os parâmetros de entrada do método são:

 

<soap:Body>

 <USERTOKEN>STRING</USERTOKEN>

 <IDENT>STRING</IDENT>

 <AMBIENTE>STRING</AMBIENTE>

 <CHAVE>STRING</CHAVE>

</soap:Body>

 

NomePaiTipoTam.Ocor.Observações
RETORNARDOCUMENTO---1-1Tag raiz.
USERTOKENRETORNARDOCUMENTOA51-1Deverá ser preenchido com o valor “TOTVS”.
ID_ENTRETORNARDOCUMENTOA61-1ID da entidade a ser utilizada.
AMBIENTERETORNARDOCUMENTOA10-1

Ambiente a ser pesquisado.

Os valores possíveis são:

1 – Produção;

2 – Homologação.
CHAVERETORNARDOCUMENTOA441-1Chave do Documento a ser retornado.

 

Os parâmetros de saída do método são:

 

<soap:Body>

 <ID_ENT>STRING</ID_ENT>

 <AMBIENTE>STRING</AMBIENTE>

  <DOCUMENTO>

      <CANCELAMENTO>

         <CANCNSU>STRING</CANCNSU>

         <CANCXMLRET>BASE64BINARY</CANCXMLRET>

         <DATAAUTORIZACAO>STRING</DATAAUTORIZACAO>

         <DATAEMISSAO>STRING</DATAEMISSAO>

      </CANCELAMENTO>

      <CCE>

         <CCENSU>STRING</CCENSU>

         <CCEXMLRET>BASE64BINARY</CCEXMLRET>

         <CORRECAO>STRING</CORRECAO>

         <DATAAUTORIZACAO>STRING</DATAAUTORIZACAO>

         <DATAEMISSAO>STRING</DATAEMISSAO>

         <HORAEMISSAO>STRING</HORAEMISSAO>

         <TZD>STRING</TZD>

      </CCE>

      <CHAVE>STRING</CHAVE>

      <CONDUTOR>

          <CONDNSU>STRING</CONDNSU>

          <CONDXMLRET>BASE64BINARY</CONDXMLRET>

          <CPF>STRING</CPF>

          <DTHRAUTORIZACAO>STRING</DTHRAUTORIZACAO>

          <DTHREMISSAO>STRING</DTHREMISSAO>

          <NOME>STRING</NOME>

      </CONDUTOR>

       <DATAAUTORIZACAO>STRING</DATAAUTORIZACAO>

       <DATAEMISSAO>STRING</DATAEMISSAO>

       <EMITENTE>

           <CNPJ>STRING</CNPJ>

           <CPF>STRING</CPF>

           <IE>STRING</IE>

           <NOME>STRING</NOME>

        </EMITENTE>

        <ENCERRAMENTO>

           <ENCNSU>STRING</ENCNSU>

           <ENCXMLRET>BASE64BINARY</ENCXMLRET>

           <CODIGOIBGE>STRING</CODIGOIBGE>

           <DTHRAUTORIZACAO>STRING</DTHRAUTORIZACAO>

           <DTHREMISSAO>STRING</DTHREMISSAO>

           <ENCDTENC>STRING</ENCDTENC>

        </ENCERRAMENTO>

        <NSU>STRING</NSU>

        <RESPOSTA>

            <DESCRICAO>STRING</DESCRICAO>

            <STATUS>STRING</STATUS>

        </RESPOSTA>

        <SITUACAO>STRING</SITUACAO>

        <SITUACAOCONFIRMACAO>STRING</SITUACAOCONFIRMACAO>

        <TIPOOPERACAO>STRING</TIPOOPERACAO>

        <VALORTOTAL>FLOAT</VALORTOTAL>

        <XMLSEFAZ>BASE64BINARY</XMLSEFAZ>

  </DOCUMENTO>
</soap:Body>

 

RETORNARDOCUMENTORESULTRETORNARDOCUMENTORESULTRETORNARDOCUMENTORESULT0
Nome
Pai
Tipo
Tam.
Ocor.
Observações
REMESSA---1-1Tag raiz.
USERTOKENRETORNARDOCUMENTORESULTREMESSAA51-1Deverá ser preenchido com o valor “TOTVS”.
ID_ENTREMESSAA61-1ID da entidade a ser utilizada.AMBIENTE 61-1ID da entidade a ser utilizada.
NFEREMESSA---Estrutura
NOTASNFE--

-

Estrutura
NFESNOTAS---Estrutura
IDNFESA1-2501-1

Ambiente a ser pesquisado.

Os valores possíveis são:

1 – Produção;

2 – Homologação.
DOCUMENTORETORNARDOCUMENTORESULT--0-1Tag raiz para as informações do documento pesquisado.
CANCELAMENTODOCUMENTO--0-1Tag raiz para as informações de cancelamento do documento.
CANCNSUCANCELAMENTOA150-1NSU do cancelamento.
CANCXMLRETCANCELAMENTOBASE64BINARY-0-1XML de retorno da SEFAZ apenas para o cancelamento.
DATAUTORIZACAOCANCELAMENTOA100-1

Data de autorização do cancelamento.

Formato – AAAA-MM-DD

DATAEMISSAOCANCELAMENTOA100-1

Data de emissão do cancelamento.

Formato – AAAA-MM-DD

CCEDOCUMENTO--0-1Tag raiz para as informações da carta de correção eletrônica do documento.
CCENSUCCEA150-1NSU da carta de correção eletrônica.
CCEXMLRETCCEBASE64BINARY-0-1XML de retorno da SEFAZ apenas para a CC-e.
CORRECAOCCEA10000-1Correção da CC-e.
DATAAUTORIZACAOCCEA100-1

Data da autorização da CC-e.

Formato – AAAA-MM-DD

DATAEMISSAOCCEA100-1

Data de emissão da CC-e.

Formato – AAAA-MM-DD

HORAEMISSAOCCEA80-1

Horário de emissão da CC-e.

Formato – HH:MM:SS

TZDCCEA60-1TZD do horário de emissão da CC-e.
CHAVEDOCUMENTOA440-1Chave do documento.
CONDUTORDOCUMENTO--0-1

Tag raiz para as informações do último evento de inclusão de condutor (MDF-e).

IMPORTANTE:

As informações serão retornadas com base no último evento de inclusão de condutor autorizado.
CONDNSUCONDUTORA150-1NSU do evento de inclusão de condutor.
CONDXMLRETCONDUTORBASE64BINARY-0-1XML de retorno da SEFAZ apenas para a Inclusão de Condutor
CPFCONDUTORA110-1CPF do condutor do veículo.
DTHRAUTORIZACAOCONDUTORA190-1

Data e hora da autorização do evento de Inclusão de Condutor.

 Formato – AAAA-MM-DDTHH:MM:SS

DTHREMISSAOCONDUTORA190-1

Data e hora da emissão do evento de Inclusão de Condutor.

 Formato – AAAA-MM-DDTHH:MM:SS

NOMECONDUTORA600-1Nome do condutor do veículo.
DATAAUTORIZACAODOCUMENTOA100-1

Data de autorização do documento.

Formato – AAAA-MM-DD

DATAEMISSAODOCUMENTOA100-1

Data de emissão do documento.

Formato – AAAA-MM-DD

EMITENTEDOCUMENTO--0-1Tag raiz para as informações do emitente do documento.
CNPJEMITENTEA140-1CNPJ do emitente do documento.
CPFEMITENTEA110-1CPF do emitente do documento.
IEEMITENTEA140-1Inscrição Estadual do emitente do documento.
NOMEEMITENTEA600-1Nome / Razão Social do emitente do documento.
ENCERRAMENTODOCUMENTO--0-1Tag raiz para as informações do evento de encerramento (MDF-e).
ENCNSUENCERRAMENTOA150-1NSU do evento de encerramento.
ENCXMLRETENCERRAMENTOBASE64BINARY-0-1XML de retorno da SEFAZ apenas para o encerramento.
CODIGOIBGEENCERRAMENTOA70-1Código do município onde ocorreu o encerramento.
DTHRAUTORIZACAOENCERRAMENTOA190-1

Data e hora da autorização do evento de encerramento.

Formato – AAAA-MM-DDTHH:MM:SS

DTHREMISSAOENCERRAMENTOA190-1

Data e hora da emissão do evento de encerramento.

 Formato – AAAA-MM-DDTHH:MM:SS

ENCDTENCENCERRAMENTOA100-1

Data em que o MDF-e foi encerrado.

 Formato – AAAA-MM-DD

NSUDOCUMENTOA150-1NSU do documento.
RESPOSTADOCUMENTO--0-1Tag raiz para as informações de resposta da SEFAZ no momento da sincronização do documento.
DESCRICAORESPOSTAA2550-1Descrição do status de resposta da SEFAZ.
STATUSRESPOSTAA30-1Código de status de resposta da SEFAZ.
SITUACAODOCUMENTOA10-1

Código de situação do documento.

Os valores possíveis são:

1 – Uso autorizado no momento da consulta;

 2 – Uso denegado (Para NF-e);

 3 – NF-e/MDF-e cancelada;

4- MDF-e Encerrado.

SITUACAOCONFIRMACAODOCUMENTOA10-1

Código da situação da confirmação da manifestação do destinatário.

Os valores possíveis são:

 0 – Sem manifestação do destinatário;

1 – Confirmada operação;

2 – Desconhecida;

3 – Operação não realizada;

4 – Ciência.

 

Para modelo 58, parâmetro sempre retornará 0.
TIPOOPERACAODOCUMENTOA10-1

Tipo da operação do documento.

 Os valores possíveis são:

0 – Entrada;

1 – Saída.

Para modelo 58, parâmetro sempre retornará 1.

VALORTOTALDOCUMENTON15,20-1Valor total do documento.
XMLSEFAZDOCUMENTOBASE64BINARY-0-1XML de retorno da SEFAZ apenas para o documento.
Id de identificação do XML da XML da NF-e, CT-e e MDF-e com o ERP. Este número será sempre informado ou solicitado pelo TOTVS Service Soa para fornecer informações sobre o status atual da NF-e, CT-e e MDF-e. É recomendado para o ERP enviar o número da chave de acesso da NF-e, CTe e MDF-e, caso utilize uma base de dados 100% volátil.
XMLNFESBASE64BINARY 1-1

NF-e:  Leiaute TSS ou padrão SEFAZ.

CT-e: Leiaute SEFAZ.

MDF-e: Leiaute SEFAZ.

MAILNFESA-0-1

Informe e-mails para que seja enviado o documento quando for autorizado/cancelado.

Caso este campo seja preenchido, o e-mail enviado no XML do documento será desconsiderado.

Os e-mails devem ser separados por ponto e vírgula(;).

Exemplo de preenchimento:

[email protected];ciclano@totvs.com.br

 

Os parâmetros de saída do método são: 

<soap:Body>
  <NFEOK>
     <ID>
      <STRING>STRING</STRING>
     </ID>
   </NFEOK>
</soap:Body>

 

Nome
Pai
Tipo
Tam.
Ocor.
Observações
NFeOk-Estrutura-- 
IDNFeOkMatriz[0,n]0060-1Matriz com as identificações das NF-es, CT-es e MDF-es que foram aceitas pelo Totvs Service Soa. O serviço somente aceita remessas duplicadas de NF-e, CT-e e MDF-e , em caso de erro na transmissão devido ao preenchimento errado dos dados do XML ou antes de realizar a transmissão. 
CSTRINGNFeOkA1-2500-1Identificação da NF-e, CT-e e MDF-e que foram aceitas pelo serviço.

 

  • Método REMESSAEVENTO

 

Método destinado ao envio em lote dos novos eventos da Nota Fiscal Eletrônica – NF-e, Manifestação Eletrônico de Documentos Fiscais – MDF-e e Conhecimento de Transporte Eletrônico – CT-e. Os eventos são recebidos em lote, porém, são tratados e enviados a SEFAZ individualmente.

 

Os parâmetros de entrada do método são:

 <soap:Body>

   <USERTOKEN>STRING</USERTOKEN>
   <ID_ENT>STRING</ID_ENT>
   <XML_LOTE>BINÁRIO</XML_LOTE>
</soap:Body>

 

Nome
Pai
Tipo
Tam.
Ocor.
Observações

REMESSAEVENTO

-

-

-

-

Tag raiz da requisição

USERTOKEN

-

A

5

1-1

Deverá ser preenchido com o valor “TOTVS”.

ID_ENT

-

A

6

1-1

ID da entidade a ser utilizada.

XML_LOTE

-

 

1-500K

1-1

XML do Lote de envio dos eventos, este XML será definido conforme o Layout de cada evento

 

 

Para o envio dos eventos, foi disponibilizado um leiaute padrão atender a todos os eventos disponibilizados para a NFe,tendo como diferencial para cada evento,apenas a tag detEvento, que deverá conter os elementos de acordo com evento a ser enviado.O Xml deverá respeitar a seguinte estrutura:

Nome
Pai
Tipo
Tam.
Ocor.
Observações

envEvento

-

-

-

1-1

Tag raiz

Eventos

envEvento

G

-

1-1

Evento

detEvento

Eventos

G

-

1-N

Informações do Evento (estrutura XML variável, depende do tipo de evento)

 

Eventos modelo 58 – MDF-e

 

Tipo de Evento
Modelo de MDFe
Descrição Evento
Tipo de Autor do Evento
Local Evento
 110111 58Evento de Cancelamento do MDF-e.  Emitente Sefaz Autorizadora
110112 58 Evento de Encerramento do MDF-e. Emitente Sefaz Autorizadora
110114 58Evento de Inclusão de Condutor do MDF-e.EmitenteSefaz Autorizadora

 

  • detEvento – Cancelamento MDF-e

Campo

Ele

Pai

Tipo

Ocor

Tam.

Dec.

Descrição

detEvento

G

-

E

1-N

-

-

Informações do   Evento (estrutura XML variável, depende do tipo de evento)

tpEvento

E

CC03

Num

1-1

06

-

Tipo de Evento

Informar : 110111

chNFe

E

CC03

Num

1-1

44

-

Chave de Acesso do MDF-e.

ambiente

E

CC03

Num

1-1

01

-

Informar o ambiete de emissão do MDF-e

xJust

E

CC03

Alfa

1-1

15-255

-

Informar a justificativa do cancelamento.


Modelo XML do Evento de Cancelamento – MDF-e

 
<envEvento>
<eventos>
<detEvento>
<tpEvento>110111</tpEvento>
<chnfe>1234567891234567891234567891234567891234567</chnfe>
<ambiente>2</ambiente>
<xJust>Informe aqui a justificativa de cancelamento.</xJust>
</detEvento>
</eventos>
</envEvento>

 

  • detEvento – Evento de Encerramento  MDF-e

Campo

Ele

Pai

Tipo

Ocor

Tam.

Dec.

Descrição

detEvento

G

-

E

1-N

-

-

Informações do   Evento (estrutura XML variável, depende do tipo de evento)

tpEvento

E

CC03

Num

1-1

06

-

Tipo de Evento

Informar : 110112

chNFe

E

CC03

Num

1-1

44

-

Chave de Acesso do MDF-e.

ambiente

E

CC03

Num

1-1

01

-

Informar o ambiete de emissão do MDF-e

dtEnc

E

CC03

Date

1-1

10

-

Data do encerramento do MDF-e.

cUF

E

CC03

String

1

02

-

Sigla da UF.

cMun

E

CC03

Num

1

07

-

Código do município.



 

Modelo XML do Evento de Encerramento – MDF-e

 

<envEvento>
<eventos>
<detEvento>
<tpEvento>110112</tpEvento>
<chnfe>1234567891234567891234567891234567891234567</chnfe>
<ambiente>2</ambiente>
<dtEnc>AAAA-MM-DD</dtEnc>
<cUF>SP</cUF> - Informar a Sigla da UF
<cMun>3550308</cMun> - Código de Município do IBGE
</detEvento>
</eventos>
</envEvento>

 

  • detEvento – Inclusão de Condutor

Campo

Ele

Pai

Tipo

Ocor 

Tam.

Dec.

detEvento

 G

-

E

 -

-

Informações do Evento (estrutura XML variável, depende do tipo de evento)

tpEvento

 A

CC03

Num

 1-1

6

Tipo de Evento

Informar : 110114

chNFe

 N

CC03

Num

 1-1

44

Chave de Acesso do MDF-e.

ambiente

 E

CC03

Num

 1-1

1

Ambiente de Transmissão:

1 – Homologação;2 - Produção

nomecondutor

 A

CC03

Alfa

 1-1

1-60

Nome do Condutor

cpfcondutor

 A

CC03

Num

 1-1

1-11

CPF do Condutor

 
 

Exemplo de  XML o evento Inclusão de Condutor

<envEvento>

<eventos>

<detEvento>

<tpEvento>110114</tpEvento>

<chnfe></chnfe>

<ambiente></ambiente>

<nomecondutor></nomecondutor>

<cpfcondutor></cpfcondutor>

</detEvento>

<detEvento>

<tpEvento>110114</tpEvento>

<chnfe></chnfe>

<ambiente></ambiente>

<nomecondutor></nomecondutor>

<cpfcondutor></cpfcondutor>

</detEvento>

</eventos>

</envEvento>

 

 

Dicionário de Dados

TABELA SPED156 - MANIFESTAÇÃO DO DESTINATÁRIO.

  

Campo

ENCDTHREMI

Tipo

C

Tamanho

25

Descrição

Data e hora de emissão do evento de encerramento.

Campo

ENCDTHRAUT

Tipo

C

Tamanho

25

Descrição

Data e hora de autorização do evento de encerramento.

Campo

ENCNSU

Tipo

C

Tamanho

15

Descrição

NSU do encerramento.

Campo

ENCXMLRET

Tipo

M

Tamanho

10

Descrição

XML do encerramento.

Campo

ENCCODMUN

Tipo

C

Tamanho

7

Descrição

Código do município do IBGE onde ocorreu o encerramento.

Campo

ENCDTENC

Tipo

C

Tamanho

10

Descrição

Data em que o MDF-e foi encerrado.

Campo

CONDTHREMI

Tipo

C

Tamanho

25

Descrição

Data e hora de emissão do evento de inclusão de condutor.

Campo

CONDTHRAUT

Tipo

C

Tamanho

25

Descrição

Data e hora de autorização do evento de inclusão de condutor.

Campo

CONDNSU

Tipo

C

Tamanho

15

Descrição

NSU da inclusão de condutor.

Campo

CONDCPF

Tipo

C

Tamanho

11

Descrição

CPF do condutor do veículo.

Campo

CONDNOME

Tipo

C

Tamanho

60

Descrição

Nome do condutor do veículo.

Campo

CONDXMLRET

Tipo

M

Tamanho

10

Descrição

XML da inclusão de condutor.

Campo

MODELO

Tipo

C

Tamanho

2

Descrição

Modelo do documento sincronizado.

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.