Geral · ClientesTags

Cadastro de Tags de Clientes

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

1consulta

3alterações

Claude · MCPpelos assistentes de IA

JSON · XMLformato

ExcluirTags

altera dadosClaudeMCP

Remove tags associadas a um cliente.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 3Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cCodIntCliente`	texto · até 60	Código de integração do cliente. (Utilizado para integração via API, não aparece na tela)
`nCodCliente`	número inteiro	Código do cliente. (Código interno utilizado apenas na API, não aparece na tela).
`tags`	lista de objetos	Tags do Cliente ou Fornecedor
`tags[].tag`	texto · até 50

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodIntCliente`	texto	Código de integração do cliente. (Utilizado para integração via API, não aparece na tela)
`cCodStatus`	texto	Código do Status.
`cDesStatus`	texto	Descrição do Status.
`nCodCliente`	número inteiro	Código do cliente. (Código interno utilizado apenas na API, não aparece na tela).

POST /api/v1/geral/clientetag/

curl -s https://app.omie.com.br/api/v1/geral/clientetag/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ExcluirTags", "param": [{"nCodCliente": 0, "cCodIntCliente": "", "tags": [{"tag": "Grupo A"}, {"tag": "Grupo B"}]}]}'

import os
import requests

corpo = {'call': 'ExcluirTags',
 'param': [{'nCodCliente': 0,
            'cCodIntCliente': '',
            'tags': [{'tag': 'Grupo A'}, {'tag': 'Grupo B'}]}]}

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

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/clientetag/");
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": "ExcluirTags",
    "param": [
        {
            "nCodCliente": 0,
            "cCodIntCliente": "",
            "tags": [
                {
                    "tag": "Grupo A"
                },
                {
                    "tag": "Grupo B"
                }
            ]
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/geral/clientetag/")
corpo = <<~'JSON'
{
  "call": "ExcluirTags",
  "param": [
    {
      "nCodCliente": 0,
      "cCodIntCliente": "",
      "tags": [
        {
          "tag": "Grupo A"
        },
        {
          "tag": "Grupo B"
        }
      ]
    }
  ]
}
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": "ExcluirTags",
  "param": [
    {
      "nCodCliente": 0,
      "cCodIntCliente": "",
      "tags": [
        {
          "tag": "Grupo A"
        },
        {
          "tag": "Grupo B"
        }
      ]
    }
  ]
}
""";

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

ExcluirTodas

altera dadosClaudeMCP

Remove todas as tags associadas a um cliente.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cCodIntCliente`	texto · até 60	Código de integração do cliente. (Utilizado para integração via API, não aparece na tela)
`nCodCliente`	número inteiro	Código do cliente. (Código interno utilizado apenas na API, não aparece na tela).

Retorno 4O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodIntCliente`	texto	Código de integração do cliente. (Utilizado para integração via API, não aparece na tela)
`cCodStatus`	texto	Código do Status.
`cDesStatus`	texto	Descrição do Status.
`nCodCliente`	número inteiro	Código do cliente. (Código interno utilizado apenas na API, não aparece na tela).

POST /api/v1/geral/clientetag/

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

import os
import requests

corpo = {'call': 'ExcluirTodas', 'param': [{'nCodCliente': 0, 'cCodIntCliente': ''}]}

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

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

require "net/http"

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

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

IncluirTags

altera dadosClaudeMCP

Associa tags a um cliente.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 3Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cCodIntCliente`	texto · até 60	Código de integração do cliente. (Utilizado para integração via API, não aparece na tela)
`nCodCliente`	número inteiro	Código do cliente. (Código interno utilizado apenas na API, não aparece na tela).
`tags`	lista de objetos	Tags do Cliente ou Fornecedor
`tags[].tag`	texto · até 50

Retorno 5O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodIntCliente`	texto	Código de integração do cliente. (Utilizado para integração via API, não aparece na tela)
`cCodStatus`	texto	Código do Status.
`cDesStatus`	texto	Descrição do Status.
`nCodCliente`	número inteiro	Código do cliente. (Código interno utilizado apenas na API, não aparece na tela).
`tagsLista`	lista de objetos	Tags do Cliente ou Fornecedor.
`tagsLista[].nCodTag`	número inteiro	Código da Tag. Criada pelo Omie no momento da inclusão.
`tagsLista[].tag`	texto

POST /api/v1/geral/clientetag/

curl -s https://app.omie.com.br/api/v1/geral/clientetag/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "IncluirTags", "param": [{"nCodCliente": 0, "cCodIntCliente": "", "tags": [{"tag": "Grupo A"}, {"tag": "Grupo B"}]}]}'

import os
import requests

corpo = {'call': 'IncluirTags',
 'param': [{'nCodCliente': 0,
            'cCodIntCliente': '',
            'tags': [{'tag': 'Grupo A'}, {'tag': 'Grupo B'}]}]}

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

<?php
$ch = curl_init("https://app.omie.com.br/api/v1/geral/clientetag/");
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": "IncluirTags",
    "param": [
        {
            "nCodCliente": 0,
            "cCodIntCliente": "",
            "tags": [
                {
                    "tag": "Grupo A"
                },
                {
                    "tag": "Grupo B"
                }
            ]
        }
    ]
}
JSON,
]);
echo curl_exec($ch);

require "net/http"

uri = URI("https://app.omie.com.br/api/v1/geral/clientetag/")
corpo = <<~'JSON'
{
  "call": "IncluirTags",
  "param": [
    {
      "nCodCliente": 0,
      "cCodIntCliente": "",
      "tags": [
        {
          "tag": "Grupo A"
        },
        {
          "tag": "Grupo B"
        }
      ]
    }
  ]
}
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": "IncluirTags",
  "param": [
    {
      "nCodCliente": 0,
      "cCodIntCliente": "",
      "tags": [
        {
          "tag": "Grupo A"
        },
        {
          "tag": "Grupo B"
        }
      ]
    }
  ]
}
""";

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

ListarTags

consultaClaudeMCP

Lista as tags de um determinado cliente.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar

Campo	Tipo	Descrição
`cCodIntCliente`	texto · até 60	Código de integração do cliente. (Utilizado para integração via API, não aparece na tela)
`nCodCliente`	número inteiro	Código do cliente. (Código interno utilizado apenas na API, não aparece na tela).

Retorno 3O que volta numa chamada bem-sucedida

Campo	Tipo	Descrição
`cCodIntCliente`	texto	Código de integração do cliente. (Utilizado para integração via API, não aparece na tela)
`nCodCliente`	número inteiro	Código do cliente. (Código interno utilizado apenas na API, não aparece na tela).
`tagsLista`	lista de objetos	Tags do Cliente ou Fornecedor.
`tagsLista[].nCodTag`	número inteiro	Código da Tag. Criada pelo Omie no momento da inclusão.
`tagsLista[].tag`	texto

POST /api/v1/geral/clientetag/

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

import os
import requests

corpo = {'call': 'ListarTags', 'param': [{'nCodCliente': 0, 'cCodIntCliente': ''}]}

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

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

require "net/http"

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

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

Operações

ExcluirTags
ExcluirTodas
IncluirTags
ListarTags