# Alterar Endereço do Recebedor



# PROC001 Alterar Endereço do Recebedor

<table border="1" id="bkmrk-%C2%A0-projeto%2Fsistema%3Age" style="border-collapse: collapse; width: 100.123%; height: 68px;"><tbody><tr style="border-style: solid;"><td rowspan="3" style="width: 26.6667%; height: 68px; border-color: black; border-top-style: hidden; border-left-style: hidden; border-bottom-style: hidden;">  
[![image-1762776253666.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/image-1762776253666.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762776253666.png)

</td><td style="width: 49.9999%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Projeto/Sistema:**</span>  
<span style="color: #000000;">CTe-GerencieAqui</span></td><td class="align-center" style="width: 23.3333%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do *Template:***</span>  
<span style="color: #000000;">1.2</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Processo:**</span>  
**PROC001 Alterar Endereço do Recebedor**</td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do Documento:**</span>  
<span style="color: #000000;">1.0</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Responsável(eis):** </span>  
<span style="color: #000000;">Luís Leite</span></td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Data:** </span>

<span style="color: #000000;">09/02/2026</span>

</td></tr></tbody></table>

##### <span style="color: #000000;">**1. Introdução**</span>

<span style="color: #000000;">**Este processo visa exemplificar a criação da função de informar endereço alternativo do recebedor no CTe.**</span>

##### <span style="color: #000000;">**2. Processo**</span>

<table cellpadding="9" cellspacing="0" id="bkmrk-processo-envolvidos-" style="width: 100%;" width="100%"><tbody><tr valign="top"><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">**Processo**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 19%;" width="19%"><span style="font-size: small; color: #000000;">**Envolvidos**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Entrada**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Saída**</span>

</td></tr><tr valign="top"><td style="border-style: solid; border-color: black; width: 27%;" width="27%">**PROC001 Alterar Endereço do Recebedor:**

</td><td style="border-style: solid; border-color: black; width: 19%;" width="19%"><span style="font-size: small; color: #000000;">-</span>

</td><td style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">Dados de endereço do Recebedor</span>

</td><td style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">Informação salva em banco e emitida em XML</span>

</td></tr></tbody></table>

#### **Especificação Funcional**

- - - - - -

#### **PROC001 Alterar Endereço do Recebedor:**

##### ***Protótipo de Tela:***

[![image-1770646566278.jpg](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/scaled-1680-/image-1770646566278.jpg)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/image-1770646566278.jpg)

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

[![image-1770655866140.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/scaled-1680-/image-1770655866140.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/image-1770655866140.png)

Imagem II - *Dialog* que deve ser aberta

##### ***Descrição dos Campos:***

<table border="1" cellpadding="7" cellspacing="0" id="bkmrk-campo-tipo-tamanho-o" style="width: 843px; height: 350px;"><tbody><tr style="height: 35px;" valign="top"><td bgcolor="#acb9ca" style="width: 168px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Campo**</span>

</td><td bgcolor="#acb9ca" style="width: 102px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Tipo**</span>

</td><td bgcolor="#acb9ca" style="width: 88px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Tamanho**</span>

</td><td bgcolor="#acb9ca" style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Obrig. ?**</span>

</td><td bgcolor="#acb9ca" style="width: 119px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Máscara**</span>

</td><td bgcolor="#acb9ca" style="width: 201px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Observações**</span>

</td></tr><tr style="height: 35px;"><td style="width: 168px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Alterar Endereço do Recebedor</span>

</td><td style="width: 102px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Botão</span>

</td><td style="width: 88px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 119px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 201px; border-style: solid; border-color: black; height: 35px;">-

</td></tr><tr style="height: 35px;"><td colspan="6" style="width: 843px; border-style: solid; border-color: black; height: 35px;"> </td></tr><tr style="height: 35px;"><td style="width: 168px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">CEP\*</span>

</td><td style="width: 102px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Texto</span>

</td><td style="width: 88px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">8</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Sim</span>

</td><td style="width: 119px; border-style: solid; border-color: black; height: 35px;">000.000-000

</td><td style="width: 201px; border-style: solid; border-color: black; height: 35px;">-

</td></tr><tr style="height: 35px;"><td style="width: 168px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Cidade\*</span>

</td><td style="width: 102px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Texto</span>

</td><td style="width: 88px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">7</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Sim</span>

</td><td style="width: 119px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 201px; border-style: solid; border-color: black; height: 35px;">-

</td></tr><tr style="height: 35px;"><td style="width: 168px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Logradouro\*</span>

</td><td style="width: 102px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Texto</span>

</td><td style="width: 88px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">2-255</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Sim</span>

</td><td style="width: 119px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 201px; border-style: solid; border-color: black; height: 35px;">-

</td></tr><tr style="height: 35px;"><td style="width: 168px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Nº\*</span>

</td><td style="width: 102px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Texto</span>

</td><td style="width: 88px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">1-60</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Sim</span>

</td><td style="width: 119px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 201px; border-style: solid; border-color: black; height: 35px;">-

</td></tr><tr style="height: 35px;"><td style="width: 168px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Bairro\*</span>

</td><td style="width: 102px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Texto</span>

</td><td style="width: 88px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">2-60</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Sim</span>

</td><td style="width: 119px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 201px; border-style: solid; border-color: black; height: 35px;">-

</td></tr><tr style="height: 35px;"><td style="width: 168px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Excluir</span>

</td><td style="width: 102px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Botão</span>

</td><td style="width: 88px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 119px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 201px; border-style: solid; border-color: black; height: 35px;">-

</td></tr><tr style="height: 35px;"><td style="width: 168px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Salvar</span>

</td><td style="width: 102px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Botão</span>

</td><td style="width: 88px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 119px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 201px; border-style: solid; border-color: black; height: 35px;">-

</td></tr></tbody></table>

##### ***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:

<p class="callout success">Endereço do Tomador alterado com sucesso!</p>

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:

<p class="callout danger">Erro ao salvar, confira o preenchimento dos campos!</p>

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

<p class="callout success">Endereço alternativo retirado.</p>

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

```SQL
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 &lt;enderReceb&gt;, por padrão vão ir com os dados do cadastro, devem ser informados os dados de endereço alternativo caso estejam preenchidos.

```XML
<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.