# 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 `suporte@procedo.com.br`.

## 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)

```javascript
<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

```javascript
<?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>
```

---

**Documents**

- [Changelog](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/changelog-Zm8YRaLsX2)
- [Comercial e Vendas](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/comercial-e-vendas-mLzQaeyoTV)
- [Configurações Gerais](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/configuracoes-gerais-J7dm490z1m)
- [Gestão de Relacionamento (CRM)](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/gestao-de-relacionamento-crm-74VyXWo680)
- [Integrações](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/integracoes-zJfkJOXdix)
- [Operações e Produtividade](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/operacoes-e-produtividade-k2U2Vd3Fk8)
- [Projetos](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/projetos-jaD6SWGAB9)
- [Relatórios](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/relatorios-uab6Sta2qa)