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 [email protected].

  • 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):

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

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