# OS 79239 - MELHORIA - SIS/WEB - CONTAS A RECEBER - CCB INTEGRAÇÃO VIA WEBSERVICE

#### **Objetivo:**

- Esta solicitação tem por objetivo utilizar e consultar dados do cliente por meio do serviço CCB (Consulta Cadastral Bandeirantes);

#### **Premissas:**

- Necessário o ambiente estar atualizado com a versão Módulo de número **112122 Genexus 17** ou superior;  
    
    - - Conceder acesso ("**CONTASRECEBER.TRCCBLOGWW**","**CONTASRECEBER.WPCONSULTACCB**") aos perfis de usuário responsáveis para acesso às telas; 
            - [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/DB3heywFvNpV89RZ-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/DB3heywFvNpV89RZ-image.png)
            - [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/zQfGUQXnsovVEjNn-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/zQfGUQXnsovVEjNn-image.png)

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

#### **Cenário: Consulta CCB**

Neste cenário iremos acessar a tela e verificar suas funções;

##### **Acessando a funcionalidade**

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

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

- Após acessar a tela será exibida as seguintes informações:

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

1- Campo de CNPJ (\*Obrigatório, com prompt para pesquisar CNPJ's que possem cadastro no sistema)  
2- Botão de Pesquisar, ao apertar irá buscar as informações do CNPJ informado;  
3- Botão Fechar, irá voltar para a tela anterior;

- Exemplo buscando o CNPJ pela lupa;

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

- Selecionar o cliente desejado e Selecionar;

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

- Após selecionar apertar em "Pesquisar CCB";

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

- Mensagem de confirmação:

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

- Dados retornados conforme Webservice:

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

- Exemplo ao consultar um CNPJ que possui cadastro;

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

#### **Cenário: Log de Consulta CCB**

Neste cenário iremos acessar a tela e verificar suas funções;

##### **Acessando a funcionalidade**

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

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

- Ao acessar a tela podemos confirmar as seguintes informações;

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

1- Combo para filtrar os dados do grid, sendo eles (Pesquisar CNPJ ou Razão, Status e Data da consulta);  
2- Botão de consulta o histórico gerado na data da consulta do CCB;  
3- Botão para extrair as consultas exibidas no grid para um relatório em Excel;  
4- Campo informando o CNPJ consultado;  
5- Campo informando a razão social consultado (caso apresente "N/A" não foi encontrado no CCB);  
6- Campo informando a data da consulta;  
7- Campo informativo do usuário da Consulta;  
8- Campo informando o Status do retorno do Webservice do CCB;

- Exemplo botão em Excel;

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

- Exemplo botão de consulta;

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

#### **Outras Considerações**

- **Códigos de possíveis validações a serem retornados do CCB, porem não foi encontrado CNPJ com alguns cenários;**
    - **![Image](https://dev.azure.com/azsendDevErp/b9102146-f6e9-4e31-bd15-a33b800b6b24/_apis/wit/attachments/fe216eba-23d6-406a-9691-eec7313d9938?fileName=image.png)**
- **Caso seja necessário configurar/alterar informações referentes ao Webservice, estará disponível no caminho abaixo;**
    - [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/uMfKu89xYDm6JgR5-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/uMfKu89xYDm6JgR5-image.png)
    - [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/1i9KehUX96wR1DR6-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/1i9KehUX96wR1DR6-image.png)
    - [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/okB7SAVFZLygHFTi-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/okB7SAVFZLygHFTi-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>