TSS

Páginas filhas
  • ER_Evento de NFe - Comprovante de Entrega da NF-e

Versões comparadas

Versão antiga 54

changes.mady.by.user Usuário desconhecido (renan.franco)

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Usuário desconhecido (renan.franco)

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.

Informações Gerais 

Especificação

Produto

TSS

Módulo

NF-e 

Segmento Executor

Serviços

Chamado/ISSUE

DSERTSS1-17272

País

( X ) Brasil  (  ) Argentina  (  ) México  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colômbia   (  ) Outro _____________.

Índice


Âncora
objetivo
objetivo
Objetivo

Realizar o envio do evento Comprovante de Entrega da NF-e, assim atendendo a NT 2021.001.

Link: https://www.nfe.fazenda.gov.br/portal/informe.aspx?ehCTG=false&Informe=vKAodF+w0bE=

As empresas e as transportadoras continuam utilizando o tradicional Canhoto da Nota Fiscal contido na representação impressa da NF-e para comprovação da entrega da mercadoria ao destinatário.

O “Comprovante de Entrega da NF-e” auxilia a instrução de processos administrativos, judiciais e financeiros que envolvem a relação emissor/destinatário da NF-e, ou transportador responsável pela entrega da Mercadoria (emissor CT-e).

Esta nota técnica tem o objetivo instituir uma infraestrutura digital de comprovação de entrega/recebimento de mercadorias, a partir da captura de imagens e registros de eventos nos documentos fiscais eletrônicos utilizados pelas empresas emitentes de NF-e.

Para a NF-e, quando a entrega não estiver relacionada com um Conhecimento de Transporte Eletrônico (CT-e), criam-se os eventos abaixo a serem gerados pela empresa emitente da NF-e:


  • Comprovante de Entrega da NF-e (tpEvento=110130); 
  • Cancelamento do Comprovante de Entrega da NF-e (tpEvento=110131);

Âncora
regradenegocio
regradenegocio
Regras de Negócio

Função: evento destinado enviar o Comprovante de Entrega da NF-e e o Cancelamento do Comprovante de Entrega da NF-e.

Autor do Evento: O autor do evento poderá ser: 1 - Empresa Emitente, 2 - Empresa destinatária, 3 - Empresa, 5 - Fisco, 6 - RFB e 9 - Outros Órgãos.

Código do Tipo de Evento: 110130 e 110131


Âncora
webmetodo
webmetodo
Web Services e Métodos do TSS

Após realizar a configuração da empresa e seus parâmetros, seguir os passos abaixo para o correto envio e monitoramento do evento: 


Deck of Cards
idmetodos
effectTypeslide
Card
defaulttrue
idremessaevento
labelEnvio do Evento
titleEnvio do Evento
effectTypeslide

Através do método RemessaEvento do serviço NFESBRA, será realizado o envio do evento de Ator Interessado na NF-e.

Deverá ser realizado a montagem da tag XML_LOTE, convertido em base64.

Segue os links com os detalhes:

Deck of Cards
idenvio_evento
Card
idexemplo_envio110130
labelComprovante de Entrega
titleComprovante de Entrega

Para o evento de Comprovante de Entrega da NFe (110130), segue as tags para XML_LOTE:

#

Campo

Ele

Pai

Tipo

Ocor

Tam.

Dec.

Descrição

CC01envEventoRaiz-----TAG Raiz.
CC02eventosGC001----Evento.

CC03

detEvento

G

CC02

-

1-20

-

-

Detalhes do evento.

CC04

tpEvento

E

CC03

Numérico

1-1

6

-

Tipo de Evento (110130).

CC05

chNFe

E

CC03

Numérico

1-1

44

-

Chave de Acesso da NF-e à qual o evento será vinculado.

CC06cOrgaoAutorECC03Numérico1-12-

Código do Órgão Autor do Evento. Informar o Código da UF para este Evento

CC07tpAutorECC03Numérico1-11-

Informar uma das opções abaixo:

1=Empresa Emitente

2=Empresa destinatária

3=Empresa

5=Fisco

6=RFB

9=Outros Órgãos

CC08dhEntregaECC03Data1-1--Data e hora do final da entrega. Formato AAAA-MMDDThh:mm:ssTZD.
CC09nDocECC03Caractere1-12-20-Número do documento de identificação da pessoa que assinou o Comprovante de Entrega da NF-e.
CC10xNomeECC03Caractere1-1

2-60

-Nome da pessoa que assinou o Comprovante de Entrega da NF-e.

CC11

latGPS

E

CC03

Numérico

0-1

[-]2v6

-

Latitude do ponto de entrega.

CC12longGPSECC03Numérico0-1[-]3v6-Longitude do ponto de entrega.
CC13hashComprovanteECC03Caractere1-128-Hash SHA-1, no formato Base64, resultante da concatenação de: Chave de Acesso da NF-e + Base64 da imagem capturada do Comprovante de Entrega da NF-e.
CC14dhHashComprovanteECC03Data0-1--Data e hora da geração do hash do Comprovante de Entrega da NF-e. Formato AAAA-MMDDThh:mm:ssTZD
Bloco de código
languagexml
<envEvento>
	<eventos>
		<detEvento>
			<tpEvento>110130</tpEvento>
			<chNFe>12345678901234567890123456789012345678901234</chNFe>
			<cOrgaoAutor>35</cOrgaoAutor>
			<tpAutor>1</tpAutor>
			<dhEntrega>2021-05-25T21:54:00-03:00</dhEntrega>
			<nDoc>12345678901234</nDoc>
			<xNome>Joao Silva</xNome>
			<hashComprovante>MWxWcyWD/LobGAYgNV1RpA3z/1o=</hashComprovante>
		</detEvento>
	</eventos>
</envEvento>
Deck of Cards
idex_envio110130
Card
idex_xml_envio_110130
labelExemplo de Envio
titleExemplo de Envio
Bloco de código
languagexml
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <REMESSAEVENTO xmlns="http://webservices.totvs.com.br/nfsebra.apw">
            <USERTOKEN>TOTVS</USERTOKEN>
            <ID_ENT>000001</ID_ENT>
            <XML_LOTE>PGVudkV2ZW50bz48ZXZlbnRvcz48ZGV0RXZlbnRvPjx0cEV2ZW50bz4xMTAxMzA8L3RwRXZlbnRvPjxjaE5GZT4xMjM0NTY3ODkwMTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDwvY2hORmU+PGNPcmdhb0F1dG9yPjM1PC9jT3JnYW9BdXRvcj48dHBBdXRvcj4xPC90cEF1dG9yPjxkaEVudHJlZ2E+MjAyMS0wNS0yNVQyMTo1NDowMC0wMzowMDwvZGhFbnRyZWdhPjxuRG9jPjEyMzQ1Njc4OTAxMjM0PC9uRG9jPjx4Tm9tZT5Kb2FvIFNpbHZhPC94Tm9tZT48aGFzaENvbXByb3ZhbnRlPk1XeFdjeVdEL0xvYkdBWWdOVjFScEEzei8xbz08L2hhc2hDb21wcm92YW50ZT48L2RldEV2ZW50bz48L2V2ZW50b3M+PC9lbnZFdmVudG8+</XML_LOTE>
        </REMESSAEVENTO>
    </soap:Body>
</soap:Envelope>
Card
idex_xml_retorno_110130
labelExemplo de Retorno
titleExemplo de Retorno
Bloco de código
languagexml
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <REMESSAEVENTORESPONSE xmlns="http://webservices.totvs.com.br/nfsebra.apw">
            <REMESSAEVENTORESULT>
                <STRING>ID1101300000000000000000000000000000000000000000000001</STRING>
            </REMESSAEVENTORESULT>
        </REMESSAEVENTORESPONSE>
    </soap:Body>
</soap:Envelope>
Card
idexemplo_envio110131
labelCancelamento do Comprovante de Entrega
titleCancelamento do Comprovante de Entrega

Para o evento de Cancelamento do Comprovante de Entrega da NFe (110131), segue as tags para XML_LOTE:

#

Campo

Ele

Pai

Tipo

Ocor

Tam.

Dec.

Descrição

CC01envEventoRaiz-----TAG Raiz.
CC02eventosGC001----Evento.

CC03

detEvento

G

CC02

-

1-20

-

-

Detalhes do evento.

CC04

tpEvento

E

CC03

Numérico

1-1

6

-

Tipo de Evento (110131).

CC05

chNFe

E

CC03

Numérico

1-1

44

-

Chave de Acesso da NF-e à qual o evento será vinculado.

CC06cOrgaoAutorECC03Numérico1-12-

Código do Órgão Autor do Evento. Informar o Código da UF para este Evento

CC07tpAutorECC03Numérico1-11-

Informar uma das opções abaixo:

1=Empresa Emitente

2=Empresa destinatária

3=Empresa

5=Fisco

6=RFB

9=Outros Órgãos

Bloco de código
<envEvento>
    <eventos>
        <detEvento>
            <tpEvento>110131</tpEvento>
			<chNFe>12345678901234567890123456789012345678901234</chNFe>
			<cOrgaoAutor>35</cOrgaoAutor>
			<tpAutor>1</tpAutor>
        </detEvento>
    </eventos>
</envEvento>
Deck of Cards
idex_envio110131
Card
idex_xml_envio_110131
labelExemplo de Envio
titleExemplo de Envio
Bloco de código
languagexml
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <REMESSAEVENTO xmlns="http://webservices.totvs.com.br/nfsebra.apw">
            <USERTOKEN>TOTVS</USERTOKEN>
            <ID_ENT>000001</ID_ENT>
            <XML_LOTE>PGVudkV2ZW50bz48ZXZlbnRvcz48ZGV0RXZlbnRvPjx0cEV2ZW50bz4xMTAxMzE8L3RwRXZlbnRvPjxjaE5GZT4xMjM0NTY3ODkwMTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDwvY2hORmU+PGNPcmdhb0F1dG9yPjM1PC9jT3JnYW9BdXRvcj48dHBBdXRvcj4xPC90cEF1dG9yPjwvZGV0RXZlbnRvPjwvZXZlbnRvcz48L2VudkV2ZW50bz4=</XML_LOTE>
        </REMESSAEVENTO>
    </soap:Body>
</soap:Envelope>
Card
idex_xml_retorno_110131
labelExemplo de Retorno
titleExemplo de Retorno
Bloco de código
languagexml
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <REMESSAEVENTORESPONSE xmlns="http://webservices.totvs.com.br/nfsebra.apw">
            <REMESSAEVENTORESULT>
                <STRING>ID1101310000000000000000000000000000000000000000000001</STRING>
            </REMESSAEVENTORESULT>
        </REMESSAEVENTORESPONSE>
    </soap:Body>
</soap:Envelope>
Card
idmonitorevento
labelMonitor do Evento
titleMonitor do Evento

Através do método NFeMonitorLoteEvento do serviço NFESBRA, será realizado o monitoramento do envio do evento do Comprovante de Entrega e Cancelamento do Comprovante de Entrega da NF-e.

Segue os links com detalhes:


Deck of Cards
idmonitor_evento
Card
idex_monitor_envio
labelExemplo de Envio
titleExemplo de Envio
Bloco de código
languagexml
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <NFEMONITORLOTEEVENTO xmlns="http://webservices.totvs.com.br/nfsebra.apw">
            <USERTOKEN>TOTVS</USERTOKEN>
            <ID_ENT>000001</ID_ENT>
            <LOTE_INICIAL/>
            <LOTE_FINAL/>
            <EVENTO>110130</EVENTO>
            <CHVINICIAL/>
            <CHVFINAL/>
            <CHAVES>00000000000000000000000000000000000000000000</CHAVES>
        </NFEMONITORLOTEEVENTO>
    </soap:Body>
</soap:Envelope>
Card
idex_monitor_retorno
labelExemplo de Retorno
titleExemplo de Retorno
Bloco de código
languagexml
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <NFEMONITORLOTEEVENTORESPONSE xmlns="http://webservices.totvs.com.br/nfsebra.apw">
         <NFEMONITORLOTEEVENTORESULT>
            <NFEMONITOREVENTO>
               <AMBIENTE>2</AMBIENTE>
               <CMOTENV>Lote de evento processado</CMOTENV>
               <CMOTEVEN>Evento registrado</CMOTEVEN>
               <CORGAO>35</CORGAO>
               <CSTATENV>128</CSTATENV>
               <CSTATEVEN>135</CSTATEVEN>
               <DHREGEVEN>0000-00-00T00:00:00-00:00</DHREGEVEN>
               <ID_EVENTO>ID1101300000000000000000000000000000000000000000000000</ID_EVENTO>
               <LOTE>0</LOTE>
               <MENSAGEM>Evento Autorizado</MENSAGEM>
               <PROTOCOLO>000000000000000</PROTOCOLO>
               <STATUS>6</STATUS>
               <TIPOEVENTO>110130</TIPOEVENTO>
            </NFEMONITOREVENTO>
         </NFEMONITORLOTEEVENTORESULT>
      </NFEMONITORLOTEEVENTORESPONSE>
   </soap:Body>
</soap:Envelope>

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.