Como funciona a Alterar pedido

5 min de leitura

A funcionalidade Alterar pedido permite que você mude um pedido de diversas maneiras, seja a mudança motivada pela vontade do cliente, pela indisponibilidade de produtos ou outros motivos. Os principais tipos de alteração de pedidos são:

Adicionar: uma quantidade de itens ou novos produtos.
Remover: uma quantidade parcial ou total de itens.
Alterar peso: os itens podem passar a ter um peso maior ou menor.
Substituir itens: trocar itens por outros, incluindo itens precificados por peso.
Alterar preço: mudar valor total do pedido.

Para ver o passo a passo completo de como realizar cada ação, veja a documentação Como alterar pedidos. O artigo atual aborda outros aspectos da Alterar pedido e está organizado da seguinte forma:

Alterações pelo Admin VTEX e API
Características gerais
Mudanças de preço

Alterações pelo Admin VTEX e API

Existem duas vias pelas quais um pedido pode ser alterado, veja os detalhes na tabela a seguir:

Como alterar	Descrição	Status que admite alteração
Via Admin VTEX	A alteração é feita pela página de detalhes do pedido, que pode ser acessada em Pedidos > Todos os pedidos, selecionando o pedido desejado.Também é possível acessar o pedido usando a barra de busca no topo do Admin VTEX. Para isso, clique sobre a barra, selecione a opção Pedidos e utilize algum dos seguintes critérios: ID do pedido Nome do cliente Email do cliente Documento do cliente Artigo no Help Center: Como alterar pedidos	`preparando entrega`
Via API	Altera pelos endpoints: Create order modifications Preview order modifications Get order modifications detail Get order modifications history Retry order modifications Cancel order modifications Get Order modifications settings Update Order modifications settings	`handling` `waiting-for-fulfillment` `ready for invoicing`

O histórico de alterações do pedido fica registrado na sua página de detalhes, na seção Histórico de itens alterados. Para consultar essa informação por API, utilize o endpoint Get order modifications history.

Características gerais

A Alterar pedidos possui características específicas, como apresentado na tabela a seguir:

Aspecto	Descrição
Número de alterações do pedido	Não existe um limite para quantas vezes um pedido pode ser alterado.
Pedidos incompletos	Não é possível alterar pedidos incompletos, aqueles que não têm todas as informações necessárias para serem processados pela plataforma VTEX.
Contas franquia	É possível alterar pedidos nos quais o seller é um conta franquia.
Marketplace VTEX, certificado, parceiro e externo	A alteração de pedidos se comporta de forma diferente nos vários cenários de marketplace na VTEX: É possível alterar pedidos de lojas que atuam tanto como seller VTEX quanto como marketplace VTEX. É possível alterar pedidos de Multilevel Omnichannel Inventory (MOI) quando são realizados em marketplaces externos. Não é possível alterar pedidos realizados em marketplaces certificados e marketplaces parceiros.
Reserva	A reserva de itens em cenários de alteração de pedidos é automática.
Atualização de inventário	Ao alterar um pedido, o inventário da loja não é atualizado automaticamente, isso precisa ser feito ela loja no Admin VTEX em Catálogo > Estoque > Gerenciamento de inventário, ou via API, usando o endpoint Update inventory by SKU and warehouse.
Permissão no Licence Manager	Para um usuário ser capaz de alterar pedidos, o seu perfil de acesso precisa estar associado a pelo menos um dos seguintes recursos do Licence Manager: `Orders Full Access` `Change order`

Mudanças de preço

Quando a alteração de itens do pedido aumenta ou diminui o valor original da compra, a comunicação do módulo Pedidos é feita de forma automática com Pagamentos e acontece da seguinte forma:

Preço menor após alteração: O comportamento depende do status do pagamento no fluxo de transação.
- Se o pagamento foi liquidado (status settled), uma notificação é enviada ao gateway de pagamento para estornar o valor que deve ser devolvido ao cliente.
- Se o pagamento ainda não foi liquidado, uma notificação é enviada ao gateway para modificar o total do pedido.
Preço maior após alteração: uma notificação é enviada ao gateway de pagamento para solicitar que o cliente pague o valor adicional.

Veja na tabela abaixo mais informações sobre pagamento e fatura na alteração de pedidos:

Aspecto	Informações
Condições para aumentar preço do pedido	Só é possível aumentar o preço de um pedido quando ele atende aos seguintes critérios: O pedido foi feito com cartão de crédito, promissórias ou customer credit. O adquirente do pedido permite transações sem o código CVV. O adquirente do pedido permite duas transações de cobrança no mesmo pedido. Se o conector não permitir alterações para valores maiores, uma nova transação será realizada com o valor excedente, e a transação não terá vínculo com o pedido original.
Alteração de pedido liquidado	No fluxo de transação, o pedido pode ser alterado no status `settled` (liquidado), desde que cumpra as seguintes condições: O pedido foi feito com um cartão de crédito. A liquidação do pagamento ocorre antes do pedido ser faturado. O conector de pagamento está configurado para permitir reembolsos parciais. Atualmente, a Adyen é o único conector de pagamento que suporta essa operação. Pedidos em que a transação se encontra com status `finished` (concluído) não podem ser alterados.
Transação compartilhada entre sellers e marketplace	É possível alterar pedidos que envolvem mais um de seller e pagamentos no ambiente do marketplace, ou seja, cenários com split de pagamento.
Descontos	Não é possível alterar o pedido aplicando descontos maiores ou iguais ao valor total do pedido original.
Fatura	Com relação à fatura, a alteração de pedidos se comporta da seguinte forma: Se o pedido já foi faturado por completo, ele não pode mais ser alterado. Pedidos ainda não faturados ou apenas parcialmente faturados podem sim ser alterados. O valor das faturas parciais do pedido alterado precisa ser igual ou maior que o valor de uma fatura já emitida. Se o valor total do pedido alterado for menor do que o valor de uma fatura já emitida, ele não pode ser alterado. Em geral, é o faturamento do pedido que deflagra a liquidação do pagamento. Este comportamento é diferente para lojas que configuraram a liquidação automática.