# OS 80855 - MELHORIA - SIS/WEB - SENDDECOR - CONSULTA API NCM EM TELA

#### **Objetivo:**

- Esta solicitação tem por objetivo adicionar o botão **“Validar NCM”** nos módulos **Faturamento Decor (emissão de NF)**, **Desenvolvimento de Produtos (cadastro de catálogo)** e **Corporativo (cadastro de produtos)**, que retorna a situação do NCM conforme item na **tabela oficial vigente**.

#### **Premissas:**

- Necessário o ambiente estar atualizado com a versão do módulo **Corporativo** de número **122578 Genexus 17** ou superior;
- Necessário o ambiente estar atualizado com a versão do módulo **SendDecor** de número **122561** ou superior;
- Necessário o ambiente estar atualizado com a versão do módulo **FaturamentoDecor** de número **122561** ou superior; 
    - Essa função será habilitada pela Send dependendo da regra de negócio de cada cliente.

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

#### **Cenário: Cadastro de produto**

Neste cenário iremos acessar o cadastro de algum produto e acessar a consulta de NCM pela API.

**Acessando a funcionalidade**

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/n0H7vhbCa3ZYy8HQ-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/n0H7vhbCa3ZYy8HQ-image.png)

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/Pt8jMD6M4NJp1Piq-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/Pt8jMD6M4NJp1Piq-image.png)

- Editar o produto desejado;

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/lXFlD7mVfJwLQAIz-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/lXFlD7mVfJwLQAIz-image.png)

- Acessar a aba de fiscal e apertar o botão de validar;

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/uWljDij1V2dqP3Xw-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/uWljDij1V2dqP3Xw-image.png)

- Será retornado os dados cadastrados na API;

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/m3IpZlnnNU77bXpC-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/m3IpZlnnNU77bXpC-image.png)

Podendo retornar os status;

Vigente;  
Não vigente;  
Inexistente.

Caso o serviço da API esteja fora do ar poderá exibir a mensagem abaixo (instabilidade por parte do portal único, aguardar normalização pela sefaz):

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/10LbYhDZba2Tg3uP-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/10LbYhDZba2Tg3uP-image.png)

#### **Cenário: Desenvolvimento de produtos**

Neste cenário iremos acessar o cadastro de catálogo e verificar o NCM cadastrado;

**Acessando a funcionalidade**

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/cAFK9O1AtARkkBvt-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/cAFK9O1AtARkkBvt-image.png)

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/rTkGbyq7ZHbPEz2p-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/rTkGbyq7ZHbPEz2p-image.png)

- Editar o catalogo desejado;

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/HnwlcAHtdbsJIzVT-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/HnwlcAHtdbsJIzVT-image.png)

- Acessar a nova funcionalidade;

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/Gd1heKkuX5meqBbR-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/Gd1heKkuX5meqBbR-image.png)

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/jWm8C6mjcRUj58ua-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/jWm8C6mjcRUj58ua-image.png)

Podendo retornar os status;

Vigente;  
Não vigente;  
Inexistente.

Caso o serviço da API esteja fora do ar poderá exibir a mensagem abaixo (instabilidade por parte do portal único, aguardar normalização pela sefaz):

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/10LbYhDZba2Tg3uP-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/10LbYhDZba2Tg3uP-image.png)

#### **Cenário: Faturamento**

Neste cenário iremos acessar o faturamento de pedidos e validar os itens vs o NCM.

**Acessando a funcionalidade**

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/k1MBHN6okLlsFZoT-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/k1MBHN6okLlsFZoT-image.png)

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/8WbIU9Cf6C2VMcLN-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/8WbIU9Cf6C2VMcLN-image.png)

- selecionar o pedido desejado;

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/010MgAqFt7ro6Wbx-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/010MgAqFt7ro6Wbx-image.png)

- Consulta dos ncms;

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/14rkxeaNNJoedzpj-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/14rkxeaNNJoedzpj-image.png)

Podendo retornar os status;

Vigente;  
Não vigente;  
Inexistente.

Caso o serviço da API esteja fora do ar poderá exibir a mensagem abaixo (instabilidade por parte do portal único, aguardar normalização pela sefaz):

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/scaled-1680-/10LbYhDZba2Tg3uP-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-10/10LbYhDZba2Tg3uP-image.png)

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