Pular para conteúdo

Consulta de Pulos de Numeração via Web Service

Com a finalidade de facilitar para os usuários efetuarem o controle dos documentos emitidos por suas empresas, o InvoiCy possibilita realizar a consulta dos pulos de numeração, onde será possível identificar falhas no sequencial da numeração de documentos emitidos para todos os módulos.

Os principais motivos que podem ocasionar falhas no sequencial de envio dos documentos são:

  • Pulo de numeração no aplicativo emissor
  • Falha do aplicativo emissor no envio do documento
  • Documentos emitidos que ainda não estão com status: Autorizado, Cancelado ou Inutilizado
  • Documentos emitidos que permanecem com status: Pendente, Rejeitado, Contingência Offline, Em conflito, EPEC ou Necessita interação

Para realizar a consulta de pulos de numeração 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.

Inicialmente, preencha o XML de envio com as informações necessárias para realizar o envio da consulta. 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>66f9db2d32d8f06d909b260ce9f44738</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.

Na estrutura XML, deve-se informar o CNPJ do emitente, CNPJ da empresa, modelo do documento, tipo de ambiente, série e data de emissão inicial e final, não podendo ultrapassar o período de 31 dias.

Para facilitar seu entendimento sobre como deve ocorrer o preenchimento das informações, disponibilizamos o layout de envio.

Após efetuar o envio da requisição para consulta dos pulos de numeração, deverá retornar o código "100" com a mensagem "Pulos de numeração processados", se o processo foi executado com sucesso.

Esse tipo de retorno irá conter o CNPJ do emissor, modelo e série do documento consultado, a quantidade de pulos de numeração, juntamente com a especificação da sequência dos números que estão faltando, e ainda o código e descrição do retorno.

Caso não seja localizado nenhum pulo de numeração, serão retornados o código "100" e a mensagem "Nenhum pulo de numeração encontrado".