Com o serviço web SOAP (Simple Object Access Protocol) é possível realizar o cadastro de Prospects sem a necessidade de estar no sistema. Este recurso é utilizado para fazer integração e/ou automatização de processos de qualquer sistema com o Procedo, por exemplo: em seu site há um formulário de contato, é possível que, ao enviar o formulário, um Prospect seja gerado no Procedo.

Para isso, seria necessário customizar o formulário para que essas informações sejam enviadas à Procedo. Vale ressaltar que algumas informações são obrigatórias, veja abaixo:

Nome: Potencialservice

Tecnologia: Webservice SOAP

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

Objetivo: possibilitar o cadastro de um prospect no Procedo através de um site, landing page ou outro sistema.

Observação: solicite seu token de segurança para utilizar os métodos do webservice [email protected]

Métodos

Método: gravaPotencial

Descrição: método responsável por adicionar um novo Prospect no Procedo.

Parâmetro  Obrigatório Formato Descrição
token sim String Identificado único da empresa para uso do método
potencial sim Array Conterá as tags que compõem os dados do prospect
codigo não Int Código numérico que determina a identificação do prospect na procedo
nome_fantasia não String Nome fantasia
cidade não String Nome da cidade
estado não String Nome do estado. Deve ser escrito no formato de sigla, exemplo: SP
email não String E-mail para contato
telefone não Int Telefone para contato. Somente números
obs não String Texto de observação
usuario sim Int Código do usuário cadastrado no Procedo
origem sim Int Código da origem cadastrada no Procedo
nome_contato não String Nome do contato

Obs.: os campos “cidade” e “estado” trabalham em conjunto, ou seja, o sistema realizará uma consulta afim de verificar se a essas informações são válidas. Caso a cidade ou o estado não estiverem cadastrados, será adicionado uma mensagem junto ao campo “obs”.

Todos os registros inserido através deste recurso são considerados públicos, ou seja, qualquer usuário poderá acessá-los.

Retorno

Código/String Retorno
0 Token inválido, neste caso é necessário entrar em contato novamente para obter o código de acesso
1 Ok, o registro foi inserido
35 Empresa sem acesso a funcionalidade solicitada
Usuário não pode ser nulo Caso o campo usuário ou origem não seja informado
Usuário inválido Caso o código informado não seja localizado no sistema

Exemplo

Exemplo de requisição com as informações sendo enviadas através do SoapUI:

<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL" xmlns:pot="https://app.procedo.com.br/api/potencialservice?wsdl">
    <x:Header/>
    <x:Body>
        <urn:gravaPotencial>
            <urn:token>1ff1de77400w5f8da163rgf4294388881c68755fQABR</urn:token>
            <urn:potencial>
                <pot:codigo>1000</pot:codigo>
                <pot:nome_fantasia>Exemplo Potencial Service</pot:nome_fantasia>
                <pot:cidade>Bauru</pot:cidade>
                <pot:estado>SP</pot:estado>
                <pot:email>[email protected]</pot:email>
                <pot:telefone>14912345789</pot:telefone>
                <pot:obs>N/A</pot:obs>
                <pot:usuario>39</pot:usuario>
                <pot:origem>1</pot:origem>
                <pot:nome_contato></pot:nome_contato>
            </urn:potencial>
        </urn:gravaPotencial>
    </x:Body>
</x:Envelope>

Agora o exemplo de retorno com sucesso:

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <ns1:gravaPotencialResponse xmlns:ns1="urn:SOAPServerWSDL">
            <return xsi:type="xsd:string">1</return>
        </ns1:gravaPotencialResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Exemplo em php

<?php

$client = new SoapClient( 'https://app.procedo.com.br/api/potencialservice?wsdl' );

$arguments = [
        'token' => '1ff1de77400w5f8da163rgf4294388881c68755fQABR',
        'potencial' => [
                'codigo' => '',
                'cidade' => 'Bauru',
                'estado' => 'SP',
                'email' => '[email protected]',
                'telefone' => '1135804396',
                'obs' => 'Lorem ipsum dolor sit amet, consectetur adipiscing elit',
                'nome_fantasia' => 'João e Luana Contábil Ltda',
                'contato' => 'Bianca',
                'usuario' => 1, //Código do usuário responsável
                'origem' => 3 //Código da origem no sistema
        ]
];
$options = ['location' => 'https://app.procedo.com.br/api/potencialservice?wsdl'];
$function = 'gravaPotencial';

$result = $client->__soapCall( $function, $arguments, $options );
print_r( $result );

 

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *