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

  • Tecnologia: 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: emitente, oportunidade ou NULL.

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>