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 camposcotacaoeversao.Oportunidade Perdida (
situacao= 2): É obrigatório preencher o campoobservacao. Os camposmotivoPerdaeconcorrentesã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)
<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>