Pular para conteúdo

Inutilização via Web Service

A inutilização é utilizada quando ocorre um pulo no sequencial de numeração dos documentos ou quando um documento é rejeitado e não se deseja corrigi-lo. Neste caso, é possível inutilizar essa numeração e emitir um novo documento com outro número.

O processo de inutilização pode ser realizado a qualquer momento, não havendo um prazo limite estipulado pela SEFAZ para realizar a inutilização de uma numeração. Além disso, é possível inutilizar tanto um único número quanto uma faixa de números em um único pedido de inutilização.

Neste artigo abordaremos o processo de envio para todos módulos em que este processo é disponibilizado, sendo eles NF-e e NFC-e.

Para realizar a inutilização de NFS-es via Web Service, é necessário atentar-se a algumas especificações. Mais informações podem ser obtidas através do artigo: Inutilização de NFS-e via Web Service.

Para realizar a inutilização de documentos via SOAP, é necessário estabelecer uma comunicação com o Web Service apropriado. Primeiramente, visualize a estrutura WSDL do mesmo:

Em seguida, será preciso realizar o consumo do Web Service para efetuar a integração.

Preencha o XML de envio com as informações necessárias para realizar a inutilização do documento. Em seguida, é realizada 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>7869d53918237b06c9e214cd3d8cba77</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>6c02d91fb081d4383ddcdb250f813aed</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.

Para facilitar o seu entendimento sobre o preenchimento dos campos, disponibilizamos um layout de inutilização no Github.

No retorno da requisição, o InvoiCy irá indicar o status atual da inutilização, juntamente do código de retorno "100" e a mensagem de retorno "Documentos processados".