Este método exclui um ou mais itens de um orçamento de venda já cadastrado, com o mesmo comportamento da exclusão de item na Manutenção de Pedidos de Vendas (PRX125915) em modo orçamento. O item é removido de vez do orçamento (não vira quantidade cancelada), e o orçamento tem desconto geral, impostos e valor total recalculados na mesma gravação.

api/OrcamentoVenda/{numero}/itens/exclusao

<IP do Serviço>:<Porta liberada para o serviço>/api/OrcamentoVenda/123456/itens/exclusao?CodigoEstabelecimento=1

• {numero} (*) - Número do orçamento cujos itens serão excluídos.
• CodigoEstabelecimento - (Opcional) Estabelecimento ao qual pertence o orçamento. Quando não informado, é usado o estabelecimento da conexão do serviço.

{
  "itens": [
    {
      "codigoProduto": 1001,
      "sequencia": 1
    },
    {
      "codigoProduto": 1002,
      "sequencia": 2
    }
  ]
}

Campos com (*) são obrigatórios:

• itens (*) → Lista → Itens que serão excluídos. Precisa ter ao menos um item, sem repetir o mesmo produto com a mesma sequência.
  • codigoProduto (*) → Long → Código do produto do item.
  • sequencia (*) → Inteiro → Sequência do item no orçamento. Junto com o produto, identifica o item, inclusive quando o mesmo produto aparece em mais de uma linha.

► Conferência do orçamento

Antes de excluir, o método confere que o orçamento:

• existe e ainda está na situação de orçamento;
• não é um Orçamento de Itens Sob Projeto (esses são mantidos pelo PRX123915);
• ainda não gerou pedido de venda nem virou pedido;
• está em uma etapa que permite a rotina de Manutenção de Orçamentos e Pedidos, quando a empresa usa controle de etapas;
• não está aberto no ERP por outro usuário.

► Localização dos itens

Cada item é procurado no orçamento pelo produto e sequência. O item que não é encontrado é ignorado, e o retorno avisa que ele não foi excluído; os demais seguem. Se nenhum dos itens enviados for encontrado, nada é gravado.

► Conferência de cada item excluído

Não pode ser excluído o item que:

• possui SMA ativa ou encerrada;
• possui atividades de fluxo que não estão canceladas.

► Gravação

Se qualquer item encontrado for recusado, nenhum item é excluído. Com todos aceitos, o ERP:

• remove os itens do orçamento, com a política de desconto e os tributos de cada um;
• recalcula o desconto geral do orçamento: com o parâmetro DEFINE-PCT-BASE-VALOR-DESCONTO ativo, mantém o valor do desconto e recalcula o percentual; desativado, mantém o percentual e recalcula o valor;
• recalcula IPI, ICMS-ST e os tributos da reforma (CBS, IBS e IS) dos itens que ficam, e o valor total do orçamento, com a mesma fórmula da tela;
• recalcula as parcelas pela condição de pagamento somente com os parâmetros PV-UTIL-COND-PERS e PRX125915-SEMPRE-GRAVA-PEDVP ativos, preservando as parcelas de antecipação; sem eles, as parcelas existentes não mudam;
• renumera as sequências dos itens que ficam de 1 em diante;
• registra a exclusão no histórico do orçamento.

A situação, a aprovação e a revisão do orçamento continuam as mesmas.

O retorno traz em dados uma mensagem por item enviado, dizendo se ele foi excluído ou se não foi encontrado:

{
  "bemSucedido": true,
  "mensagemFalha": null,
  "novoCodigo": null,
  "dados": [
    { "descricao": "Produto 1001 da sequência 1 excluído.", ... },
    { "descricao": "Produto 1002 da sequência 7 não foi encontrado no orçamento e não foi excluído.", ... }
  ]
}

Lista de itens vazia, produto ou sequência não informados, ou item repetido recusam a requisição (HTTP 400) antes de qualquer consulta ao orçamento. O motivo de cada campo vem em dados:

{
  "bemSucedido": false,
  "mensagemFalha": "Algumas validações para a exclusão de itens no orçamento não foram bem-sucedidas. Consulte os detalhes para mais informações.",
  "novoCodigo": null,
  "dados": [ ... ]
}

A recusa também volta com HTTP 400 e bemSucedido igual a false, com uma mensagem por problema em dados. As mais comuns: