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

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:

Artigo no Help Center: Como alterar pedidos

| preparando entrega

| | Via API | Altera pelos endpoints:Create order modificationsPreview order modificationsGet order modifications detailGet order modifications historyRetry order modificationsCancel order modificationsGet Order modifications settingsUpdate Order modifications settings

| handlingwaiting-for-fulfillmentready 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.

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:

| | 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:

|

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:

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:

| | 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:

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.

|