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

Pedidos de Compra

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

AlteraPedCompra

altera dadosClaudeMCP

Alterar as Informações de um Pedido de Compra.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 6Campos e estruturas que você pode enviar
CampoTipoDescrição
agropecuariolista de objetos
agropecuario[].cCpfResponsaveltexto · até 14CPF do responsável técnico legalmente habilitado.
agropecuario[].cNumReceitatexto · até 20Número da receita ou receituário do agrotóxico/defensivo agrícola.
agropecuario[].cSerieGuiatexto · até 9Número de série da guia.
agropecuario[].cUFGuiatexto · até 2UF de emissão da Guia.
agropecuario[].nNumGuianúmero inteiroNúmero da guia.
agropecuario[].nTipoGuianúmero inteiroTipo da Guia 1 - Corresponde ao GTA 2 - Corresponde ao TTA 3 - Corresponde ao DTA 4 - Corresponde ao ATV 5 - Corresponde ao PTV 6 - Corresponde ao GTV 7 - Corresponde ao Guia Florestal (DOF, SisFlora - PA e MT, SIAM - MG).
cabecalho_alterarobjetoCabeçalho do Pedido de Compra.
cabecalho_alterar.cCnpjCpfFortexto · até 20CNPJ / CPF Quando informada as tags nCodFor e cCodIntFor não devem ser informadas.
cabecalho_alterar.cCodCategtexto · até 20Código da categoria de compra.
cabecalho_alterar.cCodIntFortexto · até 20Código de integração do fornecedor do pedido (este é o código do fornecedor no seu sistema).
cabecalho_alterar.cCodIntPedtexto · até 20Código de integração do pedido de compra (este é o código do pedido no seu sistema).
cabecalho_alterar.cCodParctexto · até 3Código da Condição de Pagamento/Parcelamento. "999" - Padrão.
cabecalho_alterar.cContatotexto · até 100Nome do contato no fornecedor responsável pelo pedido de compra.
cabecalho_alterar.cContratotexto · até 20Número do Contrato de Compra. Informação localizada na Aba "Informações Adicionais" do Pedido de Compra.
cabecalho_alterar.cNumPedidotexto · até 30Número do pedido para o fornecedor.
cabecalho_alterar.cObstextoObservações do pedido de compra (elas não serão impressas no pedido enviado ao fornecedor).
cabecalho_alterar.cObsInttextoObservações internas do pedido (elas serão exibidas apenas para quem consultar o pedido de compra).
cabecalho_alterar.dDtPrevisaotexto · até 10Data de previsão de entrega do pedido de compra.
cabecalho_alterar.nCodCCnúmero inteiroCódigo interno da conta corrente do pedido de compra (este é o código da conta corrente no Omie).
cabecalho_alterar.nCodComprnúmero inteiroCódigo do comprador do pedido.
cabecalho_alterar.nCodFornúmero inteiroCódigo interno do fornecedor do pedido (este é o código do fornecedor no Omie).
cabecalho_alterar.nCodIntCCtexto · até 20Código de integração da conta corrente do pedido (este é o código da conta corrente no seu sistema).
cabecalho_alterar.nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido no Omie).
cabecalho_alterar.nCodProjnúmero inteiroCódigo do projeto relacionado ao pedido de compra.
cabecalho_alterar.nQtdeParcnúmero inteiroQuantidade de parcelas do pedido.
departamentos_alterarlista de objetosRateio do Pedido de Compra por departamento.
departamentos_alterar[].cCodDeptoobrigatóriotextoDepartamento.
departamentos_alterar[].nPercnúmeroPercentual de rateio.
frete_alterarobjetoFrete, Transporte e Outras Despesas do Pedido de Compra.
frete_alterar.cCodIntTransptexto · até 20Código de integração da transportadora (este é o código da transportadora no seu sistema).
frete_alterar.cEspVoltexto · até 60Espécie dos volumes.
frete_alterar.cLacretexto · até 60Número do lacre.
frete_alterar.cMarVoltexto · até 60Marca dos volumes.
frete_alterar.cNumVoltexto · até 60Numeração dos volumes.
frete_alterar.cPlacatexto · até 7Placa do veículo de transporte.
frete_alterar.cTpFretetexto · até 1Modalidade do frete no pedido.
frete_alterar.cUFtexto · até 2UF da placa do veículo do transporte.
frete_alterar.nCodTranspnúmero inteiroCódigo interno da transportadora (este é o código da transportadora no Omie).
frete_alterar.nPesoBrutonúmeroPeso bruto (Kg).
frete_alterar.nPesoLiqnúmeroPeso líquido (Kg).
frete_alterar.nQtdVolnúmero inteiroQuantidade de volumes.
frete_alterar.nValFretenúmeroValor do frete.
frete_alterar.nValOutrasnúmeroValor das outras despesas acessórias.
frete_alterar.nValSeguronúmeroValor do seguro.
parcelas_alterarlista de objetosParcelas do Pedido de Compra.
parcelas_alterar[].cTipoDoctextoTipo de Documento. Lista de tipos de documentos em: /api/v1/geral/tiposdoc.
parcelas_alterar[].dVenctoobrigatóriotexto · até 10Data de vencimento da parcela.
parcelas_alterar[].nDiasnúmero inteiroDias para vencimento da parcela (a partir da data de previsão de entrega).
parcelas_alterar[].nParcelaobrigatórionúmero inteiroNúmero da parcela.
parcelas_alterar[].nPercentobrigatórionúmeroPercentual da parcela em relação ao total do pedido de compra.
parcelas_alterar[].nValorobrigatórionúmeroValor da parcela.
produtos_alterarlista de objetosProdutos do Pedido de Compra.
produtos_alterar[].cCodCategtexto · até 20Código da categoria de compra do item.
produtos_alterar[].cCodIntItemtexto · até 20Código de integração do item do pedido de compra (este é o código do item no seu sistema).
produtos_alterar[].cCodIntProdtexto · até 20Código de integração do cadastro do produto (este é o código do produto no seu sistema).
produtos_alterar[].cDescricaotexto · até 120Descrição do item no pedido.
produtos_alterar[].cEANtexto · até 14Código EAN / GTIN do item no pedido.
produtos_alterar[].cMkpAtuPvtexto · até 1Indica que deve atualizar o preço de venda do produto no recebimento.
produtos_alterar[].cMkpAtuSmtexto · até 1Indica que deve atualizar o preço apenas se for maior que o atual.
produtos_alterar[].cNCMtexto · até 13Código NCM do item.
produtos_alterar[].cObstextoObservação do item no pedido (elas serão impressas no pedido enviado ao fornecedor).
produtos_alterar[].cProdutotexto · até 60Código do item no pedido (pode ser o mesmo código que aparece na NF-e do fornecedor).
produtos_alterar[].cUnidadetexto · até 6Unidade do item no pedido.
produtos_alterar[].codigo_local_estoquenúmero inteiroCódigo do Local do Estoque. Caso não informado assumirá o Local do Estoque padrão.
produtos_alterar[].nCodItemnúmero inteiroCódigo interno do item do pedido de compra (este é o código do item no Omie).
produtos_alterar[].nCodProdnúmero inteiroCódigo interno do cadastro do produto (este é o código do produto no Omie).
produtos_alterar[].nDescontonúmeroValor do desconto do item no pedido.
produtos_alterar[].nMkpPercnúmeroPercentual a ser utilizado para a atualização do preço de venda do produto.
produtos_alterar[].nPesoBrutonúmeroPeso bruto (Kg).
produtos_alterar[].nPesoLiqnúmeroPeso líquido (Kg).
produtos_alterar[].nQtdenúmeroQuantidade do item no pedido.
produtos_alterar[].nValUnitnúmeroValor unitário do item no pedido.
produtos_alterar[].nValorCofinsnúmeroValor do COFINS.
produtos_alterar[].nValorIcmsnúmeroValor do ICMS.
produtos_alterar[].nValorIpinúmeroValor do IPI.
produtos_alterar[].nValorPisnúmeroValor do PIS.
produtos_alterar[].nValorStnúmeroValor do ICMS ST.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntPedtextoCódigo de integração do pedido de compra (este é o código do pedido de compra no seu sistema).
cCodStatustextoCódigo do status.
cDescStatustextoDescrição do status.
cNumerotextoNúmero do pedido de compra.
nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido de compra no Omie).
POST /api/v1/produtos/pedidocompra/
curl -s https://app.omie.com.br/api/v1/produtos/pedidocompra/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "AlteraPedCompra", "param": [{"cabecalho_alterar": {"cCodIntPed": "INT001", "dDtPrevisao": "01/03/2027", "cCodParc": "", "nQtdeParc": 3, "nCodFor": "14170458", "cCodIntFor": "", "cCodCateg": "", "nCodCompr": 0, "cContato": "", "cContrato": "", "nCodCC": "1208238", "nCodIntCC": 0, "nCodProj": 0, "cObs": "Pedido alterado via API", "cObsInt": "Pedido alterado via API"}, "frete_alterar": {"nCodTransp": 0, "cCodIntTransp": "", "cTpFrete": "9", "cPlaca": "XXX-9999", "cUF": "SP", "nQtdVol": 5, "cEspVol": "", "cMarVol": "", "cNumVol": "", "nPesoLiq": 5.0, "nPesoBruto": 10.0, "nValFrete": 50.0, "nValSeguro": 10.0, "cLacre": "", "nValOutras": 0.0}, "departamentos_alterar": [{"cCodDepto": "200000002498904", "nPerc": 90}, {"cCodDepto": "200000002498905", "nPerc": 10}], "produtos_alterar": [{"cCodIntItem": "ITEM001", "cCodIntProd": "", "nCodProd": "2037060", "cProduto": "", "cDescricao": "", "cNCM": "", "cUnidade": "", "cEAN": "", "nPesoLiq": 0, "nPesoBruto": 0, "nQtde": 10, "nValUnit": 200, "nDesconto": 0.0, "nValorIcms": 360.0, "nValorSt": 0.0, "nValorIpi": 20.0, "nValorPis": 33.0, "nValorCofins": 152.0, "cObs": "Item alterado via API", "cMkpAtuPv": "N", "cMkpAtuSm": "N", "nMkpPerc": 0, "codigo_local_estoque": "", "cCodCateg": ""}]}]}'

ConsultarPedCompra

consultaClaudeMCP

Consultar as Informações de um Pedido de Compra.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 3Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntPedtexto · até 20Código de integração do pedido de compra (este é o código do pedido de compra no seu sistema).
cNumerotexto · até 15Número do pedido de compra.
nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido de compra no Omie).
Retorno 6O que volta numa chamada bem-sucedida
CampoTipoDescrição
cabecalho_consultaobjetoCabeçalho do Pedido de Compra.
cabecalho_consulta.cCodCategtextoCódigo da categoria de compra.
cabecalho_consulta.cCodIntFortextoCódigo de integração do fornecedor do pedido (este é o código do fornecedor no seu sistema).
cabecalho_consulta.cCodIntPedtextoCódigo de integração do pedido de compra (este é o código do pedido no seu sistema).
cabecalho_consulta.cCodParctextoCódigo da Condição de Pagamento/Parcelamento. "999" - Padrão.
cabecalho_consulta.cContatotextoNome do contato no fornecedor responsável pelo pedido de compra.
cabecalho_consulta.cContratotextoNúmero do Contrato de Compra.
cabecalho_consulta.cEtapatextoEtapa atual do pedido de compra.
cabecalho_consulta.cIncHoratextoHora de inclusão ou de criação.
cabecalho_consulta.cNumPedidotextoNúmero do pedido para o fornecedor.
cabecalho_consulta.cNumerotextoNúmero do pedido de compra.
cabecalho_consulta.cObstextoObservações do pedido de compra (elas não serão impressas no pedido enviado ao fornecedor).
cabecalho_consulta.cObsInttextoObservações internas do pedido (elas serão exibidas apenas para quem consultar o pedido de compra).
cabecalho_consulta.dDtPrevisaotextoData de previsão de entrega do pedido de compra.
cabecalho_consulta.dIncDatatextoData de inclusão ou de criação.
cabecalho_consulta.nCodCCnúmero inteiroCódigo interno da conta corrente do pedido de compra (este é o código da conta corrente no Omie).
cabecalho_consulta.nCodComprnúmero inteiroCódigo do comprador do pedido.
cabecalho_consulta.nCodFornúmero inteiroCódigo interno do fornecedor do pedido (este é o código do fornecedor no Omie).
cabecalho_consulta.nCodIntCCtextoCódigo de integração da conta corrente do pedido (este é o código da conta corrente no seu sistema).
cabecalho_consulta.nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido no Omie).
cabecalho_consulta.nCodProjnúmero inteiroCódigo do projeto relacionado ao pedido de compra.
cabecalho_consulta.nQtdeParcnúmero inteiroQuantidade de parcelas do pedido.
caracteristicas_consultaobjetoCaracterísticas do Pedido de compra.
caracteristicas_consulta.cConteudotextoConteúdo da Característica do Pedido de Compra.
caracteristicas_consulta.cNometextoNome da Característica do Pedido de Compra.
departamentos_consultalista de objetosDepartamentos do Pedido de Compras.
departamentos_consulta[].cCodDeptotextoCódigo do Departamento.
departamentos_consulta[].nPercdecimalPercentual de rateio.
departamentos_consulta[].nValordecimalValor do rateio.
frete_consultaobjetoFrete, Transporte e Outras Despesas do Pedido de Compra.
frete_consulta.cCodIntTransptextoCódigo de integração da transportadora (este é o código da transportadora no seu sistema).
frete_consulta.cEspVoltextoEspécie dos volumes.
frete_consulta.cLacretextoNúmero do lacre.
frete_consulta.cMarVoltextoMarca dos volumes.
frete_consulta.cNumVoltextoNumeração dos volumes.
frete_consulta.cPlacatextoPlaca do veículo de transporte.
frete_consulta.cTpFretetextoModalidade do frete no pedido.
frete_consulta.cUFtextoUF da placa do veículo do transporte.
frete_consulta.nCodTranspnúmero inteiroCódigo interno da transportadora (este é o código da transportadora no Omie).
frete_consulta.nPesoBrutodecimalPeso bruto (Kg).
frete_consulta.nPesoLiqdecimalPeso líquido (Kg).
frete_consulta.nQtdVolnúmero inteiroQuantidade de volumes.
frete_consulta.nValFretedecimalValor do frete.
frete_consulta.nValOutrasdecimalValor das outras despesas acessórias.
frete_consulta.nValSegurodecimalValor do seguro.
parcelas_consultalista de objetosParcelas do Pedido de Compras.
parcelas_consulta[].cTipoDoctextoTipo de Documento. Lista de tipos de documentos em: /api/v1/geral/tiposdoc.
parcelas_consulta[].dVenctotextoData de vencimento da parcela.
parcelas_consulta[].nDiasnúmero inteiroDias para vencimento da parcela (a partir da data de previsão de entrega).
parcelas_consulta[].nParcelanúmero inteiroNúmero da parcela.
parcelas_consulta[].nPercentdecimalPercentual da parcela em relação ao total do pedido de compra.
parcelas_consulta[].nValordecimalValor da parcela.
produtos_consultalista de objetosProdutos do Pedido de Compra.
produtos_consulta[].cCodCategtextoCódigo da categoria de compra do item.
produtos_consulta[].cCodIntItemtextoCódigo de integração do item do pedido de compra (este é o código do item no seu sistema).
produtos_consulta[].cCodIntProdtextoCódigo de integração do cadastro do produto (este é o código do produto no seu sistema).
produtos_consulta[].cDescricaotextoDescrição do item no pedido.
produtos_consulta[].cEANtextoCódigo EAN / GTIN do item no pedido.
produtos_consulta[].cMkpAtuPvtextoIndica que deve atualizar o preço de venda do produto no recebimento.
produtos_consulta[].cMkpAtuSmtextoIndica que deve atualizar o preço apenas se for maior que o atual.
produtos_consulta[].cNCMtextoCódigo NCM do item.
produtos_consulta[].cObstextoObservação do item no pedido (elas serão impressas no pedido enviado ao fornecedor).
produtos_consulta[].cProdutotextoCódigo do item no pedido (pode ser o mesmo código que aparece na NF-e do fornecedor).
produtos_consulta[].cUnidadetextoUnidade do item no pedido.
produtos_consulta[].codigo_local_estoquenúmero inteiroCódigo do Local do Estoque. Caso não informado assumirá o Local do Estoque padrão.
produtos_consulta[].nCodItemnúmero inteiroCódigo interno do item do pedido de compra (este é o código do item no Omie).
produtos_consulta[].nCodProdnúmero inteiroCódigo interno do cadastro do produto (este é o código do produto no Omie).
produtos_consulta[].nDescontodecimalValor do desconto do item no pedido.
produtos_consulta[].nDespesasdecimalValor das outras despesas acessórias (proporcional para o item do pedido).
produtos_consulta[].nFretedecimalValor do frete (proporcional para o item do pedido).
produtos_consulta[].nMkpPercdecimalPercentual a ser utilizado para a atualização do preço de venda do produto.
produtos_consulta[].nPesoBrutodecimalPeso bruto (Kg).
produtos_consulta[].nPesoLiqdecimalPeso líquido (Kg).
produtos_consulta[].nQtdedecimalQuantidade do item no pedido.
produtos_consulta[].nQtdeRecdecimalQuantidade recebida do Item.
produtos_consulta[].nSegurodecimalValor do seguro (proporcional para o item do pedido).
produtos_consulta[].nValMercdecimalValor total do produto (de mercadoria) no pedido.
produtos_consulta[].nValTotdecimalValor total do item (considerando descontos, despesas e impostos).
produtos_consulta[].nValUnitdecimalValor unitário do item no pedido.
produtos_consulta[].nValorCofinsdecimalValor do COFINS.
produtos_consulta[].nValorIcmsdecimalValor do ICMS.
produtos_consulta[].nValorIpidecimalValor do IPI.
produtos_consulta[].nValorPisdecimalValor do PIS.
produtos_consulta[].nValorStdecimalValor do ICMS ST.
POST /api/v1/produtos/pedidocompra/
curl -s https://app.omie.com.br/api/v1/produtos/pedidocompra/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ConsultarPedCompra", "param": [{"nCodPed": 0, "cCodIntPed": "INT001", "cNumero": ""}]}'

EncerraPedCompra

altera dadosClaudeMCP

Encerra um Pedido de Compra aprovado, ou cancela um Pedido de Compra ainda não aprovado. A ação aplicada é decidida pelo Omie e devolvida na tag cAcaoRealizada.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 5Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntPedtexto · até 20Código de integração do pedido de compra (este é o código do pedido de compra no seu sistema).
cDescEnctexto · até 150Descrição do motivo do encerramento. Alternativa ao nIdMotivoEnc para quem não conhece o ID do motivo. O Omie procura um motivo com essa mesma descrição no aplicativo e o reaproveita; se não existir, cadastra um novo. Quando as duas tags são enviadas, prevalece o nIdMotivoEnc. Não pode ser preenchida apenas com números, pois o valor seria interpretado como ID de motivo.
cObsEnctextoObservações do encerramento. Utilizado apenas quando o pedido está aprovado e, portanto, é encerrado. Se não for informado, o Omie registra "Encerramento enviado via API.".
nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido de compra no Omie).
nIdMotivoEncnúmero inteiroID do motivo do encerramento. Utilizado apenas quando o pedido está aprovado e, portanto, é encerrado. No cancelamento não existe motivo e esta tag é ignorada. Os valores aceitos são os devolvidos pela operação ListarMotivosEncerramento. Quando não informada, vale a tag cDescEnc; sem nenhuma das duas o pedido é encerrado sem motivo.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
cAcaoRealizadatextoAção efetivamente realizada no pedido. "ENCERRADO" quando o pedido estava aprovado, "CANCELADO" quando ainda não estava.
cCodIntPedtextoCódigo de integração do pedido de compra (este é o código do pedido de compra no seu sistema).
cCodStatustextoCódigo do status. Retorna 0 quando a operação é concluída com sucesso. Em caso de falha, traz o código do erro.
cDescStatustextoDescrição do status. Em caso de sucesso, confirma se o pedido foi encerrado ou cancelado; em caso de falha, descreve o motivo.
nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido de compra no Omie).
POST /api/v1/produtos/pedidocompra/
curl -s https://app.omie.com.br/api/v1/produtos/pedidocompra/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "EncerraPedCompra", "param": [{"nCodPed": 1234567890, "nIdMotivoEnc": 1, "cObsEnc": "Compra desistida junto ao fornecedor."}]}'

ExcluirPedCompra

altera dadosClaudeMCP

Excluir um Pedido de Compra.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntPedtexto · até 20Código de integração do pedido de compra (este é o código do pedido de compra no seu sistema).
nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido de compra no Omie).
Retorno 4O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntPedtextoCódigo de integração do pedido de compra (este é o código do pedido de compra no seu sistema).
cCodStatustextoCódigo do status.
cDescStatustextoDescrição do status.
nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido de compra no Omie).
POST /api/v1/produtos/pedidocompra/
curl -s https://app.omie.com.br/api/v1/produtos/pedidocompra/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ExcluirPedCompra", "param": [{"nCodPed": 0, "cCodIntPed": "INT001"}]}'

IncluirPedCompra

altera dadosClaudeMCP

Incluir um Pedido de Compra.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 6Campos e estruturas que você pode enviar
CampoTipoDescrição
agropecuariolista de objetos
agropecuario[].cCpfResponsaveltexto · até 14CPF do responsável técnico legalmente habilitado.
agropecuario[].cNumReceitatexto · até 20Número da receita ou receituário do agrotóxico/defensivo agrícola.
agropecuario[].cSerieGuiatexto · até 9Número de série da guia.
agropecuario[].cUFGuiatexto · até 2UF de emissão da Guia.
agropecuario[].nNumGuianúmero inteiroNúmero da guia.
agropecuario[].nTipoGuianúmero inteiroTipo da Guia 1 - Corresponde ao GTA 2 - Corresponde ao TTA 3 - Corresponde ao DTA 4 - Corresponde ao ATV 5 - Corresponde ao PTV 6 - Corresponde ao GTV 7 - Corresponde ao Guia Florestal (DOF, SisFlora - PA e MT, SIAM - MG).
cabecalho_incluirobjetoCabeçalho do Pedido de Compra.
cabecalho_incluir.cCnpjCpfFortexto · até 20CNPJ / CPF Quando informada as tags nCodFor e cCodIntFor não devem ser informadas.
cabecalho_incluir.cCodCategtexto · até 20Código da categoria de compra.
cabecalho_incluir.cCodIntFortexto · até 20Código de integração do fornecedor do pedido (este é o código do fornecedor no seu sistema).
cabecalho_incluir.cCodIntPedtexto · até 20Código de integração do pedido de compra (este é o código do pedido no seu sistema).
cabecalho_incluir.cCodParctexto · até 3Código da Condição de Pagamento/Parcelamento. "999" - Padrão.
cabecalho_incluir.cContatotexto · até 100Nome do contato no fornecedor responsável pelo pedido de compra.
cabecalho_incluir.cContratotexto · até 20Número do Contrato de Compra. Informação localizada na Aba "Informações Adicionais" do Pedido de Compra.
cabecalho_incluir.cEmailAprovadortexto · até 120Informe aqui o E-mail do usúario que irá aprovar o pedido. Esse usúario deve ter permissão de acesso para realizar a aprovação. Ao informar esse campo o pedido de compra será atribuído a etapa de aprovação com o status de aprovado.
cabecalho_incluir.cNumPedidotexto · até 30Número do pedido para o fornecedor.
cabecalho_incluir.cObstextoObservações do pedido de compra (elas não serão impressas no pedido enviado ao fornecedor).
cabecalho_incluir.cObsInttextoObservações internas do pedido (elas serão exibidas apenas para quem consultar o pedido de compra).
cabecalho_incluir.dDtPrevisaotexto · até 10Data de previsão de entrega do pedido de compra.
cabecalho_incluir.nCodCCnúmero inteiroCódigo interno da conta corrente do pedido de compra (este é o código da conta corrente no Omie).
cabecalho_incluir.nCodComprnúmero inteiroCódigo do comprador do pedido.
cabecalho_incluir.nCodFornúmero inteiroCódigo interno do fornecedor do pedido (este é o código do fornecedor no Omie).
cabecalho_incluir.nCodIntCCtexto · até 20Código de integração da conta corrente do pedido (este é o código da conta corrente no seu sistema).
cabecalho_incluir.nCodProjnúmero inteiroCódigo do projeto relacionado ao pedido de compra.
cabecalho_incluir.nQtdeParcnúmero inteiroQuantidade de parcelas do pedido.
departamentos_incluirlista de objetosRateio do Pedido de Compra por departamento.
departamentos_incluir[].cCodDeptoobrigatóriotextoDepartamento.
departamentos_incluir[].nPercnúmeroPercentual de rateio.
frete_incluirobjetoFrete, Transporte e Outras Despesas do Pedido de Compra.
frete_incluir.cCodIntTransptexto · até 20Código de integração da transportadora (este é o código da transportadora no seu sistema).
frete_incluir.cEspVoltexto · até 60Espécie dos volumes.
frete_incluir.cLacretexto · até 60Número do lacre.
frete_incluir.cMarVoltexto · até 60Marca dos volumes.
frete_incluir.cNumVoltexto · até 60Numeração dos volumes.
frete_incluir.cPlacatexto · até 7Placa do veículo de transporte.
frete_incluir.cTpFretetexto · até 1Modalidade do frete no pedido.
frete_incluir.cUFtexto · até 2UF da placa do veículo do transporte.
frete_incluir.nCodTranspnúmero inteiroCódigo interno da transportadora (este é o código da transportadora no Omie).
frete_incluir.nPesoBrutonúmeroPeso bruto (Kg).
frete_incluir.nPesoLiqnúmeroPeso líquido (Kg).
frete_incluir.nQtdVolnúmero inteiroQuantidade de volumes.
frete_incluir.nValFretenúmeroValor do frete.
frete_incluir.nValOutrasnúmeroValor das outras despesas acessórias.
frete_incluir.nValSeguronúmeroValor do seguro.
parcelas_incluirlista de objetosParcelas do Pedido de Compra.
parcelas_incluir[].cTipoDoctexto · até 5Tipo de Documento. Lista de tipos de documentos em: /api/v1/geral/tiposdoc.
parcelas_incluir[].dVenctoobrigatóriotexto · até 10Data de vencimento da parcela.
parcelas_incluir[].nDiasnúmero inteiroDias para vencimento da parcela (a partir da data de previsão de entrega).
parcelas_incluir[].nParcelaobrigatórionúmero inteiroNúmero da parcela.
parcelas_incluir[].nPercentobrigatórionúmeroPercentual da parcela em relação ao total do pedido de compra.
parcelas_incluir[].nValorobrigatórionúmeroValor da parcela.
produtos_incluirlista de objetosProdutos do Pedido de Compra.
produtos_incluir[].cCodCategtexto · até 20Código da categoria de compra do item.
produtos_incluir[].cCodIntItemtexto · até 20Código de integração do item do pedido de compra (este é o código do item no seu sistema).
produtos_incluir[].cCodIntProdtexto · até 20Código de integração do cadastro do produto (este é o código do produto no seu sistema).
produtos_incluir[].cDescricaotexto · até 120Descrição do item no pedido.
produtos_incluir[].cEANtexto · até 14Código EAN / GTIN do item no pedido.
produtos_incluir[].cMkpAtuPvtexto · até 1Indica que deve atualizar o preço de venda do produto no recebimento.
produtos_incluir[].cMkpAtuSmtexto · até 1Indica que deve atualizar o preço apenas se for maior que o atual.
produtos_incluir[].cNCMtexto · até 13Código NCM do item.
produtos_incluir[].cObstextoObservação do item no pedido (elas serão impressas no pedido enviado ao fornecedor).
produtos_incluir[].cProdutotexto · até 60Código do item no pedido (pode ser o mesmo código que aparece na NF-e do fornecedor).
produtos_incluir[].cUnidadetexto · até 6Unidade do item no pedido.
produtos_incluir[].codigo_local_estoquenúmero inteiroCódigo do Local do Estoque. Caso não informado assumirá o Local do Estoque padrão.
produtos_incluir[].nCodProdnúmero inteiroCódigo interno do cadastro do produto (este é o código do produto no Omie).
produtos_incluir[].nDescontonúmeroValor do desconto do item no pedido.
produtos_incluir[].nMkpPercnúmeroPercentual a ser utilizado para a atualização do preço de venda do produto.
produtos_incluir[].nPesoBrutonúmeroPeso bruto (Kg).
produtos_incluir[].nPesoLiqnúmeroPeso líquido (Kg).
produtos_incluir[].nQtdeobrigatórionúmeroQuantidade do item no pedido.
produtos_incluir[].nValUnitobrigatórionúmeroValor unitário do item no pedido.
produtos_incluir[].nValorCofinsnúmeroValor do COFINS.
produtos_incluir[].nValorIcmsnúmeroValor do ICMS.
produtos_incluir[].nValorIpinúmeroValor do IPI.
produtos_incluir[].nValorPisnúmeroValor do PIS.
produtos_incluir[].nValorStnúmeroValor do ICMS ST.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntPedtextoCódigo de integração do pedido de compra (este é o código do pedido de compra no seu sistema).
cCodStatustextoCódigo do status.
cDescStatustextoDescrição do status.
cNumerotextoNúmero do pedido de compra.
nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido de compra no Omie).
POST /api/v1/produtos/pedidocompra/
curl -s https://app.omie.com.br/api/v1/produtos/pedidocompra/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "IncluirPedCompra", "param": [{"cabecalho_incluir": {"cCodIntPed": "INT001", "dDtPrevisao": "09/11/2026", "cCodParc": "", "nQtdeParc": 1, "nCodFor": "14170458", "cCodIntFor": "", "cCodCateg": "", "nCodCompr": 0, "cContato": "", "cContrato": "", "nCodCC": "1208238", "nCodIntCC": 0, "nCodProj": 0, "cNumPedido": "71876", "cObs": "Pedido incluido via API", "cObsInt": "Pedido Cadastrado via API"}, "frete_incluir": {"nCodTransp": 0, "cCodIntTransp": "", "cTpFrete": "9", "cPlaca": "XXX-9999", "cUF": "SP", "nQtdVol": 5, "cEspVol": "", "cMarVol": "", "cNumVol": "", "nPesoLiq": 0.0, "nPesoBruto": 0.0, "nValFrete": 0, "nValSeguro": 0.0, "cLacre": "", "nValOutras": 0.0}, "departamentos_incluir": [{"cCodDepto": "200000002498904", "nPerc": 50}, {"cCodDepto": "200000002498905", "nPerc": 50}], "produtos_incluir": [{"cCodIntItem": "ITEM001", "cCodIntProd": "", "nCodProd": "2037060", "cProduto": "", "cDescricao": "", "cNCM": "", "cUnidade": "", "cEAN": "", "nPesoLiq": 0, "nPesoBruto": 0, "nQtde": 10, "nValUnit": 200, "nDesconto": 0.0, "nValorIcms": 360.0, "nValorSt": 0.0, "nValorIpi": 20.0, "nValorPis": 33.0, "nValorCofins": 152.0, "cObs": "", "cMkpAtuPv": "N", "cMkpAtuSm": "N", "nMkpPerc": 0, "codigo_local_estoque": "", "cCodCateg": ""}]}]}'

ListarMotivosEncerramento

consultaClaudeMCP

Lista os motivos de encerramento cadastrados no aplicativo, para uso na tag nIdMotivoEnc da operação EncerraPedCompra.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 2Campos e estruturas que você pode enviar
CampoTipoDescrição
nPaginanúmero inteiroNúmero da página para resgatar os dados.
nRegistrosPorPaginanúmero inteiroNúmero de registros a serem exibidos por página.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
motivoslista de objetosLista dos motivos de encerramento cadastrados no aplicativo.
motivos[].cDescricaotextoDescrição do motivo do encerramento.
motivos[].cInativotextoIndica se o motivo está inativo [S/N].
motivos[].nIdMotivoEncnúmero inteiroID do motivo do encerramento, aceito na tag nIdMotivoEnc da operação EncerraPedCompra.
nPaginanúmero inteiroNúmero da página retornada.
nRegistrosPorPaginanúmero inteiroNúmero de registros retornados na página.
nTotalPaginasnúmero inteiroNúmero total de páginas.
nTotalRegistrosnúmero inteiroTotal de registros encontrados.
POST /api/v1/produtos/pedidocompra/
curl -s https://app.omie.com.br/api/v1/produtos/pedidocompra/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ListarMotivosEncerramento", "param": [{"nPagina": 1, "nRegistrosPorPagina": 100}]}'

PesquisarPedCompra

consultaClaudeChatGPTMCP

Pesquisar por Pedidos de Compra em determinada condição.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 13Campos e estruturas que você pode enviar
CampoTipoDescrição
dDataFinaltextoExibir os pedidos de compra até esta data.
dDataInicialtextoExibir os pedidos de compra a partir desta data.
lApenasAlteradossim/nãoExibir apenas pedidos alterados no periodo. Default = false.
lApenasImportadoApitexto · até 1Exibir apenas pedidos importados por esta API.
lExibirPedidosCanceladostextoExibir os pedidos de compra cancelados.
lExibirPedidosEncerradostextoExibir os pedidos de compra encerrados.
lExibirPedidosFatParciaistextoExibir os pedidos de compra faturados parcialmente.
lExibirPedidosFaturadostextoExibir os pedidos de compra faturados pelo fornecedor.
lExibirPedidosPendentestextoExibir os pedidos de compra pendentes.
lExibirPedidosRecParciaistextoExibir os pedidos de compra recebidos parcialmente.
lExibirPedidosRecebidostextoExibir os pedidos de compra recebidos.
nPaginanúmero inteiroPágina da pesquisa.
nRegsPorPaginanúmero inteiroRegistros por página.
Retorno 13O que volta numa chamada bem-sucedida
CampoTipoDescrição
dDataFinaltextoExibir os pedidos de compra até esta data.
dDataInicialtextoExibir os pedidos de compra a partir desta data.
lApenasImportadoApitextoExibir apenas pedidos importados por esta API.
lExibirPedidosCanceladostextoExibir os pedidos de compra cancelados.
lExibirPedidosEncerradostextoExibir os pedidos de compra encerrados.
lExibirPedidosFaturadostextoExibir os pedidos de compra faturados pelo fornecedor.
lExibirPedidosPendentestextoExibir os pedidos de compra pendentes.
lExibirPedidosRecebidostextoExibir os pedidos de compra recebidos.
nPaginanúmero inteiroPágina da pesquisa.
nRegsPorPaginanúmero inteiroRegistros por página.
nTotalPaginasnúmero inteiroTotal de páginas disponíveis na pesquisa.
nTotalRegistrosnúmero inteiroTotal de registros disponíveis na pesquisa.
pedidos_pesquisalista de objetosLista com os pedidos de compra.
pedidos_pesquisa[].cabecalho_consultaobjetoCabeçalho do Pedido de Compra.
pedidos_pesquisa[].cabecalho_consulta.cCodCategtextoCódigo da categoria de compra.
pedidos_pesquisa[].cabecalho_consulta.cCodIntFortextoCódigo de integração do fornecedor do pedido (este é o código do fornecedor no seu sistema).
pedidos_pesquisa[].cabecalho_consulta.cCodIntPedtextoCódigo de integração do pedido de compra (este é o código do pedido no seu sistema).
pedidos_pesquisa[].cabecalho_consulta.cCodParctextoCódigo da Condição de Pagamento/Parcelamento. "999" - Padrão.
pedidos_pesquisa[].cabecalho_consulta.cContatotextoNome do contato no fornecedor responsável pelo pedido de compra.
pedidos_pesquisa[].cabecalho_consulta.cContratotextoNúmero do Contrato de Compra.
pedidos_pesquisa[].cabecalho_consulta.cEtapatextoEtapa atual do pedido de compra.
pedidos_pesquisa[].cabecalho_consulta.cIncHoratextoHora de inclusão ou de criação.
pedidos_pesquisa[].cabecalho_consulta.cNumPedidotextoNúmero do pedido para o fornecedor.
pedidos_pesquisa[].cabecalho_consulta.cNumerotextoNúmero do pedido de compra.
pedidos_pesquisa[].cabecalho_consulta.cObstextoObservações do pedido de compra (elas não serão impressas no pedido enviado ao fornecedor).
pedidos_pesquisa[].cabecalho_consulta.cObsInttextoObservações internas do pedido (elas serão exibidas apenas para quem consultar o pedido de compra).
pedidos_pesquisa[].cabecalho_consulta.dDtPrevisaotextoData de previsão de entrega do pedido de compra.
pedidos_pesquisa[].cabecalho_consulta.dIncDatatextoData de inclusão ou de criação.
pedidos_pesquisa[].cabecalho_consulta.nCodCCnúmero inteiroCódigo interno da conta corrente do pedido de compra (este é o código da conta corrente no Omie).
pedidos_pesquisa[].cabecalho_consulta.nCodComprnúmero inteiroCódigo do comprador do pedido.
pedidos_pesquisa[].cabecalho_consulta.nCodFornúmero inteiroCódigo interno do fornecedor do pedido (este é o código do fornecedor no Omie).
pedidos_pesquisa[].cabecalho_consulta.nCodIntCCtextoCódigo de integração da conta corrente do pedido (este é o código da conta corrente no seu sistema).
pedidos_pesquisa[].cabecalho_consulta.nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido no Omie).
pedidos_pesquisa[].cabecalho_consulta.nCodProjnúmero inteiroCódigo do projeto relacionado ao pedido de compra.
pedidos_pesquisa[].cabecalho_consulta.nQtdeParcnúmero inteiroQuantidade de parcelas do pedido.
pedidos_pesquisa[].caracteristicas_consultaobjetoCaracterísticas do Pedido de compra.
pedidos_pesquisa[].caracteristicas_consulta.cConteudotextoConteúdo da Característica do Pedido de Compra.
pedidos_pesquisa[].caracteristicas_consulta.cNometextoNome da Característica do Pedido de Compra.
pedidos_pesquisa[].departamentos_consultalista de objetosDepartamentos do Pedido de Compras.
pedidos_pesquisa[].departamentos_consulta[].cCodDeptotextoCódigo do Departamento.
pedidos_pesquisa[].departamentos_consulta[].nPercdecimalPercentual de rateio.
pedidos_pesquisa[].departamentos_consulta[].nValordecimalValor do rateio.
pedidos_pesquisa[].frete_consultaobjetoFrete, Transporte e Outras Despesas do Pedido de Compra.
pedidos_pesquisa[].frete_consulta.cCodIntTransptextoCódigo de integração da transportadora (este é o código da transportadora no seu sistema).
pedidos_pesquisa[].frete_consulta.cEspVoltextoEspécie dos volumes.
pedidos_pesquisa[].frete_consulta.cLacretextoNúmero do lacre.
pedidos_pesquisa[].frete_consulta.cMarVoltextoMarca dos volumes.
pedidos_pesquisa[].frete_consulta.cNumVoltextoNumeração dos volumes.
pedidos_pesquisa[].frete_consulta.cPlacatextoPlaca do veículo de transporte.
pedidos_pesquisa[].frete_consulta.cTpFretetextoModalidade do frete no pedido.
pedidos_pesquisa[].frete_consulta.cUFtextoUF da placa do veículo do transporte.
pedidos_pesquisa[].frete_consulta.nCodTranspnúmero inteiroCódigo interno da transportadora (este é o código da transportadora no Omie).
pedidos_pesquisa[].frete_consulta.nPesoBrutodecimalPeso bruto (Kg).
pedidos_pesquisa[].frete_consulta.nPesoLiqdecimalPeso líquido (Kg).
pedidos_pesquisa[].frete_consulta.nQtdVolnúmero inteiroQuantidade de volumes.
pedidos_pesquisa[].frete_consulta.nValFretedecimalValor do frete.
pedidos_pesquisa[].frete_consulta.nValOutrasdecimalValor das outras despesas acessórias.
pedidos_pesquisa[].frete_consulta.nValSegurodecimalValor do seguro.
pedidos_pesquisa[].parcelas_consultalista de objetosParcelas do Pedido de Compras.
pedidos_pesquisa[].parcelas_consulta[].cTipoDoctextoTipo de Documento. Lista de tipos de documentos em: /api/v1/geral/tiposdoc.
pedidos_pesquisa[].parcelas_consulta[].dVenctotextoData de vencimento da parcela.
pedidos_pesquisa[].parcelas_consulta[].nDiasnúmero inteiroDias para vencimento da parcela (a partir da data de previsão de entrega).
pedidos_pesquisa[].parcelas_consulta[].nParcelanúmero inteiroNúmero da parcela.
pedidos_pesquisa[].parcelas_consulta[].nPercentdecimalPercentual da parcela em relação ao total do pedido de compra.
pedidos_pesquisa[].parcelas_consulta[].nValordecimalValor da parcela.
pedidos_pesquisa[].produtos_consultalista de objetosProdutos do Pedido de Compra.
pedidos_pesquisa[].produtos_consulta[].cCodCategtextoCódigo da categoria de compra do item.
pedidos_pesquisa[].produtos_consulta[].cCodIntItemtextoCódigo de integração do item do pedido de compra (este é o código do item no seu sistema).
pedidos_pesquisa[].produtos_consulta[].cCodIntProdtextoCódigo de integração do cadastro do produto (este é o código do produto no seu sistema).
pedidos_pesquisa[].produtos_consulta[].cDescricaotextoDescrição do item no pedido.
pedidos_pesquisa[].produtos_consulta[].cEANtextoCódigo EAN / GTIN do item no pedido.
pedidos_pesquisa[].produtos_consulta[].cMkpAtuPvtextoIndica que deve atualizar o preço de venda do produto no recebimento.
pedidos_pesquisa[].produtos_consulta[].cMkpAtuSmtextoIndica que deve atualizar o preço apenas se for maior que o atual.
pedidos_pesquisa[].produtos_consulta[].cNCMtextoCódigo NCM do item.
pedidos_pesquisa[].produtos_consulta[].cObstextoObservação do item no pedido (elas serão impressas no pedido enviado ao fornecedor).
pedidos_pesquisa[].produtos_consulta[].cProdutotextoCódigo do item no pedido (pode ser o mesmo código que aparece na NF-e do fornecedor).
pedidos_pesquisa[].produtos_consulta[].cUnidadetextoUnidade do item no pedido.
pedidos_pesquisa[].produtos_consulta[].codigo_local_estoquenúmero inteiroCódigo do Local do Estoque. Caso não informado assumirá o Local do Estoque padrão.
pedidos_pesquisa[].produtos_consulta[].nCodItemnúmero inteiroCódigo interno do item do pedido de compra (este é o código do item no Omie).
pedidos_pesquisa[].produtos_consulta[].nCodProdnúmero inteiroCódigo interno do cadastro do produto (este é o código do produto no Omie).
pedidos_pesquisa[].produtos_consulta[].nDescontodecimalValor do desconto do item no pedido.
pedidos_pesquisa[].produtos_consulta[].nDespesasdecimalValor das outras despesas acessórias (proporcional para o item do pedido).
pedidos_pesquisa[].produtos_consulta[].nFretedecimalValor do frete (proporcional para o item do pedido).
pedidos_pesquisa[].produtos_consulta[].nMkpPercdecimalPercentual a ser utilizado para a atualização do preço de venda do produto.
pedidos_pesquisa[].produtos_consulta[].nPesoBrutodecimalPeso bruto (Kg).
pedidos_pesquisa[].produtos_consulta[].nPesoLiqdecimalPeso líquido (Kg).
pedidos_pesquisa[].produtos_consulta[].nQtdedecimalQuantidade do item no pedido.
pedidos_pesquisa[].produtos_consulta[].nQtdeRecdecimalQuantidade recebida do Item.
pedidos_pesquisa[].produtos_consulta[].nSegurodecimalValor do seguro (proporcional para o item do pedido).
pedidos_pesquisa[].produtos_consulta[].nValMercdecimalValor total do produto (de mercadoria) no pedido.
pedidos_pesquisa[].produtos_consulta[].nValTotdecimalValor total do item (considerando descontos, despesas e impostos).
pedidos_pesquisa[].produtos_consulta[].nValUnitdecimalValor unitário do item no pedido.
pedidos_pesquisa[].produtos_consulta[].nValorCofinsdecimalValor do COFINS.
pedidos_pesquisa[].produtos_consulta[].nValorIcmsdecimalValor do ICMS.
pedidos_pesquisa[].produtos_consulta[].nValorIpidecimalValor do IPI.
pedidos_pesquisa[].produtos_consulta[].nValorPisdecimalValor do PIS.
pedidos_pesquisa[].produtos_consulta[].nValorStdecimalValor do ICMS ST.
POST /api/v1/produtos/pedidocompra/
curl -s https://app.omie.com.br/api/v1/produtos/pedidocompra/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "PesquisarPedCompra", "param": [{"nPagina": 1, "nRegsPorPagina": 10, "lApenasImportadoApi": "F", "lExibirPedidosPendentes": "T", "lExibirPedidosFaturados": "F", "lExibirPedidosRecebidos": "F", "lExibirPedidosCancelados": "F", "lExibirPedidosEncerrados": "F", "lExibirPedidosRecParciais": "F", "lExibirPedidosFatParciais": "F", "dDataInicial": "01/01/2021", "dDataFinal": "31/12/2021", "lApenasAlterados": "F"}]}'

UpsertPedCompra

altera dadosClaudeMCP

Upsert (inclusão ou alteração) de um Pedido de Compra.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 6Campos e estruturas que você pode enviar
CampoTipoDescrição
agropecuariolista de objetos
agropecuario[].cCpfResponsaveltexto · até 14CPF do responsável técnico legalmente habilitado.
agropecuario[].cNumReceitatexto · até 20Número da receita ou receituário do agrotóxico/defensivo agrícola.
agropecuario[].cSerieGuiatexto · até 9Número de série da guia.
agropecuario[].cUFGuiatexto · até 2UF de emissão da Guia.
agropecuario[].nNumGuianúmero inteiroNúmero da guia.
agropecuario[].nTipoGuianúmero inteiroTipo da Guia 1 - Corresponde ao GTA 2 - Corresponde ao TTA 3 - Corresponde ao DTA 4 - Corresponde ao ATV 5 - Corresponde ao PTV 6 - Corresponde ao GTV 7 - Corresponde ao Guia Florestal (DOF, SisFlora - PA e MT, SIAM - MG).
cabecalho_upsertobjetoCabeçalho do Pedido de Compra.
cabecalho_upsert.cCnpjCpfFortexto · até 20CNPJ / CPF Quando informada as tags nCodFor e cCodIntFor não devem ser informadas.
cabecalho_upsert.cCodCategtexto · até 20Código da categoria de compra.
cabecalho_upsert.cCodIntFortexto · até 20Código de integração do fornecedor do pedido (este é o código do fornecedor no seu sistema).
cabecalho_upsert.cCodIntPedtexto · até 20Código de integração do pedido de compra (este é o código do pedido no seu sistema).
cabecalho_upsert.cCodParctexto · até 3Código da Condição de Pagamento/Parcelamento. "999" - Padrão.
cabecalho_upsert.cContatotexto · até 100Nome do contato no fornecedor responsável pelo pedido de compra.
cabecalho_upsert.cContratotexto · até 20Número do Contrato de Compra. Informação localizada na Aba "Informações Adicionais" do Pedido de Compra.
cabecalho_upsert.cEmailAprovadortexto · até 120Informe aqui o E-mail do usúario que irá aprovar o pedido. Esse usúario deve ter permissão de acesso para realizar a aprovação. Ao informar esse campo o pedido de compra será atribuído a etapa de aprovação com o status de aprovado.
cabecalho_upsert.cNumPedidotexto · até 30Número do pedido para o fornecedor.
cabecalho_upsert.cObstextoObservações do pedido de compra (elas não serão impressas no pedido enviado ao fornecedor).
cabecalho_upsert.cObsInttextoObservações internas do pedido (elas serão exibidas apenas para quem consultar o pedido de compra).
cabecalho_upsert.dDtPrevisaotexto · até 10Data de previsão de entrega do pedido de compra.
cabecalho_upsert.nCodCCnúmero inteiroCódigo interno da conta corrente do pedido de compra (este é o código da conta corrente no Omie).
cabecalho_upsert.nCodComprnúmero inteiroCódigo do comprador do pedido.
cabecalho_upsert.nCodFornúmero inteiroCódigo interno do fornecedor do pedido (este é o código do fornecedor no Omie).
cabecalho_upsert.nCodIntCCtexto · até 20Código de integração da conta corrente do pedido (este é o código da conta corrente no seu sistema).
cabecalho_upsert.nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido no Omie).
cabecalho_upsert.nCodProjnúmero inteiroCódigo do projeto relacionado ao pedido de compra.
cabecalho_upsert.nQtdeParcnúmero inteiroQuantidade de parcelas do pedido.
departamentos_upsertlista de objetosRateio do Pedido de Compra por departamento.
departamentos_upsert[].cCodDeptoobrigatóriotextoDepartamento.
departamentos_upsert[].nPercnúmeroPercentual de rateio.
frete_upsertobjetoFrete, Transporte e Outras Despesas do Pedido de Compra.
frete_upsert.cCodIntTransptexto · até 20Código de integração da transportadora (este é o código da transportadora no seu sistema).
frete_upsert.cEspVoltexto · até 60Espécie dos volumes.
frete_upsert.cLacretexto · até 60Número do lacre.
frete_upsert.cMarVoltexto · até 60Marca dos volumes.
frete_upsert.cNumVoltexto · até 60Numeração dos volumes.
frete_upsert.cPlacatexto · até 7Placa do veículo de transporte.
frete_upsert.cTpFretetexto · até 1Modalidade do frete no pedido.
frete_upsert.cUFtexto · até 2UF da placa do veículo do transporte.
frete_upsert.nCodTranspnúmero inteiroCódigo interno da transportadora (este é o código da transportadora no Omie).
frete_upsert.nPesoBrutonúmeroPeso bruto (Kg).
frete_upsert.nPesoLiqnúmeroPeso líquido (Kg).
frete_upsert.nQtdVolnúmero inteiroQuantidade de volumes.
frete_upsert.nValFretenúmeroValor do frete.
frete_upsert.nValOutrasnúmeroValor das outras despesas acessórias.
frete_upsert.nValSeguronúmeroValor do seguro.
parcelas_upsertlista de objetosParcelas do Pedido de Compra.
parcelas_upsert[].cTipoDoctextoTipo de Documento. Lista de tipos de documentos em: /api/v1/geral/tiposdoc.
parcelas_upsert[].dVenctoobrigatóriotexto · até 10Data de vencimento da parcela.
parcelas_upsert[].nDiasnúmero inteiroDias para vencimento da parcela (a partir da data de previsão de entrega).
parcelas_upsert[].nParcelaobrigatórionúmero inteiroNúmero da parcela.
parcelas_upsert[].nPercentobrigatórionúmeroPercentual da parcela em relação ao total do pedido de compra.
parcelas_upsert[].nValorobrigatórionúmeroValor da parcela.
produtos_upsertlista de objetosProdutos do Pedido de Compra.
produtos_upsert[].cCodCategtexto · até 20Código da categoria de compra do item.
produtos_upsert[].cCodIntItemtexto · até 20Código de integração do item do pedido de compra (este é o código do item no seu sistema).
produtos_upsert[].cCodIntProdtexto · até 20Código de integração do cadastro do produto (este é o código do produto no seu sistema).
produtos_upsert[].cDescricaotexto · até 120Descrição do item no pedido.
produtos_upsert[].cEANtexto · até 14Código EAN / GTIN do item no pedido.
produtos_upsert[].cMkpAtuPvtexto · até 1Indica que deve atualizar o preço de venda do produto no recebimento.
produtos_upsert[].cMkpAtuSmtexto · até 1Indica que deve atualizar o preço apenas se for maior que o atual.
produtos_upsert[].cNCMtexto · até 13Código NCM do item.
produtos_upsert[].cObstextoObservação do item no pedido (elas serão impressas no pedido enviado ao fornecedor).
produtos_upsert[].cProdutotexto · até 60Código do item no pedido (pode ser o mesmo código que aparece na NF-e do fornecedor).
produtos_upsert[].cUnidadetexto · até 6Unidade do item no pedido.
produtos_upsert[].codigo_local_estoquenúmero inteiroCódigo do Local do Estoque. Caso não informado assumirá o Local do Estoque padrão.
produtos_upsert[].nCodItemnúmero inteiroCódigo interno do item do pedido de compra (este é o código do item no Omie).
produtos_upsert[].nCodProdnúmero inteiroCódigo interno do cadastro do produto (este é o código do produto no Omie).
produtos_upsert[].nDescontonúmeroValor do desconto do item no pedido.
produtos_upsert[].nMkpPercnúmeroPercentual a ser utilizado para a atualização do preço de venda do produto.
produtos_upsert[].nPesoBrutonúmeroPeso bruto (Kg).
produtos_upsert[].nPesoLiqnúmeroPeso líquido (Kg).
produtos_upsert[].nQtdenúmeroQuantidade do item no pedido.
produtos_upsert[].nValUnitnúmeroValor unitário do item no pedido.
produtos_upsert[].nValorCofinsnúmeroValor do COFINS.
produtos_upsert[].nValorIcmsnúmeroValor do ICMS.
produtos_upsert[].nValorIpinúmeroValor do IPI.
produtos_upsert[].nValorPisnúmeroValor do PIS.
produtos_upsert[].nValorStnúmeroValor do ICMS ST.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntPedtextoCódigo de integração do pedido de compra (este é o código do pedido de compra no seu sistema).
cCodStatustextoCódigo do status.
cDescStatustextoDescrição do status.
cNumerotextoNúmero do pedido de compra.
nCodPednúmero inteiroCódigo interno do pedido de compra (este é o código do pedido de compra no Omie).
POST /api/v1/produtos/pedidocompra/
curl -s https://app.omie.com.br/api/v1/produtos/pedidocompra/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "UpsertPedCompra", "param": [{"cabecalho_upsert": {"cCodIntPed": "INT001", "dDtPrevisao": "28/12/2026", "cCodParc": "", "nQtdeParc": 3, "nCodFor": "14170458", "cCodIntFor": "", "cCodCateg": "", "nCodCompr": 0, "cContato": "", "cContrato": "", "nCodCC": "1208238", "nCodIntCC": 0, "nCodProj": 0, "cObs": "Pedido alterado via API - Upsert", "cObsInt": "Pedido alterado via API - Upsert"}, "frete_upsert": {"nCodTransp": 0, "cCodIntTransp": "", "cTpFrete": "9", "cPlaca": "XXX-9999", "cUF": "SP", "nQtdVol": 5, "cEspVol": "", "cMarVol": "", "cNumVol": "", "nPesoLiq": 5.0, "nPesoBruto": 10.0, "nValFrete": 50.0, "nValSeguro": 10.0, "cLacre": "", "nValOutras": 0.0}, "departamentos_upsert": [{"cCodDepto": "200000002498904", "nPerc": 40}, {"cCodDepto": "200000002498905", "nPerc": 30}, {"cCodDepto": "200000002498906", "nPerc": 15}, {"cCodDepto": "200000002498907", "nPerc": 15}], "produtos_upsert": [{"cCodIntItem": "ITEM001", "cCodIntProd": "", "nCodProd": "2037060", "cProduto": "", "cDescricao": "", "cNCM": "", "cUnidade": "", "cEAN": "", "nPesoLiq": 0, "nPesoBruto": 0, "nQtde": 10, "nValUnit": 200, "nDesconto": 0.0, "nValorIcms": 360.0, "nValorSt": 0.0, "nValorIpi": 20.0, "nValorPis": 33.0, "nValorCofins": 152.0, "cObs": "Item alterado via API - Upsert", "cMkpAtuPv": "N", "cMkpAtuSm": "N", "nMkpPerc": 0, "codigo_local_estoque": "", "cCodCateg": ""}, {"cCodIntItem": "ITEM002", "cCodIntProd": "", "nCodProd": "2037060", "cProduto": "", "cDescricao": "", "cNCM": "", "cUnidade": "", "cEAN": "", "nPesoLiq": 0, "nPesoBruto": 0, "nQtde": 20, "nValUnit": 200, "nDesconto": 0.0, "nValorIcms": 720.0, "nValorSt": 0.0, "nValorIpi": 40.0, "nValorPis": 66.0, "nValorCofins": 304.0, "cObs": "Item incluído via API - Upsert", "cMkpAtuPv": "N", "cMkpAtuSm": "N", "nMkpPerc": 0, "codigo_local_estoque": "", "cCodCateg": ""}]}]}'