# OS 79380 - MELHORIA - SIS/WEB - RECEBIMENTO - IDENTIFICADOR DE ARQUIVO NO LANÇAMENTO DA PREVIA DAS NOTAS FISCAIS

#### **Objetivo:**

Esta solicitação term por objetivo validar a nova funcionalidade de definição do **Tipo de Anexo** para arquivos vinculados à nota fiscal de entrada, no módulo **Recebimento**, conforme projeto DEPJ 79380, incluindo:

- Exibição e obrigatoriedade do campo "Tipo de Anexo";
- Restrições de edição e exclusão por perfil (WWTNotFisA\_Update / WWTNotFisA\_Delete);
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/QTnu7dnOxWtRhZmC-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/QTnu7dnOxWtRhZmC-image.png)
- Classificação automática de XMLs processados;
- Impedimento de continuidade sem preenchimento obrigatório.

#### **Premissas:**

- Necessário o ambiente estar atualizado com a versão Recebimento de número **113705 Genexus 16** ou superior / **113706 Genexus 17** ou superior;

<p class="callout success">**Regras da funcionalidade:**</p>

**Regras de validação:**

- > Solicitamos a inclusão de um combo, afim de padronizar os nomes dos arquivos a serem disponibilizados para os demais departamentos.”  
    > 📄 *Fonte: DEPJ 79380, pág. 9* <span class="" data-state="closed"><span class="relative inline-flex items-center"><button class="ms-1 flex h-[22px] items-center rounded-xl px-2 relative bottom-[-2px] bg-[#f4f4f4] text-token-text-secondary! hover:bg-token-bg-secondary dark:bg-token-main-surface-secondary dark:hover:bg-token-bg-secondary"><svg alt="Arquivo" class="h-[16px] w-[16px] object-contain" fill="currentColor" height="20" viewbox="0 0 20 20" width="20" xmlns="http://www.w3.org/2000/svg"><path clip-rule="evenodd" d="M11.2598 2.25191C11.8396 2.25191 12.2381 2.24808 12.6201 2.33981L12.8594 2.40719C13.0957 2.48399 13.3228 2.5886 13.5352 2.71871L13.6582 2.79879C13.9416 2.99641 14.1998 3.25938 14.5586 3.61813L15.5488 4.60836L15.833 4.89449C16.0955 5.16136 16.2943 5.38072 16.4482 5.6318L16.5703 5.84957C16.6829 6.07074 16.7691 6.30495 16.8271 6.54684L16.8574 6.69137C16.918 7.0314 16.915 7.39998 16.915 7.90719V13.0839C16.915 13.7728 16.9157 14.3301 16.8789 14.7802C16.8461 15.1808 16.781 15.5417 16.6367 15.8779L16.5703 16.0205C16.3049 16.5413 15.9008 16.9772 15.4053 17.2812L15.1865 17.4033C14.8099 17.5951 14.4041 17.6745 13.9463 17.7119C13.4961 17.7487 12.9391 17.749 12.25 17.749H7.75C7.06092 17.749 6.50395 17.7487 6.05371 17.7119C5.65317 17.6791 5.29227 17.6148 4.95606 17.4707L4.81348 17.4033C4.29235 17.1378 3.85586 16.7341 3.55176 16.2382L3.42969 16.0205C3.23787 15.6439 3.15854 15.2379 3.12109 14.7802C3.08432 14.3301 3.08496 13.7728 3.08496 13.0839V6.91695C3.08496 6.228 3.08433 5.67086 3.12109 5.22066C3.1585 4.76296 3.23797 4.35698 3.42969 3.98043C3.73311 3.38494 4.218 2.90008 4.81348 2.59664C5.19009 2.40484 5.59593 2.32546 6.05371 2.28805C6.50395 2.25126 7.06091 2.25191 7.75 2.25191H11.2598ZM7.75 3.58199C7.03896 3.58199 6.54563 3.58288 6.16211 3.61422C5.78642 3.64492 5.575 3.70168 5.41699 3.78219C5.0718 3.95811 4.79114 4.23874 4.61524 4.58395C4.53479 4.74193 4.47795 4.95354 4.44727 5.32906C4.41595 5.71254 4.41504 6.20609 4.41504 6.91695V13.0839C4.41504 13.7947 4.41594 14.2884 4.44727 14.6718C4.47798 15.0472 4.53477 15.259 4.61524 15.417L4.68555 15.5429C4.86186 15.8304 5.11487 16.0648 5.41699 16.2187L5.54688 16.2744C5.69065 16.3258 5.88016 16.3636 6.16211 16.3867C6.54563 16.418 7.03898 16.4189 7.75 16.4189H12.25C12.961 16.4189 13.4544 16.418 13.8379 16.3867C14.2135 16.356 14.425 16.2992 14.583 16.2187L14.709 16.1474C14.9963 15.9712 15.2308 15.7189 15.3848 15.417L15.4414 15.2861C15.4927 15.1425 15.5297 14.953 15.5527 14.6718C15.5841 14.2884 15.585 13.7947 15.585 13.0839V8.55758L13.3506 8.30953C12.2572 8.18804 11.3976 7.31827 11.2881 6.22359L11.0234 3.58199H7.75ZM12.6113 6.09176C12.6584 6.56193 13.0275 6.93498 13.4971 6.98727L15.5762 7.21871C15.5727 7.13752 15.5686 7.07109 15.5615 7.01266L15.5342 6.85738C15.5005 6.7171 15.4501 6.58135 15.3848 6.45309L15.3145 6.32711C15.2625 6.24233 15.1995 6.16135 15.0928 6.04488L14.6084 5.54879L13.6182 4.55856C13.2769 4.21733 13.1049 4.04904 12.9688 3.94234L12.8398 3.8525C12.7167 3.77705 12.5853 3.71637 12.4482 3.67184L12.3672 3.6484L12.6113 6.09176Z" fill-rule="evenodd"></path></svg></button></span></span>
    
    Outros pontos extraídos do documento:
    
    
    - Os tipos disponíveis são: **PEDIDO**, **DANFE**, **XML**, **NOTA FISCAL - SERVIÇO**, **OUTROS**.
    - O **XML** deve ser classificado automaticamente e **não pode ser editado**.
    - Todos os anexos devem possuir tipo definido para prosseguir.;

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

#### Cenário 1 – Inclusão de Anexos com Seleção de Tipo

**Passos:**

1. Acesse o menu `Recebimento > Lançamento Prévio Nota Fiscal`.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/nePg24jLoUe2S7Cb-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/nePg24jLoUe2S7Cb-image.png)
2. Clique em **Inserir** para nova nota.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/QpszPuZ9j3kCXop1-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/QpszPuZ9j3kCXop1-image.png)
3. Vá até a aba **Anexos**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/gOIxDatim5RxgMEe-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/gOIxDatim5RxgMEe-image.png)
4. Defina o tipo do anexo. 
    1. **São opções:** Pedido, Danfe, XML, Nota Fiscal - Serviço e Outros;
    2. Todas as opções foram sugestões do cliente e inseridas como um **domínio interno da aplicação**.
5. Adicione os anexos desejados.
6. Clique em **Confirmar**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/YRfP7bePZduHL0hT-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/YRfP7bePZduHL0hT-image.png)

**Resultado Esperado:**

- Após definir os tipos dos anexos é possível gravar.

---

#### Cenário 2 – Validação ao tentar confirmar com tipo de anexo não definido

**Passos:**

1. Siga os mesmos passos do cenário 1, mas **não defina o tipo** para o anexo.
2. Clique em **Confirmar**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/351NMEibvktquQHv-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/351NMEibvktquQHv-image.png)

**Resultado Esperado:**

- Sistema bloqueia com a mensagem:
    
    > #### **Erro: Existem arquivos sem tipo de anexo definido!**

---

#### Cenário 3 – Alterar Tipo de Anexo (perfil com permissão)

**Pré-requisito:** perfil com funcionalidade **WWTNotFisA\_Update**.

**Passos:**

1. Acesse uma nota existente com anexo PDF.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/v85DHEWQbmUkkDuf-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/v85DHEWQbmUkkDuf-image.png)
2. Clique no botão de edição (ícone de lápis).
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/V2WQjoiYRwVEldrO-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/V2WQjoiYRwVEldrO-image.png)
3. Altere o tipo do anexo de "OUTROS" para "DANFE".
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/Foy6pWm3eOzaKCgt-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/Foy6pWm3eOzaKCgt-image.png)
4. Clique em **Confirmar**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/NzY1BaS3e1ny5bjM-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/NzY1BaS3e1ny5bjM-image.png)

**Resultado Esperado:**

- O tipo do anexo é atualizado corretamente e exibido na listagem.

---

#### Cenário 4 – Exclusão de Anexo (perfil com permissão)

**Pré-requisito:** perfil com funcionalidade **WWTNotFisA\_Delete**.

**Passos:**

1. Acesse uma nota com anexos.
2. Clique no ícone da X ao lado de um anexo não XML.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/wQfLnk8vhV9znYG0-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/wQfLnk8vhV9znYG0-image.png)
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/xynhJTlF4keCKw4X-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/xynhJTlF4keCKw4X-image.png)
3. Confirme a exclusão.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/58ajYg14fyMTeF9J-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/58ajYg14fyMTeF9J-image.png)

**Resultado Esperado:**

- O anexo é removido da listagem.

---

#### Cenário 6 – Tentativa de edição do tipo de anexo para XML processado automaticamente

**Objetivo:** Garantir que arquivos XML não sejam editáveis.

**Passos:**

1. Acesse uma nota com anexo XML.
2. Clique no botão de edição (ícone de lápis).
3. Altere o tipo de anexo de **XML** para **PEDIDO**.
4. Clique em **Confirmar**.

**Resultado Esperado:**

- ⚠️ O sistema **permite alteração**, o que **não está conforme o esperado**.
- Segundo o DEPJ 79380, XMLs devem ter tipo de anexo **não editável**.

📌 **Ajuste necessário:** travar a edição de tipo de anexo para arquivos XML processados automaticamente.

---

#### Cenário 7 – Ações disponíveis para arquivos anexos conforme tipo e status

**Passos:**

1. Acesse uma nota fiscal já existente com arquivos anexos variados (XML, PDF, PNG).
2. Clique para visualizar os arquivos.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/Yu24KlNe36nd5Oxh-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/Yu24KlNe36nd5Oxh-image.png)

**Resultado Esperado:**

- Para **XML processado automaticamente**:
    
    
    - Campo "Tipo de anexo" aparece como **XML** (não editável).
    - Ícone de visualização da **DANFE** habilitado.
    - Ícone de edição e exclusão **desabilitado**.
- Para **outros arquivos (ex: PDF, PNG)**:
    
    
    - Campo "Tipo de anexo" aparece como "(Não Definido)" e é editável.
    - ✅ Ícone de edição aparece **se** o perfil possuir `WWTNotFisA_Update`.
    - ✅ Ícone de exclusão aparece **se** o perfil possuir `WWTNotFisA_Delete` e status da nota for "Lançamento Prévio".

📌 Observações:

- Demais arquivos permanecem com tipo "Não Definido" até edição manual.

#### Cenário 8 – Upload e Validação de Anexos em Recebimento (Manual, XML e REINF)

**Objetivo:**  
Validar o painel de Upload de anexos nas telas de recebimento, garantindo a obrigatoriedade do tipo de anexo e correta exibição dos arquivos em modo consulta.

---

**Passos:**

1. Acesse o menu `Recebimento > Nota Fiscal Manual`, `Nota Fiscal via XML` ou `Nota Fiscal de Serviço - REINF`.
2. Clique em `Inserir` e preencha os dados obrigatórios da nota.
3. Vá até a seção **Upload**, localizada na parte inferior da tela.
4. Anexe um ou mais arquivos (exemplo: um PDF e um XML).
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/QozjW723Mkes83Nd-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/QozjW723Mkes83Nd-image.png)
5. Clique em `Adicionar arquivos`.
6. Para um dos arquivos, deixe o campo **Tipo de Anexo** em branco.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/q76lPEr1Eu9W0Mp0-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/q76lPEr1Eu9W0Mp0-image.png)
7. Clique em **Confirmar**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/u9jG1g5wsYIIfH0b-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/u9jG1g5wsYIIfH0b-image.png)

---

**Resultado Esperado:**

- O sistema **bloqueia a confirmação** e exibe uma **mensagem de erro** informando que há anexos sem tipo definido.
- O painel de upload é exibido corretamente mesmo para notas de **lançamento manual**, conforme apresentado nas imagens de evidência.
- Para notas com **status "Lançamento Prévio"**, a visualização do componente de arquivos é sempre em **modo consulta**, ou seja, **sem botões de ação disponíveis**.
- Quando acessada por meio da tela **Nota Fiscal – Efetivação**, a exibição de anexos da nota também estará no **modo consulta**, obedecendo às regras definidas para controle de botões visíveis (editar, excluir, tipo de anexo, etc).

![4.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-03/scaled-1680-/eO9m8fVMKPpticCz-4.png)

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