OpenAPITodas as operações em OpenAPI (Postman, Insomnia).
Produtos · TabelaPrecos

Tabela de Preços

POSThttps://app.omie.com.br/api/v1/produtos/tabelaprecos/WSDL
3consultas
7alterações
Claude 10 de 10 · ChatGPT 1 de 10 · MCP 10 de 10pelos assistentes de IA
JSON · XMLformato

AlterarPrecoItem

altera dadosClaudeMCP

Altera o preço de um item da Tabela de Preços.

Obrigatórios 2

CampoTipoDescrição
nCodProdnúmero inteiroCódigo do produto. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno do produto gerado pelo Omie.
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
Opcionais 1Campos e estruturas que você pode enviar
CampoTipoDescrição
nValorTabelanúmeroValor do Item da Tabela de Preços.
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodStatustextoCó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 duranteo o processamento da solicitação. A tag "cDesStatus" descreve o problema ocorrido.
cDesStatustextoDescrição do status do processamento. Essa tag explica o resultado da tag "cCodigoStatus".
nCodProdnúmero inteiroCódigo do produto. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno do produto gerado pelo Omie.
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
POST /api/v1/produtos/tabelaprecos/
curl -s https://app.omie.com.br/api/v1/produtos/tabelaprecos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AlterarPrecoItem", "param": [{"nCodTabPreco": 0, "nCodProd": 0, "nValorTabela": 0}]}'

AlterarTabelaPreco

altera dadosClaudeMCP

Altera uma tabela de preços.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 9Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntTabPrecotexto · até 20Código de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
cCodigotexto · até 20Código da Tabela de Preço. (Exibido na tela do aplicativo).
cNometexto · até 50Nome da Tabela de Preço.
cOrigemtexto · até 3Origem da Tabela de Preços. Pode ser: PRD - Lê o preço do cadastro de produtos. CMC - Lê o preço do CMC do produto. TBL - Lê o preço de uma tabela específica informada na tag "nCodOrigTab".
caracteristicasobjetoCaracterísticas da tabela de preço.
caracteristicas.cArredPrecotexto · até 1Indica se deve Arredondar o preço dos produtos (S/N).
caracteristicas.cTemDescontotexto · até 1Indica se a Tabela de Preço possui Desconto Sugerido ou Máximo (S/N).
caracteristicas.cTemValidadetexto · até 1Indica se a Tabela de Preço possui Validade (S/N).
caracteristicas.dDtFinaltexto · até 10Data Final de Validade Tabela de Preço. No formato dd/mm/aaaa.
caracteristicas.dDtInicialtexto · até 10Data Inicial da Validade da Tabela de Preço. No formato dd/mm/aaaa.
caracteristicas.nDescSugeridonúmeroPercentual de Desconto Sugerido.
caracteristicas.nPercDescMaxnúmeroPercentual de Desconto Máximo Permitido.
clientesobjetoDados dos filtros do cliente.
clientes.cTagtexto · até 50Descrição da tag do cliente informada no campo nCodTag. O conteúdo deste campo é apenas informativo e não tem efeito na inclusão. Na inclusão utilize a tag "nCodTag".
clientes.cTodosClientestexto · até 1Considerar todos os clientes nesta tabela de preços? (S/N) O padrão é "S". Quando informar "S", todos os demais campos deste grupo serão desconsiderados. Caso informe "N", pelo menos 1 dos campos deste grupo deverá ser informado.
clientes.cUFtexto · até 2Considerar apenas os clientes do Estado. Será ignorado caso o campo "cTodosClientes" estiver preenhido com "S".
clientes.nCodTagnúmero inteiroConsiderar apenas os clientes de uma determinada Tag. Será ignorado caso o campo "cTodosClientes" estiver preenhido com "S".
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
outrasInfoobjetoOutros filtros da tabela de preços.
outrasInfo.nCodOrigTabnúmero inteiroCódigo da Tabela de Preço Original.
outrasInfo.nPercAcrescimonúmeroPercentual de Acréscimo da tabela de preços.
outrasInfo.nPercDescontonúmeroPercentual de Desconto da tabela de preços.
produtosobjetoDados dos filtros por produto.
produtos.cConteudotexto · até 60Conteúdo da característica. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.cNCMtexto · até 13Código do NCM. No formato 9999.99.99 Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.cTodosProdutostexto · até 1Considerar todos os produtos nesta tabela de preços? (S/N) O padrão é "S". Quando informar "S", todos os demais campos deste grupo serão desconsiderados. Caso informe "N", pelo menos 1 dos campos deste grupo deverá ser informado.
produtos.nCodCaractnúmero inteiroCódigo da característica de produto. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da característica do produto gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.nCodFamilianúmero inteiroCódigo da família. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da família gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.nCodFornecnúmero inteiroCódigo do fornecedor. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno do fornecedor gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntTabPrecotextoCódigo de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
cCodStatustextoCó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 duranteo o processamento da solicitação. A tag "cDesStatus" descreve o problema ocorrido.
cDesStatustextoDescrição do status do processamento. Essa tag explica o resultado da tag "cCodigoStatus".
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
POST /api/v1/produtos/tabelaprecos/
curl -s https://app.omie.com.br/api/v1/produtos/tabelaprecos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AlterarTabelaPreco", "param": [{"nCodTabPreco": 0, "cCodIntTabPreco": "TP1790776581", "cNome": "", "cCodigo": "", "cOrigem": "", "produtos": {"cTodosProdutos": "S", "nCodFamilia": 0, "cNCM": "", "nCodCaract": 0, "cConteudo": "", "nCodFornec": 0}, "clientes": {"cTodosClientes": "S", "nCodTag": 0, "cTag": "", "cUF": ""}, "outrasInfo": {"nCodOrigTab": 0, "nPercAcrescimo": 0, "nPercDesconto": 0}, "caracteristicas": {"cTemValidade": "S", "dDtInicial": "30/09/2026", "dDtFinal": "30/09/2026", "cTemDesconto": "", "nDescSugerido": 0, "nPercDescMax": 0, "cArredPreco": "N"}}]}'

AtivarTabelaPreco

altera dadosClaudeMCP

Ativa uma tabela de preços.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntTabPrecotexto · até 20Código de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntTabPrecotextoCódigo de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
cCodStatustextoCó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 duranteo o processamento da solicitação. A tag "cDesStatus" descreve o problema ocorrido.
cDesStatustextoDescrição do status do processamento. Essa tag explica o resultado da tag "cCodigoStatus".
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
POST /api/v1/produtos/tabelaprecos/
curl -s https://app.omie.com.br/api/v1/produtos/tabelaprecos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AtivarTabelaPreco", "param": [{"nCodTabPreco": 0, "cCodIntTabPreco": ""}]}'

AtualizarProdutos

altera dadosClaudeMCP

Atualiza os produtos da tabela de preços.

Obrigatórios 1

CampoTipoDescrição
cArredPrecotexto · até 1Indica se deve Arredondar o preço dos produtos (S/N).
Opcionais 4Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntTabPrecotexto · até 20Código de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
nPercAcrescimonúmeroPercentual de Acréscimo da tabela de preços.
nPercDescontonúmeroPercentual de Desconto da tabela de preços.
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntTabPrecotextoCódigo de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
cCodStatustextoCó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 duranteo o processamento da solicitação. A tag "cDesStatus" descreve o problema ocorrido.
cDesStatustextoDescrição do status do processamento. Essa tag explica o resultado da tag "cCodigoStatus".
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
POST /api/v1/produtos/tabelaprecos/
curl -s https://app.omie.com.br/api/v1/produtos/tabelaprecos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AtualizarProdutos", "param": [{"nCodTabPreco": 0, "cCodIntTabPreco": ""}]}'

ConsultarTabelaPreco

consultaClaudeMCP

Consulta uma tabela de preços.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntTabPrecotexto · até 20Código de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
Retorno 11O que volta numa chamada bem-sucedida
CampoTipoDescrição
cAtivatextoIndica se a tabela de preços está ativa (S/N).
cCodIntTabPrecotextoCódigo de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
cCodigotextoCódigo da Tabela de Preço. (Exibido na tela do aplicativo).
cNometextoNome da Tabela de Preço.
cOrigemtextoOrigem da Tabela de Preços. Pode ser: PRD - Lê o preço do cadastro de produtos. CMC - Lê o preço do CMC do produto. TBL - Lê o preço de uma tabela específica informada na tag "nCodOrigTab".
caracteristicasobjetoCaracterísticas da tabela de preço.
caracteristicas.cArredPrecotextoIndica se deve Arredondar o preço dos produtos (S/N).
caracteristicas.cTemDescontotextoIndica se a Tabela de Preço possui Desconto Sugerido ou Máximo (S/N).
caracteristicas.cTemValidadetextoIndica se a Tabela de Preço possui Validade (S/N).
caracteristicas.dDtFinaltextoData Final de Validade Tabela de Preço. No formato dd/mm/aaaa.
caracteristicas.dDtInicialtextoData Inicial da Validade da Tabela de Preço. No formato dd/mm/aaaa.
caracteristicas.nDescSugeridodecimalPercentual de Desconto Sugerido.
caracteristicas.nPercDescMaxdecimalPercentual de Desconto Máximo Permitido.
clientesobjetoDados dos filtros do cliente.
clientes.cTagtextoDescrição da tag do cliente informada no campo nCodTag. O conteúdo deste campo é apenas informativo e não tem efeito na inclusão. Na inclusão utilize a tag "nCodTag".
clientes.cTodosClientestextoConsiderar todos os clientes nesta tabela de preços? (S/N) O padrão é "S". Quando informar "S", todos os demais campos deste grupo serão desconsiderados. Caso informe "N", pelo menos 1 dos campos deste grupo deverá ser informado.
clientes.cUFtextoConsiderar apenas os clientes do Estado. Será ignorado caso o campo "cTodosClientes" estiver preenhido com "S".
clientes.nCodTagnúmero inteiroConsiderar apenas os clientes de uma determinada Tag. Será ignorado caso o campo "cTodosClientes" estiver preenhido com "S".
infoobjetoInformações do cadastro da tabela de preços.
info.cImpAPItextoImportado pela API (S/N).
info.dAlttextoData da Alteração. No formato dd/mm/aaaa.
info.dInctextoData da Inclusão. No formato dd/mm/aaaa.
info.hAlttextoHora da Alteração. No formato hh:mm:ss.
info.hInctextoHora da Inclusão. No formato hh:mm:ss.
info.uAlttextoUsuário da Alteração.
info.uInctextoUsuário da Inclusão.
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
outrasInfoobjetoOutros filtros da tabela de preços.
outrasInfo.nCodOrigTabnúmero inteiroCódigo da Tabela de Preço Original.
outrasInfo.nPercAcrescimodecimalPercentual de Acréscimo da tabela de preços.
outrasInfo.nPercDescontodecimalPercentual de Desconto da tabela de preços.
produtosobjetoDados dos filtros por produto.
produtos.cConteudotextoConteúdo da característica. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.cNCMtextoCódigo do NCM. No formato 9999.99.99 Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.cTodosProdutostextoConsiderar todos os produtos nesta tabela de preços? (S/N) O padrão é "S". Quando informar "S", todos os demais campos deste grupo serão desconsiderados. Caso informe "N", pelo menos 1 dos campos deste grupo deverá ser informado.
produtos.nCodCaractnúmero inteiroCódigo da característica de produto. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da característica do produto gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.nCodFamilianúmero inteiroCódigo da família. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da família gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.nCodFornecnúmero inteiroCódigo do fornecedor. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno do fornecedor gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
POST /api/v1/produtos/tabelaprecos/
curl -s https://app.omie.com.br/api/v1/produtos/tabelaprecos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ConsultarTabelaPreco", "param": [{"nCodTabPreco": 0, "cCodIntTabPreco": ""}]}'

ExcluirTabelaPreco

altera dadosClaudeMCP

Exclui uma tabela de preços.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntTabPrecotexto · até 20Código de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntTabPrecotextoCódigo de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
cCodStatustextoCó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 duranteo o processamento da solicitação. A tag "cDesStatus" descreve o problema ocorrido.
cDesStatustextoDescrição do status do processamento. Essa tag explica o resultado da tag "cCodigoStatus".
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
POST /api/v1/produtos/tabelaprecos/
curl -s https://app.omie.com.br/api/v1/produtos/tabelaprecos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ExcluirTabelaPreco", "param": [{"nCodTabPreco": 0, "cCodIntTabPreco": ""}]}'

IncluirTabelaPreco

altera dadosClaudeMCP

Inclui uma tabela de preços.

Obrigatórios 3

CampoTipoDescrição
cCodIntTabPrecotexto · até 20Código de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
cNometexto · até 50Nome da Tabela de Preço.
cOrigemtexto · até 3Origem da Tabela de Preços. Pode ser: PRD - Lê o preço do cadastro de produtos. CMC - Lê o preço do CMC do produto. TBL - Lê o preço de uma tabela específica informada na tag "nCodOrigTab".
Opcionais 5Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodigotexto · até 20Código da Tabela de Preço. (Exibido na tela do aplicativo).
caracteristicasobjetoCaracterísticas da tabela de preço.
caracteristicas.cArredPrecotexto · até 1Indica se deve Arredondar o preço dos produtos (S/N).
caracteristicas.cTemDescontotexto · até 1Indica se a Tabela de Preço possui Desconto Sugerido ou Máximo (S/N).
caracteristicas.cTemValidadetexto · até 1Indica se a Tabela de Preço possui Validade (S/N).
caracteristicas.dDtFinaltexto · até 10Data Final de Validade Tabela de Preço. No formato dd/mm/aaaa.
caracteristicas.dDtInicialtexto · até 10Data Inicial da Validade da Tabela de Preço. No formato dd/mm/aaaa.
caracteristicas.nDescSugeridonúmeroPercentual de Desconto Sugerido.
caracteristicas.nPercDescMaxnúmeroPercentual de Desconto Máximo Permitido.
clientesobjetoDados dos filtros do cliente.
clientes.cTagtexto · até 50Descrição da tag do cliente informada no campo nCodTag. O conteúdo deste campo é apenas informativo e não tem efeito na inclusão. Na inclusão utilize a tag "nCodTag".
clientes.cTodosClientestexto · até 1Considerar todos os clientes nesta tabela de preços? (S/N) O padrão é "S". Quando informar "S", todos os demais campos deste grupo serão desconsiderados. Caso informe "N", pelo menos 1 dos campos deste grupo deverá ser informado.
clientes.cUFtexto · até 2Considerar apenas os clientes do Estado. Será ignorado caso o campo "cTodosClientes" estiver preenhido com "S".
clientes.nCodTagnúmero inteiroConsiderar apenas os clientes de uma determinada Tag. Será ignorado caso o campo "cTodosClientes" estiver preenhido com "S".
outrasInfoobjetoOutros filtros da tabela de preços.
outrasInfo.nCodOrigTabnúmero inteiroCódigo da Tabela de Preço Original.
outrasInfo.nPercAcrescimonúmeroPercentual de Acréscimo da tabela de preços.
outrasInfo.nPercDescontonúmeroPercentual de Desconto da tabela de preços.
produtosobjetoDados dos filtros por produto.
produtos.cConteudotexto · até 60Conteúdo da característica. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.cNCMtexto · até 13Código do NCM. No formato 9999.99.99 Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.cTodosProdutostexto · até 1Considerar todos os produtos nesta tabela de preços? (S/N) O padrão é "S". Quando informar "S", todos os demais campos deste grupo serão desconsiderados. Caso informe "N", pelo menos 1 dos campos deste grupo deverá ser informado.
produtos.nCodCaractnúmero inteiroCódigo da característica de produto. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da característica do produto gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.nCodFamilianúmero inteiroCódigo da família. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da família gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
produtos.nCodFornecnúmero inteiroCódigo do fornecedor. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno do fornecedor gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntTabPrecotextoCódigo de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
cCodStatustextoCó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 duranteo o processamento da solicitação. A tag "cDesStatus" descreve o problema ocorrido.
cDesStatustextoDescrição do status do processamento. Essa tag explica o resultado da tag "cCodigoStatus".
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
POST /api/v1/produtos/tabelaprecos/
curl -s https://app.omie.com.br/api/v1/produtos/tabelaprecos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "IncluirTabelaPreco", "param": [{"cCodIntTabPreco": "TP1790776581", "cNome": "", "cCodigo": "", "cOrigem": "", "produtos": {"cTodosProdutos": "S", "nCodFamilia": 0, "cNCM": "", "nCodCaract": 0, "cConteudo": "", "nCodFornec": 0}, "clientes": {"cTodosClientes": "S", "nCodTag": 0, "cTag": "", "cUF": ""}, "outrasInfo": {"nCodOrigTab": 0, "nPercAcrescimo": 0, "nPercDesconto": 0}, "caracteristicas": {"cTemValidade": "S", "dDtInicial": "30/09/2026", "dDtFinal": "30/09/2026", "cTemDesconto": "", "nDescSugerido": 0, "nPercDescMax": 0, "cArredPreco": "N"}}]}'

ListarTabelaItens

consultaClaudeMCP

Lista os itens de uma tabela de preços.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 12Campos e estruturas que você pode enviar
CampoTipoDescrição
cApenasFixadotexto · até 1Indica se deve retornar apenas itens que foram modificados manualmente (S/N).
cCodIntTabPrecotexto · até 20Código de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie.
cOrdemDecrescentetexto · até 1Indica se a ordem de exibição é Decrescente caso seja informado "S".
cOrdenarPortexto · até 100Ordem os resultados da página por: CODIGO - Código da Tabela de Preço. CODINT - Código de Integração da Tabela de Preço. NOME - Nome da Tabela de Preço.
dDtAltAtetexto · até 10Data de alteração final. No formato dd/mm/aaaa.
dDtAltDetexto · até 10Data de alteração inicial. No formato dd/mm/aaaa.
dDtIncAtetexto · até 10Data de inclusão final. No formato dd/mm/aaaa.
dDtIncDetexto · até 10Data de inclusão inicial. No formato dd/mm/aaaa.
lApenasItenssim/nãoFiltrar apenas itens que tiveram alteração no período definido entre dDtAltDe e dDtAltAte. Ativando esse filtro, não serão consideradas alterações no cabeçalho da Tabela de Preços.
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
nPaginanúmero inteiroNúmero da página que se deseja resgatar. O padrão é "1".
nRegPorPaginanúmero inteiroNúmero de registros retornados por página. O padrão é 20. O limite máximo é 50 por página.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
listaTabelaPrecoobjetoTabela de preço com itens.
listaTabelaPreco.cAtivatextoIndica se a tabela de preços está ativa (S/N).
listaTabelaPreco.cCodIntTabPrecotextoCódigo de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
listaTabelaPreco.cCodigotextoCódigo da Tabela de Preço. (Exibido na tela do aplicativo).
listaTabelaPreco.cNometextoNome da Tabela de Preço.
listaTabelaPreco.cOrigemtextoOrigem da Tabela de Preços. Pode ser: PRD - Lê o preço do cadastro de produtos. CMC - Lê o preço do CMC do produto. TBL - Lê o preço de uma tabela específica informada na tag "nCodOrigTab".
listaTabelaPreco.itensTabelalista de objetosItens da Tabela de Preços.
listaTabelaPreco.itensTabela[].cArredPrecotextoIndica se deve Arredondar o preço do produto (S/N).
listaTabelaPreco.itensTabela[].cCodIntProdtextoCódigo de integração do produto. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código utilizado no seu aplicativo quando incluir um produto no Omie. Assim, poderá utilizá-lo para resgatar as informações do produto desejado. Caso informe esse campo, não informe a tag nCodProd. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
listaTabelaPreco.itensTabela[].cCodigoProdutotextoCódigo do produto. (Exibido na tela do aplicativo).
listaTabelaPreco.itensTabela[].cDescricaoProdutotextoDescrição do produto.
listaTabelaPreco.itensTabela[].cEANtextoEAN do produto.
listaTabelaPreco.itensTabela[].cManualtextoIndica se o item foi modificado Manualmente (S/N).
listaTabelaPreco.itensTabela[].cNCMtextoCódigo do NCM. No formato 9999.99.99.
listaTabelaPreco.itensTabela[].cTemDescontotextoIndica se a Tabela de Preço possui Desconto Sugerido ou Máximo (S/N).
listaTabelaPreco.itensTabela[].itemInfoobjetoInformações do cadastro do item.
listaTabelaPreco.itensTabela[].itemInfo.cImpAPIItemtextoImportado pela API (S/N).
listaTabelaPreco.itensTabela[].itemInfo.dAltItemtextoData da Alteração. No formato dd/mm/aaaa.
listaTabelaPreco.itensTabela[].itemInfo.dIncItemtextoData da Inclusão. No formato dd/mm/aaaa.
listaTabelaPreco.itensTabela[].itemInfo.hAltItemtextoHora da Alteração. No formato hh:mm:ss.
listaTabelaPreco.itensTabela[].itemInfo.hIncItemtextoHora da Inclusão. No formato hh:mm:ss.
listaTabelaPreco.itensTabela[].itemInfo.uAltItemtextoUsuário da Alteração.
listaTabelaPreco.itensTabela[].itemInfo.uIncItemtextoUsuário da Inclusão.
listaTabelaPreco.itensTabela[].nCodFamilianúmero inteiroCódigo da Familia do Produto. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da família gerado pelo Omie.
listaTabelaPreco.itensTabela[].nCodProdnúmero inteiroCódigo do produto. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno do produto gerado pelo Omie.
listaTabelaPreco.itensTabela[].nDescMaximodecimalPercentual de Desconto Máximo Permitido.
listaTabelaPreco.itensTabela[].nDescSugeridodecimalPercentual de Desconto Sugerido.
listaTabelaPreco.itensTabela[].nPercAcrescimodecimalPercentual de Acréscimo da tabela de preços.
listaTabelaPreco.itensTabela[].nPercDescontodecimalPercentual de Desconto da tabela de preços.
listaTabelaPreco.itensTabela[].nValorCalculadodecimalValor Calculado.
listaTabelaPreco.itensTabela[].nValorOriginaldecimalValor Original.
listaTabelaPreco.itensTabela[].nValorTabeladecimalValor da Tabela de Preços.
listaTabelaPreco.nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
nPaginanúmero inteiroNúmero da página resgatada.
nRegistrosnúmero inteiroNúmero de registros retornados na página.
nTotPaginasnúmero inteiroNúmero total de páginas encontradas.
nTotRegistrosnúmero inteiroNúmero total de registros encontrados.
POST /api/v1/produtos/tabelaprecos/
curl -s https://app.omie.com.br/api/v1/produtos/tabelaprecos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ListarTabelaItens", "param": [{"nPagina": 1, "nRegPorPagina": 20, "nCodTabPreco": 0, "cCodIntTabPreco": ""}]}'

ListarTabelasPreco

consultaClaudeChatGPTMCP

Lista as tabelas de preço cadastradas.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 9Campos e estruturas que você pode enviar
CampoTipoDescrição
cOrdemDecrescentetexto · até 1Indica se a ordem de exibição é Decrescente caso seja informado "S".
cOrdenarPortexto · até 100Ordem os resultados da página por: CODIGO - Código da Tabela de Preço. CODINT - Código de Integração da Tabela de Preço. NOME - Nome da Tabela de Preço.
dDtAltAtetexto · até 10Data de alteração final. No formato dd/mm/aaaa.
dDtAltDetexto · até 10Data de alteração inicial. No formato dd/mm/aaaa.
dDtIncAtetexto · até 10Data de inclusão final. No formato dd/mm/aaaa.
dDtIncDetexto · até 10Data de inclusão inicial. No formato dd/mm/aaaa.
nCodTagnúmero inteiroConsiderar apenas os clientes de uma determinada Tag. Será ignorado caso o campo "cTodosClientes" estiver preenhido com "S".
nPaginanúmero inteiroNúmero da página que se deseja resgatar. O padrão é "1".
nRegPorPaginanúmero inteiroNúmero de registros retornados por página. O padrão é 20. O limite máximo é 50 por página.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
listaTabelasPrecolista de objetosLista das tabelas de preço.
listaTabelasPreco[].cAtivatextoIndica se a tabela de preços está ativa (S/N).
listaTabelasPreco[].cCodIntTabPrecotextoCódigo de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
listaTabelasPreco[].cCodigotextoCódigo da Tabela de Preço. (Exibido na tela do aplicativo).
listaTabelasPreco[].cNometextoNome da Tabela de Preço.
listaTabelasPreco[].cOrigemtextoOrigem da Tabela de Preços. Pode ser: PRD - Lê o preço do cadastro de produtos. CMC - Lê o preço do CMC do produto. TBL - Lê o preço de uma tabela específica informada na tag "nCodOrigTab".
listaTabelasPreco[].caracteristicasobjetoCaracterísticas da tabela de preço.
listaTabelasPreco[].caracteristicas.cArredPrecotextoIndica se deve Arredondar o preço dos produtos (S/N).
listaTabelasPreco[].caracteristicas.cTemDescontotextoIndica se a Tabela de Preço possui Desconto Sugerido ou Máximo (S/N).
listaTabelasPreco[].caracteristicas.cTemValidadetextoIndica se a Tabela de Preço possui Validade (S/N).
listaTabelasPreco[].caracteristicas.dDtFinaltextoData Final de Validade Tabela de Preço. No formato dd/mm/aaaa.
listaTabelasPreco[].caracteristicas.dDtInicialtextoData Inicial da Validade da Tabela de Preço. No formato dd/mm/aaaa.
listaTabelasPreco[].caracteristicas.nDescSugeridodecimalPercentual de Desconto Sugerido.
listaTabelasPreco[].caracteristicas.nPercDescMaxdecimalPercentual de Desconto Máximo Permitido.
listaTabelasPreco[].clientesobjetoDados dos filtros do cliente.
listaTabelasPreco[].clientes.cTagtextoDescrição da tag do cliente informada no campo nCodTag. O conteúdo deste campo é apenas informativo e não tem efeito na inclusão. Na inclusão utilize a tag "nCodTag".
listaTabelasPreco[].clientes.cTodosClientestextoConsiderar todos os clientes nesta tabela de preços? (S/N) O padrão é "S". Quando informar "S", todos os demais campos deste grupo serão desconsiderados. Caso informe "N", pelo menos 1 dos campos deste grupo deverá ser informado.
listaTabelasPreco[].clientes.cUFtextoConsiderar apenas os clientes do Estado. Será ignorado caso o campo "cTodosClientes" estiver preenhido com "S".
listaTabelasPreco[].clientes.nCodTagnúmero inteiroConsiderar apenas os clientes de uma determinada Tag. Será ignorado caso o campo "cTodosClientes" estiver preenhido com "S".
listaTabelasPreco[].infoobjetoInformações do cadastro da tabela de preços.
listaTabelasPreco[].info.cImpAPItextoImportado pela API (S/N).
listaTabelasPreco[].info.dAlttextoData da Alteração. No formato dd/mm/aaaa.
listaTabelasPreco[].info.dInctextoData da Inclusão. No formato dd/mm/aaaa.
listaTabelasPreco[].info.hAlttextoHora da Alteração. No formato hh:mm:ss.
listaTabelasPreco[].info.hInctextoHora da Inclusão. No formato hh:mm:ss.
listaTabelasPreco[].info.uAlttextoUsuário da Alteração.
listaTabelasPreco[].info.uInctextoUsuário da Inclusão.
listaTabelasPreco[].nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
listaTabelasPreco[].outrasInfoobjetoOutros filtros da tabela de preços.
listaTabelasPreco[].outrasInfo.nCodOrigTabnúmero inteiroCódigo da Tabela de Preço Original.
listaTabelasPreco[].outrasInfo.nPercAcrescimodecimalPercentual de Acréscimo da tabela de preços.
listaTabelasPreco[].outrasInfo.nPercDescontodecimalPercentual de Desconto da tabela de preços.
listaTabelasPreco[].produtosobjetoDados dos filtros por produto.
listaTabelasPreco[].produtos.cConteudotextoConteúdo da característica. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
listaTabelasPreco[].produtos.cNCMtextoCódigo do NCM. No formato 9999.99.99 Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
listaTabelasPreco[].produtos.cTodosProdutostextoConsiderar todos os produtos nesta tabela de preços? (S/N) O padrão é "S". Quando informar "S", todos os demais campos deste grupo serão desconsiderados. Caso informe "N", pelo menos 1 dos campos deste grupo deverá ser informado.
listaTabelasPreco[].produtos.nCodCaractnúmero inteiroCódigo da característica de produto. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da característica do produto gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
listaTabelasPreco[].produtos.nCodFamilianúmero inteiroCódigo da família. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da família gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
listaTabelasPreco[].produtos.nCodFornecnúmero inteiroCódigo do fornecedor. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno do fornecedor gerado pelo Omie. Será ignorado caso o campo "cTodosProdutos" estiver preenhido com "S".
nPaginanúmero inteiroNúmero da página resgatada.
nRegistrosnúmero inteiroNúmero de registros retornados na página.
nTotPaginasnúmero inteiroNúmero total de páginas encontradas.
nTotRegistrosnúmero inteiroNúmero total de registros encontrados.
POST /api/v1/produtos/tabelaprecos/
curl -s https://app.omie.com.br/api/v1/produtos/tabelaprecos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ListarTabelasPreco", "param": [{"nPagina": 1, "nRegPorPagina": 20}]}'

SuspenderTabelaPreco

altera dadosClaudeMCP

Suspende uma tabela de preços.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntTabPrecotexto · até 20Código de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntTabPrecotextoCódigo de integração da Tabela de Preços. (Interno, utilizado apenas na Integração via API, não aparece na tela). Utilize esse campo para informar o código da Tabela de Preços utilizado no seu aplicativo quando incluir uma Tabela de Preços no Omie. Assim, poderá utilizar esse campo para resgatar as informações da Tabela de Preços desejada. Caso informe esse campo, não informe a tag nCodTabPreco. Caso isso aconteça, o conteúdo dessa tag será desconsiderada.
cCodStatustextoCó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 duranteo o processamento da solicitação. A tag "cDesStatus" descreve o problema ocorrido.
cDesStatustextoDescrição do status do processamento. Essa tag explica o resultado da tag "cCodigoStatus".
nCodTabPreconúmero inteiroCódigo da Tabela de Preços. (Interno, utilizado apenas na integração via API, não é exibido na tela). O conteúdo desse campo é o código interno da Tabela de Preços gerado pelo Omie.
POST /api/v1/produtos/tabelaprecos/
curl -s https://app.omie.com.br/api/v1/produtos/tabelaprecos/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "SuspenderTabelaPreco", "param": [{"nCodTabPreco": 0, "cCodIntTabPreco": ""}]}'