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

Pedido de venda montado item a item

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

AdicionarPedido

altera dadosClaudeMCP

Inclusão do Pedido de Venda.

Obrigatórios 1

CampoTipoDescrição
codigo_pedido_integracaotexto · até 60Código de integração do pedido de venda. Preencha esse campo com o código do pedido no aplicativo que você está integração com o Omie. A função dele é servir como uma mapa de relacionamento entre as aplicações. Ao realizar uma consulta/listagem de pedidos você conseguirá ver a relação entre o id do pedido gerado no Omie e o código de pedido existente em sua aplicação.
Opcionais 20Campos e estruturas que você pode enviar
CampoTipoDescrição
codProjnúmero inteiroCódigo do Projeto. Informação localizada na Aba "Informações Adicionais" do Pedido de Venda. Utilize a tag "codigo" do método "ListarProjetos" da API http://app.omie.com.br/api/v1/geral/projetos/ para obter essa informação.
codVendnúmero inteiroCódigo do Vendedor. Informação localizada no cabeçalho do Pedido de Venda. Utilize a tag "codigo" do método "ListarVendedores" da API http://app.omie.com.br/api/v1/geral/vendedores/ para obter essa informação.
codigo_categoriatexto · até 20Código da categoria. Informação localizada na Aba "Informações Adicionais" do Pedido de Venda. Utilize a tag "codigo" do método "ListarCategorias" da API http://app.omie.com.br/api/v1/geral/categorias/ para obter essa informação.
codigo_cenario_impostosnúmero inteiroCódigo do Cenário de Impostos. Se não informado, será assumido o cenário padrão.
codigo_clientenúmero inteiroCódigo do cliente. Utilize a tag "codigo_cliente_omie" do método "ListarClientes" da API http://app.omie.com.br/api/v1/geral/clientes/ para obter essa informação.
codigo_cliente_integracaotexto · até 60Código de Integração do Cliente Esse campo deve ser informado apenas se você incluiu o cliente via API e informou um código de integração para o cliente. Do contrário, informe sempre a tag "codigo_cliente".
codigo_conta_correntenúmero inteiroCódigo da Conta Corrente. Informação localizada na Aba "Informações Adicionais" do Pedido de Venda. Utilize a tag "codigo" do método "PesquisarContaCorrente" da API http://app.omie.com.br/api/v1/geral/contacorrente/ para obter essa informação.
codigo_parcelatexto · até 3Código da parcela/Condição de pagamento. Utilize a tag "nCodigo" do método "ListarFormasPagVendas" da API http://app.omie.com.br/api/v1/produtos/formaspagvendas/ para obter essa informação. O código "999" é o único que permite uma definição de forma de pagamento customizada. Caso você escolha essa opção, deve também informar a tag "qtde_parcelas" e a estrutura "lista_parcelas". Alguns dos valores disponíveis são: "000" - A Vista "A03" - Para 3 dias "A05" - Para 5 dias "A07" - Para 7 dias "A08" - Para 8 dias "A09" - Para 9 dias "A10" - Para 10 dias "A13" - Para 13 dias "A14" - Para 14 dias "A15" - Para 15 dias "A17" - Para 17 dias "A20" - Para 20 dias "A21" - Para 21 dias "A25" - Para 25 dias "A26" - Para 26 dias "A28" - Para 28 dias "A35" - Para 35 dias "A36" - Para 36 dias "A40" - Para 40 dias "A42" - Para 42 dias "A45" - Para 45 dias "A50" - Para 50 dias "A56" - Para 56 dias "A60" - Para 60 dias "A70" - Para 70 dias "A75" - Para 75 dias "A90" - Para 90 dias "A98" - Para 98 dias "B20" - Para 120 dias "001" - 1 Parcela (para 30 dias) "002" - 2 Parcelas "003" - 3 Parcelas "004" - 4 Parcelas "005" - 5 Parcelas "006" - 6 Parcelas "007" - 7 Parcelas "010" - 10 Parcelas "012" - 12 Parcelas "024" - 24 Parcelas "036" - 36 Parcelas "048" - 48 Parcelas "S01" - 30/60 "S02" - 45/60 "S03" - 21/28/35 "S04" - 21/28/35/42 "S05" - 28/35/42 "S06" - 28/35/42/49 "S07" - 30/45/60/75/90 "S08" - 25/56 "S09" - 30/45 "S10" - 28/56 "S11" - 10/30/60 "S12" - 15/30/60 "S13" - 28/35 "S14" - 7/14/21 "S15" - 10/30/60/90 "S16" - 60/90/120 "S17" - 45/60/90 "S18" - 30/60/90 "S19" - 14/21 "S20" - 7/14 "S21" - 14/21/28 "S22" - 45/75 "S23" - 30/45/60 "S24" - 3/20/40 "S25" - 30/60/90/120 "S26" - 21/28 "S27" - a Vista/15 "S28" - a Vista/30 "S29" - a Vista/30/60 "S30" - a Vista/30/60/90 "S31" - a Vista/30/60/90/120/150 "S41" - 28/42/56 "S32" - 15/45/75 "S33" - 14/28/42 "S34" - 14/21/28/35/42 "S35" - 30/42/54/66/78/90 "S36" - 14/21/28/35 "S37" - 28/42 "S38" - 30/45/60 "S39" - 35/42/49/56 "S40" - 28/42/56/70 "S42" - 30/40/50/60 "S43" - 30/50/70/90 "S44" - 14/28 "S45" - 45/60/75/90 "S46" - a Vista/30/60/90/120 "S47" - a vista/20/40/60 "S48" - 21/42 "S49" - 15/30/45 "S50" - 14/42 "S51" - 21/35 "S52" - 28/56/84 "S53" - 28/42/56/70/84 "S54" - a Vista/30/45 "S55" - 21/45 "S56" - a Vista/28 "S57" - a Vista/60/90 "S58" - 35/45/55 "S59" - 28/35/42/56 "S60" - 30/45/60/75 "S61" - 28/35/42/49/56 "S62" - 40/70/100 "S63" - 42/56 "S64" - a Vista/28/35 "S65" - 35/42 "S66" - 20/40 "S67" - a Vista/28/35/42
consumidor_finaltexto · até 1Nota Fiscal para Consumo Final. Informar "S" ou "N". Informação localizada na Aba "Informações Adicionais" do Pedido de Venda.
contatotexto · até 100Contato. Informação localizada na Aba "Informações Adicionais" do Pedido de Venda.
dados_adicionais_nftextoDados adicionais para a Nota Fiscal. Utilize o caracter pipe ( | ) como separador de linha. Informação localizada na Aba "Informações Adicionais" do Pedido de Venda.
data_previsaotexto · até 10Data de Previsão de Faturamento. Utilize o formato "dd/mm/aaaa". Esse campo indica a data da previsão do faturamento do pedido e deve ser informado com uma data igual ou superior a data corrente.
enviar_emailtexto · até 1Enviar e-mail com o boleto de cobrança gerado pelo faturamento (juntamente com o DANFE e o XML da NF-e). Informar "S" ou "N". Default "N" Informação localizada na Aba "E-mail para o Cliente" do Pedido de Venda. É permitido somente o preenchimento de uma das tags "enviar_pix" ou "enviar_email".
enviar_pixtexto · até 1Enviar e-mail com o PIX de cobrança gerado pelo faturamento (juntamente com o DANFE e o XML da NF-e). Informar "S" ou "N". Default "N" Informação localizada na Aba "E-mail para o Cliente" do Pedido de Venda. É permitido somente o preenchimento de uma das tags "enviar_pix" ou "enviar_email".
etapatexto · até 2Etapa do pedido de venda. Esse campo indica em que coluna o pedido de venda irá figurar no processo de faturamento do Omie. Utilize a tag "codigo" do método "ListarEtapasFaturamento" da API http://app.omie.com.br/api/v1/produtos/etapafat/ para obter essa informação. Os valores são fixos, mas as descrições (funções atribuídas a cada coluna pode mudar. A API irá indicar a descrição de cada coluna. Os valores disponíveis para esse campo podem ser: "10" - Primeira coluna "20" - Segunda coluna "30" - Terceira coluna "40" - Quarta coluna "50" - Faturar.
itenslista de objetosArray de Itens do pedido de Venda.
itens[].cfoptexto · até 10CFOP - Código Fiscal de Operações e Prestações. Utilize a tag "nCodigo" do método "ListarCFOP" da API /api/v1/produtos/cfop/ para obter essa informação.
itens[].codigo_categoria_itemtexto · até 20Código da Categoria do item.
itens[].codigo_cenario_impostos_itemnúmero inteiroCódigo do Cenário de Impostos.
itens[].codigo_local_estoquenúmero inteiroCódigo do Local do Estoque.
itens[].codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
itens[].codigo_produtonúmero inteiroID do Produto. Esse campo não é exibido na tela do Pedido de Vendas. É uma informação interna, utilizada apenas nas APIs. Utilize a tag "codigo_produto" do método "ListarProdutos" da API http://app.omie.com.br/api/v1/geral/produtos/ para obter essa informação.
itens[].codigo_tabela_preconúmero inteiroCódigo da tabela de preço. (Código Interno, utilizado apenas na integração via API, não é exibido na tela). Deve ser informada opcionalmente, caso a tabela de preços esteja configurada no Omie.
itens[].dados_adicionais_itemtextoInformações para a Nota Fiscal.
itens[].item_pedido_compranúmero inteiroItem do Pedido de Compra.
itens[].lote_validadelista de objetosInformações referentes ao lote e validade do produto. A tag só deve ser informada se o produto possuir controle de lote e se a intenção é informar os lotes "manualmente" por API.
itens[].lote_validade[].nIdLoteobrigatórionúmero inteiroId do Lote do produto. Obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações..
itens[].lote_validade[].nQtdLoteobrigatórionúmeroInforme aqui a quantidade do Lote para o produto. É obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações.
itens[].nao_gerar_financeirotexto · até 1Não gerar conta a receber para este item. Informar "S" ou "N". (Informe "S" para ativar essa opção).
itens[].nao_movimentar_estoquetexto · até 1Não gerar a saída de estoque deste item ao emitir NF-e. Informar "S" ou "N". (informe "S" para ativar essa opção).
itens[].nao_somar_totaltexto · até 1
itens[].numero_pedido_compratexto · até 15Número do Pedido de Compra.
itens[].numero_recopitexto · até 20Número do registro gerado pelo sistema RECOPI Nacional (Reconhecimento e Controle das Operações com Papel Imune).
itens[].obs_itemtextoObservações do item (elas não serão exibidas na Nota Fisca, mas serão impressas no pedido de venda). Informação localizada na Aba "Observações" do Item do Pedido de Venda.
itens[].percentual_descontonúmeroPercentual de Desconto. Ao informar o desconto na capa do pedido o mesmo será distribuído proporcionalmente para os itens. Uma vez realizada a distribuição os valores do desconto serão exibidos apenas nos itens. IMPORTANTE: - Não será permitido informar desconto na capa caso já exista distribuição pelos itens. - Na alteração o desconto será aplicado para todos os itens do pedido.
itens[].quantidadenúmeroQuantidade.
itens[].quantidade_tribnúmero
itens[].tipo_descontotexto · até 1Tipo de Desconto. Pode ser: V - Valor P - Percentual Ao informar o desconto na capa do pedido o mesmo será distribuído proporcionalmente para os itens. Uma vez realizada a distribuição os valores do desconto serão exibidos apenas nos itens. IMPORTANTE: - Não será permitido informar desconto na capa caso já exista distribuição pelos itens. - Na alteração o desconto será aplicado para todos os itens do pedido.
itens[].unidade_tribtexto · até 6
itens[].valor_descontonúmeroValor do Desconto Ao informar o desconto na capa do pedido o mesmo será distribuído proporcionalmente para os itens. Uma vez realizada a distribuição os valores do desconto serão exibidos apenas nos itens. IMPORTANTE: - Não será permitido informar desconto na capa caso já exista distribuição pelos itens. - Na alteração o desconto será aplicado para todos os itens do pedido. - Se o desconto for superior ao valor do pedido ele não será aplicado.
itens[].valor_unitarionúmeroValor Unitário.
numero_contratotexto · até 20Número do Contrato de Venda. Informação localizada na Aba "Informações Adicionais" do Pedido de Venda.
numero_pedido_clientetexto · até 30Número do pedido do cliente. Informação localizada na Aba "Informações Adicionais" do Pedido de Venda.
origem_pedidotexto · até 3Origem do Pedido. Default: API - Importado via API. MLV - Mercado Livre.
utilizar_emailstextoUtilizar os seguintes endereços de e-mail. Informar a lista de e-mail que receberão a Nota Fiscal. Utilize a virgula (,) como separador. Informação localizada na Aba "E-mail para o Cliente" do Pedido de Venda.
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
codigo_statustextoCó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 "codigo_status" descreve o problema ocorrido.
descricao_statustextoDescrição do status do processamento. Essa tag explica o resultado da tag "codigo_status".
numero_pedidotexto
POST /api/v1/produtos/pedidovenda/
curl -s https://app.omie.com.br/api/v1/produtos/pedidovenda/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AdicionarPedido", "param": [{"codigo_pedido_integracao": "PED0001", "codigo_cliente": 123456, "itens": {"codigo_produto": 654321, "quantidade": 2, "valor_unitario": 150.0}}]}'

AlterarItemPedido

altera dadosClaudeChatGPTMCP

Altera um item no pedido de venda.

Obrigatórios 1

CampoTipoDescrição
codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
Opcionais 24Campos e estruturas que você pode enviar
CampoTipoDescrição
cfoptexto · até 10Utilize a tag "nCodigo" do método "ListarCFOP" da API /api/v1/produtos/cfop/ para obter essa informação.
codigo_categoria_itemtexto · até 20Código da Categoria do item.
codigo_cenario_impostos_itemnúmero inteiroCódigo do Cenário de Impostos.
codigo_itemnúmero inteiroID do Item do Pedido.
codigo_item_integracaotexto · até 30Código de Integração do Item do Pedido de Venda. Informe a identificação do Item do Pedido de Venda. Caso você não tenha essa informação no seu aplicativo, informe o número sequencial de cada item do pedido. Informa de 1 a 199.
codigo_local_estoquenúmero inteiroCódigo do Local do Estoque.
codigo_produtonúmero inteiroID do Produto. Esse campo não é exibido na tela do Pedido de Vendas. É uma informação interna, utilizada apenas nas APIs. Utilize a tag "codigo_produto" do método "ListarProdutos" da API http://app.omie.com.br/api/v1/geral/produtos/ para obter essa informação.
codigo_tabela_preconúmero inteiroCódigo da tabela de preço. (Código Interno, utilizado apenas na integração via API, não é exibido na tela). Deve ser informada opcionalmente, caso a tabela de preços esteja configurada no Omie.
dados_adicionais_itemtextoInformações para a Nota Fiscal.
item_pedido_compranúmero inteiroItem do Pedido de Compra.
lote_validadelista de objetosInformações referentes ao lote e validade do produto. A tag só deve ser informada se o produto possuir controle de lote e se a intenção é informar os lotes "manualmente" por API.
lote_validade[].nIdLoteobrigatórionúmero inteiroId do Lote do produto. Obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações..
lote_validade[].nQtdLoteobrigatórionúmeroInforme aqui a quantidade do Lote para o produto. É obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações.
nao_gerar_financeirotexto · até 1Não gerar conta a receber para este item. Informar "S" ou "N". (Informe "S" para ativar essa opção).
nao_movimentar_estoquetexto · até 1Não gerar a saída de estoque deste item ao emitir NF-e. Informar "S" ou "N". (informe "S" para ativar essa opção).
nao_somar_totaltexto · até 1
numero_pedido_compratexto · até 15Número do Pedido de Compra.
numero_recopitexto · até 20Número do registro gerado pelo sistema RECOPI Nacional (Reconhecimento e Controle das Operações com Papel Imune).
obs_itemtextoObservações do item (elas não serão exibidas na Nota Fisca, mas serão impressas no pedido de venda). Informação localizada na Aba "Observações" do Item do Pedido de Venda.
percentual_descontonúmeroPercentual de Desconto. Ao informar o desconto na capa do pedido o mesmo será distribuído proporcionalmente para os itens. Uma vez realizada a distribuição os valores do desconto serão exibidos apenas nos itens. IMPORTANTE: - Não será permitido informar desconto na capa caso já exista distribuição pelos itens. - Na alteração o desconto será aplicado para todos os itens do pedido.
quantidadenúmeroQuantidade.
quantidade_tribnúmero
tipo_descontotexto · até 1Tipo de Desconto. Pode ser: V - Valor P - Percentual Ao informar o desconto na capa do pedido o mesmo será distribuído proporcionalmente para os itens. Uma vez realizada a distribuição os valores do desconto serão exibidos apenas nos itens. IMPORTANTE: - Não será permitido informar desconto na capa caso já exista distribuição pelos itens. - Na alteração o desconto será aplicado para todos os itens do pedido.
unidade_tribtexto · até 6
valor_descontonúmeroValor do Desconto Ao informar o desconto na capa do pedido o mesmo será distribuído proporcionalmente para os itens. Uma vez realizada a distribuição os valores do desconto serão exibidos apenas nos itens. IMPORTANTE: - Não será permitido informar desconto na capa caso já exista distribuição pelos itens. - Na alteração o desconto será aplicado para todos os itens do pedido. - Se o desconto for superior ao valor do pedido ele não será aplicado.
valor_unitarionúmeroValor Unitário.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
codigo_itemnúmero inteiroID do Item do Pedido.
codigo_item_integracaotextoCódigo de Integração do Item do Pedido de Venda. Informe a identificação do Item do Pedido de Venda. Caso você não tenha essa informação no seu aplicativo, informe o número sequencial de cada item do pedido. Informa de 1 a 199.
codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
codigo_statustextoCó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 "codigo_status" descreve o problema ocorrido.
descricao_statustextoDescrição do status do processamento. Essa tag explica o resultado da tag "codigo_status".
POST /api/v1/produtos/pedidovenda/
curl -s https://app.omie.com.br/api/v1/produtos/pedidovenda/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AlterarItemPedido", "param": [{"codigo_pedido": 123456789, "codigo_item": 1, "quantidade": 3, "valor_unitario": 145.0}]}'

ExcluirItemPedido

altera dadosClaudeMCP

Exclui um item no pedido de venda.

Obrigatórios 1

CampoTipoDescrição
codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
Opcionais 2Campos e estruturas que você pode enviar
CampoTipoDescrição
codigo_itemnúmero inteiroID do Item do Pedido.
codigo_item_integracaotexto · até 30Código de Integração do Item do Pedido de Venda. Informe a identificação do Item do Pedido de Venda. Caso você não tenha essa informação no seu aplicativo, informe o número sequencial de cada item do pedido. Informa de 1 a 199.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
codigo_itemnúmero inteiroID do Item do Pedido.
codigo_item_integracaotextoCódigo de Integração do Item do Pedido de Venda. Informe a identificação do Item do Pedido de Venda. Caso você não tenha essa informação no seu aplicativo, informe o número sequencial de cada item do pedido. Informa de 1 a 199.
codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
codigo_statustextoCó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 "codigo_status" descreve o problema ocorrido.
descricao_statustextoDescrição do status do processamento. Essa tag explica o resultado da tag "codigo_status".
POST /api/v1/produtos/pedidovenda/
curl -s https://app.omie.com.br/api/v1/produtos/pedidovenda/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ExcluirItemPedido", "param": [{"codigo_pedido": 123456789, "codigo_item": 1}]}'

ExcluirItensPedido

altera dadosClaudeMCP

Exclui todos os itens do pedido de venda.

Obrigatórios 1

CampoTipoDescrição
codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
Retorno 3O que volta numa chamada bem-sucedida
CampoTipoDescrição
codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
codigo_statustextoCó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 "codigo_status" descreve o problema ocorrido.
descricao_statustextoDescrição do status do processamento. Essa tag explica o resultado da tag "codigo_status".
POST /api/v1/produtos/pedidovenda/
curl -s https://app.omie.com.br/api/v1/produtos/pedidovenda/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ExcluirItensPedido", "param": [{"codigo_pedido": 123456789}]}'

IncluirItemPedido

altera dadosClaudeMCP

Inclui um item no pedido de venda.

Obrigatórios 4

CampoTipoDescrição
codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
codigo_produtonúmero inteiroID do Produto. Esse campo não é exibido na tela do Pedido de Vendas. É uma informação interna, utilizada apenas nas APIs. Utilize a tag "codigo_produto" do método "ListarProdutos" da API http://app.omie.com.br/api/v1/geral/produtos/ para obter essa informação.
quantidadenúmeroQuantidade.
valor_unitarionúmeroValor Unitário.
Opcionais 20Campos e estruturas que você pode enviar
CampoTipoDescrição
cfoptexto · até 10Utilize a tag "nCodigo" do método "ListarCFOP" da API /api/v1/produtos/cfop/ para obter essa informação.
codigo_categoria_itemtexto · até 20Código da Categoria do item.
codigo_cenario_impostos_itemnúmero inteiroCódigo do Cenário de Impostos.
codigo_item_integracaotexto · até 30Código de Integração do Item do Pedido de Venda. Informe a identificação do Item do Pedido de Venda. Caso você não tenha essa informação no seu aplicativo, informe o número sequencial de cada item do pedido. Informa de 1 a 199.
codigo_local_estoquenúmero inteiroCódigo do Local do Estoque.
codigo_tabela_preconúmero inteiroCódigo da tabela de preço. (Código Interno, utilizado apenas na integração via API, não é exibido na tela). Deve ser informada opcionalmente, caso a tabela de preços esteja configurada no Omie.
dados_adicionais_itemtextoInformações para a Nota Fiscal.
item_pedido_compranúmero inteiroItem do Pedido de Compra.
lote_validadelista de objetosInformações referentes ao lote e validade do produto. A tag só deve ser informada se o produto possuir controle de lote e se a intenção é informar os lotes "manualmente" por API.
lote_validade[].nIdLoteobrigatórionúmero inteiroId do Lote do produto. Obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações..
lote_validade[].nQtdLoteobrigatórionúmeroInforme aqui a quantidade do Lote para o produto. É obrigatório quando o produto possui controle de lote e o método do consumo do lote está definido como 'Manual' nas configurações.
nao_gerar_financeirotexto · até 1Não gerar conta a receber para este item. Informar "S" ou "N". (Informe "S" para ativar essa opção).
nao_movimentar_estoquetexto · até 1Não gerar a saída de estoque deste item ao emitir NF-e. Informar "S" ou "N". (informe "S" para ativar essa opção).
nao_somar_totaltexto · até 1
numero_pedido_compratexto · até 15Item do Pedido de Compra.
numero_recopitexto · até 20Número do registro gerado pelo sistema RECOPI Nacional (Reconhecimento e Controle das Operações com Papel Imune).
obs_itemtextoObservações do item (elas não serão exibidas na Nota Fisca, mas serão impressas no pedido de venda). Informação localizada na Aba "Observações" do Item do Pedido de Venda.
percentual_descontonúmeroPercentual de Desconto. Ao informar o desconto na capa do pedido o mesmo será distribuído proporcionalmente para os itens. Uma vez realizada a distribuição os valores do desconto serão exibidos apenas nos itens. IMPORTANTE: - Não será permitido informar desconto na capa caso já exista distribuição pelos itens. - Na alteração o desconto será aplicado para todos os itens do pedido.
quantidade_tribnúmero
tipo_descontotexto · até 1Tipo de desconto para o pedido. Pode ser: V - Valor P - Percentual Ao informar o desconto na capa do pedido o mesmo será distribuído proporcionalmente para os itens. Uma vez realizada a distribuição os valores do desconto serão exibidos apenas nos itens. IMPORTANTE: - Não será permitido informar desconto na capa caso já exista distribuição pelos itens. - Na alteração o desconto será aplicado para todos os itens do pedido.
unidade_tribtexto · até 6
valor_descontonúmeroValor do Desconto Ao informar o desconto na capa do pedido o mesmo será distribuído proporcionalmente para os itens. Uma vez realizada a distribuição os valores do desconto serão exibidos apenas nos itens. IMPORTANTE: - Não será permitido informar desconto na capa caso já exista distribuição pelos itens. - Na alteração o desconto será aplicado para todos os itens do pedido. - Se o desconto for superior ao valor do pedido ele não será aplicado.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
codigo_itemnúmero inteiroID do Item do Pedido.
codigo_item_integracaotextoCódigo de Integração do Item do Pedido de Venda. Informe a identificação do Item do Pedido de Venda. Caso você não tenha essa informação no seu aplicativo, informe o número sequencial de cada item do pedido. Informa de 1 a 199.
codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
codigo_statustextoCó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 "codigo_status" descreve o problema ocorrido.
descricao_statustextoDescrição do status do processamento. Essa tag explica o resultado da tag "codigo_status".
POST /api/v1/produtos/pedidovenda/
curl -s https://app.omie.com.br/api/v1/produtos/pedidovenda/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "IncluirItemPedido", "param": [{"codigo_pedido": 123456789, "codigo_produto": 654321, "quantidade": 2, "valor_unitario": 150.0}]}'

TotalizarPedido

altera dadosClaudeMCP

Recalcula os totais do pedido de venda.

Obrigatórios 1

CampoTipoDescrição
codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
Retorno 3O que volta numa chamada bem-sucedida
CampoTipoDescrição
codigo_pedidonúmero inteiroID do pedido do venda. Identificação do pedido de venda, esse campo não é exibido na tela do Omie. É uma informação interna, utilizada apenas nas APIs.
codigo_statustextoCó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 "codigo_status" descreve o problema ocorrido.
descricao_statustextoDescrição do status do processamento. Essa tag explica o resultado da tag "codigo_status".
POST /api/v1/produtos/pedidovenda/
curl -s https://app.omie.com.br/api/v1/produtos/pedidovenda/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "TotalizarPedido", "param": [{"codigo_pedido": 123456789}]}'