Webservice: Método listaContato

Este método retorna uma lista de contatos do Procedo. É ideal para sincronização inicial ou busca de dados específicos.

1. Informações de Conexão

  • URL WSDL: https://app.procedo.com.br/api/contatoservice?wsdl

  • Limite: Retorno máximo de 50 registros por requisição.

    • Regra 1: Só vem cliente que não foram integrados ainda ou que a data de integração é menor do que a ultima atualização feita no registro Regra

    • Regra 2: Se não for enviado nenhuma fase, ele limita apenas os registros na fase 'Cliente'.

  • Nota: Para Pessoa Física, o campo CNPJ retorna o CPF e inscricao_estadual retorna o RG.

2. Parâmetros e Retornos

Parâmetro

Obrigatório

Descrição

token

Sim

Identificador único da empresa.

situacao

Não

Filtro por nomes de situações (Ex: "Contatado, Novo").

fase

Não

Nome da fase (Padrão: "Cliente").

cod_contato

Não

Código específico de um contato.

Códigos de Retorno: 0 (Token inválido), 1 (Ok), 2 (Situação não encontrada), 9 (Nenhum registro), 35 (Sem acesso).

3. Exemplo de Requisição (SoapUI)

<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
    <x:Header/>
    <x:Body>
        <urn:listaContato>
            <urn:token>SEU_TOKEN_AQUI</urn:token>
            <urn:situacao>Contatado, Novo</urn:situacao>
            <urn:fase>Prospect</urn:fase>
            <urn:cod_contato></urn:cod_contato>
        </urn:listaContato>
    </x:Body>
</x:Envelope>