CRM ·
AdicionarOportunidadeInclusão de oportunidade no CRM
0consultas
1alteração
Claude · MCPpelos assistentes de IA
JSON · XMLformato
Inclusão de uma Oportunidade.
Obrigatórios 1
| Campo | Tipo | Descrição |
|---|---|---|
cDadosOp | texto | Texto com um JSON (começando com "{" e terminando com "}") com a estrutura da Oportunidade, da conta e do contato do CRM. Obrigatório. Blocos: identificacao - cDesOp (nome), nCodContato, nCodConta, nCodVendedor, nCodSolucao (obrigatório) e nCodOrigem (obrigatório). observacoes - cObs. fasesStatus - nCodFase, nCodStatus e dNovoLead (dd/mm/aaaa). outrasInf - nCodTipo e cOrigem. conta - identificacao (cCodInt, cNome obrigatório, cObs, nCodVendedor, cDoc), endereco (cEndereco, cCidade, cUF, cPais) e telefone_email (cDDDTel, cNumTel, cEmail, cWebsite). contato - identificacao (cCodInt, cNome obrigatório, cSobrenome, nCodVendedor, nCodConta), endereco e telefone_email. vendedor - cEmail (localiza o vendedor pelo e-mail). Caso a Conta e Contato informados nas tags [conta] e [contato] não estejam cadastrados, seu cadastro será efetuado automaticamente; se o cadastro já existir para o Código de integração, E-mail ou Nome, a Conta e o Contato existentes são usados na Oportunidade. |
Opcionais 1Campos e estruturas que você pode enviar
| Campo | Tipo | Descrição |
|---|---|---|
cCodIntOp | texto | Código de integração da oportunidade. Obrigatório e único no aplicativo. Também é usado como código de integração da conta e do contato quando eles não trazem o seu. (Utilizado em cadastros incluídos via API, não é visualizado na tela) |
Retorno 4O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
cCodIntOp | texto | Código de integração da oportunidade incluída. |
cCodStatus | texto | Código do status. "0" indica sucesso. |
cDesStatus | texto | Descrição do status. |
nCodOp | número inteiro | Código da oportunidade incluída. |
POST /api/v1/crm/adicionaroportunidade/
curl -s https://app.omie.com.br/api/v1/crm/adicionaroportunidade/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "AdicionarOp", "param": [{"cCodIntOp": "OP-2025-0001", "cDadosOp": "{\"identificacao\": {\"cDesOp\": \"Implantação ERP - Padaria Pão Dourado\", \"nCodContato\": 0, \"nCodConta\": 0, \"nCodVendedor\": 4562342071, \"nCodSolucao\": 4561522783, \"nCodOrigem\": 4561265881}, \"observacoes\": {\"cObs\": \"Oportunidade incluída via API\"}, \"fasesStatus\": {\"nCodFase\": 4564827911}, \"outrasInf\": {\"nCodTipo\": 4564138281, \"cOrigem\": \"\"}, \"conta\": {\"identificacao\": {\"cCodInt\": \"CTA-1001\", \"cNome\": \"Padaria Pão Dourado Ltda\", \"cObs\": \"Conta incluída via API\", \"nCodVendedor\": 4562342071}, \"endereco\": {\"cEndereco\": \"Rua das Flores, 100\", \"cCidade\": \"São Paulo\", \"cUF\": \"SP\", \"cPais\": \"Brasil\"}, \"telefone_email\": {\"cDDDTel\": \"11\", \"cNumTel\": \"99999-9999\", \"cEmail\": \"contato@paodourado.com.br\", \"cWebsite\": \"\"}}, \"contato\": {\"identificacao\": {\"cCodInt\": \"CTT-1001\", \"cNome\": \"Maria\", \"cSobrenome\": \"Souza\", \"nCodVendedor\": 4562342071, \"nCodConta\": 0}, \"endereco\": {\"cEndereco\": \"Rua das Flores, 100\", \"cCidade\": \"São Paulo\", \"cUF\": \"SP\", \"cPais\": \"Brasil\"}, \"telefone_email\": {\"cDDDTel\": \"11\", \"cNumTel\": \"98888-7777\", \"cEmail\": \"maria@paodourado.com.br\", \"cWebsite\": \"\"}}}"}]}'import os
import requests
corpo = {'call': 'AdicionarOp',
'param': [{'cCodIntOp': 'OP-2025-0001',
'cDadosOp': '{"identificacao": {"cDesOp": "Implantação ERP - Padaria Pão '
'Dourado", "nCodContato": 0, "nCodConta": 0, "nCodVendedor": '
'4562342071, "nCodSolucao": 4561522783, "nCodOrigem": '
'4561265881}, "observacoes": {"cObs": "Oportunidade incluída '
'via API"}, "fasesStatus": {"nCodFase": 4564827911}, '
'"outrasInf": {"nCodTipo": 4564138281, "cOrigem": ""}, '
'"conta": {"identificacao": {"cCodInt": "CTA-1001", "cNome": '
'"Padaria Pão Dourado Ltda", "cObs": "Conta incluída via API", '
'"nCodVendedor": 4562342071}, "endereco": {"cEndereco": "Rua '
'das Flores, 100", "cCidade": "São Paulo", "cUF": "SP", '
'"cPais": "Brasil"}, "telefone_email": {"cDDDTel": "11", '
'"cNumTel": "99999-9999", "cEmail": '
'"contato@paodourado.com.br", "cWebsite": ""}}, "contato": '
'{"identificacao": {"cCodInt": "CTT-1001", "cNome": "Maria", '
'"cSobrenome": "Souza", "nCodVendedor": 4562342071, '
'"nCodConta": 0}, "endereco": {"cEndereco": "Rua das Flores, '
'100", "cCidade": "São Paulo", "cUF": "SP", "cPais": '
'"Brasil"}, "telefone_email": {"cDDDTel": "11", "cNumTel": '
'"98888-7777", "cEmail": "maria@paodourado.com.br", '
'"cWebsite": ""}}}'}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/crm/adicionaroportunidade/",
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/adicionaroportunidade/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "AdicionarOp",
"param": [
{
"cCodIntOp": "OP-2025-0001",
"cDadosOp": "{\"identificacao\": {\"cDesOp\": \"Implantação ERP - Padaria Pão Dourado\", \"nCodContato\": 0, \"nCodConta\": 0, \"nCodVendedor\": 4562342071, \"nCodSolucao\": 4561522783, \"nCodOrigem\": 4561265881}, \"observacoes\": {\"cObs\": \"Oportunidade incluída via API\"}, \"fasesStatus\": {\"nCodFase\": 4564827911}, \"outrasInf\": {\"nCodTipo\": 4564138281, \"cOrigem\": \"\"}, \"conta\": {\"identificacao\": {\"cCodInt\": \"CTA-1001\", \"cNome\": \"Padaria Pão Dourado Ltda\", \"cObs\": \"Conta incluída via API\", \"nCodVendedor\": 4562342071}, \"endereco\": {\"cEndereco\": \"Rua das Flores, 100\", \"cCidade\": \"São Paulo\", \"cUF\": \"SP\", \"cPais\": \"Brasil\"}, \"telefone_email\": {\"cDDDTel\": \"11\", \"cNumTel\": \"99999-9999\", \"cEmail\": \"contato@paodourado.com.br\", \"cWebsite\": \"\"}}, \"contato\": {\"identificacao\": {\"cCodInt\": \"CTT-1001\", \"cNome\": \"Maria\", \"cSobrenome\": \"Souza\", \"nCodVendedor\": 4562342071, \"nCodConta\": 0}, \"endereco\": {\"cEndereco\": \"Rua das Flores, 100\", \"cCidade\": \"São Paulo\", \"cUF\": \"SP\", \"cPais\": \"Brasil\"}, \"telefone_email\": {\"cDDDTel\": \"11\", \"cNumTel\": \"98888-7777\", \"cEmail\": \"maria@paodourado.com.br\", \"cWebsite\": \"\"}}}"
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/crm/adicionaroportunidade/");
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": "AdicionarOp",
"param": [
{
"cCodIntOp": "OP-2025-0001",
"cDadosOp": "{\"identificacao\": {\"cDesOp\": \"Implantação ERP - Padaria Pão Dourado\", \"nCodContato\": 0, \"nCodConta\": 0, \"nCodVendedor\": 4562342071, \"nCodSolucao\": 4561522783, \"nCodOrigem\": 4561265881}, \"observacoes\": {\"cObs\": \"Oportunidade incluída via API\"}, \"fasesStatus\": {\"nCodFase\": 4564827911}, \"outrasInf\": {\"nCodTipo\": 4564138281, \"cOrigem\": \"\"}, \"conta\": {\"identificacao\": {\"cCodInt\": \"CTA-1001\", \"cNome\": \"Padaria Pão Dourado Ltda\", \"cObs\": \"Conta incluída via API\", \"nCodVendedor\": 4562342071}, \"endereco\": {\"cEndereco\": \"Rua das Flores, 100\", \"cCidade\": \"São Paulo\", \"cUF\": \"SP\", \"cPais\": \"Brasil\"}, \"telefone_email\": {\"cDDDTel\": \"11\", \"cNumTel\": \"99999-9999\", \"cEmail\": \"contato@paodourado.com.br\", \"cWebsite\": \"\"}}, \"contato\": {\"identificacao\": {\"cCodInt\": \"CTT-1001\", \"cNome\": \"Maria\", \"cSobrenome\": \"Souza\", \"nCodVendedor\": 4562342071, \"nCodConta\": 0}, \"endereco\": {\"cEndereco\": \"Rua das Flores, 100\", \"cCidade\": \"São Paulo\", \"cUF\": \"SP\", \"cPais\": \"Brasil\"}, \"telefone_email\": {\"cDDDTel\": \"11\", \"cNumTel\": \"98888-7777\", \"cEmail\": \"maria@paodourado.com.br\", \"cWebsite\": \"\"}}}"
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/crm/adicionaroportunidade/")
corpo = <<~'JSON'
{
"call": "AdicionarOp",
"param": [
{
"cCodIntOp": "OP-2025-0001",
"cDadosOp": "{\"identificacao\": {\"cDesOp\": \"Implantação ERP - Padaria Pão Dourado\", \"nCodContato\": 0, \"nCodConta\": 0, \"nCodVendedor\": 4562342071, \"nCodSolucao\": 4561522783, \"nCodOrigem\": 4561265881}, \"observacoes\": {\"cObs\": \"Oportunidade incluída via API\"}, \"fasesStatus\": {\"nCodFase\": 4564827911}, \"outrasInf\": {\"nCodTipo\": 4564138281, \"cOrigem\": \"\"}, \"conta\": {\"identificacao\": {\"cCodInt\": \"CTA-1001\", \"cNome\": \"Padaria Pão Dourado Ltda\", \"cObs\": \"Conta incluída via API\", \"nCodVendedor\": 4562342071}, \"endereco\": {\"cEndereco\": \"Rua das Flores, 100\", \"cCidade\": \"São Paulo\", \"cUF\": \"SP\", \"cPais\": \"Brasil\"}, \"telefone_email\": {\"cDDDTel\": \"11\", \"cNumTel\": \"99999-9999\", \"cEmail\": \"contato@paodourado.com.br\", \"cWebsite\": \"\"}}, \"contato\": {\"identificacao\": {\"cCodInt\": \"CTT-1001\", \"cNome\": \"Maria\", \"cSobrenome\": \"Souza\", \"nCodVendedor\": 4562342071, \"nCodConta\": 0}, \"endereco\": {\"cEndereco\": \"Rua das Flores, 100\", \"cCidade\": \"São Paulo\", \"cUF\": \"SP\", \"cPais\": \"Brasil\"}, \"telefone_email\": {\"cDDDTel\": \"11\", \"cNumTel\": \"98888-7777\", \"cEmail\": \"maria@paodourado.com.br\", \"cWebsite\": \"\"}}}"
}
]
}
JSON
resp = Net::HTTP.post(uri, corpo,
"Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
"Content-Type" => "application/json")
puts resp.bodyimport java.net.URI;
import java.net.http.*;
var corpo = """
{
"call": "AdicionarOp",
"param": [
{
"cCodIntOp": "OP-2025-0001",
"cDadosOp": "{\\"identificacao\\": {\\"cDesOp\\": \\"Implantação ERP - Padaria Pão Dourado\\", \\"nCodContato\\": 0, \\"nCodConta\\": 0, \\"nCodVendedor\\": 4562342071, \\"nCodSolucao\\": 4561522783, \\"nCodOrigem\\": 4561265881}, \\"observacoes\\": {\\"cObs\\": \\"Oportunidade incluída via API\\"}, \\"fasesStatus\\": {\\"nCodFase\\": 4564827911}, \\"outrasInf\\": {\\"nCodTipo\\": 4564138281, \\"cOrigem\\": \\"\\"}, \\"conta\\": {\\"identificacao\\": {\\"cCodInt\\": \\"CTA-1001\\", \\"cNome\\": \\"Padaria Pão Dourado Ltda\\", \\"cObs\\": \\"Conta incluída via API\\", \\"nCodVendedor\\": 4562342071}, \\"endereco\\": {\\"cEndereco\\": \\"Rua das Flores, 100\\", \\"cCidade\\": \\"São Paulo\\", \\"cUF\\": \\"SP\\", \\"cPais\\": \\"Brasil\\"}, \\"telefone_email\\": {\\"cDDDTel\\": \\"11\\", \\"cNumTel\\": \\"99999-9999\\", \\"cEmail\\": \\"contato@paodourado.com.br\\", \\"cWebsite\\": \\"\\"}}, \\"contato\\": {\\"identificacao\\": {\\"cCodInt\\": \\"CTT-1001\\", \\"cNome\\": \\"Maria\\", \\"cSobrenome\\": \\"Souza\\", \\"nCodVendedor\\": 4562342071, \\"nCodConta\\": 0}, \\"endereco\\": {\\"cEndereco\\": \\"Rua das Flores, 100\\", \\"cCidade\\": \\"São Paulo\\", \\"cUF\\": \\"SP\\", \\"cPais\\": \\"Brasil\\"}, \\"telefone_email\\": {\\"cDDDTel\\": \\"11\\", \\"cNumTel\\": \\"98888-7777\\", \\"cEmail\\": \\"maria@paodourado.com.br\\", \\"cWebsite\\": \\"\\"}}}"
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/crm/adicionaroportunidade/"))
.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/adicionaroportunidade/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""AdicionarOp"", ""param"": [{""cCodIntOp"": ""OP-2025-0001"", ""cDadosOp"": ""{\""identificacao\"": {\""cDesOp\"": \""Implantação ERP - Padaria Pão Dourado\"", \""nCodContato\"": 0, \""nCodConta\"": 0, \""nCodVendedor\"": 4562342071, \""nCodSolucao\"": 4561522783, \""nCodOrigem\"": 4561265881}, \""observacoes\"": {\""cObs\"": \""Oportunidade incluída via API\""}, \""fasesStatus\"": {\""nCodFase\"": 4564827911}, \""outrasInf\"": {\""nCodTipo\"": 4564138281, \""cOrigem\"": \""\""}, \""conta\"": {\""identificacao\"": {\""cCodInt\"": \""CTA-1001\"", \""cNome\"": \""Padaria Pão Dourado Ltda\"", \""cObs\"": \""Conta incluída via API\"", \""nCodVendedor\"": 4562342071}, \""endereco\"": {\""cEndereco\"": \""Rua das Flores, 100\"", \""cCidade\"": \""São Paulo\"", \""cUF\"": \""SP\"", \""cPais\"": \""Brasil\""}, \""telefone_email\"": {\""cDDDTel\"": \""11\"", \""cNumTel\"": \""99999-9999\"", \""cEmail\"": \""contato@paodourado.com.br\"", \""cWebsite\"": \""\""}}, \""contato\"": {\""identificacao\"": {\""cCodInt\"": \""CTT-1001\"", \""cNome\"": \""Maria\"", \""cSobrenome\"": \""Souza\"", \""nCodVendedor\"": 4562342071, \""nCodConta\"": 0}, \""endereco\"": {\""cEndereco\"": \""Rua das Flores, 100\"", \""cCidade\"": \""São Paulo\"", \""cUF\"": \""SP\"", \""cPais\"": \""Brasil\""}, \""telefone_email\"": {\""cDDDTel\"": \""11\"", \""cNumTel\"": \""98888-7777\"", \""cEmail\"": \""maria@paodourado.com.br\"", \""cWebsite\"": \""\""}}}""}]}")
]
),
Dados = Json.Document(Resposta)
in
Dados