Pular para conteúdo

Inutilização de NFS-e via Web Service

A plataforma possibilita que as empresas que possuem NFS-es com o status final "Rejeitado", realizem a inutilização das mesmas através do Web Service de recepção do InvoiCy. Permitindo inutilizar determinada numeração de RPS, em virtude dos pulos no sequencial de numeração de um documento, ou quando um documento é rejeitado e não se deseja corrigi-lo.

Este processo de inutilização de documentos, só poderá ser utilizado por padrões que não exigem a sequência de numeração do RPS, ou seja, caso o padrão em questão tenha RPS sequencial, a inutilização será inviabilizada.

Destacando que hoje apenas o município de Caxias do Sul (RS) possui serviço de inutilização, então para os demais municípios as NFS-es serão inutilizadas apenas no InvoiCy, e não na prefeitura.

Para realizar o processo de inutilização de documentos para a NFS-e 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/" 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.

No retorno do serviço de inutilização, será exibido apenas uma NFS-e inutilizada, ou mais de uma NFS-e inutilizada em uma única requisição - caso tenha sido inutilizada uma faixa de documentos.

O seu sistema deve ler o retorno, validando as informações conforme o layout de retorno. Este retorno criará um grupo para cada NFS-e, contendo o número, série, situação, entre outros. Retornará também os erros, caso a prefeitura não permita a inutilização.