PROC001 Alterar Endereço do Recebedor

	Projeto/Sistema: CTe-GerencieAqui	Versão do Template: 1.2
	Processo: PROC001 Alterar Endereço do Recebedor	Versão do Documento: 1.0
	Responsável(eis):  Luís Leite	Data:  09/02/2026

1. Introdução

Este processo visa exemplificar a criação da função de informar endereço alternativo do recebedor no CTe.

2. Processo

Processo	Envolvidos	Dados de Entrada	Dados de Saída
PROC001 Alterar Endereço do Recebedor:	-	Dados de endereço do Recebedor	Informação salva em banco e emitida em XML

Especificação Funcional

---

PROC001 Alterar Endereço do Recebedor:

Protótipo de Tela:

Imagem I - Botão "Alterar Endereço do Recebedor" renderizado

Imagem II - Dialog que deve ser aberta

Descrição dos Campos:

Campo	Tipo	Tamanho	Obrig. ?	Máscara	Observações
Alterar Endereço do Recebedor	Botão	-	-	-	-
CEP*	Texto	8	Sim	000.000-000	-
Cidade*	Texto	7	Sim	-	-
Logradouro*	Texto	2-255	Sim	-	-
Nº*	Texto	1-60	Sim	-	-
Bairro*	Texto	2-60	Sim	-	-
Excluir	Botão	-	-	-	-
Salvar	Botão	-	-	-	-

Regras de Interface:

1. Botão "Alterar Endereço do Recebedor":
Só deve ser renderizado caso seja informado o recebedor no CT-e.
2. Botão "Alterar Endereço do Recebedor":
Deve abrir a Dialog para o preenchimento de outro endereço diferente do cadastrado. Todos os campos são de preenchimento obrigatório. (Imagem II)
3. Botão Salvar:
Caso seja possível salvar o registro de endereços, deve ser finalizada a Dialog e deve voltar o aviso:

Endereço do Tomador alterado com sucesso!

Caso não seja possível devido a não preenchimento ou preenchimento incorreto dos campos, deve ser retornado aviso e manter a Dialog aberta:

Erro ao salvar, confira o preenchimento dos campos!

4. Botão Excluir:
Só deve ser renderizado somente se houver preenchimento nos campos da Dialog. A ação deve limpar o preenchimento dos campos e encerrar a Dialog:

Endereço alternativo retirado.

Regras de Negócio:

1. Botão Salvar:
Deve validar o preenchimento de todos os campos, se estão respeitando os tamanhos de campo ou se estão em branco. Somente deve ser salvo em banco caso cumprir os requisitos, caso contrario retornar a rejeição conforme regras de interface.
2. Botão Excluir:
Deve remover o vínculo do outro endereço do Recebedor com o CTe. 
3. Deve ser criada uma tabela na base de dados para armazenar o vínculo do endereço do recebedor com o CTe.

Questões Técnicas:

1. Alterar tabela de 'cte' para armazenar novos dados

ALTER TABLE cte 
ADD recebxLgr varchar(255),
ADD recebNro varchar(60),
ADD recebBairro varchar(60),
ADD recebCEP char(8),
ADD recebMun bigint,
ADD CONSTRAINT fk_cte_recebMun
 FOREIGN KEY (recebMun) REFERENCES cidade(id);

2. Exemplo XML de envio, os dados do endereço devem ser adicionados nas tags pai <enderReceb>, por padrão vão ir com os dados do cadastro, devem ser informados os dados de endereço alternativo caso estejam preenchidos.

<receb>
<CNPJ>07702969000153</CNPJ>
<IE>456064276113</IE>
<xNome>FUNDICAO REGALI BRASIL LTDA</xNome>
<enderReceb>
<xLgr>RUA DE TESTE RECEBDOR</xLgr>
<nro>10</nro>
<xBairro>RECEBDOR</xBairro>
<cMun>3525706</cMun>
<xMun>JOSE BONIFACIO</xMun>
<CEP>15200000</CEP>
<UF>SP</UF>
</enderReceb>
</receb>

©SOFTEN SISTEMAS 2026.