Pular para conteúdo

Distribuição de Documentos Fiscais de Entrada na SEFAZ

A distribuição de documentos fiscais eletrônicos tem como finalidade permitir que os atores envolvidos em uma operação de NF-e, CT-e ou MDF-e tenham acesso aos documentos e informações resumidas que não tenham sido geradas por eles, mas que sejam de seu interesse.

Esses documentos ficam disponíveis para distribuição no Ambiente Nacional por até 3 meses após sua recepção original. Através desta consulta, é possível realizar o download do XML completo ou obter informações resumidas para fins de manifestação e escrituração.

Integração via Web Service:
Para realizar a consulta de NF-e, CT-e ou MDF-e via integração SOAP, deve-se estabelecer comunicação com o Web Service de recepção do InvoiCy. Utilize as URLs de WSDL abaixo conforme o ambiente desejado:

Em seguida, será preciso realizar o consumo do Web Service para efetuar a integração. Para mais detalhes sobre o processo, consulte o artigo disponível aqui.

Distribuição de NF-es de Entrada

Baseado na NT 2014.002, o serviço "NFeDistribuicaoDFe" permite a consulta de notas emitidas contra o CNPJ da empresa. A distribuição é autorizada para Emitentes, Destinatários, Transportadores e Terceiros autorizados no XML.

Parâmetros de Consulta (NSU e Chave de Acesso):
A busca pode ser realizada de 3 formas, controladas pelo campo UsarUltimoNSU:

  • UsarUltimoNSU = "S": Caso informe o campo UltimoNSU, a consulta iniciará a partir deste número. Se o campo UltimoNSU ficar vazio, o InvoiCy utilizará o NSU gravado automaticamente nas extensões de importação ou manifestação da empresa.
  • UsarUltimoNSU = "N": Preencha obrigatoriamente o campo NSUEspecifico com o número desejado.
  • Chave de acesso: Não preencha os campos de NSU. Informe apenas a tag chaAcesso e preencha com a chave de acesso do documento.

Distribuição de CT-es de Entrada

Regulamentado pela NT 2015.002, o serviço "CTeDistribuicaoDFe" disponibiliza documentos para Emitentes, Remetentes, Destinatários, Expedidores, Recebedores, Tomadores e Terceiros autorizados.

Regras de Consulta:
Assim como na NF-e, a integração utiliza o controle de NSU:

  • Consulta por lote: Informe UsarUltimoNSU como "S". Caso possua um ponto de partida específico, preencha o campo NSUEspecifico (ou UltimoNSU, conforme o layout).
  • Consulta por chave: Deixe os campos de NSU vazios e informe a chave de acesso do CT-e.

Distribuição de MDF-es de Entrada

De acordo com a NT 2015/002, que tem como objetivo apresentar um novo Web Service denominado "MDFeDistribuicaoDFe", que irá 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).

Os documentos fiscais estarão disponíveis para distribuição por até 3 meses após sua recepção pelo Ambiente Nacional do MDF-e. Os seguintes documentos serão disponibilizados para terceiros: MDF-e, Evento de Cancelamento, Evento de Encerramento e Evento de Inclusão de Ator.

Para o usuário não terá nenhum impacto na execução do processo, que continuará integrando com o Web Service de recepção do InvoiCy.

Estrutura de Envio e Comunicação

Para prosseguir com o processo de envio da requisição, preencha o XML de envio com as informações necessárias. Em seguida, realize a geração do hash MD5, conforme orientações do artigo de referência.

Além disso, o XML deve ser linearizado, convertido para texto e enviado dentro da tag <inv:Documento> na estrutura SOAP, conforme demonstrado a seguir:

<soapenv:Envelope xmlns:soapenv="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)" xmlns:inv="InvoiCy">
   <soapenv:Header/>
   <soapenv:Body>
      <inv:recepcao.Execute>
         <inv:Invoicyrecepcao>
            <inv:Cabecalho>
               <inv:EmpPK>ABCabcCBAcbaA+CabcCBAc==</inv:EmpPK>
               <inv:EmpCK>8e1f33a3a9c68d9a576d4ce8a7d339e3</inv:EmpCK>
               <inv:EmpCO></inv:EmpCO>
            </inv:Cabecalho>
            <inv:Informacoes>
               <inv:Texto></inv:Texto>
            </inv:Informacoes>
            <inv:Dados>
               <inv:DadosItem>
                  <inv:Documento><!-- (1) --></inv:Documento>
                  <inv:Parametros></inv:Parametros>
               </inv:DadosItem>
            </inv:Dados>
         </inv:Invoicyrecepcao>
      </inv:recepcao.Execute>
   </soapenv:Body>
</soapenv:Envelope>
  1. Neste campo, informe o XML de envio. Para visualizar um exemplo de envio, clique aqui.
<soapenv:Envelope xmlns:soapenv="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)" xmlns:inv="InvoiCy">
   <soapenv:Header/>
   <soapenv:Body>
      <inv:recepcao.Execute>
         <inv:Invoicyrecepcao>
            <inv:Cabecalho>
               <inv:EmpPK>ABCabcCBAcbaA+CabcCBAc==</inv:EmpPK>
               <inv:EmpCK>96e79218965eb72c92a549dd5a330112</inv:EmpCK>
               <inv:EmpCO></inv:EmpCO>
            </inv:Cabecalho>
            <inv:Informacoes>
               <inv:Texto></inv:Texto>
            </inv:Informacoes>
            <inv:Dados>
               <inv:DadosItem>
                  <inv:Documento><!-- (1) --></inv:Documento>
                  <inv:Parametros></inv:Parametros>
               </inv:DadosItem>
            </inv:Dados>
         </inv:Invoicyrecepcao>
      </inv:recepcao.Execute>
   </soapenv:Body>
</soapenv:Envelope>
  1. Neste campo, informe o XML de envio. Para visualizar um exemplo de envio, clique aqui.
<soapenv:Envelope xmlns:soapenv="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)" xmlns:inv="InvoiCy">
   <soapenv:Header/>
   <soapenv:Body>
      <inv:recepcao.Execute>
         <inv:Invoicyrecepcao>
            <inv:Cabecalho>
               <inv:EmpPK>ABCabcCBAcbaA+CabcCBAc==</inv:EmpPK>
               <inv:EmpCK>c4ca4238a0b923820dcc509a6f75849b</inv:EmpCK>
               <inv:EmpCO></inv:EmpCO>
            </inv:Cabecalho>
            <inv:Informacoes>
               <inv:Texto></inv:Texto>
            </inv:Informacoes>
            <inv:Dados>
               <inv:DadosItem>
                  <inv:Documento><!-- (1) --></inv:Documento>
                  <inv:Parametros></inv:Parametros>
               </inv:DadosItem>
            </inv:Dados>
         </inv:Invoicyrecepcao>
      </inv:recepcao.Execute>
   </soapenv:Body>
</soapenv:Envelope>
  1. Neste campo, informe o XML de envio. Para visualizar um exemplo de envio, clique aqui.

Acesse abaixo os layout de envio para entender melhor sobre a estrutura que dever ser gerada e preenchida para realizar a disponibilização de determinados documentos para os atores de cada módulo:

No retorno, será exibida uma lista com as notas de entrada de acordo com os parâmetros informados para a busca.