apiDocumentaçãoOperaçõesapiDocumentaçãoOperaçõesIncluirItemPedidoaltera dadosInclui um item no pedido de venda.
| Operação | produtos/pedidovenda:IncluirItemPedido |
|---|---|
| Serviço | PedidoVenda |
| Módulo | Produtos |
| Endpoint | /api/v1/produtos/pedidovenda/ |
incluir item de pedido
| Campo | Tipo | Descrição |
|---|---|---|
cfop | lista de string | Preenchimento Opcional. Utilize a tag "nCodigo" do método "ListarCFOP" da API /api/v1/produtos/cfop/ para obter essa informação. |
codigo_categoria_item | lista de string | Código da Categoria do item. Preenchimento opcional. |
codigo_cenario_impostos_item | lista de integer | Código do Cenário de Impostos. Preenchimento opcional. |
codigo_item_integracao | lista de string | Có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. Preenchimento opcional. |
codigo_local_estoque | lista de integer | Código do Local do Estoque. Preenchimento opcional. |
codigo_pedido obrigatório | lista de integer | ID 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. Preenchimento obrigatório. |
codigo_produto obrigatório | lista de integer | ID 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. Preenchimento obrigatório. |
codigo_tabela_preco | lista de integer | Có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_item | lista de string | Informações para a Nota Fiscal. Preenchimento Opcional. |
item_pedido_compra | lista de integer | Item do Pedido de Compra. Preenchimento Opcional. |
lote_validade | lista de object | Informaçõ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. |
nao_gerar_financeiro | lista de string | Não gerar conta a receber para este item. Preenchimento Opcional. Informar "S" ou "N". (Informe "S" para ativar essa opção). |
nao_movimentar_estoque | lista de string | Não gerar a saída de estoque deste item ao emitir NF-e. Preenchimento Opcional. Informar "S" ou "N". (informe "S" para ativar essa opção). |
nao_somar_total | lista de string | Indica se não deve somar o item no total do documento. |
numero_pedido_compra | lista de string | Item do Pedido de Compra. Preenchimento Opcional. |
numero_recopi | lista de string | Número do registro gerado pelo sistema RECOPI Nacional (Reconhecimento e Controle das Operações com Papel Imune). |
obs_item | lista de string | Observações do item (elas não serão exibidas na Nota Fisca, mas serão impressas no pedido de venda). Preenchimento Opcional. Informação localizada na Aba "Observações" do Item do Pedido de Venda. |
percentual_desconto | lista de number | Percentual de Desconto. Preenchimento opcional. 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 obrigatório | lista de number | Quantidade Preenchimento obrigatório. |
quantidade_trib | lista de number | Quantidade do Item - Tributável |
tipo_desconto | lista de string | Tipo de desconto para o pedido. Pode ser: V - Valor P - Percentual Preenchimento opcional. 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_trib | lista de string | Código da Unidade - Tributável |
valor_desconto | lista de number | Valor do Desconto Preenchimento opcional. 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_unitario obrigatório | lista de number | Valor Unitário Preenchimento obrigatório. |
{
"codigo_pedido": 0,
"codigo_item_integracao": "",
"codigo_produto": 0,
"quantidade": 1,
"valor_unitario": 1,
"cfop": "",
"codigo_cenario_impostos_item": 0
}