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

Objetivo
Regras de Negócio
Web Services e Métodos do TSS

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);

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

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:

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:

Serviço: WebService - NFESBra
Método: Método - RemessaEvento
Demais eventos: Eventos

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
CC01	envEvento	Raiz	-	-	-	-	-	TAG Raiz.
CC02	eventos	G	C001	-	-	-	-	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.
CC06	cOrgaoAutor	E	CC03	Numérico	1-1	2	-	Código do Órgão Autor do Evento. Informar o Código da UF para este Evento
CC07	tpAutor	E	CC03	Numérico	1-1	1	-	Informar uma das opções abaixo: 1=Empresa Emitente 2=Empresa destinatária 3=Empresa 5=Fisco 6=RFB 9=Outros Órgãos
CC08	dhEntrega	E	CC03	Data	1-1	-	-	Data e hora do final da entrega. Formato AAAA-MMDDThh:mm:ssTZD.
CC09	nDoc	E	CC03	Caractere	1-1	2-20	-	Número do documento de identificação da pessoa que assinou o Comprovante de Entrega da NF-e.
CC10	xNome	E	CC03	Caractere	1-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.
CC12	longGPS	E	CC03	Numérico	0-1	[-]3v6	-	Longitude do ponto de entrega.
CC13	hashComprovante	E	CC03	Caractere	1-1	28	-	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.
CC14	dhHashComprovante	E	CC03	Data	0-1	-	-	Data e hora da geração do hash do Comprovante de Entrega da NF-e. Formato AAAA-MMDDThh:mm:ssTZD

<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>

<?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>

<?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>

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
CC01	envEvento	Raiz	-	-	-	-	-	TAG Raiz.
CC02	eventos	G	C001	-	-	-	-	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.
CC06	cOrgaoAutor	E	CC03	Numérico	1-1	2	-	Código do Órgão Autor do Evento. Informar o Código da UF para este Evento
CC07	tpAutor	E	CC03	Numérico	1-1	1	-	Informar uma das opções abaixo: 1=Empresa Emitente 2=Empresa destinatária 3=Empresa 5=Fisco 6=RFB 9=Outros Órgãos

<envEvento>
    <eventos>
        <detEvento>
            <tpEvento>110131</tpEvento>
			<chNFe>12345678901234567890123456789012345678901234</chNFe>
			<cOrgaoAutor>35</cOrgaoAutor>
			<tpAutor>1</tpAutor>
        </detEvento>
    </eventos>
</envEvento>

<?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>

<?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>

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:

Serviço: WebService - NFESBra
Método: Método - NfeMonitorLoteEvento

<?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>

<?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.

Páginas filhas

ER_Evento de NFe - Comprovante de Entrega da NF-e

Informações Gerais

Regras de Negócio

Web Services e Métodos do TSS