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	CT-e
Segmento Executor	Serviços
Chamado/ISSUE	DSERTSS1-21275
País	( X ) Brasil ( ) Argentina ( ) México ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colômbia ( ) Outro _____________.

Índice

Âncora

	objetivo
	objetivo

Objetivo

Realizar o envio do Evento de Insucesso na Entrega do CT-e, assim atendendo a NT 2023.002.

Link: https://www.cte.fazenda.gov.br/portal/listaConteudo.aspx?tipoConteudo=Y0nErnoZpsg=

Âncora
regradenegocio
regradenegocio
Regras de Negócio

Função: evento destinado a informação do evento de insucesso na entrega do CT-e.

Autor do Evento: O autor do evento é o emissor do CT-e. A mensagem XML do evento será assinada com o certificado digital que tenha o CNPJ base do Emissor do CT-e.

Código do Tipo de Evento: 110190

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

Para o envio do evento deverá seguir o seguinte processo:

Detalhes sobres os métodos abaixo:

Deck of Cards

id	metodos

Card

default	true
id	admempresas
label	Configuração de empresa
title	Configuração de empresa

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

Link do Serviço: WebService - SPEDADM

Link Método: Método - AdmEmpresas

Deck of Cards

id	exemploadmempresa

Card

default	true
id	exadmempresaenvio
label	Exemplo de Envio
title	Exemplo de Envio

Bloco de código

language	xml
title	Exemplo de Envio
linenumbers	true
collapse	true

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

Card

id	exadmempresaretorno
label	Exemplo de Retorno
title	Exemplo de Retorno

Bloco de código

language	xml
title	Exemplo de Retorno
linenumbers	true
collapse	true

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

Card

id	cfgbpe
label	Configuração dos parâmetros
title	Configuração dos parâmetros

Através do método CFGEPECCTE 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 detalhes:

Link do Serviço: WebService - SpedCfgNFe

Link Método: Método - CFGEPECCTE

Deck of Cards

id	exemploparametros

Card

default	true
id	exparamenvio
label	Exemplo de Envio
title	Exemplo de Envio

Bloco de código

language	xml
title	Exemplo de Envio
linenumbers	true
collapse	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sped="http://webservices.totvs.com.br/spedcfgnfe.apw">
   <soapenv:Header/>
   <soapenv:Body>
      <sped:CFGEPECCTE>
         <sped:USERTOKEN>TOTVS<			<sped:VERSAOGERALEPEC>4.00</sped:USERTOKEN>
         <sped:ID_ENT>000001<VERSAOGERALEPEC>
			<sped:VERSAOINSUCESSO>4.00</sped:ID_ENT>
         <sped:VERSAOGERALEPEC>3VERSAOINSUCESSO>
			<sped:VERSAOCANCINSU>4.00</sped:VERSAOGERALEPEC>
         <sped:VERSAOEVENEPEC>3VERSAOCANCINSU>
			<sped:VERSAOEVENCANC>4.00</sped:VERSAOEVENEPEC>
         <sped:VERSAOGERALCANC>3VERSAOEVENCANC>
			<sped:VERSAOEVENCOMPROV>4.00</sped:VERSAOGERALCANC>
         <sped:VERSAOEVENCANC>3VERSAOEVENCOMPROV>
			<sped:VERSAOEVENCANCCOMPROV>4.00</sped:VERSAOEVENCANC>
         <sped:VERSAOGERALCCE>3VERSAOEVENCANCCOMPROV>
			<sped:VERSAOEVENEPEC>4.00</sped:VERSAOGERALCCE>
         <sped:VERSAOEVENCCE>3VERSAOEVENEPEC>
			<sped:VERSAOGERALCANC>4.00</sped:VERSAOEVENCCE>
         <sped:VERSAOINSUCESSO>4VERSAOGERALCANC>
			<sped:VERSAOGERALCCE>4.00</sped:VERSAOINSUCESSO>
         <sped:VERSAOEVENCOMPROV>4VERSAOGERALCCE>
			<sped:VERSAOEVENCCE>4.00</sped:VERSAOEVENCOMPROV>
         <sped:VERSAOEVENCANCCOMPROV>4VERSAOEVENCCE>
			<sped:VERSAOGERALMULT>4.00</sped:VERSAOEVENCANCCOMPROV>
         <sped:VERSAOCANCINSU>4.00<sped:VERSAOCANCINSU>
         <!--Optional:-->
         <sped:VERSAOGERALMULT>3VERSAOGERALMULT>
			<sped:VERSAOEVENMULT>4.00</sped:VERSAOEVENMULT>
			<sped:VERSAOGERALDESAC>4.00</sped:VERSAOGERALMULT>
         <!--Optional:-->
         <sped:VERSAOEVENMULT>3.00</sped:VERSAOEVENMULT>
         <!--Optional:-->
         <sped:VERSAOGERALGTV>3.00</sped:VERSAOGERALGTV>
         <!--Optional:-->
         <sped:VERSAOEVENGTV>3.00</sped:VERSAOEVENGTV>
         <!--Optional:-->
         <sped:VERSAOGERALDESAC>3.00</sped:VERSAOGERALDESAC>
         <!--Optional:-->
         <sped:VERSAOEVENDESAC>3.00</sped:VERSAOEVENDESAC>
         <!--Optional:-->
         <sped:SEQLOTEEPEC></sped:SEQLOTEEPEC>
         <sped:CTECANCEVENTO>1</sped:CTECANCEVENTO>
         <!--Optional:-->
         <sped:HORAVERAOCTE>2</sped:HORAVERAOCTE>
         <!--Optional:-->
         <sped:HORARIOCTE>2</sped:HORARIOCTE>
     VERSAOGERALDESAC>
			<sped:CTECANCEVENTO>1</sped:CTECANCEVENTO>
			<sped:VERSAOEVENDESAC>4.00</sped:VERSAOEVENDESAC>
       </sped:CFGEPECCTE>
   </soapenv:Body>
</soapenv:Envelope>

Card

id	exparamretorno
label	Exemplo de Retorno
title	Exemplo de Retorno

Bloco de código

language	yml
firstline	1
title	Exemplo de retorno
linenumbers	true
collapse	true

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


      <CFGEPECCTERESPONSE xmlns="http://webservices.totvs.com.br/spedcfgnfe.apw">


         <CFGEPECCTERESULT>


            <CTECANCEVENTO>1-Cancelamento por evento habilitado</CTECANCEVENTO>


            <HORARIOCTE>2-Brasilia</HORARIOCTE>


            <HORAVERAOCTE>2-Nao</HORAVERAOCTE>

<SEQLOTEEPEC>36<

 <SEQLOTEEPEC>61</SEQLOTEEPEC>

<VERSAOEVENCANC>3

 <VERSAOCANCINSU>4.00</

VERSAOEVENCANC>

VERSAOCANCINSU>

<VERSAOEVENCANCCOMPROV>4

 <VERSAOEVENCANC>4.00</

VERSAOEVENCANCCOMPROV>

VERSAOEVENCANC>

<VERSAOEVENCCE>3

 <VERSAOEVENCANCCOMPROV>4.00</

VERSAOEVENCCE>

VERSAOEVENCANCCOMPROV>

</CFGEPECCTERESULT>

</CFGEPECCTERESPONSE>

</soap:Body>

           <VERSAOEVENCCE>4.00</VERSAOEVENCCE>
            <VERSAOEVENCOMPROV>4.00</VERSAOEVENCOMPROV>
            <VERSAOEVENDESAC>4.00</VERSAOEVENDESAC>
            <VERSAOEVENEPEC>4.00</VERSAOEVENEPEC>
            <VERSAOEVENMULT>4.00</VERSAOEVENMULT>
            <VERSAOGERALCANC>4.00</VERSAOGERALCANC>
            <VERSAOGERALCCE>4.00</VERSAOGERALCCE>
            <VERSAOGERALDESAC>4.00</VERSAOGERALDESAC>
            <VERSAOGERALEPEC>4.00</VERSAOGERALEPEC>
            <VERSAOGERALMULT>4.00</VERSAOGERALMULT>
            <VERSAOINSUCESSO>4.00</VERSAOINSUCESSO> 
         </CFGEPECCTERESULT>
      </CFGEPECCTERESPONSE>
   </soap:Body>
</soap:Envelope>

Card

id	cfgcertbpe
label	Configuração do certificado digital
title	Configuração do certificado digital

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 Excesso de Bagagem.

Segue os links com detalhes:

Link do Serviço: WebService - SpedCfgNFe

Link Método: Método - CFGCertificatePFX

Deck of Cards

id	exemplocertificado

Card

default	true
id	excertenvio
label	Exemplo de Envio
title	Exemplo de Envio

Bloco de código

language	xml
title	Exemplo de Envio
linenumbers	true
collapse	true

<?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>Y2VydGlmaWNhZG8gZW5jb2RhZG8gZW0gYmFzZTY0</CERTIFICATE>
			<PASSWORD>c2VuaGEgZW5jb2RhZG8gZW0gYmFzZTY0</PASSWORD>
		</CFGCERTIFICATEPFX>
	</soap:Body>
</soap:Envelope>

Card

id	excertretorno
label	Exemplo de Retorno
title	Exemplo de Retorno

Bloco de código

language	xml
title	Exemplo de Retorno
linenumbers	true
collapse	true

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

Card

id	remessaevento
label	Envio do Evento
title	Envio do Evento

Através do método RemessaEvento do serviço NFESBRA, será realizado o envio do evento de insucesso na entrega.

Deverá ser realizado a montagem da tag XML_LOTE, encodado em base64, da seguinte maneira:

Bloco de código

language	xml
title	Conteúdo LOTE_XML

<envEvento>
     <eventos>
          <detEvento>
               <tpEvento>110190</tpEvento>
               <chnfe>431908XXXXXXXXXXXXXX573330000012221000000138</chnfe>
               <ambiente>2</ambiente>
               <evIECTe>
                     <nTentativa>001</nTentativa>
                     <tpMotivo>4</tpMotivo>
                     <xJustMotivo>ESSE DOCUMENTO E APENAS UM TESTE DESCONSIDERAR</xJustMotivo>      
                     <hashTentativaEntrega>ymXdv4XdlKvswYVfuj75wY7d7ww=</hashTentativaEntrega>
                     <dhHashTentativaEntrega>2023-05-18T11:09:07-03:00</dhHashTentativaEntrega>
                     <infEntrega>
                            <chNFe>352206XXXXXXXXXXXXXX557641000100001466187274</chNFe>
                     </infEntrega>
                </evIECTe>
          </detEvento>
     </eventos>
</envEvento>

Tag	Tag Pai	Tamanho	Obrigatório	Observação
detEvento	Eventos	-	Sim	Tag raiz
tpEvento	detEvento	6	Sim	Tipo do Evento 110190
chNFe	detEvento	44	Sim	Chave de Acesso do CT-e
ambiente	detEvento	1	Sim	1 - Produção / 2 - Homologação .
evIECTe	detEvento	-	Sim	Tag raiz. Caso não seja passado o grupo irá considerar o último ou o único evento do comprovante autorizado do evento 110190
nTentativa	evIECTe	3	Não	Número da tentativa de entrega que não teve insucesso.
tpMotivo	evIECTe	1	Sim	Motivo do insucesso: 1- Recebedor não encontrado; 2- Recusa do recebedor; 3- Endereço inexistente; 4- Outros (exige informar justificativa)
xJustMotivo	evIECTe	25-250	Não, porém se o valor for igual a 4 deve ser enviada.	Justificativa do Motivo de insucesso, informar apenas para tpMotivo = 4
hashTentativaEntrega	evIECTe	28	Sim	Hash (SHA1) no formato Base64 resultante da concatenação: Chave de acesso do CT-e + Base64 da imagem capturada na tentativa da entrega (Exemplo: imagem capturada da assinatura eletrônica, digital do recebedor, foto, etc) Nota 1: A critério do autor deste evento, este campo pode ser utilizado como índice para acesso as informações do Insucesso de entrega. Nota 2: A SEFAZ não tem nenhum controle sobre a informação deste campo. Observação: 28 caracteres são representados no schema como 20 bytes do tipo base64Binary
dhHashTentativaEntrega	evIECTe	-	Sim	Data e hora da geração do hash da tentativa de entrega Formato = AAAA-MM-DDTHH:MM:SS TZD
infEntrega	evIECTe	0-2000	Não	Grupo de informações das NF-e que não tiveram sucesso na entrega ao Destinatário. Informar apenas para CT-e com tipo de serviço Normal.
chNFe	infEntrega	44	Sim	Chave de acesso da NF-e com insucesso na tentativa de entrega.

Segue os links com detalhes:

Link do Serviço: WebService - NFESBra

Link Método: Método - RemessaEvento

Deck of Cards

id	exemploenvio

Card

default	true
id	exenvio
label	Exemplo de Envio
title	Exemplo de Envio

Bloco de código

language	xml
title	Exemplo de Envio
linenumbers	true
collapse	true

<?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>PGVudkV2ZW50bz48ZXZlbnRvcz48ZGV0RXZlbnRvPjx0cEV2ZW50bz4xMTAxOTA8L3RwRXZlbnRvPjxDaE5mZT4zNTIzMDU1MzExMzc5MTAwMDEyMjU3NTQxMDAwMDQ2ODY1MTEwMDIyNTI3NTwvQ2hOZmU+PGFtYmllbnRlPjI8L2FtYmllbnRlPjxldklFQ1RlPjxuVGVudGF0aXZhPjAwMjwvblRlbnRhdGl2YT48dHBNb3Rpdm8+NDwvdHBNb3Rpdm8+PHhKdXN0TW90aXZvPkVTU0UgRE9DVU1FTlRPIEUgQVBFTkFTIFVNIFRFU1RFIERFU0NPTlNJREVSQVI8L3hKdXN0TW90aXZvPjxoYXNoVGVudGF0aXZhRW50cmVnYT5aQ0VZNmR2L1NkMXg2OGdnUGswTFFkMjlMS3c9PC9oYXNoVGVudGF0aXZhRW50cmVnYT48ZGhIYXNoVGVudGF0aXZhRW50cmVnYT4yMDIzLTA1LTE4VDE1OjIyOjAwLTAzOjAwPC9kaEhhc2hUZW50YXRpdmFFbnRyZWdhPjxpbmZFbnRyZWdhPjxjaE5GZT4zNTIyMDY1MzExMzc5MTAwMDEyMjU1NzY0MTAwMDEwMDAwMTQ2NjE4NzI3NDwvY2hORmU+PC9pbmZFbnRyZWdhPjwvZXZJRUNUZT48L2RldEV2ZW50bz48L2V2ZW50b3M+PC9lbnZFdmVudG8+</XML_LOTE>
		</REMESSAEVENTO>
	</soap:Body>
</soap:Envelope>

Card

id	exretorno
label	Exemplo de Retorno
title	Exemplo de Retorno

Bloco de código

language	xml
title	Exemplo de Retorno
linenumbers	true
collapse	true

<?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>ID1101170000000000000000000000000000000000000000000001</STRING>
			</REMESSAEVENTORESULT>
		</REMESSAEVENTORESPONSE>
	</soap:Body>
</soap:Envelope>

Card

id	monitorevento
label	Monitor do Evento
title	Monitor do Evento

Através do método NFeMonitorLoteEvento do serviço NFESBRA, será realizado o monitoramento do envio do evento de insucesso na entrega.

Segue os links com detalhes:

Link do Serviço: WebService - NFESBra

Link Método: Método - NfeMonitorLoteEvento

Deck of Cards

id	exemplomonitor

Card

default	true
id	exmonitorenvio
label	Exemplo de Envio
title	Exemplo de Envio

Bloco de código

language	xml
title	Exemplo de Envio
linenumbers	true
collapse	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:nfs="http://webservices.totvs.com.br/nfsebra.apw">
	<soapenv:Header/>
	<soapenv:Body>
		<nfs:NFEMONITORLOTEEVENTO>
			<nfs:USERTOKEN>TOTVS</nfs:USERTOKEN>
			<nfs:ID_ENT>000001</nfs:ID_ENT>
			<nfs:EVENTO>110190</nfs:EVENTO>
			<nfs:CHVINICIAL>352305XXXXXXXXXXXXXX575410000468651100225275</nfs:CHVINICIAL>
			<nfs:CHVFINAL>352305XXXXXXXXXXXXXX575410000468651100225275</nfs:CHVFINAL>
		</nfs:NFEMONITORLOTEEVENTO>
	</soapenv:Body>
</soapenv:Envelope>

Card

id	exmonitorretorno
label	Exemplo de Retorno
title	Exemplo de Retorno

Bloco de código

language	xml
title	Exemplo de Retorno
linenumbers	true
collapse	true

<?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>                                                                                                                                                                                                                                                          </CMOTENV>
					<CMOTEVEN>                                                                                                                                                                                                                                                              </CMOTEVEN>
					<CORGAO>35</CORGAO>
					<CSTATENV>0</CSTATENV>
					<CSTATEVEN>0</CSTATEVEN>
					<DHREGEVEN>                              </DHREGEVEN>
					<ID_EVENTO>ID110190352305XXXXXXXXXXXXXX57541000046865110022527500</ID_EVENTO>
					<LOTE>36</LOTE>
					<MENSAGEM>Evento Assinado</MENSAGEM>
					<PROTOCOLO>0</PROTOCOLO>
					<STATUS>2</STATUS>
					<TIPOEVENTO>110190</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

Versões comparadas

Versão antiga 7

Nova versão Atual

Chave

Informações Gerais

Âncora
regradenegocio
regradenegocio
Regras de Negócio

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

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 7

Nova versão Atual

Chave

Informações Gerais

ÂncoraregradenegocioregradenegocioRegras de Negócio

ÂncorawebmetodowebmetodoWeb Services e Métodos do TSS

Âncora
regradenegocio
regradenegocio
Regras de Negócio

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