Pular para conteúdo

Controle de Numeração da NF-e

Com o intuito de realizar o controle de numeração e série para a NF-e modelo 55, implementamos a tag IDUnico nos layouts de envio, consulta e cancelamento de NF-e que pode ser utilizada tanto na integração via Web Service e API REST.

Esta tag é de preenchimento opcional, mas se for utilizada irá substituir o número e a série do documento enviado. Se preenchida, será necessário que exista uma série cadastrada no InvoiCy, pois é através dela que faremos o controle de numeração e série do documento ao enviar para a SEFAZ.

O ID Único do documento pode ser verificado na aba "Geral" nos detalhes do documento, conforme segue:

alt text

No cadastro da série para o módulo NF-e, é preciso informar também o número do último documento emitido, pois o InvoiCy irá incrementar e enviar esse número sequencialmente para a SEFAZ. Caso a tag serie não seja preenchida, a série padrão cadastrada no InvoiCy será utilizada.

Envio de Documento

No envio de um documento, se o IDUnico, o número e a série no documento forem enviados, existem duas possibilidades, são elas:

  • Se a série enviada no XML estiver cadastrada no InvoiCy, mesmo não sendo a série padrão, o sistema irá consultar em tela qual o último número emitido para a mesma e inserir a numeração da sequência, independente da numeração informada no XML.

  • Caso a série informada no XML não esteja cadastrada no InvoiCy, o mesmo não conseguirá consultar qual o último número da NF-e emitida para tal série, mantendo o número da NF-e como "0" ao enviar para a SEFAZ, resultando na rejeição no documento.

Cada NF-e possui um ID único, ou seja, o mesmo ID não poderá ser utilizado para outra nota. Dentro deste campo, pode ser preenchido qualquer valor que possa identificar a NF-e, entretanto essa tag aceita até 200 caracteres.

O envio do documento ocorrerá normalmente, a única alteração será o preenchimento da tag que pode ou não ser realizada.

Abaixo, segue um exemplo de envio do documento utilizando o IDUnico e não informando a série e o número da nota:

<Envio>
    <ModeloDocumento>NFe</ModeloDocumento>
    <Versao>4.00</Versao>
    <Parametros/>
    <ide>
        <cNF>9170280</cNF>
        <cUF>43</cUF>
        <natOp>Venda de mercadoria</natOp>
        <indPag>0</indPag>
        <mod>55</mod>
       <IDUnico>5315</IDUnico>
       <fusoHorario>-03:00</fusoHorario>
        <tpNf>1</tpNf>
        <idDest>1</idDest>
        <indFinal>1</indFinal>
[...]

Mais informações sobre a estrutura completa do envio de documentos podem ser consultadas aqui.

Pode-se observar que no retorno do envio, o InvoiCy irá trazer o DocNumero seguindo a sequência da última NF-e emitida e também o DocSerie conforme a série cadastrada como “padrão” no InvoiCy.

Consulta de Documento

Para realizar a consulta de documentos é preciso preencher apenas a tag IDUnico, com o mesmo valor utilizado na emissão da NF-e, conforme o exemplo abaixo:

<Consulta>
    <ModeloDocumento>NFe</ModeloDocumento>
    <Versao>4.00</Versao>
    <tpAmb>2</tpAmb>
    <CnpjEmpresa>99999999999999</CnpjEmpresa>
    <CnpjEmissor>99999999999999</CnpjEmissor>
   <IDUnico>5315</IDUnico>
</Consulta>

Acesse aqui, mais informações sobre o XML de consulta de documentos.

No retorno da consulta também será apresentado o número do IDUnico bem como a numeração e série atrelada ao documento fiscal.

Cancelamento de Documento

No envio do cancelamento, caso opte por inserir além da tag IDUnico, as tags de série e número do documento e por ventura informar o número de um documento que não corresponda ao mesmo documento do IDUnico, a numeração e série serão ignoradas pois sempre o que prevalece é o número do IDUnico.

<EnvioEvento>
    <ModeloDocumento>NFe</ModeloDocumento>
    <Versao>4.00</Versao>
    <Evento>
        <NtfCnpjEmissor>99999999999999</NtfCnpjEmissor>
       <IDUnico>5312</IDUnico>
       <tpAmb>2</tpAmb>
[...]

Mais informações sobre a estrutura XML de envio, podem ser obtidas aqui.