# Webservice: Método gravaContato

Método para inserção ou atualização completa de dados de contatos (Pessoa ou Empresa).

## 1. Regras Importantes

* **Obrigatórios:** `token` e `usuario` (E-mail do responsável).
* **Condicionais:** Se `tipo_pessoa` for "Empresa", `nome_fantasia` é obrigatório. Se for "Pessoa", `razao_social` (Nome) é obrigatório.
* **Endereço:** Siglas de estado (ex: SP) são obrigatórias para validar o endereço.
* **Vínculos Dinâmicos:** Se `ramoatividade`, `origem` ou `regiao` não existirem no sistema, o Procedo os criará automaticamente.

## 2. Códigos de Retorno

* **1:** Ok, registro inserido/atualizado.
* **2:** E-mail do usuário responsável não localizado.
* **3:** Faltam campos obrigatórios (`nome_fantasia` ou `razao_social`).
* **9:** CNPJ duplicado ou erro interno de gravação.

## 3. Exemplo de Requisição

```javascript
<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SOAPServerWSDL">
    <x:Header/>
    <x:Body>
        <urn:gravaContato>
            <urn:token>SEU_TOKEN_AQUI</urn:token>
            <urn:usuario>vendedor@empresa.com.br</urn:usuario>
            <urn:tipo_pessoa>Empresa</urn:tipo_pessoa>
            <urn:nome_fantasia>Procedo Tecnologia</urn:nome_fantasia>
            <urn:cnpj>00.000.000/0001-00</urn:cnpj>
            <urn:estado>SP</urn:estado>
            <urn:cidade>Bauru</urn:cidade>
            <urn:fase>prospect</urn:fase>
        </urn:gravaContato>
    </x:Body>
</x: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)