# Webservice: Método listaContato

Este método retorna uma lista de contatos do Procedo. É ideal para sincronização inicial ou busca de dados específicos.

## 1. Informações de Conexão

* **URL WSDL:** `https://app.procedo.com.br/api/contatoservice?wsdl`
* **Limite:** Retorno máximo de 50 registros por requisição.
  * Regra 1: Só vem cliente que não foram integrados ainda ou que a data de integração é menor do que a ultima atualização feita no registro Regra 
  * Regra 2:  Se não for enviado nenhuma fase, ele limita apenas os registros na fase 'Cliente'.
* **Nota:** Para Pessoa Física, o campo `CNPJ` retorna o CPF e `inscricao_estadual` retorna o RG.

## 2. Parâmetros e Retornos

| **Parâmetro** | **Obrigatório** | **Descrição** |
|-----------|-------------|-----------|
| **token** | Sim         | Identificador único da empresa. |
| **situacao** | Não         | Filtro por nomes de situações (Ex: "Contatado, Novo"). |
| **fase**  | Não         | Nome da fase (Padrão: "Cliente"). |
| **cod_contato** | Não         | Código específico de um contato. |

**Códigos de Retorno:** `0` (Token inválido), `1` (Ok), `2` (Situação não encontrada), `9` (Nenhum registro), `35` (Sem acesso).

## 3. Exemplo de Requisição (SoapUI)

```javascript
<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
    <x:Header/>
    <x:Body>
        <urn:listaContato>
            <urn:token>SEU_TOKEN_AQUI</urn:token>
            <urn:situacao>Contatado, Novo</urn:situacao>
            <urn:fase>Prospect</urn:fase>
            <urn:cod_contato></urn:cod_contato>
        </urn:listaContato>
    </x:Body>
</x:Envelope>
```

---

**Documents**

- [Changelog](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/changelog-Zm8YRaLsX2)
- [Comercial e Vendas](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/comercial-e-vendas-mLzQaeyoTV)
- [Configurações Gerais](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/configuracoes-gerais-J7dm490z1m)
- [Gestão de Relacionamento (CRM)](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/gestao-de-relacionamento-crm-74VyXWo680)
- [Integrações](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/integracoes-zJfkJOXdix)
- [Operações e Produtividade](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/operacoes-e-produtividade-k2U2Vd3Fk8)
- [Projetos](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/projetos-jaD6SWGAB9)
- [Relatórios](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/relatorios-uab6Sta2qa)