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)

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