# OS 104190 - MELHORIA - SENDDECOR - ENDEREÇO DE ENTREGA DE ITENS NA VIA DE MERCADORIA

#### **Objetivo:**

A solicitação tem como objetivo **apresentar, na Via do Escritório do pedido de venda, o endereço de entrega correspondente a cada item quando o pedido possuir endereços adicionais**.

Com essa melhoria, quando diferentes produtos de um mesmo pedido precisarem ser entregues em locais distintos, a equipe responsável pela separação e logística poderá identificar diretamente na impressão da Via do Escritório **qual endereço deverá ser utilizado para cada item**, evitando a necessidade de consultar outra via do pedido para obter essa informação.

Quando determinado item não possuir um endereço adicional relacionado, será considerado o **endereço de entrega padrão do pedido**.

#### **Premissas:**

- Necessário o ambiente estar atualizado com as versões: 
    - SendDecor de número **148107** ou superior;

#### **Teste realizado após a atualização.**

#### <span role="text">**Cenário 01: Conferir os endereços de entrega disponíveis para o cliente**</span>

**Objetivo:**  
Garantir que os endereços utilizados posteriormente no pedido estejam previamente cadastrados e ativos para seleção.

**Pré-condição:**  
O cliente utilizado no pedido deve possuir ao menos dois endereços do tipo **Entrega** cadastrados e ativos.

<p class="callout info">**Resultado Esperado:**  
O cadastro do cliente deve apresentar os endereços de entrega disponíveis e ativos, permitindo que eles sejam posteriormente utilizados como endereço padrão ou endereço adicional do pedido.</p>

**Passo a passo – Conferindo os endereços do cliente:**

1. Acesse o módulo **Corporativo**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/SvK1zyDFLrsM7Vhy-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/SvK1zyDFLrsM7Vhy-image.png)
2. Acesse **Parceiros &gt; Cliente e Fornecedor**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/3EhlYmmRyJr9b5Bv-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/3EhlYmmRyJr9b5Bv-image.png)
3. Localize o cliente desejado e acesse sua edição.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/ZE5i4Qd4NtyYokEq-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/ZE5i4Qd4NtyYokEq-image.png)
4. Acesse a aba **Endereços**.
5. Confira os registros cadastrados com o tipo **Entrega**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/dagzqWxmpNDWnOYi-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/dagzqWxmpNDWnOYi-image.png)
6. Verifique se existem ao menos dois endereços de entrega ativos.
7. Confirme os dados e retorne ao pedido de venda.

---

#### <span role="text">**Cenário 02: Validar a impressão da Via do Escritório sem endereço adicional**</span>

**Objetivo:**  
Validar o comportamento padrão da impressão quando o pedido ainda não possui endereço adicional relacionado aos itens.

**Pré-condição:**  
O cliente deve possuir endereço de faturamento, cobrança e entrega cadastrado, e o pedido não deve possuir endereço adicional informado.

<p class="callout info">**Resultado Esperado:**  
Ao gerar a **Via do Escritório**, o endereço padrão de entrega deve ser apresentado normalmente no bloco **Endereços**, juntamente com as demais informações do pedido.</p>

<p class="callout info">Nesse momento, como não existem endereços adicionais relacionados aos itens, não é necessário apresentar um endereço individual abaixo de cada produto.</p>

**Passo a passo – Gerando o pedido sem endereço adicional:**

1. Acesse o módulo **Frente de Loja**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/31doofUZ7pM7WtAJ-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/31doofUZ7pM7WtAJ-image.png)
2. Acesse **Pedido &gt; Pedido de Venda**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/bNUJ8yb5oklyHDLz-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/bNUJ8yb5oklyHDLz-image.png)
3. Insira um novo pedido ou edite um pedido existente.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/fq1moo6SybcJGsvN-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/fq1moo6SybcJGsvN-image.png)
4. Na aba **Cliente**, confira o endereço de entrega padrão apresentado para o pedido.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/Zn1ZP4r17UJVUofY-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/Zn1ZP4r17UJVUofY-image.png)
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/tERC1upPrerlPS7a-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/tERC1upPrerlPS7a-image.png)
5. Acesse a aba **Itens**.
6. Inclua os produtos que farão parte da venda.
7. Quando aplicável, inclua os produtos utilizando suas respectivas etiquetas.
8. Confira se todos os itens foram adicionados corretamente.
9. Salve o pedido.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/ZKK6wbHQMVNpZlEE-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/ZKK6wbHQMVNpZlEE-image.png)
10. Clique em **Exemplar Escritório**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/7yp69cwPFEybfcJE-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/7yp69cwPFEybfcJE-image.png)
11. Confira o bloco **Endereços** da impressão.
12. Verifique se o endereço padrão de entrega do pedido é apresentado corretamente.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/XWHNucvTbUScrYQG-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/XWHNucvTbUScrYQG-image.png)

---

#### <span role="text">**Cenário 03: Incluir um endereço adicional de entrega no pedido**</span>

**Objetivo:**  
Permitir que o usuário informe um endereço de entrega diferente do endereço padrão para determinados itens do pedido.

**Pré-condição:**  
O cliente deve possuir mais de um endereço de entrega ativo e o pedido deve possuir itens incluídos.

<p class="callout info">**Resultado Esperado:**  
Ao inserir um endereço adicional do tipo **Entrega**, o sistema deve disponibilizar para seleção os endereços de entrega ativos existentes no cadastro do cliente.</p>

<p class="callout info">Após a confirmação, o endereço selecionado deve permanecer vinculado ao pedido e disponível para que sejam relacionados os respectivos itens ou etiquetas.</p>

**Passo a passo – Incluindo o endereço adicional:**

1. No pedido de venda, acesse a aba **Endereços Adicionais**.
2. Clique em **Inserir**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/g95V6uriziagJ5CH-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/g95V6uriziagJ5CH-image.png)
3. Confira que o tipo apresentado corresponde a **Entrega**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/QbWJlAaXKCxMG1Jw-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/QbWJlAaXKCxMG1Jw-image.png)
4. No campo de endereço, consulte as opções disponíveis.
5. Verifique se os endereços de entrega ativos do cliente são apresentados.
6. Selecione o endereço que será utilizado como endereço adicional.
7. Clique em **Confirmar**.
8. Confira se o endereço foi incluído na grade de **Endereços Adicionais**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/d2SgSmZaCF6yppVx-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/d2SgSmZaCF6yppVx-image.png)

---

#### <span role="text">**Cenário 04: Relacionar etiquetas ao endereço adicional**</span>

**Objetivo:**  
Permitir que o endereço adicional de entrega seja relacionado diretamente às etiquetas dos produtos que deverão ser entregues em outro local.

**Pré-condição:**  
O pedido deve possuir produtos incluídos por etiqueta e um endereço adicional do tipo **Entrega** previamente cadastrado.

<p class="callout info">**Resultado Esperado:**  
As etiquetas selecionadas devem ficar vinculadas ao endereço adicional informado.  
O sistema deve permitir também o preenchimento de uma observação para auxiliar na identificação da entrega.  
Após a confirmação, cada etiqueta vinculada deve ser apresentada na relação do endereço adicional.</p>

**Passo a passo – Relacionando as etiquetas:**

1. Na aba **Endereços Adicionais**, localize o endereço incluído.
2. Acesse a edição ou visualização detalhada do endereço.
3. Localize a seção **Etiquetas**.
4. Clique em **Inserir**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/EBQbavrYDt3GrnaQ-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/EBQbavrYDt3GrnaQ-image.png)
5. Selecione uma das etiquetas pertencentes aos itens do pedido.
6. No campo **Observação**, informe, quando necessário, uma orientação relacionada à entrega.
7. Clique em **Confirmar**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/XISSdrJWJa1c7oPt-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/XISSdrJWJa1c7oPt-image.png)
8. Confira se a etiqueta passou a ser apresentada na grade.
9. Repita o procedimento para uma segunda etiqueta.
10. Mantenha ao menos uma etiqueta do pedido sem vínculo com o endereço adicional, permitindo validar também o comportamento do endereço padrão.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/IA9J3nN9sbiMQnt8-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/IA9J3nN9sbiMQnt8-image.png)

<p class="callout warning">**Atenção:** Quando o produto tiver sido incluído no pedido por etiqueta, recomenda-se relacionar o endereço adicional pela própria **Etiqueta**. Para produtos sem controle por etiqueta, o endereço poderá ser relacionado pelo **Item**.</p>

<p class="callout warning">Quando houver indicação de endereço tanto pelo produto quanto pela etiqueta, **prevalece o endereço relacionado à etiqueta**.</p>

---

#### <span role="text">**Cenário 05: Validar o endereço de entrega por item na Via do Escritório**</span>

**Objetivo:**  
Confirmar que a Via do Escritório apresente, junto a cada item, o endereço de entrega que efetivamente deverá ser utilizado.

**Pré-condição:**  
O pedido deve possuir:

- mais de um item;
- endereço de entrega padrão;
- um endereço adicional cadastrado;
- parte dos itens ou etiquetas vinculados ao endereço adicional;
- ao menos um item ou etiqueta sem vínculo com o endereço adicional.

<p class="callout info">**Resultado Esperado:**  
Ao gerar a **Via do Escritório**, o bloco geral de **Endereços** deve continuar apresentando as informações de cobrança e faturamento.</p>

<p class="callout info">Quando existirem endereços adicionais, o endereço de entrega deve ser apresentado **individualmente junto aos respectivos itens**.</p>

<p class="callout info">Para os itens relacionados ao endereço adicional, deve ser exibido o endereço adicional selecionado.</p>

<p class="callout info">Para os itens que não possuem relacionamento com endereço adicional, deve ser utilizado automaticamente o **endereço de entrega padrão do pedido**.</p>

<p class="callout info">Dessa forma, a impressão deve permitir que a equipe responsável pela logística identifique claramente o destino correto de cada mercadoria.</p>

**Passo a passo – Conferindo a Via do Escritório:**

1. Retorne à tela principal do pedido.
2. Salve as alterações realizadas.
3. Clique em **Exemplar Escritório**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/Vfh81y1m8QKW4RQb-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/Vfh81y1m8QKW4RQb-image.png)
4. Na impressão, confira inicialmente o bloco **Endereços**.
5. Verifique que, na existência de endereço adicional, o endereço de entrega passa a ser identificado junto aos itens.
6. Localize o primeiro item relacionado a uma etiqueta cadastrada no endereço adicional.
7. Confira se abaixo do item é apresentado o endereço adicional selecionado.
8. Repita a conferência para o segundo item relacionado ao mesmo endereço adicional.
9. Localize o item cuja etiqueta não foi relacionada ao endereço adicional.
10. Confira se esse item apresenta o endereço de entrega padrão do pedido.
11. Verifique se cada item possui identificação clara do respectivo local de entrega.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/Nm8cdaF3YxYsmErv-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/Nm8cdaF3YxYsmErv-image.png)

---

#### <span role="text">**Cenário 06: Comparar a informação com a Via do Cliente**</span>

**Objetivo:**  
Confirmar que a melhoria aplicada à Via do Escritório mantenha coerência com a informação de endereço de entrega já disponível na Via do Cliente.

**Pré-condição:**  
O pedido deve possuir endereço adicional vinculado a determinados itens ou etiquetas.

<p class="callout info">**Resultado Esperado:**  
A **Via do Cliente** e a **Via do Escritório** devem apresentar corretamente o endereço correspondente a cada item.</p>

<p class="callout info">Os itens vinculados ao endereço adicional devem utilizar esse endereço, enquanto os demais devem permanecer associados ao endereço padrão de entrega do pedido.</p>

**Passo a passo – Comparando as impressões:**

1. No pedido de venda, clique em **Exemplar Cliente** ou gere a respectiva via.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/7hdEbpcPkbtXlUE4-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/7hdEbpcPkbtXlUE4-image.png)
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/Tv3kq79uKBDhKEPl-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/Tv3kq79uKBDhKEPl-image.png)
2. Localize os itens vinculados ao endereço adicional.
3. Confira o endereço apresentado abaixo desses itens.
4. Localize o item que permaneceu associado ao endereço padrão.
5. Confira o respectivo endereço.
6. Compare essas informações com a **Via do Escritório**.
7. Verifique se a definição dos endereços está coerente entre as duas impressões.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/qSnxHtF2ZDgLXHFY-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/qSnxHtF2ZDgLXHFY-image.png)

#### [![Ficou com alguma dúvida .png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/3LKSgbAcJ0XTTlsS-ficou-com-alguma-duvida.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/3LKSgbAcJ0XTTlsS-ficou-com-alguma-duvida.png)

<p class="callout danger">**ATENÇÃO: As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.**</p>