Tarefas
Webservice: Método gravaTarefa
Este método permite a criação automatizada de eventos no Procedo, podendo ser do tipo Tarefa (T) ou Compromisso/Evento (C). As tarefas podem ser vinculadas a clientes (emitentes), prospects ou oportunidades específicas.
1. Informações de Conexão
URL WSDL:
https://app.procedo.com.br/api/tarefaservice?wsdlTecnologia: SOAP
Observação: O token de segurança deve ser solicitado via
[email protected].
2. Parâmetros e Regras Condicionais
Parâmetro | Obrigatório | Formato | Descrição |
token | Sim | String | Identificador único da empresa. |
tipo | Sim | String | T para Tarefa ou C para Compromisso/Evento. |
entidade | Não | String | Opções: |
dtinicio | Sim | Date | Data de início (yyyy-mm-dd). |
dttermino | Parcial | Date | Obrigatória se o evento for de "dia inteiro". |
hrinicio / hrtermino | Parcial | Time | Obrigatórios para Compromissos (C). Podem ser vazios para Tarefas (T). |
diainteiro | Não | Int | 1 = Sim (ignora horários) / 0 = Não. |
lembrete | Não | Int | Tempo em minutos antes do evento (Ex: 60 para 1 hora). |
responsavel | Sim | Int | Código do usuário responsável no Procedo. |
Nota importante: Caso os horários de início e término sejam enviados iguais, o sistema definirá automaticamente o término para 30 minutos após o início.
3. Códigos de Retorno
1: Ok, registro inserido.
9: Tipo informado inválido (deve ser T ou C).
10: Entidade inválida (deve ser emitente ou oportunidade).
12/13: Data ou Horário de término inferior ao de início.
16/17: Data de início não informada ou formato inválido.
4. Exemplo de Requisição (Compromisso vinculado a Oportunidade)
<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL" xmlns:tar="http://localhost.procedo.com.br/api/tarefaservice?wsdl">
<x:Header/>
<x:Body>
<urn:gravaTarefa>
<urn:token>SEU_TOKEN_AQUI</urn:token>
<urn:tarefa>
<tar:tipo>C</tar:tipo>
<tar:entidade>oportunidade</tar:entidade>
<tar:codentidade>1093</tar:codentidade>
<tar:assunto>Reunião de Alinhamento</tar:assunto>
<tar:dtinicio>2026-03-05</tar:dtinicio>
<tar:dttermino>2026-03-05</tar:dttermino>
<tar:hrinicio>14:00</tar:hrinicio>
<tar:hrtermino>15:00</tar:hrtermino>
<tar:diainteiro>0</tar:diainteiro>
<tar:responsavel>39</tar:responsavel>
<tar:descricao>Discussão técnica sobre a integração.</tar:descricao>
</urn:tarefa>
</urn:gravaTarefa>
</x:Body>
</x:Envelope>
5. Exemplo de Retorno com Sucesso
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<ns1:gravaTarefaResponse xmlns:ns1="urn:SOAPServerWSDL">
<return xsi:type="xsd:string">1</return>
</ns1:gravaTarefaResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>