CRM · contatos

Operações relacionadas a CRM - Contatos

POSThttps://app.omie.com.br/api/v1/crm/contatos/WSDL

3consultas

4alterações

Claude · MCPpelos assistentes de IA

JSON · XMLformato

AlterarContato

altera dadosClaudeMCP

Altera um Contato

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 4Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cObs`	texto	Observações.
`endereco`	objeto
`endereco.cBairro`	texto · até 60	Bairro
`endereco.cCEP`	texto · até 10	CEP
`endereco.cCidade`	texto · até 50	Cidade
`endereco.cCompl`	texto · até 200	Complemento
`endereco.cEndereco`	texto · até 200	Endereço do contato
`endereco.cPais`	texto · até 50	País
`endereco.cUF`	texto · até 50	Estado
`identificacao`	objeto
`identificacao.cCargo`	texto · até 60	Cargo
`identificacao.cCodInt`	texto	Código de Integração
`identificacao.cNome`	texto · até 60	Nome do contato
`identificacao.cSobrenome`	texto · até 60	Sobrenome do contato
`identificacao.dDtNasc`	texto · até 10	Data de Nascimento
`identificacao.nCod`	número inteiro	Código do Contato
`identificacao.nCodConta`	número inteiro	Código da Conta
`identificacao.nCodVend`	número inteiro	Código do Vendedor
`telefone_email`	objeto
`telefone_email.cDDDCel1`	texto · até 5	DDD do celular
`telefone_email.cDDDCel2`	texto · até 5	DDD do Celular
`telefone_email.cDDDFax`	texto · até 5	DDD do Fax
`telefone_email.cDDDTel`	texto · até 5	DDD do Telefone
`telefone_email.cEmail`	texto · até 200	E-mail do contato
`telefone_email.cNumCel1`	texto · até 15	Número do Celular
`telefone_email.cNumCel2`	texto · até 15	Número do Celular
`telefone_email.cNumFax`	texto · até 15	Número do Fax
`telefone_email.cNumTel`	texto · até 15	Número do Telefone
`telefone_email.cWebsite`	texto · até 100	WebSite

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodInt`	texto	Código de Integração
`cCodStatus`	texto	Código do Status
`cDesStatus`	texto	Descrição do Status
`nCod`	número inteiro	Código do contato

POST /api/v1/crm/contatos/

curl -s https://app.omie.com.br/api/v1/crm/contatos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AlterarContato", "param": [{"identificacao": {"cCodInt": "", "cNome": "", "cSobrenome": "", "cCargo": "", "dDtNasc": "", "nCodVend": 0, "nCodConta": 0}, "endereco": {"cEndereco": "", "cCompl": "", "cCEP": "", "cBairro": "", "cCidade": "", "cUF": "", "cPais": ""}, "telefone_email": {"cDDDCel1": "", "cNumCel1": "", "cEmail": "", "cWebsite": ""}}]}'

import os
import requests

corpo = {'call': 'AlterarContato',
 'param': [{'identificacao': {'cCodInt': '',
                              'cNome': '',
                              'cSobrenome': '',
                              'cCargo': '',
                              'dDtNasc': '',
                              'nCodVend': 0,
                              'nCodConta': 0},
            'endereco': {'cEndereco': '',
                         'cCompl': '',
                         'cCEP': '',
                         'cBairro': '',
                         'cCidade': '',
                         'cUF': '',
                         'cPais': ''},
            'telefone_email': {'cDDDCel1': '',
                               'cNumCel1': '',
                               'cEmail': '',
                               'cWebsite': ''}}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/crm/contatos/",
    headers={"Authorization": f"Bearer {os.environ['TOKEN_DO_APLICATIVO']}"},
    json=corpo,
    timeout=60,
)
print(resp.json())

const resp = await fetch("https://app.omie.com.br/api/v1/crm/contatos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "AlterarContato",
    "param": [
      {
        "identificacao": {
          "cCodInt": "",
          "cNome": "",
          "cSobrenome": "",
          "cCargo": "",
          "dDtNasc": "",
          "nCodVend": 0,
          "nCodConta": 0
        },
        "endereco": {
          "cEndereco": "",
          "cCompl": "",
          "cCEP": "",
          "cBairro": "",
          "cCidade": "",
          "cUF": "",
          "cPais": ""
        },
        "telefone_email": {
          "cDDDCel1": "",
          "cNumCel1": "",
          "cEmail": "",
          "cWebsite": ""
        }
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/crm/contatos/");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("TOKEN_DO_APLICATIVO"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "call": "AlterarContato",
    "param": [
        {
            "identificacao": {
                "cCodInt": "",
                "cNome": "",
                "cSobrenome": "",
                "cCargo": "",
                "dDtNasc": "",
                "nCodVend": 0,
                "nCodConta": 0
            },
            "endereco": {
                "cEndereco": "",
                "cCompl": "",
                "cCEP": "",
                "cBairro": "",
                "cCidade": "",
                "cUF": "",
                "cPais": ""
            },
            "telefone_email": {
                "cDDDCel1": "",
                "cNumCel1": "",
                "cEmail": "",
                "cWebsite": ""
            }
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/crm/contatos/")
corpo = <<~'JSON'
{
  "call": "AlterarContato",
  "param": [
    {
      "identificacao": {
        "cCodInt": "",
        "cNome": "",
        "cSobrenome": "",
        "cCargo": "",
        "dDtNasc": "",
        "nCodVend": 0,
        "nCodConta": 0
      },
      "endereco": {
        "cEndereco": "",
        "cCompl": "",
        "cCEP": "",
        "cBairro": "",
        "cCidade": "",
        "cUF": "",
        "cPais": ""
      },
      "telefone_email": {
        "cDDDCel1": "",
        "cNumCel1": "",
        "cEmail": "",
        "cWebsite": ""
      }
    }
  ]
}
JSON

resp = Net::HTTP.post(uri, corpo,
  "Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
  "Content-Type" => "application/json")
puts resp.body

import java.net.URI;
import java.net.http.*;

var corpo = """
{
  "call": "AlterarContato",
  "param": [
    {
      "identificacao": {
        "cCodInt": "",
        "cNome": "",
        "cSobrenome": "",
        "cCargo": "",
        "dDtNasc": "",
        "nCodVend": 0,
        "nCodConta": 0
      },
      "endereco": {
        "cEndereco": "",
        "cCompl": "",
        "cCEP": "",
        "cBairro": "",
        "cCidade": "",
        "cUF": "",
        "cPais": ""
      },
      "telefone_email": {
        "cDDDCel1": "",
        "cNumCel1": "",
        "cEmail": "",
        "cWebsite": ""
      }
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/crm/contatos/"))
    .header("Authorization", "Bearer " + System.getenv("TOKEN_DO_APLICATIVO"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(corpo))
    .build();
var resp = HttpClient.newHttpClient().send(pedido, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

// TokenDoAplicativo: parâmetro do Power BI (Página Inicial > Gerenciar parâmetros)
let
    Resposta = Web.Contents(
        "https://app.omie.com.br/api/v1/crm/contatos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""AlterarContato"", ""param"": [{""identificacao"": {""cCodInt"": """", ""cNome"": """", ""cSobrenome"": """", ""cCargo"": """", ""dDtNasc"": """", ""nCodVend"": 0, ""nCodConta"": 0}, ""endereco"": {""cEndereco"": """", ""cCompl"": """", ""cCEP"": """", ""cBairro"": """", ""cCidade"": """", ""cUF"": """", ""cPais"": """"}, ""telefone_email"": {""cDDDCel1"": """", ""cNumCel1"": """", ""cEmail"": """", ""cWebsite"": """"}}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

ConsultarContato

consultaClaudeMCP

Consulta o Contato

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cCodInt`	texto	Código de Integração
`nCod`	número inteiro	Código do Contato

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cObs`	texto	Observações.
`endereco`	objeto
`endereco.cBairro`	texto	Bairro
`endereco.cCEP`	texto	CEP
`endereco.cCidade`	texto	Cidade
`endereco.cCompl`	texto	Complemento
`endereco.cEndereco`	texto	Endereço do contato
`endereco.cPais`	texto	País
`endereco.cUF`	texto	Estado
`identificacao`	objeto
`identificacao.cCargo`	texto	Cargo
`identificacao.cCodInt`	texto	Código de Integração
`identificacao.cNome`	texto	Nome do contato
`identificacao.cSobrenome`	texto	Sobrenome do contato
`identificacao.dDtNasc`	texto	Data de Nascimento
`identificacao.nCod`	número inteiro	Código do Contato
`identificacao.nCodConta`	número inteiro	Código da Conta
`identificacao.nCodVend`	número inteiro	Código do Vendedor
`telefone_email`	objeto
`telefone_email.cDDDCel1`	texto	DDD do celular
`telefone_email.cDDDCel2`	texto	DDD do Celular
`telefone_email.cDDDFax`	texto	DDD do Fax
`telefone_email.cDDDTel`	texto	DDD do Telefone
`telefone_email.cEmail`	texto	E-mail do contato
`telefone_email.cNumCel1`	texto	Número do Celular
`telefone_email.cNumCel2`	texto	Número do Celular
`telefone_email.cNumFax`	texto	Número do Fax
`telefone_email.cNumTel`	texto	Número do Telefone
`telefone_email.cWebsite`	texto	WebSite

POST /api/v1/crm/contatos/

curl -s https://app.omie.com.br/api/v1/crm/contatos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ConsultarContato", "param": [{"nCod": 1, "cCodInt": ""}]}'

import os
import requests

corpo = {'call': 'ConsultarContato', 'param': [{'nCod': 1, 'cCodInt': ''}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/crm/contatos/",
    headers={"Authorization": f"Bearer {os.environ['TOKEN_DO_APLICATIVO']}"},
    json=corpo,
    timeout=60,
)
print(resp.json())

const resp = await fetch("https://app.omie.com.br/api/v1/crm/contatos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "ConsultarContato",
    "param": [
      {
        "nCod": 1,
        "cCodInt": ""
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/crm/contatos/");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("TOKEN_DO_APLICATIVO"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "call": "ConsultarContato",
    "param": [
        {
            "nCod": 1,
            "cCodInt": ""
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/crm/contatos/")
corpo = <<~'JSON'
{
  "call": "ConsultarContato",
  "param": [
    {
      "nCod": 1,
      "cCodInt": ""
    }
  ]
}
JSON

resp = Net::HTTP.post(uri, corpo,
  "Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
  "Content-Type" => "application/json")
puts resp.body

import java.net.URI;
import java.net.http.*;

var corpo = """
{
  "call": "ConsultarContato",
  "param": [
    {
      "nCod": 1,
      "cCodInt": ""
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/crm/contatos/"))
    .header("Authorization", "Bearer " + System.getenv("TOKEN_DO_APLICATIVO"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(corpo))
    .build();
var resp = HttpClient.newHttpClient().send(pedido, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

// TokenDoAplicativo: parâmetro do Power BI (Página Inicial > Gerenciar parâmetros)
let
    Resposta = Web.Contents(
        "https://app.omie.com.br/api/v1/crm/contatos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""ConsultarContato"", ""param"": [{""nCod"": 1, ""cCodInt"": """"}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

ExcluirContato

altera dadosClaudeMCP

Exclui um Contato

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cCodInt`	texto	Código de Integração
`nCod`	número inteiro	Código do Contato

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodInt`	texto	Código de Integração
`cCodStatus`	texto	Código do Status
`cDesStatus`	texto	Descrição do Status
`nCod`	número inteiro	Código do contato

POST /api/v1/crm/contatos/

curl -s https://app.omie.com.br/api/v1/crm/contatos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ExcluirContato", "param": [{"nCod": 0, "cCodInt": ""}]}'

import os
import requests

corpo = {'call': 'ExcluirContato', 'param': [{'nCod': 0, 'cCodInt': ''}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/crm/contatos/",
    headers={"Authorization": f"Bearer {os.environ['TOKEN_DO_APLICATIVO']}"},
    json=corpo,
    timeout=60,
)
print(resp.json())

const resp = await fetch("https://app.omie.com.br/api/v1/crm/contatos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "ExcluirContato",
    "param": [
      {
        "nCod": 0,
        "cCodInt": ""
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/crm/contatos/");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("TOKEN_DO_APLICATIVO"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "call": "ExcluirContato",
    "param": [
        {
            "nCod": 0,
            "cCodInt": ""
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/crm/contatos/")
corpo = <<~'JSON'
{
  "call": "ExcluirContato",
  "param": [
    {
      "nCod": 0,
      "cCodInt": ""
    }
  ]
}
JSON

resp = Net::HTTP.post(uri, corpo,
  "Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
  "Content-Type" => "application/json")
puts resp.body

import java.net.URI;
import java.net.http.*;

var corpo = """
{
  "call": "ExcluirContato",
  "param": [
    {
      "nCod": 0,
      "cCodInt": ""
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/crm/contatos/"))
    .header("Authorization", "Bearer " + System.getenv("TOKEN_DO_APLICATIVO"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(corpo))
    .build();
var resp = HttpClient.newHttpClient().send(pedido, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

// TokenDoAplicativo: parâmetro do Power BI (Página Inicial > Gerenciar parâmetros)
let
    Resposta = Web.Contents(
        "https://app.omie.com.br/api/v1/crm/contatos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""ExcluirContato"", ""param"": [{""nCod"": 0, ""cCodInt"": """"}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

IncluirContato

altera dadosClaudeMCP

Inclui um novo Contato

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 4Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cObs`	texto	Observações.
`endereco`	objeto
`endereco.cBairro`	texto · até 60	Bairro
`endereco.cCEP`	texto · até 10	CEP
`endereco.cCidade`	texto · até 50	Cidade
`endereco.cCompl`	texto · até 200	Complemento
`endereco.cEndereco`	texto · até 200	Endereço do contato
`endereco.cPais`	texto · até 50	País
`endereco.cUF`	texto · até 50	Estado
`identificacao`	objeto
`identificacao.cCargo`	texto · até 60	Cargo
`identificacao.cCodInt`	texto	Código de Integração
`identificacao.cNome`	texto · até 60	Nome do contato
`identificacao.cSobrenome`	texto · até 60	Sobrenome do contato
`identificacao.dDtNasc`	texto · até 10	Data de Nascimento
`identificacao.nCod`	número inteiro	Código do Contato
`identificacao.nCodConta`	número inteiro	Código da Conta
`identificacao.nCodVend`	número inteiro	Código do Vendedor
`telefone_email`	objeto
`telefone_email.cDDDCel1`	texto · até 5	DDD do celular
`telefone_email.cDDDCel2`	texto · até 5	DDD do Celular
`telefone_email.cDDDFax`	texto · até 5	DDD do Fax
`telefone_email.cDDDTel`	texto · até 5	DDD do Telefone
`telefone_email.cEmail`	texto · até 200	E-mail do contato
`telefone_email.cNumCel1`	texto · até 15	Número do Celular
`telefone_email.cNumCel2`	texto · até 15	Número do Celular
`telefone_email.cNumFax`	texto · até 15	Número do Fax
`telefone_email.cNumTel`	texto · até 15	Número do Telefone
`telefone_email.cWebsite`	texto · até 100	WebSite

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodInt`	texto	Código de Integração
`cCodStatus`	texto	Código do Status
`cDesStatus`	texto	Descrição do Status
`nCod`	número inteiro	Código do contato

POST /api/v1/crm/contatos/

curl -s https://app.omie.com.br/api/v1/crm/contatos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "IncluirContato", "param": [{"identificacao": {"cCodInt": "", "cNome": "", "cSobrenome": "", "cCargo": "", "dDtNasc": "", "nCodVend": 0, "nCodConta": 0}, "endereco": {"cEndereco": "", "cCompl": "", "cCEP": "", "cBairro": "", "cCidade": "", "cUF": "", "cPais": ""}, "telefone_email": {"cDDDCel1": "", "cNumCel1": "", "cEmail": "", "cWebsite": ""}}]}'

import os
import requests

corpo = {'call': 'IncluirContato',
 'param': [{'identificacao': {'cCodInt': '',
                              'cNome': '',
                              'cSobrenome': '',
                              'cCargo': '',
                              'dDtNasc': '',
                              'nCodVend': 0,
                              'nCodConta': 0},
            'endereco': {'cEndereco': '',
                         'cCompl': '',
                         'cCEP': '',
                         'cBairro': '',
                         'cCidade': '',
                         'cUF': '',
                         'cPais': ''},
            'telefone_email': {'cDDDCel1': '',
                               'cNumCel1': '',
                               'cEmail': '',
                               'cWebsite': ''}}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/crm/contatos/",
    headers={"Authorization": f"Bearer {os.environ['TOKEN_DO_APLICATIVO']}"},
    json=corpo,
    timeout=60,
)
print(resp.json())

const resp = await fetch("https://app.omie.com.br/api/v1/crm/contatos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "IncluirContato",
    "param": [
      {
        "identificacao": {
          "cCodInt": "",
          "cNome": "",
          "cSobrenome": "",
          "cCargo": "",
          "dDtNasc": "",
          "nCodVend": 0,
          "nCodConta": 0
        },
        "endereco": {
          "cEndereco": "",
          "cCompl": "",
          "cCEP": "",
          "cBairro": "",
          "cCidade": "",
          "cUF": "",
          "cPais": ""
        },
        "telefone_email": {
          "cDDDCel1": "",
          "cNumCel1": "",
          "cEmail": "",
          "cWebsite": ""
        }
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/crm/contatos/");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("TOKEN_DO_APLICATIVO"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "call": "IncluirContato",
    "param": [
        {
            "identificacao": {
                "cCodInt": "",
                "cNome": "",
                "cSobrenome": "",
                "cCargo": "",
                "dDtNasc": "",
                "nCodVend": 0,
                "nCodConta": 0
            },
            "endereco": {
                "cEndereco": "",
                "cCompl": "",
                "cCEP": "",
                "cBairro": "",
                "cCidade": "",
                "cUF": "",
                "cPais": ""
            },
            "telefone_email": {
                "cDDDCel1": "",
                "cNumCel1": "",
                "cEmail": "",
                "cWebsite": ""
            }
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/crm/contatos/")
corpo = <<~'JSON'
{
  "call": "IncluirContato",
  "param": [
    {
      "identificacao": {
        "cCodInt": "",
        "cNome": "",
        "cSobrenome": "",
        "cCargo": "",
        "dDtNasc": "",
        "nCodVend": 0,
        "nCodConta": 0
      },
      "endereco": {
        "cEndereco": "",
        "cCompl": "",
        "cCEP": "",
        "cBairro": "",
        "cCidade": "",
        "cUF": "",
        "cPais": ""
      },
      "telefone_email": {
        "cDDDCel1": "",
        "cNumCel1": "",
        "cEmail": "",
        "cWebsite": ""
      }
    }
  ]
}
JSON

resp = Net::HTTP.post(uri, corpo,
  "Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
  "Content-Type" => "application/json")
puts resp.body

import java.net.URI;
import java.net.http.*;

var corpo = """
{
  "call": "IncluirContato",
  "param": [
    {
      "identificacao": {
        "cCodInt": "",
        "cNome": "",
        "cSobrenome": "",
        "cCargo": "",
        "dDtNasc": "",
        "nCodVend": 0,
        "nCodConta": 0
      },
      "endereco": {
        "cEndereco": "",
        "cCompl": "",
        "cCEP": "",
        "cBairro": "",
        "cCidade": "",
        "cUF": "",
        "cPais": ""
      },
      "telefone_email": {
        "cDDDCel1": "",
        "cNumCel1": "",
        "cEmail": "",
        "cWebsite": ""
      }
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/crm/contatos/"))
    .header("Authorization", "Bearer " + System.getenv("TOKEN_DO_APLICATIVO"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(corpo))
    .build();
var resp = HttpClient.newHttpClient().send(pedido, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

// TokenDoAplicativo: parâmetro do Power BI (Página Inicial > Gerenciar parâmetros)
let
    Resposta = Web.Contents(
        "https://app.omie.com.br/api/v1/crm/contatos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""IncluirContato"", ""param"": [{""identificacao"": {""cCodInt"": """", ""cNome"": """", ""cSobrenome"": """", ""cCargo"": """", ""dDtNasc"": """", ""nCodVend"": 0, ""nCodConta"": 0}, ""endereco"": {""cEndereco"": """", ""cCompl"": """", ""cCEP"": """", ""cBairro"": """", ""cCidade"": """", ""cUF"": """", ""cPais"": """"}, ""telefone_email"": {""cDDDCel1"": """", ""cNumCel1"": """", ""cEmail"": """", ""cWebsite"": """"}}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

ListarContatos

consultaClaudeMCP

Lista os contatos do CRM.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 7Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`apenas_importado_api`	texto · até 1	Exibir apenas os registros gerados pela API
`exibir_obs`	texto · até 1	Exibir as observações do contato (S/N). Preencher com "S" ou "N".
`filtrar_por_conta`	número inteiro	Filtrar os contatos pelo código da conta. Utilize a tag "nCod" do método "ListarContas" da API /api/v1/crm/contas/ para obter essa informação
`ordem_decrescente`	texto · até 1	Se a lista será apresentada em ordem decrescente.
`ordenar_por`	texto · até 100	Ordem de exibição dos dados. Padrão: Código.
`pagina`	número inteiro	Número da página para resgatar os dados.
`registros_por_pagina`	número inteiro	Número de registros a serem exibidos por página. Máximo 50.

Retorno 5O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cadastros`	lista de objetos	Lista os cadastros encontrados.
`cadastros[].cObs`	texto	Observações.
`cadastros[].endereco`	objeto
`cadastros[].endereco.cBairro`	texto	Bairro
`cadastros[].endereco.cCEP`	texto	CEP
`cadastros[].endereco.cCidade`	texto	Cidade
`cadastros[].endereco.cCompl`	texto	Complemento
`cadastros[].endereco.cEndereco`	texto	Endereço do contato
`cadastros[].endereco.cPais`	texto	País
`cadastros[].endereco.cUF`	texto	Estado
`cadastros[].identificacao`	objeto
`cadastros[].identificacao.cCargo`	texto	Cargo
`cadastros[].identificacao.cCodInt`	texto	Código de Integração
`cadastros[].identificacao.cNome`	texto	Nome do contato
`cadastros[].identificacao.cSobrenome`	texto	Sobrenome do contato
`cadastros[].identificacao.dDtNasc`	texto	Data de Nascimento
`cadastros[].identificacao.nCod`	número inteiro	Código do Contato
`cadastros[].identificacao.nCodConta`	número inteiro	Código da Conta
`cadastros[].identificacao.nCodVend`	número inteiro	Código do Vendedor
`cadastros[].telefone_email`	objeto
`cadastros[].telefone_email.cDDDCel1`	texto	DDD do celular
`cadastros[].telefone_email.cDDDCel2`	texto	DDD do Celular
`cadastros[].telefone_email.cDDDFax`	texto	DDD do Fax
`cadastros[].telefone_email.cDDDTel`	texto	DDD do Telefone
`cadastros[].telefone_email.cEmail`	texto	E-mail do contato
`cadastros[].telefone_email.cNumCel1`	texto	Número do Celular
`cadastros[].telefone_email.cNumCel2`	texto	Número do Celular
`cadastros[].telefone_email.cNumFax`	texto	Número do Fax
`cadastros[].telefone_email.cNumTel`	texto	Número do Telefone
`cadastros[].telefone_email.cWebsite`	texto	WebSite
`pagina`	número inteiro	Número da página retornada
`registros`	número inteiro	Número de registros retornados na página.
`total_de_paginas`	número inteiro	Número total de páginas
`total_de_registros`	número inteiro	total de registros encontrados

POST /api/v1/crm/contatos/

curl -s https://app.omie.com.br/api/v1/crm/contatos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ListarContatos", "param": [{"pagina": 1, "registros_por_pagina": 50}]}'

import os
import requests

corpo = {'call': 'ListarContatos', 'param': [{'pagina': 1, 'registros_por_pagina': 50}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/crm/contatos/",
    headers={"Authorization": f"Bearer {os.environ['TOKEN_DO_APLICATIVO']}"},
    json=corpo,
    timeout=60,
)
print(resp.json())

const resp = await fetch("https://app.omie.com.br/api/v1/crm/contatos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "ListarContatos",
    "param": [
      {
        "pagina": 1,
        "registros_por_pagina": 50
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/crm/contatos/");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("TOKEN_DO_APLICATIVO"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "call": "ListarContatos",
    "param": [
        {
            "pagina": 1,
            "registros_por_pagina": 50
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/crm/contatos/")
corpo = <<~'JSON'
{
  "call": "ListarContatos",
  "param": [
    {
      "pagina": 1,
      "registros_por_pagina": 50
    }
  ]
}
JSON

resp = Net::HTTP.post(uri, corpo,
  "Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
  "Content-Type" => "application/json")
puts resp.body

import java.net.URI;
import java.net.http.*;

var corpo = """
{
  "call": "ListarContatos",
  "param": [
    {
      "pagina": 1,
      "registros_por_pagina": 50
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/crm/contatos/"))
    .header("Authorization", "Bearer " + System.getenv("TOKEN_DO_APLICATIVO"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(corpo))
    .build();
var resp = HttpClient.newHttpClient().send(pedido, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

// TokenDoAplicativo: parâmetro do Power BI (Página Inicial > Gerenciar parâmetros)
let
    Resposta = Web.Contents(
        "https://app.omie.com.br/api/v1/crm/contatos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""ListarContatos"", ""param"": [{""pagina"": 1, ""registros_por_pagina"": 50}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

UpsertContato

altera dadosClaudeMCP

Upsert do contato

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 4Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cObs`	texto	Observações.
`endereco`	objeto
`endereco.cBairro`	texto · até 60	Bairro
`endereco.cCEP`	texto · até 10	CEP
`endereco.cCidade`	texto · até 50	Cidade
`endereco.cCompl`	texto · até 200	Complemento
`endereco.cEndereco`	texto · até 200	Endereço do contato
`endereco.cPais`	texto · até 50	País
`endereco.cUF`	texto · até 50	Estado
`identificacao`	objeto
`identificacao.cCargo`	texto · até 60	Cargo
`identificacao.cCodInt`	texto	Código de Integração
`identificacao.cNome`	texto · até 60	Nome do contato
`identificacao.cSobrenome`	texto · até 60	Sobrenome do contato
`identificacao.dDtNasc`	texto · até 10	Data de Nascimento
`identificacao.nCod`	número inteiro	Código do Contato
`identificacao.nCodConta`	número inteiro	Código da Conta
`identificacao.nCodVend`	número inteiro	Código do Vendedor
`telefone_email`	objeto
`telefone_email.cDDDCel1`	texto · até 5	DDD do celular
`telefone_email.cDDDCel2`	texto · até 5	DDD do Celular
`telefone_email.cDDDFax`	texto · até 5	DDD do Fax
`telefone_email.cDDDTel`	texto · até 5	DDD do Telefone
`telefone_email.cEmail`	texto · até 200	E-mail do contato
`telefone_email.cNumCel1`	texto · até 15	Número do Celular
`telefone_email.cNumCel2`	texto · até 15	Número do Celular
`telefone_email.cNumFax`	texto · até 15	Número do Fax
`telefone_email.cNumTel`	texto · até 15	Número do Telefone
`telefone_email.cWebsite`	texto · até 100	WebSite

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodInt`	texto	Código de Integração
`cCodStatus`	texto	Código do Status
`cDesStatus`	texto	Descrição do Status
`nCod`	número inteiro	Código do contato

POST /api/v1/crm/contatos/

curl -s https://app.omie.com.br/api/v1/crm/contatos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "UpsertContato", "param": [{"identificacao": {"cCodInt": "", "cNome": "", "cSobrenome": "", "cCargo": "", "dDtNasc": "", "nCodVend": 0, "nCodConta": 0}, "endereco": {"cEndereco": "", "cCompl": "", "cCEP": "", "cBairro": "", "cCidade": "", "cUF": "", "cPais": ""}, "telefone_email": {"cDDDCel1": "", "cNumCel1": "", "cEmail": "", "cWebsite": ""}}]}'

import os
import requests

corpo = {'call': 'UpsertContato',
 'param': [{'identificacao': {'cCodInt': '',
                              'cNome': '',
                              'cSobrenome': '',
                              'cCargo': '',
                              'dDtNasc': '',
                              'nCodVend': 0,
                              'nCodConta': 0},
            'endereco': {'cEndereco': '',
                         'cCompl': '',
                         'cCEP': '',
                         'cBairro': '',
                         'cCidade': '',
                         'cUF': '',
                         'cPais': ''},
            'telefone_email': {'cDDDCel1': '',
                               'cNumCel1': '',
                               'cEmail': '',
                               'cWebsite': ''}}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/crm/contatos/",
    headers={"Authorization": f"Bearer {os.environ['TOKEN_DO_APLICATIVO']}"},
    json=corpo,
    timeout=60,
)
print(resp.json())

const resp = await fetch("https://app.omie.com.br/api/v1/crm/contatos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "UpsertContato",
    "param": [
      {
        "identificacao": {
          "cCodInt": "",
          "cNome": "",
          "cSobrenome": "",
          "cCargo": "",
          "dDtNasc": "",
          "nCodVend": 0,
          "nCodConta": 0
        },
        "endereco": {
          "cEndereco": "",
          "cCompl": "",
          "cCEP": "",
          "cBairro": "",
          "cCidade": "",
          "cUF": "",
          "cPais": ""
        },
        "telefone_email": {
          "cDDDCel1": "",
          "cNumCel1": "",
          "cEmail": "",
          "cWebsite": ""
        }
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/crm/contatos/");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("TOKEN_DO_APLICATIVO"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "call": "UpsertContato",
    "param": [
        {
            "identificacao": {
                "cCodInt": "",
                "cNome": "",
                "cSobrenome": "",
                "cCargo": "",
                "dDtNasc": "",
                "nCodVend": 0,
                "nCodConta": 0
            },
            "endereco": {
                "cEndereco": "",
                "cCompl": "",
                "cCEP": "",
                "cBairro": "",
                "cCidade": "",
                "cUF": "",
                "cPais": ""
            },
            "telefone_email": {
                "cDDDCel1": "",
                "cNumCel1": "",
                "cEmail": "",
                "cWebsite": ""
            }
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/crm/contatos/")
corpo = <<~'JSON'
{
  "call": "UpsertContato",
  "param": [
    {
      "identificacao": {
        "cCodInt": "",
        "cNome": "",
        "cSobrenome": "",
        "cCargo": "",
        "dDtNasc": "",
        "nCodVend": 0,
        "nCodConta": 0
      },
      "endereco": {
        "cEndereco": "",
        "cCompl": "",
        "cCEP": "",
        "cBairro": "",
        "cCidade": "",
        "cUF": "",
        "cPais": ""
      },
      "telefone_email": {
        "cDDDCel1": "",
        "cNumCel1": "",
        "cEmail": "",
        "cWebsite": ""
      }
    }
  ]
}
JSON

resp = Net::HTTP.post(uri, corpo,
  "Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
  "Content-Type" => "application/json")
puts resp.body

import java.net.URI;
import java.net.http.*;

var corpo = """
{
  "call": "UpsertContato",
  "param": [
    {
      "identificacao": {
        "cCodInt": "",
        "cNome": "",
        "cSobrenome": "",
        "cCargo": "",
        "dDtNasc": "",
        "nCodVend": 0,
        "nCodConta": 0
      },
      "endereco": {
        "cEndereco": "",
        "cCompl": "",
        "cCEP": "",
        "cBairro": "",
        "cCidade": "",
        "cUF": "",
        "cPais": ""
      },
      "telefone_email": {
        "cDDDCel1": "",
        "cNumCel1": "",
        "cEmail": "",
        "cWebsite": ""
      }
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/crm/contatos/"))
    .header("Authorization", "Bearer " + System.getenv("TOKEN_DO_APLICATIVO"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(corpo))
    .build();
var resp = HttpClient.newHttpClient().send(pedido, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

// TokenDoAplicativo: parâmetro do Power BI (Página Inicial > Gerenciar parâmetros)
let
    Resposta = Web.Contents(
        "https://app.omie.com.br/api/v1/crm/contatos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""UpsertContato"", ""param"": [{""identificacao"": {""cCodInt"": """", ""cNome"": """", ""cSobrenome"": """", ""cCargo"": """", ""dDtNasc"": """", ""nCodVend"": 0, ""nCodConta"": 0}, ""endereco"": {""cEndereco"": """", ""cCompl"": """", ""cCEP"": """", ""cBairro"": """", ""cCidade"": """", ""cUF"": """", ""cPais"": """"}, ""telefone_email"": {""cDDDCel1"": """", ""cNumCel1"": """", ""cEmail"": """", ""cWebsite"": """"}}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

VerificarContato

consultaClaudeMCP

Verifica se um contato já existe.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cEmail`	texto · até 200	E-mail do contato
`cNome`	texto · até 60	Nome completo (Nome + Sobrenome) do contato.

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodInt`	texto	Código de Integração
`cCodStatus`	texto	Código do Status
`cDesStatus`	texto	Descrição do Status
`nCod`	número inteiro	Código do contato

POST /api/v1/crm/contatos/

curl -s https://app.omie.com.br/api/v1/crm/contatos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "VerificarContato", "param": [{"cNome": "", "cEmail": ""}]}'

import os
import requests

corpo = {'call': 'VerificarContato', 'param': [{'cNome': '', 'cEmail': ''}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/crm/contatos/",
    headers={"Authorization": f"Bearer {os.environ['TOKEN_DO_APLICATIVO']}"},
    json=corpo,
    timeout=60,
)
print(resp.json())

const resp = await fetch("https://app.omie.com.br/api/v1/crm/contatos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "VerificarContato",
    "param": [
      {
        "cNome": "",
        "cEmail": ""
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/crm/contatos/");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("TOKEN_DO_APLICATIVO"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "call": "VerificarContato",
    "param": [
        {
            "cNome": "",
            "cEmail": ""
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/crm/contatos/")
corpo = <<~'JSON'
{
  "call": "VerificarContato",
  "param": [
    {
      "cNome": "",
      "cEmail": ""
    }
  ]
}
JSON

resp = Net::HTTP.post(uri, corpo,
  "Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
  "Content-Type" => "application/json")
puts resp.body

import java.net.URI;
import java.net.http.*;

var corpo = """
{
  "call": "VerificarContato",
  "param": [
    {
      "cNome": "",
      "cEmail": ""
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/crm/contatos/"))
    .header("Authorization", "Bearer " + System.getenv("TOKEN_DO_APLICATIVO"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(corpo))
    .build();
var resp = HttpClient.newHttpClient().send(pedido, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

// TokenDoAplicativo: parâmetro do Power BI (Página Inicial > Gerenciar parâmetros)
let
    Resposta = Web.Contents(
        "https://app.omie.com.br/api/v1/crm/contatos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""VerificarContato"", ""param"": [{""cNome"": """", ""cEmail"": """"}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

Operações

AlterarContato
ConsultarContato
ExcluirContato
IncluirContato
ListarContatos
UpsertContato
VerificarContato