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?wsdlObservaçã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>