Geral · DepartamentosCadastro

Cadastro de Departamentos

POSThttps://app.omie.com.br/api/v1/geral/departamentos/WSDL

2consultas

3alterações

Claude 5 de 5 · ChatGPT 1 de 5 · MCP 5 de 5pelos assistentes de IA

JSON · XMLformato

AlterarDepartamento

altera dadosClaudeMCP

Altera os dados de um departamento existente

Obrigatórios 1

Campo	Tipo	Descrição
`codigo`	texto · até 40	Código do Departamento ou Centro de Custo

Opcionais 1Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`descricao`	texto · até 50	Nome do Departamento ou Centro de Custo

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodStatus`	texto	Código do status do processamento. Se o retorno for "0" significa que a solicitação foi executada com sucesso. Se o retorno for maior que "0" ocorreu algum erro durante o processamento da solicitação. A tag "cDesStatus" descreve o problema ocorrido.
`cDesStatus`	texto	Descrição do status do processamento. Essa tag explica o resultado da tag "cCodigoStatus".
`codigo`	texto	Código do Departamento ou Centro de Custo
`descricao`	texto	Nome do Departamento ou Centro de Custo

POST /api/v1/geral/departamentos/

curl -s https://app.omie.com.br/api/v1/geral/departamentos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AlterarDepartamento", "param": [{"descricao": "", "codigo": "000000000723648"}]}'

import os
import requests

corpo = {'call': 'AlterarDepartamento',
 'param': [{'descricao': '', 'codigo': '000000000723648'}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/geral/departamentos/",
    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/departamentos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "AlterarDepartamento",
    "param": [
      {
        "descricao": "",
        "codigo": "000000000723648"
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/departamentos/");
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": "AlterarDepartamento",
    "param": [
        {
            "descricao": "",
            "codigo": "000000000723648"
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/geral/departamentos/")
corpo = <<~'JSON'
{
  "call": "AlterarDepartamento",
  "param": [
    {
      "descricao": "",
      "codigo": "000000000723648"
    }
  ]
}
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": "AlterarDepartamento",
  "param": [
    {
      "descricao": "",
      "codigo": "000000000723648"
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/geral/departamentos/"))
    .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/departamentos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""AlterarDepartamento"", ""param"": [{""descricao"": """", ""codigo"": ""000000000723648""}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

ConsultarDepartamento

consultaClaudeMCP

Consulta um código de departamento.

Obrigatórios 1

Campo	Tipo	Descrição
`codigo`	texto · até 40	Código do Departamento

Retorno 5O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`codigo`	texto	Código do Departamento ou Centro de Custo
`descricao`	texto	Nome do Departamento ou Centro de Custo
`estrutura`	texto	Utilizado para estruturação dos Departamentos no modo "diagrama"
`inativo`	texto	Indica que o Departamento ou Centro de Custo está inativo
`nivel_totalizador`	texto	Indica que o Departamento ou Centro de Custo é um nível totalizador

POST /api/v1/geral/departamentos/

curl -s https://app.omie.com.br/api/v1/geral/departamentos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ConsultarDepartamento", "param": [{"codigo": ""}]}'

import os
import requests

corpo = {'call': 'ConsultarDepartamento', 'param': [{'codigo': ''}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/geral/departamentos/",
    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/departamentos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "ConsultarDepartamento",
    "param": [
      {
        "codigo": ""
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/departamentos/");
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": "ConsultarDepartamento",
    "param": [
        {
            "codigo": ""
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/geral/departamentos/")
corpo = <<~'JSON'
{
  "call": "ConsultarDepartamento",
  "param": [
    {
      "codigo": ""
    }
  ]
}
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": "ConsultarDepartamento",
  "param": [
    {
      "codigo": ""
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/geral/departamentos/"))
    .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/departamentos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""ConsultarDepartamento"", ""param"": [{""codigo"": """"}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

ExcluirDepartamento

altera dadosClaudeMCP

Exclui um departamento do cadastro

Obrigatórios 1

Campo	Tipo	Descrição
`codigo`	texto · até 40	Código do Departamento ou Centro de Custo

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodStatus`	texto	Código do status do processamento. Se o retorno for "0" significa que a solicitação foi executada com sucesso. Se o retorno for maior que "0" ocorreu algum erro durante o processamento da solicitação. A tag "cDesStatus" descreve o problema ocorrido.
`cDesStatus`	texto	Descrição do status do processamento. Essa tag explica o resultado da tag "cCodigoStatus".
`codigo`	texto	Código do Departamento ou Centro de Custo
`descricao`	texto	Nome do Departamento ou Centro de Custo

POST /api/v1/geral/departamentos/

curl -s https://app.omie.com.br/api/v1/geral/departamentos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ExcluirDepartamento", "param": [{"codigo": ""}]}'

import os
import requests

corpo = {'call': 'ExcluirDepartamento', 'param': [{'codigo': ''}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/geral/departamentos/",
    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/departamentos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "ExcluirDepartamento",
    "param": [
      {
        "codigo": ""
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/departamentos/");
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": "ExcluirDepartamento",
    "param": [
        {
            "codigo": ""
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/geral/departamentos/")
corpo = <<~'JSON'
{
  "call": "ExcluirDepartamento",
  "param": [
    {
      "codigo": ""
    }
  ]
}
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": "ExcluirDepartamento",
  "param": [
    {
      "codigo": ""
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/geral/departamentos/"))
    .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/departamentos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""ExcluirDepartamento"", ""param"": [{""codigo"": """"}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

IncluirDepartamento

altera dadosClaudeMCP

Inclui um novo departamento no cadastro

Obrigatórios 1

Campo	Tipo	Descrição
`codigo`	texto · até 40	Código do Departamento ou Centro de Custo pai no qual você deseja incluir o novo departamento.

Opcionais 1Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`descricao`	texto · até 50	Nome do Departamento ou Centro de Custo

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodStatus`	texto	Código do status do processamento. Se o retorno for "0" significa que a solicitação foi executada com sucesso. Se o retorno for maior que "0" ocorreu algum erro durante o processamento da solicitação. A tag "cDesStatus" descreve o problema ocorrido.
`cDesStatus`	texto	Descrição do status do processamento. Essa tag explica o resultado da tag "cCodigoStatus".
`codigo`	texto	Código do Departamento ou Centro de Custo
`descricao`	texto	Nome do Departamento ou Centro de Custo

POST /api/v1/geral/departamentos/

curl -s https://app.omie.com.br/api/v1/geral/departamentos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "IncluirDepartamento", "param": [{"descricao": "", "codigo": "000000000723648"}]}'

import os
import requests

corpo = {'call': 'IncluirDepartamento',
 'param': [{'descricao': '', 'codigo': '000000000723648'}]}

resp = requests.post(
    "https://app.omie.com.br/api/v1/geral/departamentos/",
    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/departamentos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "IncluirDepartamento",
    "param": [
      {
        "descricao": "",
        "codigo": "000000000723648"
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/departamentos/");
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": "IncluirDepartamento",
    "param": [
        {
            "descricao": "",
            "codigo": "000000000723648"
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/geral/departamentos/")
corpo = <<~'JSON'
{
  "call": "IncluirDepartamento",
  "param": [
    {
      "descricao": "",
      "codigo": "000000000723648"
    }
  ]
}
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": "IncluirDepartamento",
  "param": [
    {
      "descricao": "",
      "codigo": "000000000723648"
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/geral/departamentos/"))
    .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/departamentos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""IncluirDepartamento"", ""param"": [{""descricao"": """", ""codigo"": ""000000000723648""}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

ListarDepartamentos

consultaClaudeChatGPTMCP

Lista os departamentos cadastrados no Omie.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`pagina`	número inteiro	Número da página de registros.
`registros_por_pagina`	número inteiro	Quantidade de registros por página retornados na consulta.

Descontinuados 7Ainda aceitos, fora do fluxo principal

Campo	Tipo	Descrição
`apenas_importado_api`descontinuado	texto · até 1	DEPRECATED
`filtrar_apenas_alteracao`descontinuado	texto · até 1	DEPRECATED
`filtrar_apenas_inclusao`descontinuado	texto · até 1	DEPRECATED
`filtrar_por_data_ate`descontinuado	texto · até 10	DEPRECATED
`filtrar_por_data_de`descontinuado	texto · até 10	DEPRECATED
`ordem_descrescente`descontinuado	texto · até 1	DEPRECATED
`ordenar_por`descontinuado	texto · até 100	DEPRECATED

Retorno 5O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`departamentos`	lista de objetos
`departamentos[].codigo`	texto	Código do Departamento ou Centro de Custo
`departamentos[].descricao`	texto	Nome do Departamento ou Centro de Custo
`departamentos[].estrutura`	texto	Utilizado para estruturação dos Departamentos no modo "diagrama"
`departamentos[].inativo`	texto	Indica que o Departamento ou Centro de Custo está inativo
`departamentos[].nivel_totalizador`	texto	Indica que o Departamento ou Centro de Custo é um nível totalizador
`pagina`	número inteiro	Número da página de registros.
`registros`	número inteiro	Quantidade de registros retornados nesta página.
`total_de_paginas`	número inteiro	Quantidade total de páginas disponíveis para a consulta.
`total_de_registros`	número inteiro	Quantidade total de registros encontrados pela consulta.

POST /api/v1/geral/departamentos/

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

import os
import requests

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

resp = requests.post(
    "https://app.omie.com.br/api/v1/geral/departamentos/",
    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/departamentos/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "call": "ListarDepartamentos",
    "param": [
      {
        "pagina": 1,
        "registros_por_pagina": 50
      }
    ]
  }),
});
console.log(await resp.json());

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/departamentos/");
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": "ListarDepartamentos",
    "param": [
        {
            "pagina": 1,
            "registros_por_pagina": 50
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/geral/departamentos/")
corpo = <<~'JSON'
{
  "call": "ListarDepartamentos",
  "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": "ListarDepartamentos",
  "param": [
    {
      "pagina": 1,
      "registros_por_pagina": 50
    }
  ]
}
""";

var pedido = HttpRequest.newBuilder()
    .uri(URI.create("https://app.omie.com.br/api/v1/geral/departamentos/"))
    .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/departamentos/",
        [
            Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
            Content = Text.ToBinary("{""call"": ""ListarDepartamentos"", ""param"": [{""pagina"": 1, ""registros_por_pagina"": 50}]}")
        ]
    ),
    Dados = Json.Document(Resposta)
in
    Dados

Operações

AlterarDepartamento
ConsultarDepartamento
ExcluirDepartamento
IncluirDepartamento
ListarDepartamentos