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-16008
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 de Ator Interessado na NF-e, assim atendendo a NT 2020.007.

Link: http://www.nfe.fazenda.gov.br/portal/exibirArquivo.aspx?conteudo=bR7rBwLvaZQ=

"No momento da emissão da NF-e, muitas vezes o emitente ainda não definiu o Transportador que ficará responsável pela entrega da mercadoria. Consequentemente, isso impede que essa informação conste em campo específico da NF-e.

O objetivo desta Nota Técnica é permitir que o Emitente informe a identificação do Transportador a qualquer momento, como uma das pessoas autorizadas a acessar o XML da NF-e. No caso em que o transporte não é de responsabilidade do Emitente, o Destinatário poderá gerar o evento, com o objetivo de autorizar que o Transportador fique autorizado a acessar o XML da NF-e."

Regras de Negócio

Função: evento destinado a identificar o(s) transportador(es) autorizado(s) a acessar o XML da NF-e.

Autor do Evento: O autor do evento poderá ser 1- Empresa emitente, 2- Empresa destinatária ou 3- Empresa transportadora.

Código do Tipo de Evento: 110150

Web Services e Métodos do TSS

Seguir os passos abaixo para o correto envio do evento:

Através do método AdmEmpresas do serviço SPEDADM, será realizado a criação da empresa, onde é representada por um código de entidade no TSS.

Segue os links com os detalhes:

Serviço: WebService - SPEDADM
Método: Método - AdmEmpresas

<?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>
		<ADMEMPRESAS xmlns="http://webservices.totvs.com.br/spedadm.apw">
			<USERTOKEN>TOTVS</USERTOKEN>
			<EMPRESA>
				<BAIRRO>BAIRRO</BAIRRO>
				<CEP>00000000</CEP>
				<CNPJ>00000000000000</CNPJ>
				<COD_MUN>0000000</COD_MUN>
				<COD_PAIS>0000</COD_PAIS>
				<COMPL/>
				<CPF/>
				<DDD>00</DDD>
				<ENDERECO>ENDERECO</ENDERECO>
				<FANTASIA>NOME FANTASIA</FANTASIA>
				<FAX>0000000</FAX>
				<FONE>0000000</FONE>
				<IE>000000000000</IE>
				<IM>00000000</IM>
				<MUN>MUNICIPIO</MUN>
				<NIRE/>
				<NOME>NOME EMPRESA</NOME>
				<NUM>NUMERO ENDERECO</NUM>
				<UF>XX</UF>
			</EMPRESA>
		</ADMEMPRESAS>
	</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>
		<ADMEMPRESASRESPONSE xmlns="http://webservices.totvs.com.br/spedadm.apw">
			<ADMEMPRESASRESULT>000001</ADMEMPRESASRESULT>
		</ADMEMPRESASRESPONSE>
	</soap:Body>
</soap:Envelope>

Através do método CfgCCe do serviço SPEDCFGNFE, será realizado a configuração dos parâmetros da empresa, ou seja, parâmetros necessários da entidade no TSS para envio do evento.

Segue os links com os detalhes:

Serviço: WebService - SpedCfgNFe
Método: Método - CfgCCe

<?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>
		<CFGCCE xmlns="http://webservices.totvs.com.br/spedcfgnfe.apw">
			<USERTOKEN>TOTVS</USERTOKEN>
			<ID_ENT>000001</ID_ENT>
			<AMBIENTECCE>2</AMBIENTECCE>
			<VERCCELAYOUT>1.00</VERCCELAYOUT>
			<VERCCELAYEVEN>1.00</VERCCELAYEVEN>
			<VERCCEEVEN>1.00</VERCCEEVEN>
			<VERCCE>1.00</VERCCE>
			<HORAVERAOCCE>2</HORAVERAOCCE>
			<HORARIOCCE>2</HORARIOCCE>
			<SEQLOTECCE>1</SEQLOTECCE>
		</CFGCCE>
	</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>
		<CFGCCERESPONSE xmlns="http://webservices.totvs.com.br/spedcfgnfe.apw">
			<CFGCCERESULT>
				<AMBIENTE>2-Homologacao</AMBIENTE>
				<AMBIENTEEPP>2-Homologacao</AMBIENTEEPP>
				<HORARIOCCE>2-Brasilia</HORARIOCCE>
				<HORAVERAOCCE>2-Nao</HORAVERAOCCE>
				<SEQLOTECCE>1</SEQLOTECCE>
				<SEQLOTEEPP>0</SEQLOTEEPP>
				<VERCCE>1.00</VERCCE>
				<VERCCEEVEN>1.00</VERCCEEVEN>
				<VERCCELAYEVEN>1.00</VERCCELAYEVEN>
				<VERCCELAYOUT>1.00</VERCCELAYOUT>
				<VEREPP>1.00</VEREPP>
				<VEREPPEVEN>1.00</VEREPPEVEN>
				<VEREPPLAYEVEN>1.00</VEREPPLAYEVEN>
				<VEREPPLAYOUT>1.00</VEREPPLAYOUT>
			</CFGCCERESULT>
		</CFGCCERESPONSE>
	</soap:Body>
</soap:Envelope>

Através do método CfgCertificatePFX do serviço SPEDCFGNFE, será realizado a configuração do certificado digital da empresa para assinatura do envio do evento de Ator Interessado na NF-e.

Segue os links com detalhes:

Serviço: WebService - SpedCfgNFe
Método: Método - CFGCertificatePFX

<?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>
		<CFGCERTIFICATEPFX xmlns="http://webservices.totvs.com.br/spedcfgnfe.apw">
			<USERTOKEN>TOTVS</USERTOKEN>
			<ID_ENT>000001</ID_ENT>
			<CERTIFICATE>Y2VydGlmaWNhZG8gY29udmVydGlkbyBlbSBiYXNlNjQ=</CERTIFICATE>
			<PASSWORD>c2VuaGEgY29udmVydGlkYSBlbSBiYXNlNjQ=</PASSWORD>
		</CFGCERTIFICATEPFX>
	</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>
		<CFGCERTIFICATEPFXRESPONSE xmlns="http://webservices.totvs.com.br/spedcfgnfe.apw">
			<CFGCERTIFICATEPFXRESULT>Certificado (PFX)- Ok
				Autoridades certificadoras convertidas para formato apache - Ok
				Certificado convertido para formato apache - Ok
				PrivateKey convertida para formato apache - Ok
				Password - Ok

				Registrado para: EMPRESA TESTE
				Validade de 01/01/2020 ate 31/12/9999
			</CFGCERTIFICATEPFXRESULT>
		</CFGCERTIFICATEPFXRESPONSE>
	</soap:Body>
</soap:Envelope>

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

#	Campo	Ele	Pai	Tipo	Ocor	Tam.	Dec.	Descrição
CC03	detEvento	G	CC02	-	1-N	-	-	Informações do Evento (estrutura XML variável, depende do tipo de evento)
CC04	tpEvento	E	CC03	Num	1-1	6	-	Tipo de Evento
CC05	chNFe	E	CC03	Num	1-1	44	-	Chave de Acesso do documento.
CC06	tpAutor	E	CC03	Num	1-1	1	-	Informar uma das opções abaixo: 1=Empresa Emitente 2=Empresa Destinatária 3=Empresa Transportadora.
CC07	cOrgaoAutor	E	CC03	Num	1-1	2	-	UF do Emitente do evento, pode ser emitente da NF, destinatário da NF ou mesmo a transportadora.
CC08	autXML	G	CC03	-	1-1	-	-	Pessoas autorizadas a acessar o XML da NF-e
CC09	CNPJ	CE	CC08	Num	1-1	3-14	-	CNPJ autorizado
CC10	CPF	CE	CC08	Num	1-1	3-11	-	CPF autorizado
CC11	tpAutorizacao	E	CC03	Alfa	1-1	15-1000	-	0 – Não permite; 1 – Permite o transportador autorizado pelo emitente ou destinatário autorizar outros transportadores para ter acesso ao download da NF-e

Conteúdo LOTE_XML

<envEvento>
    <eventos>
        <detEvento>
            <tpEvento>110150</tpEvento>
            <chNFe>00000000000000000000000000000000000000000000</chNFe>
			<tpAutor>1</tpAutor>
			<cOrgaoAutor>35</cOrgaoAutor>
			<autXML>
				<!---Informar ou CNPJ ou CPF, nunca os dois-->
				<CNPJ>00000000000000</CNPJ>
				<CPF>00000000000</CPF>
			</autXML>
			<tpAutorizacao>1</tpAutorizacao>
        </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>PGVudkV2ZW50bz4NCiAgICA8ZXZlbnRvcz4NCiAgICAgICAgPGRldEV2ZW50bz4NCiAgICAgICAgICAgIDx0cEV2ZW50bz4xMTAxNTA8L3RwRXZlbnRvPg0KICAgICAgICAgICAgPGNoTkZlPjAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwPC9jaE5GZT4NCgkJCTx0cEF1dG9yPjE8L3RwQXV0b3I+DQoJCQk8Y09yZ2FvQXV0b3I+U1A8L2NPcmdhb0F1dG9yPg0KCQkJPGF1dFhNTD4NCgkJCQk8IS0tLUluZm9ybWFyIG91IENOUEogb3UgQ1BGLCBudW5jYSBvcyBkb2lzLS0+DQoJCQkJPENOUEo+MDAwMDAwMDAwMDAwMDA8L0NOUEo+DQoJCQkJPENQRj4wMDAwMDAwMDAwMDwvQ1BGPg0KCQkJPC9hdXRYTUw+DQoJCQk8dHBBdXRvcml6YWNhbz4xPC90cEF1dG9yaXphY2FvPg0KICAgICAgICA8L2RldEV2ZW50bz4NCiAgICA8L2V2ZW50b3M+DQo8L2VudkV2ZW50bz4=</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>ID1101500000000000000000000000000000000000000000000001</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 de Ator Interessado na NF-e..

Segue os links com detalhes:

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

Exemplo de Envio

<?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>110150</EVENTO>
			<CHVINICIAL/>
			<CHVFINAL/>
			<CHAVES>00000000000000000000000000000000000000000000</CHAVES>
		</NFEMONITORLOTEEVENTO>
	</soap:Body>
</soap:Envelope>

Exemplo de Retorno

<?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>ID1101500000000000000000000000000000000000000000000000</ID_EVENTO>
               <LOTE>0</LOTE>
               <MENSAGEM>Evento Autorizado</MENSAGEM>
               <PROTOCOLO>000000000000000</PROTOCOLO>
               <STATUS>6</STATUS>
               <TIPOEVENTO>110150</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 - Ator Interessado na NF-e

Informações Gerais

Regras de Negócio

Web Services e Métodos do TSS