# Integração de Análise de Crédito - SOA WebServices
## Introdução

>[!TIP] SOA WebServices
>A **[SOA WebServices](https://www.soawebservices.com.br/)** é uma empresa especializada em soluções de análise de crédito e consultas cadastrais online. Seu site, [https://www.soawebservices.com.br/](https://www.soawebservices.com.br/), oferece uma plataforma abrangente de serviços web para empresas que necessitam de informações confiáveis para tomada de decisões financeiras e comerciais.

A integração com a plataforma **[SOA WebServices](https://www.soawebservices.com.br/)** no sistema é voltada para a análise de crédito no sistema. Esta ferramenta tem como principal objetivo aprimorar o processo de avaliação da saúde financeira e confiabilidade de clientes, promovendo um melhor gerenciamento financeiro à organização.

A integração com a plataforma SOA WebService permite realizar consultas de CPF/CNPJs para clientes, oportunidades/leads e prospecções. Além disso, permite realizar a restrição cadastral de clientes em situações de inadimplência. O objetivo é obter informações creditícias confiáveis para auxiliar na tomada de decisão sobre concessão de crédito e condições comerciais.


>[!INFO] Análise de crédito:
> Esta integração faz parte do módulo de Análise de Crédito do sistema.

> [!NOTA] Acesso à Configuração
> Caminho: Configurações > Integrações > Integração análise de crédito > Alterar Senha Consulta/Alterar Senha Pefin

## Entrega de Valor
- **Gestão de risco aprimorada**: Ao avaliar o histórico financeiro de potenciais clientes, o provedor pode tomar decisões mais informadas sobre contratos e planos de serviço. Isso reduz significativamente o risco de inadimplência e permite a personalização de ofertas com base no perfil creditício do cliente;
- **Agilidade na aprovação**: Facilita e acelera o processo de análise e aprovação de novos clientes, aumentando a eficiência operacional.
- **Proteção financeira:** Permite a negativação de clientes inadimplentes, proporcionando uma camada adicional de proteção ao crédito, contribuindo para a saúde financeira do provedor, auxiliando a manter preços competitivos para clientes inadimplentes.
## Estrutura do Formulário
O formulário está estruturado em uma grid, que reúne as informações de todas integrações cadastradas. Esta grid está organizada em linhas e colunas e cada registro individual corresponde ao mesmo formulário que armazena os detalhes das integrações.

Ao visualizar um registro individualmente, o formulário está estruturado em uma aba principal: **Integração análise de crédito**. A aba está relacionada ao cadastro da integração, que por sua vez, tem como objetivo viabilizar os processos de consultas de documentos, negativações e baixas de negativações diretamente pelo sistema.

### Aba Integração análise de crédito
Esta aba é composta por campos específicos relacionados à integração de uma plataforma de análise de crédito, visando a configuração dos dados de acesso e parâmetros da integração. 

### Campos principais

| Campo                           | Descrição                                                                  |
| ------------------------------- | -------------------------------------------------------------------------- |
| ID                              | Identificador numérico da integração, gerado automaticamente pelo sistema. |
| Intermediador                   | Provedor do serviço de análise de crédito.                                 |
| Filial                          | Filial da empresa que está configurando a integração.                      |
| Ambiente                        | Ambiente de operação (Produção ou Homologação).                            |
| E-mail                          | E-mail de acesso para a integração.                                        |
| Senha                           | Senha de acesso à plataforma.                                              |
| Saldo                           | Saldo disponível na plataforma.                                            |
| Incluir/Remover automaticamente | Opção para inclusão/remoção automática de negativações.                    |
| Código de Restrição             | Código associado à restrição de crédito.                                   |
| Código para Baixa               | Código associado à baixa de restrições.                                    |

## Processo de Integração
Para realizar a integração entre o sistema e a plataforma Crédito na Medida, siga os passos a seguir:

1. Acesse o formulário **Integrações de Análise de Crédito** através do caminho: Configurações > Integrações > Integrações de análise de crédito
2. Clique em **Novo** para registrar a integração da SOA WebServices no sistema;
3. Preencha os campos conforme apresentados:
	- **Intermediador:** marque a opção SOA WebServices;
	- **Filial:** clique sobre a lupa e indique a filial da qual será associada à esta integração;
	- **Ambiente:** defina se é um ambiente de testes (homologação) ou se a plataforma já está em uso efetivamente (produção);
	- **E-mail:** insira o e-mail de acesso à plataforma, fornecido pela plataforma;
	- **Senha:** insira a senha de acesso à plataforma, fornecida pela plataforma;
	  
	 **Campos de preenchimento automático:**
	- **Saldo:** indica o saldo disponível na plataforma, para realizar consultas e negativações;
	  
	**Seção Inclusão/Exclusão automática:**
	- **Incluir/Remover automaticamente:** se marcado como **sim**, ocorrerá a negativação e baixa automáticas pelos [[parametros de cobranca|Parâmetros de Cobrança]], através da [[rotina de cobranca (crm de cobranca)|Rotina de Cobrança (CRM de Cobrança)]], no etapa 5 de cobrança (Enviar análise de crédito/Cartório);
	- **Código de restrição:** identificador que indica a restrição cadastral (negativação) devido à pendência financeira. Insira um código padrão para as negativações automáticas;
	- **Código para baixa:** identificador que indica o motivo da baixa da negativação devido à pendência financeira, exemplo: código n° X - pagamento da dívida. Insira um código padrão para as remoções automáticas; 
	  
4. Clique em **Salvar** para finalizar o cadastro da integração
5. Acesse a filial vinculada na integração através do caminho: Configurações > Empresa > Filiais 
6. Após, selecione a filial, clique em **Editar** e vá até a aba **Integrações**
7. Na aba **Integrações**, no campo **Integração de análise de crédito**, vincule a integração de análise de crédito cadastrada
8. Clique em **Salvar** para validar as alterações e finalizar o cadastro da integração

Após finalizar as configurações, a integração já estará disponível para uso no sistema.

## Casos de uso

>[!EXAMPLE] Casos de uso:
>- [[negativacao manual de cliente|Negativação Manual de Cliente]];
>- [[negativacao automatica|Negativação Automática]];
>- [[remocao manual de negativacoes|Remoção Manual de Negativações]];
>- [[remocao automatica de negativacoes|Remoção Automática de Negativações]].

### Considerações importantes
- Ao baixar um boleto que foi negativado manualmente, a negativação não é baixada automaticamente, sendo necessário realizar a baixa manual da negativação através do processo descrito na documentação: [[remocao manual de negativacoes|Remoção Manual de Negativações]]. Este recurso é válido para todas as integrações de análise de crédito.
- Ao utilizar a integração de análise de crédito com  SOA WebServices, é necessário realizar a configuração da tarefa [[tarefa - consultar negativacao serasa|Tarefa - Consultar Negativação Serasa]] para manter atualizados os status das negativações, a fim de sincronizar os dados entre o sistema e a plataforma.


## Fluxos de Trabalho

```mermaid
graph TD
    A[Cliente identifica a necessidade de realizar consultas e negativações de crédito] --> B[Realiza o credenciamento com a plataforma de análise de crédito]
    B --> C[Realiza o cadastro da integração no sistema]
    
    %% Ramificação para consultas de análise de crédito
    C --> D[Realiza consultas de análise de crédito]
    D --> E[Consulta em leads]
    D --> F[Consulta em prospecções]
    D --> G[Consulta em clientes]

    %% Fluxo para negativação manual
    C --> H[Realiza a negativação manual de clientes inadimplentes]
    H --> I{Cliente realizou o pagamento?}
    I -->|Sim| Q[Realiza a baixa manual da negativação]
    I -->|Não| J[Processo finalizado]

    %% Verificação de rotina de cobrança
    C --> K{Utiliza rotina de cobrança?}
    K -->|Sim| L[Configura negativação automática]
    L --> M[Cliente entra em cobrança]
    M --> N[Negativação automática]
    N --> O{Cliente realizou o pagamento?}
    O -->|Sim| P[Baixa automática]
    O -->|Não| J[Negativação ativa]

```

## Considerações Finais
A integração com a plataforma SOA WebServices permite uma análise de crédito rápida e confiável, auxiliando na redução de riscos e na agilidade dos processos comerciais. É importante manter as credenciais de acesso atualizadas e monitorar os logs de consulta para garantir o correto funcionamento da integração.

## Etiquetas
#Integracoes #IntegracaoAnaliseDeCredito #SoaWebServices #ConsultaDeCredito #Negativacao #BaixaDeNegativacao  
## Leia Também
- [[integracoes|Integrações]]
- [[parametros de cobranca|Parâmetros de Cobrança]]
- [[rotina de cobranca (crm de cobranca)|Rotina de Cobrança (CRM de Cobrança)]]
- [[integracoes de analise de credito|Integrações de Análise de Crédito]]
- [[aba (consultas de analise de credito) no lead|Aba (Consultas de análise de crédito) no Lead]]
- [[aba consultas analise de credito - cliente|Aba Consultas Análise de Crédito - Cliente]]
- [[aba (consultas de analise de credito) na prospeccao|Aba (Consultas de Análise de Crédito) na Prospecção]]
- [[consulta de analise de credito pelo cadastro do cliente|Consulta de Análise de Crédito pelo Cadastro do Cliente]]
- [[consulta de analise de credito pelo cadastro da prospeccao|Consulta de análise de crédito pelo Cadastro da Prospecção]]
- [[consulta de analise de credito pelo cadastro do lead|Consulta de análise de crédito pelo Cadastro do Lead]]
- [[relatorio de consultas analise de credito|Relatório de Consultas Análise de Crédito]]
- [[relatorio de negativacoes de credito|Relatório de Negativações de Crédito]]
- [[negativacao manual de cliente|Negativação Manual de Cliente]]
- [[remocao manual de negativacoes|Remoção Manual de Negativações]]
- [[negativacao automatica|Negativação Automática]]
- [[remocao automatica de negativacoes|Remoção Automática de Negativações]]
- [[alteracao de senhas na integracao connect sa|Alteração de Senhas na Integração Connect SA]]
- [[reenvio de negativacoes com erro - connect sa|Reenvio de Negativações com Erro - Connect SA]]
- [[tarefa - consultar negativacao serasa|Tarefa - Consultar Negativação Serasa]]