# Webservice: Método encerraOportunidade

Método utilizado para finalizar uma oportunidade como Vencida ou Perdida. Ao encerrar, um histórico é criado automaticamente no sistema.

## 1. Regras de Negócio

* **Oportunidade Vencida (**`**situacao**` **= 1):** É obrigatório informar os campos `cotacao` e `versao`.
* **Oportunidade Perdida (**`**situacao**` **= 2):** É obrigatório preencher o campo `observacao`. Os campos `motivoPerda` e `concorrente` são opcionais e criam novos registros no Procedo caso não existam.

## 2. Parâmetros Principais

| **Parâmetro** | **Obrigatório** | **Descrição** |
|-----------|-------------|-----------|
| **token** | Sim         | Identificador único da empresa. |
| **oportunidade** | Sim         | Código da oportunidade no Procedo. |
| **situacao** | Sim         | 1 = Vencida; 2 = Perdida. |
| **cotacao / versao** | Parcial     | Obrigatório apenas se a situação for 1 (Vencida). |
| **observacao** | Parcial     | Obrigatório apenas se a situação for 2 (Perdida). |

**Códigos de Retorno:** `3` (Observação nula na perda), `4` (Cotação/Versão não encontrada), `5` (Cotação não pertence à oportunidade), `7` (Já encerrada).

## 3. Exemplo de Requisição (Encerrando como Perdida)

```javascript
<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
    <x:Header/>
    <x:Body>
        <urn:encerraOportunidade>
            <urn:token>SEU_TOKEN_AQUI</urn:token>
            <urn:oportunidade>946</urn:oportunidade>
            <urn:situacao>2</urn:situacao>
            <urn:motivo_perda>Valor elevado</urn:motivo_perda>
            <urn:concorrente>Concorrente 1</urn:concorrente>
            <urn:observacao>Concorrente ofereceu orçamento melhor</urn:observacao>
        </urn:encerraOportunidade>
    </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)