Geral ·
TarefasTarefas do ERP
5consultas
3alterações
Claude 8 de 8 · ChatGPT 1 de 8 · MCP 8 de 8pelos assistentes de IA
JSON · XMLformato
Método para realizar a alteração de uma tarefa.
Obrigatórios 0
Nenhum campo obrigatório.
Opcionais 11Campos e estruturas que você pode enviar
| Campo | Tipo | Descrição |
|---|---|---|
cCodIntTarefa | texto · até 20 | |
cDescricao | texto | Descrição da tarefa. |
cImportante | texto · até 1 | Indica se a tarefa é importante (S/N).Ex.: S, N |
cSituacao | texto · até 40 | Situação da tarefa.
Para métodos de criação e edição:
Como default será utilizado "Pendente".
Pode ser:
pendente (Pendente)
em-execucao (Em execução)
realizada (Realizada)Ex.: pendente, em-execucao, realizada |
cUrgente | texto · até 1 | Indica se a tarefa é urgente (S/N).Ex.: S, N |
dData | texto | |
hHora | texto · até 5 | |
nCodAtividade | número inteiro | Código do tipo de tarefa vinculado. Para métodos de criação e edição: Para obter os tipos de tarefa, utilize o método ObterTiposTarefa da API: /api/v1/geral/tipostarefa/ |
nCodNotif | número inteiro | Código da notificação. Para métodos de criação e edição: Como default será utilizado "Não notificar". 99999 (Não notificar) 15 (15 minutos antes) 30 (30 minutos antes) 60 (1 hora antes) 120 (2 horas antes) 180 (3 horas antes) 1001 (1 dia antes) 1002 (2 dias antes) 1003 (3 dias antes) 2001 (1 semana antes) 2002 (2 semanas antes) |
nCodTarefa | número inteiro | Código único da tarefa. |
nCodUserAtb | número inteiro | Código do usuário atribuído. Para método de criação: Para método de edição: Para obter os possíveis usuários para alocar a tarefa, utilize o método ListarUsuarios da API: /api/v1/geral/usuarios/ |
Retorno 3O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
cCodStatus | texto | |
cDesStatus | texto | |
nCodTarefa | número inteiro | Código único da tarefa. |
POST /api/v1/geral/tarefas/
curl -s https://app.omie.com.br/api/v1/geral/tarefas/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "AlterarTarefa", "param": [{"nCodTarefa": 987654, "cDescricao": "Ligar para o cliente (remarcado)", "dData": "21/10/2026", "hHora": "10:00"}]}'import os
import requests
corpo = {'call': 'AlterarTarefa',
'param': [{'nCodTarefa': 987654,
'cDescricao': 'Ligar para o cliente (remarcado)',
'dData': '21/10/2026',
'hHora': '10:00'}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/geral/tarefas/",
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/geral/tarefas/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "AlterarTarefa",
"param": [
{
"nCodTarefa": 987654,
"cDescricao": "Ligar para o cliente (remarcado)",
"dData": "21/10/2026",
"hHora": "10:00"
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/tarefas/");
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": "AlterarTarefa",
"param": [
{
"nCodTarefa": 987654,
"cDescricao": "Ligar para o cliente (remarcado)",
"dData": "21/10/2026",
"hHora": "10:00"
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/geral/tarefas/")
corpo = <<~'JSON'
{
"call": "AlterarTarefa",
"param": [
{
"nCodTarefa": 987654,
"cDescricao": "Ligar para o cliente (remarcado)",
"dData": "21/10/2026",
"hHora": "10:00"
}
]
}
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": "AlterarTarefa",
"param": [
{
"nCodTarefa": 987654,
"cDescricao": "Ligar para o cliente (remarcado)",
"dData": "21/10/2026",
"hHora": "10:00"
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/geral/tarefas/"))
.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/geral/tarefas/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""AlterarTarefa"", ""param"": [{""nCodTarefa"": 987654, ""cDescricao"": ""Ligar para o cliente (remarcado)"", ""dData"": ""21/10/2026"", ""hHora"": ""10:00""}]}")
]
),
Dados = Json.Document(Resposta)
in
DadosMétodo para realizar a consulta de uma tarefa.
Obrigatórios 0
Nenhum campo obrigatório.
Opcionais 2Campos e estruturas que você pode enviar
| Campo | Tipo | Descrição |
|---|---|---|
cCodIntTarefa | texto · até 20 | |
nCodTarefa | número inteiro | Código único da tarefa. |
Retorno 3O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
cCodStatus | texto | |
cDesStatus | texto | |
tarefa | objeto | |
tarefa.cCodIntTarefa | texto | |
tarefa.cDescDoc | texto | Descrição do documento vinculado a tarefa. Exemplo: Se a origem da tarefa for "pedido-compra", esse campo reflete a descrição do pedido de compra. Se a origem da tarefa for "contas-receber", esse campo reflete a descrição da conta a receber. |
tarefa.cDescNotif | texto | |
tarefa.cDescTipoTarefa | texto | |
tarefa.cDescricao | texto | Descrição da tarefa. |
tarefa.cImportante | texto | Indica se a tarefa é importante (S/N). |
tarefa.cNomeUserAtb | texto | |
tarefa.cOrigem | texto | Origem da tarefa. Para método de criação: Pode ser: oportunidade geral cliente produto servico pedido-venda pedido-compra pedido-importacao contas-pagar contas-receber ordem-producao ordem-servico contrato-servico |
tarefa.cSituacao | texto | Situação da tarefa. Para métodos de criação e edição: Como default será utilizado "Pendente". Pode ser: pendente (Pendente) em-execucao (Em execução) realizada (Realizada) |
tarefa.cUrgente | texto | Indica se a tarefa é urgente (S/N). |
tarefa.dData | texto | |
tarefa.hHora | texto | |
tarefa.nCodDoc | número inteiro | Id do documento vinculado a tarefa. Esse campo varia conforme a origem da tarefa. Ele permite vincular a tarefa a um documento específico, seja ele relacionado a uma oportunidade, contas a pagar, contas a receber, entre outros. Exemplo: Se a origem da tarefa for "pedido-compra", esse campo reflete o código do pedido de compra. Se a origem da tarefa for "contas-receber", esse campo reflete o código da conta a receber. No cadastro de uma tarefa, quando a origem for "geral", não é permitido informar esse campo. |
tarefa.nCodNotif | número inteiro | |
tarefa.nCodSituacao | número inteiro | Código da situação da tarefa. |
tarefa.nCodTarefa | número inteiro | Código único da tarefa. |
tarefa.nCodTipoTarefa | número inteiro | Código do tipo de tarefa vinculado. Para métodos de criação e edição: Para obter os tipos de tarefa, utilize o método ObterTiposTarefa da API: /api/v1/geral/tipostarefa/ |
tarefa.nCodUserAtb | número inteiro | Código do usuário atribuído. Para método de criação: Para método de edição: Para obter os possíveis usuários para alocar a tarefa, utilize o método ListarUsuarios da API: /api/v1/geral/usuarios/ |
POST /api/v1/geral/tarefas/
curl -s https://app.omie.com.br/api/v1/geral/tarefas/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "ConsultarTarefa", "param": [{"nCodTarefa": 987654}]}'import os
import requests
corpo = {'call': 'ConsultarTarefa', 'param': [{'nCodTarefa': 987654}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/geral/tarefas/",
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/geral/tarefas/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "ConsultarTarefa",
"param": [
{
"nCodTarefa": 987654
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/tarefas/");
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": "ConsultarTarefa",
"param": [
{
"nCodTarefa": 987654
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/geral/tarefas/")
corpo = <<~'JSON'
{
"call": "ConsultarTarefa",
"param": [
{
"nCodTarefa": 987654
}
]
}
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": "ConsultarTarefa",
"param": [
{
"nCodTarefa": 987654
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/geral/tarefas/"))
.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/geral/tarefas/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""ConsultarTarefa"", ""param"": [{""nCodTarefa"": 987654}]}")
]
),
Dados = Json.Document(Resposta)
in
DadosMétodo para realizar a exclusão de uma tarefa.
Obrigatórios 0
Nenhum campo obrigatório.
Opcionais 2Campos e estruturas que você pode enviar
| Campo | Tipo | Descrição |
|---|---|---|
cCodIntTarefa | texto · até 20 | |
nCodTarefa | número inteiro | Código único da tarefa. |
Retorno 2O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
cCodStatus | texto | |
cDesStatus | texto |
POST /api/v1/geral/tarefas/
curl -s https://app.omie.com.br/api/v1/geral/tarefas/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "ExcluirTarefa", "param": [{"nCodTarefa": 987654}]}'import os
import requests
corpo = {'call': 'ExcluirTarefa', 'param': [{'nCodTarefa': 987654}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/geral/tarefas/",
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/geral/tarefas/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "ExcluirTarefa",
"param": [
{
"nCodTarefa": 987654
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/tarefas/");
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": "ExcluirTarefa",
"param": [
{
"nCodTarefa": 987654
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/geral/tarefas/")
corpo = <<~'JSON'
{
"call": "ExcluirTarefa",
"param": [
{
"nCodTarefa": 987654
}
]
}
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": "ExcluirTarefa",
"param": [
{
"nCodTarefa": 987654
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/geral/tarefas/"))
.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/geral/tarefas/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""ExcluirTarefa"", ""param"": [{""nCodTarefa"": 987654}]}")
]
),
Dados = Json.Document(Resposta)
in
DadosMétodo para realizar a inclusão de uma tarefa.
Obrigatórios 4
| Campo | Tipo | Descrição |
|---|---|---|
cOrigem | texto · até 20 | Origem da tarefa.
Para método de criação:
Pode ser:
oportunidade
geral
cliente
produto
servico
pedido-venda
pedido-compra
pedido-importacao
contas-pagar
contas-receber
ordem-producao
ordem-servico
contrato-servicoEx.: oportunidade, geral, cliente |
dData | texto | |
hHora | texto · até 5 | |
nCodUserAtb | número inteiro | Código do usuário atribuído. Para método de criação: Para método de edição: Para obter os possíveis usuários para alocar a tarefa, utilize o método ListarUsuarios da API: /api/v1/geral/usuarios/ |
Opcionais 8Campos e estruturas que você pode enviar
| Campo | Tipo | Descrição |
|---|---|---|
cCodIntTarefa | texto · até 20 | |
cDescricao | texto | Descrição da tarefa. |
cImportante | texto · até 1 | Indica se a tarefa é importante (S/N).Ex.: S, N |
cSituacao | texto · até 40 | Situação da tarefa.
Para métodos de criação e edição:
Como default será utilizado "Pendente".
Pode ser:
pendente (Pendente)
em-execucao (Em execução)
realizada (Realizada)Ex.: pendente, em-execucao, realizada |
cUrgente | texto · até 1 | Indica se a tarefa é urgente (S/N).Ex.: S, N |
nCodAtividade | número inteiro | Código do tipo de tarefa vinculado. Para métodos de criação e edição: Para obter os tipos de tarefa, utilize o método ObterTiposTarefa da API: /api/v1/geral/tipostarefa/ |
nCodDoc | número inteiro | Id do documento vinculado a tarefa. Esse campo varia conforme a origem da tarefa. Ele permite vincular a tarefa a um documento específico, seja ele relacionado a uma oportunidade, contas a pagar, contas a receber, entre outros. Exemplo: Se a origem da tarefa for "pedido-compra", esse campo reflete o código do pedido de compra. Se a origem da tarefa for "contas-receber", esse campo reflete o código da conta a receber. No cadastro de uma tarefa, quando a origem for "geral", não é permitido informar esse campo. |
nCodNotif | número inteiro | Código da notificação. Para métodos de criação e edição: Como default será utilizado "Não notificar". 99999 (Não notificar) 15 (15 minutos antes) 30 (30 minutos antes) 60 (1 hora antes) 120 (2 horas antes) 180 (3 horas antes) 1001 (1 dia antes) 1002 (2 dias antes) 1003 (3 dias antes) 2001 (1 semana antes) 2002 (2 semanas antes) |
Retorno 3O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
cCodStatus | texto | |
cDesStatus | texto | |
nCodTarefa | número inteiro | Código único da tarefa. |
POST /api/v1/geral/tarefas/
curl -s https://app.omie.com.br/api/v1/geral/tarefas/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "IncluirTarefa", "param": [{"cOrigem": "geral", "cDescricao": "Ligar para o cliente", "dData": "20/10/2026", "hHora": "14:00", "nCodUserAtb": 123456}]}'import os
import requests
corpo = {'call': 'IncluirTarefa',
'param': [{'cOrigem': 'geral',
'cDescricao': 'Ligar para o cliente',
'dData': '20/10/2026',
'hHora': '14:00',
'nCodUserAtb': 123456}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/geral/tarefas/",
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/geral/tarefas/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "IncluirTarefa",
"param": [
{
"cOrigem": "geral",
"cDescricao": "Ligar para o cliente",
"dData": "20/10/2026",
"hHora": "14:00",
"nCodUserAtb": 123456
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/tarefas/");
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": "IncluirTarefa",
"param": [
{
"cOrigem": "geral",
"cDescricao": "Ligar para o cliente",
"dData": "20/10/2026",
"hHora": "14:00",
"nCodUserAtb": 123456
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/geral/tarefas/")
corpo = <<~'JSON'
{
"call": "IncluirTarefa",
"param": [
{
"cOrigem": "geral",
"cDescricao": "Ligar para o cliente",
"dData": "20/10/2026",
"hHora": "14:00",
"nCodUserAtb": 123456
}
]
}
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": "IncluirTarefa",
"param": [
{
"cOrigem": "geral",
"cDescricao": "Ligar para o cliente",
"dData": "20/10/2026",
"hHora": "14:00",
"nCodUserAtb": 123456
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/geral/tarefas/"))
.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/geral/tarefas/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""IncluirTarefa"", ""param"": [{""cOrigem"": ""geral"", ""cDescricao"": ""Ligar para o cliente"", ""dData"": ""20/10/2026"", ""hHora"": ""14:00"", ""nCodUserAtb"": 123456}]}")
]
),
Dados = Json.Document(Resposta)
in
DadosMétodo para realizar a listagem de tarefas cadastradas no ERP.
Obrigatórios 0
Nenhum campo obrigatório.
Opcionais 14Campos e estruturas que você pode enviar
| Campo | Tipo | Descrição |
|---|---|---|
cAtribuidasAMim | texto · até 1 | Indica se deve retornar apenas as tarefas atribuídas ao usuário (S/N).Ex.: S, N |
cCriadasPorMim | texto · até 1 | Indica se deve retornar apenas as tarefas criadas pelo usuário (S/N).Ex.: S, N |
cImportante | texto · até 1 | Indica se a tarefa é importante (S/N).Ex.: S, N |
cIntervalo | texto · até 30 | Filtrar tarefas a partir de intervalos específicos.
Quando preenchida essa tag, não informar as tags 'dDataInicial' e 'dDataFinal'
Pode ser:
hoje
semana-atual
proxima-semana
mes (mês atual)Ex.: hoje, semana-atual, proxima-semana |
cOrdemDesc | texto · até 1 | Indica se a ordem de exibição é decrescente (S/N).
Caso não informado, o padrão é "N".Ex.: S, N |
cOrdenarPor | texto · até 100 | Ordem de exibição dos dados.
Quando não preenchido o padrão será por código
Pode ser:
codigo
codint
data
descricaoEx.: codigo |
cOrigem | texto · até 20 | Origem da tarefa.
Pode ser:
oportunidade
geral
cliente
produto
servico
pedido-venda
pedido-compra
pedido-importacao
contas-pagar
contas-receber
ordem-producao
ordem-servico
contrato-servicoEx.: oportunidade, geral, cliente |
cSituacao | texto · até 40 | Situação da tarefa.
Para métodos de criação e edição:
Como default será utilizado "Pendente".
Pode ser:
pendente (Pendente)
em-execucao (Em execução)
realizada (Realizada)Ex.: pendente, em-execucao, realizada |
cUrgente | texto · até 1 | Indica se a tarefa é urgente (S/N).Ex.: S, N |
dDataFinal | texto · até 10 | Filtrar tarefas até essa data |
dDataInicial | texto · até 10 | Filtrar tarefas a partir dessa data |
nCodDoc | número inteiro | Id do documento vinculado a tarefa. Esse campo varia conforme a origem da tarefa. Ele permite vincular a tarefa a um documento específico, seja ele relacionado a uma oportunidade, contas a pagar, contas a receber, entre outros. Exemplo: Se a origem da tarefa for "pedido-compra", esse campo reflete o código do pedido de compra. Se a origem da tarefa for "contas-receber", esse campo reflete o código da conta a receber. No cadastro de uma tarefa, quando a origem for "geral", não é permitido informar esse campo. |
nPagina | número inteiro | |
nRegPorPagina | número inteiro |
Retorno 7O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
cCodStatus | texto | |
cDesStatus | texto | |
listaTarefas | lista de objetos | |
listaTarefas[].cCodIntTarefa | texto | |
listaTarefas[].cDescDoc | texto | Descrição do documento vinculado a tarefa. Exemplo: Se a origem da tarefa for "pedido-compra", esse campo reflete a descrição do pedido de compra. Se a origem da tarefa for "contas-receber", esse campo reflete a descrição da conta a receber. |
listaTarefas[].cDescNotif | texto | |
listaTarefas[].cDescOrigem | texto | Nome da origem da tarefa |
listaTarefas[].cDescTipoTarefa | texto | |
listaTarefas[].cDescricao | texto | Descrição da tarefa. |
listaTarefas[].cImportante | texto | Indica se a tarefa é importante (S/N). |
listaTarefas[].cNomeUserAtb | texto | |
listaTarefas[].cOrigem | texto | Origem da tarefa. Para método de criação: Pode ser: oportunidade geral cliente produto servico pedido-venda pedido-compra pedido-importacao contas-pagar contas-receber ordem-producao ordem-servico contrato-servico |
listaTarefas[].cSituacao | texto | Situação da tarefa. Para métodos de criação e edição: Como default será utilizado "Pendente". Pode ser: pendente (Pendente) em-execucao (Em execução) realizada (Realizada) |
listaTarefas[].cUrgente | texto | Indica se a tarefa é urgente (S/N). |
listaTarefas[].dData | texto | |
listaTarefas[].hHora | texto | |
listaTarefas[].nCodDoc | número inteiro | Id do documento vinculado a tarefa. Esse campo varia conforme a origem da tarefa. Ele permite vincular a tarefa a um documento específico, seja ele relacionado a uma oportunidade, contas a pagar, contas a receber, entre outros. Exemplo: Se a origem da tarefa for "pedido-compra", esse campo reflete o código do pedido de compra. Se a origem da tarefa for "contas-receber", esse campo reflete o código da conta a receber. No cadastro de uma tarefa, quando a origem for "geral", não é permitido informar esse campo. |
listaTarefas[].nCodNotif | número inteiro | |
listaTarefas[].nCodSituacao | número inteiro | Código da situação da tarefa. |
listaTarefas[].nCodTarefa | número inteiro | Código único da tarefa. |
listaTarefas[].nCodTipoTarefa | número inteiro | Código do tipo de tarefa vinculado. Para métodos de criação e edição: Para obter os tipos de tarefa, utilize o método ObterTiposTarefa da API: /api/v1/geral/tipostarefa/ |
listaTarefas[].nCodUserAtb | número inteiro | Código do usuário atribuído. Para método de criação: Para método de edição: Para obter os possíveis usuários para alocar a tarefa, utilize o método ListarUsuarios da API: /api/v1/geral/usuarios/ |
nPagina | número inteiro | |
nRegistros | número inteiro | |
nTotPaginas | número inteiro | |
nTotRegistros | número inteiro |
POST /api/v1/geral/tarefas/
curl -s https://app.omie.com.br/api/v1/geral/tarefas/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "ListarTarefas", "param": [{"nPagina": 1, "nRegPorPagina": 20, "cOrigem": "geral"}]}'import os
import requests
corpo = {'call': 'ListarTarefas',
'param': [{'nPagina': 1, 'nRegPorPagina': 20, 'cOrigem': 'geral'}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/geral/tarefas/",
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/geral/tarefas/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "ListarTarefas",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 20,
"cOrigem": "geral"
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/tarefas/");
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": "ListarTarefas",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 20,
"cOrigem": "geral"
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/geral/tarefas/")
corpo = <<~'JSON'
{
"call": "ListarTarefas",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 20,
"cOrigem": "geral"
}
]
}
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": "ListarTarefas",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 20,
"cOrigem": "geral"
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/geral/tarefas/"))
.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/geral/tarefas/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""ListarTarefas"", ""param"": [{""nPagina"": 1, ""nRegPorPagina"": 20, ""cOrigem"": ""geral""}]}")
]
),
Dados = Json.Document(Resposta)
in
DadosMétodo para obter o calendário de tarefas no intervalo informado, retornando o resumo diário de tare
Obrigatórios 2
| Campo | Tipo | Descrição |
|---|---|---|
dDataFinal | texto · até 10 | Filtrar tarefas até essa data |
dDataInicial | texto · até 10 | Filtrar tarefas a partir dessa data |
Opcionais 3Campos e estruturas que você pode enviar
| Campo | Tipo | Descrição |
|---|---|---|
cAtribuidasAMim | texto · até 1 | Indica se deve retornar apenas as tarefas atribuídas ao usuário (S/N).Ex.: S, N |
cCriadasPorMim | texto · até 1 | Indica se deve retornar apenas as tarefas criadas pelo usuário (S/N).Ex.: S, N |
cOrigem | texto · até 20 | Origem da tarefa.
Pode ser:
oportunidade
geral
cliente
produto
servico
pedido-venda
pedido-compra
pedido-importacao
contas-pagar
contas-receber
ordem-producao
ordem-servico
contrato-servicoEx.: oportunidade, geral, cliente |
Retorno 3O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
cCodStatus | texto | |
cDesStatus | texto | |
calendario | lista de objetos | |
calendario[].cStatus | texto | Status de situação geral para o dia. Pode ser: "00" - Nenhuma tarefa mapeada para essa data "01" - Possui tarefas pendentes/execução "02" - Possui tarefas pendentes/execução (atrasados - menor que a data atual) "03" - Todas tarefas já foram concluídas |
calendario[].dData | texto | Data relacionada à consulta ou ao agrupamento de tarefas. |
calendario[].nConcluidas | número inteiro | Número de tarefas concluídas para a data. |
calendario[].nEmExecucao | número inteiro | Número de tarefas em execução para a data. |
calendario[].nPendentes | número inteiro | Número de tarefas pendentes para a data. |
POST /api/v1/geral/tarefas/
curl -s https://app.omie.com.br/api/v1/geral/tarefas/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "ObterCalendarioTarefas", "param": [{"dDataInicial": "01/10/2026", "dDataFinal": "31/10/2026"}]}'import os
import requests
corpo = {'call': 'ObterCalendarioTarefas',
'param': [{'dDataInicial': '01/10/2026', 'dDataFinal': '31/10/2026'}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/geral/tarefas/",
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/geral/tarefas/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "ObterCalendarioTarefas",
"param": [
{
"dDataInicial": "01/10/2026",
"dDataFinal": "31/10/2026"
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/tarefas/");
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": "ObterCalendarioTarefas",
"param": [
{
"dDataInicial": "01/10/2026",
"dDataFinal": "31/10/2026"
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/geral/tarefas/")
corpo = <<~'JSON'
{
"call": "ObterCalendarioTarefas",
"param": [
{
"dDataInicial": "01/10/2026",
"dDataFinal": "31/10/2026"
}
]
}
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": "ObterCalendarioTarefas",
"param": [
{
"dDataInicial": "01/10/2026",
"dDataFinal": "31/10/2026"
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/geral/tarefas/"))
.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/geral/tarefas/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""ObterCalendarioTarefas"", ""param"": [{""dDataInicial"": ""01/10/2026"", ""dDataFinal"": ""31/10/2026""}]}")
]
),
Dados = Json.Document(Resposta)
in
DadosMétodo para obter o resumo das tarefas.
Obrigatórios 0
Nenhum campo obrigatório.
Opcionais 4Campos e estruturas que você pode enviar
| Campo | Tipo | Descrição |
|---|---|---|
cApenasResumo | texto · até 1 | |
cAtribuidasAMim | texto · até 1 | Indica se deve retornar apenas as tarefas atribuídas ao usuário (S/N).Ex.: S, N |
cCriadasPorMim | texto · até 1 | Indica se deve retornar apenas as tarefas criadas pelo usuário (S/N).Ex.: S, N |
cOrigem | texto · até 20 | Origem da tarefa.
Pode ser:
oportunidade
geral
cliente
produto
servico
pedido-venda
pedido-compra
pedido-importacao
contas-pagar
contas-receber
ordem-producao
ordem-servico
contrato-servicoEx.: oportunidade, geral, cliente |
Retorno 4O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
cCodStatus | texto | |
cDesStatus | texto | |
dData | texto | Data relacionada à consulta ou ao agrupamento de tarefas. |
resumo | objeto | |
resumo.nHoje | número inteiro | Número de tarefas de hoje. |
resumo.nMesAtual | número inteiro | Número de tarefas do mês atual. |
resumo.nProximaSemana | número inteiro | Número de tarefas da próxima semana. |
resumo.nSemanaAtual | número inteiro | Número de tarefas da semana atual. |
POST /api/v1/geral/tarefas/
curl -s https://app.omie.com.br/api/v1/geral/tarefas/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "ObterResumoTarefas", "param": [{"cOrigem": "geral"}]}'import os
import requests
corpo = {'call': 'ObterResumoTarefas', 'param': [{'cOrigem': 'geral'}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/geral/tarefas/",
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/geral/tarefas/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "ObterResumoTarefas",
"param": [
{
"cOrigem": "geral"
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/tarefas/");
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": "ObterResumoTarefas",
"param": [
{
"cOrigem": "geral"
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/geral/tarefas/")
corpo = <<~'JSON'
{
"call": "ObterResumoTarefas",
"param": [
{
"cOrigem": "geral"
}
]
}
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": "ObterResumoTarefas",
"param": [
{
"cOrigem": "geral"
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/geral/tarefas/"))
.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/geral/tarefas/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""ObterResumoTarefas"", ""param"": [{""cOrigem"": ""geral""}]}")
]
),
Dados = Json.Document(Resposta)
in
DadosMétodo para obter o número de tarefas de acordo com a origem e documento.
Obrigatórios 2
| Campo | Tipo | Descrição |
|---|---|---|
cOrigem | texto · até 20 | Origem da tarefa.
Pode ser:
oportunidade
geral
cliente
produto
servico
pedido-venda
pedido-compra
pedido-importacao
contas-pagar
contas-receber
ordem-producao
ordem-servico
contrato-servicoEx.: oportunidade, geral, cliente |
nCodDoc | número inteiro | Id do documento vinculado a tarefa. Esse campo varia conforme a origem da tarefa. Ele permite vincular a tarefa a um documento específico, seja ele relacionado a uma oportunidade, contas a pagar, contas a receber, entre outros. Exemplo: Se a origem da tarefa for "pedido-compra", esse campo reflete o código do pedido de compra. Se a origem da tarefa for "contas-receber", esse campo reflete o código da conta a receber. No cadastro de uma tarefa, quando a origem for "geral", não é permitido informar esse campo. |
Retorno 3O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
cCodStatus | texto | |
cDesStatus | texto | |
nTarefas | número inteiro | Número de tarefas. |
POST /api/v1/geral/tarefas/
curl -s https://app.omie.com.br/api/v1/geral/tarefas/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "ObterTotalTarefas", "param": [{"cOrigem": "geral", "nCodDoc": 987654}]}'import os
import requests
corpo = {'call': 'ObterTotalTarefas', 'param': [{'cOrigem': 'geral', 'nCodDoc': 987654}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/geral/tarefas/",
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/geral/tarefas/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "ObterTotalTarefas",
"param": [
{
"cOrigem": "geral",
"nCodDoc": 987654
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/tarefas/");
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": "ObterTotalTarefas",
"param": [
{
"cOrigem": "geral",
"nCodDoc": 987654
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/geral/tarefas/")
corpo = <<~'JSON'
{
"call": "ObterTotalTarefas",
"param": [
{
"cOrigem": "geral",
"nCodDoc": 987654
}
]
}
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": "ObterTotalTarefas",
"param": [
{
"cOrigem": "geral",
"nCodDoc": 987654
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/geral/tarefas/"))
.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/geral/tarefas/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""ObterTotalTarefas"", ""param"": [{""cOrigem"": ""geral"", ""nCodDoc"": 987654}]}")
]
),
Dados = Json.Document(Resposta)
in
Dados