# Webservice: Método listaOportunidade

Este método retorna uma lista de oportunidades do Procedo, permitindo filtrar por registros pendentes de integração, vencidos ou perdidos.

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

* **URL WSDL:** `https://app.procedo.com.br/api/oportunidadeservice?wsdl`
* **Observação:** Solicite seu token de segurança através do e-mail `suporte@procedo.com.br`.
* **Limite:** O retorno é limitado a **50 oportunidades** por requisição. Para grandes volumes, a integração deve ser feita em lotes de 50 até que não restem registros.

## 2. Parâmetros e Retornos

| **Parâmetro** | **Obrigatório** | **Formato** | **Descrição** |
|-----------|-------------|---------|-----------|
| **token** | Sim         | String  | Identificador único da empresa. |
| **situacao** | Sim         | Int     | 0=Ativas; 1=Vencidas; 2=Perdidas. |

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

## 3. Exemplo de Requisição e Retorno

**Requisição (SoapUI):**

```javascript
<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
    <x:Header/>
    <x:Body>
        <urn:listaOportunidade>
            <urn:token>SEU_TOKEN_AQUI</urn:token>
            <urn:situacao>0</urn:situacao>
        </urn:listaOportunidade>
    </x:Body>
</x:Envelope>
```

**Retorno com Sucesso:**

```javascript
<ns1:listaOportunidadeResponse xmlns:ns1="urn:SOAPServerWSDL">
    <return xsi:type="xsd:int">1</return>
    <mensagem xsi:type="xsd:int">OK</mensagem>
    <return xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="tns:Oportunidade[1]">
        <item xsi:type="tns:Oportunidade">
            <codigo>8</codigo>
            <nome>Projeto abc</nome>
            <valor>9980.00</valor>
            <data_prevista>2017-02-10</data_prevista>
            <responsavel>Ubaldo</responsavel>
            <situacao>Ativa</situacao>
        </item>
    </return>
</ns1:listaOportunidadeResponse>
```

---

**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)