OpenAPITodas as operações em OpenAPI (Postman, Insomnia).
Geral · Tarefas

Tarefas do ERP

POSThttps://app.omie.com.br/api/v1/geral/tarefas/WSDL
5consultas
3alterações
Claude 8 de 8 · ChatGPT 1 de 8 · MCP 8 de 8pelos assistentes de IA
JSON · XMLformato

AlterarTarefa

altera dadosClaudeMCP

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
CampoTipoDescrição
cCodIntTarefatexto · até 20
cDescricaotextoDescrição da tarefa.
cImportantetexto · até 1Indica se a tarefa é importante (S/N).Ex.: S, N
cSituacaotexto · até 40Situaçã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
cUrgentetexto · até 1Indica se a tarefa é urgente (S/N).Ex.: S, N
dDatatexto
hHoratexto · até 5
nCodAtividadenúmero inteiroCó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/
nCodNotifnúmero inteiroCó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)
nCodTarefanúmero inteiroCódigo único da tarefa.
nCodUserAtbnúmero inteiroCó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
CampoTipoDescrição
cCodStatustexto
cDesStatustexto
nCodTarefanúmero inteiroCó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"}]}'

ConsultarTarefa

consultaClaudeMCP

Método para realizar a consulta de uma tarefa.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntTarefatexto · até 20
nCodTarefanúmero inteiroCódigo único da tarefa.
Retorno 3O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodStatustexto
cDesStatustexto
tarefaobjeto
tarefa.cCodIntTarefatexto
tarefa.cDescDoctextoDescriçã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.cDescNotiftexto
tarefa.cDescTipoTarefatexto
tarefa.cDescricaotextoDescrição da tarefa.
tarefa.cImportantetextoIndica se a tarefa é importante (S/N).
tarefa.cNomeUserAtbtexto
tarefa.cOrigemtextoOrigem 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.cSituacaotextoSituaçã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.cUrgentetextoIndica se a tarefa é urgente (S/N).
tarefa.dDatatexto
tarefa.hHoratexto
tarefa.nCodDocnúmero inteiroId 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.nCodNotifnúmero inteiro
tarefa.nCodSituacaonúmero inteiroCódigo da situação da tarefa.
tarefa.nCodTarefanúmero inteiroCódigo único da tarefa.
tarefa.nCodTipoTarefanúmero inteiroCó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.nCodUserAtbnúmero inteiroCó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}]}'

ExcluirTarefa

altera dadosClaudeMCP

Método para realizar a exclusão de uma tarefa.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntTarefatexto · até 20
nCodTarefanúmero inteiroCódigo único da tarefa.
Retorno 2O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodStatustexto
cDesStatustexto
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}]}'

IncluirTarefa

altera dadosClaudeMCP

Método para realizar a inclusão de uma tarefa.

Obrigatórios 4

CampoTipoDescrição
cOrigemtexto · até 20Origem 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
dDatatexto
hHoratexto · até 5
nCodUserAtbnúmero inteiroCó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
CampoTipoDescrição
cCodIntTarefatexto · até 20
cDescricaotextoDescrição da tarefa.
cImportantetexto · até 1Indica se a tarefa é importante (S/N).Ex.: S, N
cSituacaotexto · até 40Situaçã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
cUrgentetexto · até 1Indica se a tarefa é urgente (S/N).Ex.: S, N
nCodAtividadenúmero inteiroCó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/
nCodDocnúmero inteiroId 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.
nCodNotifnúmero inteiroCó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
CampoTipoDescrição
cCodStatustexto
cDesStatustexto
nCodTarefanúmero inteiroCó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}]}'

ListarTarefas

consultaClaudeChatGPTMCP

Mé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
CampoTipoDescrição
cAtribuidasAMimtexto · até 1Indica se deve retornar apenas as tarefas atribuídas ao usuário (S/N).Ex.: S, N
cCriadasPorMimtexto · até 1Indica se deve retornar apenas as tarefas criadas pelo usuário (S/N).Ex.: S, N
cImportantetexto · até 1Indica se a tarefa é importante (S/N).Ex.: S, N
cIntervalotexto · até 30Filtrar 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
cOrdemDesctexto · até 1Indica se a ordem de exibição é decrescente (S/N). Caso não informado, o padrão é "N".Ex.: S, N
cOrdenarPortexto · até 100Ordem de exibição dos dados. Quando não preenchido o padrão será por código Pode ser: codigo codint data descricaoEx.: codigo
cOrigemtexto · até 20Origem 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
cSituacaotexto · até 40Situaçã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
cUrgentetexto · até 1Indica se a tarefa é urgente (S/N).Ex.: S, N
dDataFinaltexto · até 10Filtrar tarefas até essa data
dDataInicialtexto · até 10Filtrar tarefas a partir dessa data
nCodDocnúmero inteiroId 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.
nPaginanúmero inteiro
nRegPorPaginanúmero inteiro
Retorno 7O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodStatustexto
cDesStatustexto
listaTarefaslista de objetos
listaTarefas[].cCodIntTarefatexto
listaTarefas[].cDescDoctextoDescriçã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[].cDescNotiftexto
listaTarefas[].cDescOrigemtextoNome da origem da tarefa
listaTarefas[].cDescTipoTarefatexto
listaTarefas[].cDescricaotextoDescrição da tarefa.
listaTarefas[].cImportantetextoIndica se a tarefa é importante (S/N).
listaTarefas[].cNomeUserAtbtexto
listaTarefas[].cOrigemtextoOrigem 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[].cSituacaotextoSituaçã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[].cUrgentetextoIndica se a tarefa é urgente (S/N).
listaTarefas[].dDatatexto
listaTarefas[].hHoratexto
listaTarefas[].nCodDocnúmero inteiroId 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[].nCodNotifnúmero inteiro
listaTarefas[].nCodSituacaonúmero inteiroCódigo da situação da tarefa.
listaTarefas[].nCodTarefanúmero inteiroCódigo único da tarefa.
listaTarefas[].nCodTipoTarefanúmero inteiroCó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[].nCodUserAtbnúmero inteiroCó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/
nPaginanúmero inteiro
nRegistrosnúmero inteiro
nTotPaginasnúmero inteiro
nTotRegistrosnú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"}]}'

ObterCalendarioTarefas

consultaClaudeMCP

Método para obter o calendário de tarefas no intervalo informado, retornando o resumo diário de tare

Obrigatórios 2

CampoTipoDescrição
dDataFinaltexto · até 10Filtrar tarefas até essa data
dDataInicialtexto · até 10Filtrar tarefas a partir dessa data
Opcionais 3Campos e estruturas que você pode enviar
CampoTipoDescrição
cAtribuidasAMimtexto · até 1Indica se deve retornar apenas as tarefas atribuídas ao usuário (S/N).Ex.: S, N
cCriadasPorMimtexto · até 1Indica se deve retornar apenas as tarefas criadas pelo usuário (S/N).Ex.: S, N
cOrigemtexto · até 20Origem 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
CampoTipoDescrição
cCodStatustexto
cDesStatustexto
calendariolista de objetos
calendario[].cStatustextoStatus 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[].dDatatextoData relacionada à consulta ou ao agrupamento de tarefas.
calendario[].nConcluidasnúmero inteiroNúmero de tarefas concluídas para a data.
calendario[].nEmExecucaonúmero inteiroNúmero de tarefas em execução para a data.
calendario[].nPendentesnúmero inteiroNú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"}]}'

ObterResumoTarefas

consultaClaudeMCP

Método para obter o resumo das tarefas.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 4Campos e estruturas que você pode enviar
CampoTipoDescrição
cApenasResumotexto · até 1
cAtribuidasAMimtexto · até 1Indica se deve retornar apenas as tarefas atribuídas ao usuário (S/N).Ex.: S, N
cCriadasPorMimtexto · até 1Indica se deve retornar apenas as tarefas criadas pelo usuário (S/N).Ex.: S, N
cOrigemtexto · até 20Origem 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
CampoTipoDescrição
cCodStatustexto
cDesStatustexto
dDatatextoData relacionada à consulta ou ao agrupamento de tarefas.
resumoobjeto
resumo.nHojenúmero inteiroNúmero de tarefas de hoje.
resumo.nMesAtualnúmero inteiroNúmero de tarefas do mês atual.
resumo.nProximaSemananúmero inteiroNúmero de tarefas da próxima semana.
resumo.nSemanaAtualnúmero inteiroNú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"}]}'

ObterTotalTarefas

consultaClaudeMCP

Método para obter o número de tarefas de acordo com a origem e documento.

Obrigatórios 2

CampoTipoDescrição
cOrigemtexto · até 20Origem 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
nCodDocnúmero inteiroId 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
CampoTipoDescrição
cCodStatustexto
cDesStatustexto
nTarefasnúmero inteiroNú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}]}'