{"section":"tutorials","requestedLocale":"pt","requestedSlug":"como-funciona-a-alterar-pedido","locale":"pt","slug":"como-funciona-a-alterar-pedido","path":"docs/pt/tutorials/pedidos/todos-os-pedidos/como-funciona-a-alterar-pedido.md","branch":"main","content":"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: \n\n* **Adicionar:** uma quantidade de itens ou novos produtos.\n* **Remover:** uma quantidade parcial ou total de itens.\n* **Alterar peso:** os itens podem passar a ter um peso maior ou menor.\n* **Substituir itens:** trocar itens por outros, incluindo itens precificados por peso.\n* **Alterar preço:** mudar valor total do pedido.\n\nPara ver o passo a passo completo de como realizar cada ação, veja a documentação [Como alterar pedidos](/pt/docs/tutorials/como-alterar-pedidos). O artigo atual aborda outros aspectos da **Alterar pedido** e está organizado da seguinte forma:\n\n* [Alterações pelo Admin VTEX e API](#alteracoes-pelo-admin-vtex-e-api)\n* [Características gerais](#caracteristicas-gerais)\n* [Mudanças de preço](#mudancas-de-preco)\n\n## Alterações pelo Admin VTEX e API\n\nExistem duas vias pelas quais um pedido pode ser alterado, veja os detalhes na tabela a seguir:\n\n| **Como alterar** | **Descrição** | **Status que admite alteração** |\n|:---:|:--- |:--- |\n| Via Admin VTEX | A alteração é feita pela [página de detalhes do pedido](/pt/docs/tutorials/pagina-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:<ul><li>ID do pedido</li><li>Nome do cliente</li><li>Email do cliente</li><li>Documento do cliente</li></ul>**Artigo no Help Center:** [Como alterar pedidos](/pt/docs/tutorials/como-alterar-pedidos) | <ul><li>`preparando entrega`</li></ul> |\n| Via API | Altera pelos endpoints:<ul><li>[Create order modifications](https://developers.vtex.com/docs/api-reference/orders-api#patch-/api/order-system/orders/-changeOrderId-/changes)</li><li>[Preview order modifications](https://developers.vtex.com/docs/api-reference/orders-api#post-/api/order-system/orders/-changeOrderId-/changes/preview)</li><li>[Get order modifications detail](https://developers.vtex.com/docs/api-reference/orders-api#get-/api/order-system/orders/-changeOrderId-/changes/-changeRequestId-)</li><li>[Get order modifications history](https://developers.vtex.com/docs/api-reference/orders-api#get-/api/order-system/orders/-changeOrderId-/changes)</li><li>[Retry order modifications](https://developers.vtex.com/docs/api-reference/orders-api#post-/api/order-system/orders/-changeOrderId-/changes/-changeRequestId-/retry)</li><li>[Cancel order modifications](https://developers.vtex.com/docs/api-reference/orders-api#post-/api/order-system/orders/-changeOrderId-/changes/-changeRequestId-/cancel)</li><li>[Get Order modifications settings](https://developers.vtex.com/docs/api-reference/orders-api#get-/api/order-system/orders/changes/settings)</li><li>[Update Order modifications settings](https://developers.vtex.com/docs/api-reference/orders-api#put-/api/order-system/orders/changes/settings)</li></ul> | <ul><li>`handling`</li><li>`waiting-for-fulfillment`</li><li>`ready for invoicing`</li></ul> |\n\nO histórico de alterações do pedido fica registrado na sua [página de detalhes](/pt/docs/tutorials/pagina-de-detalhes-do-pedido), na seção **Histórico de itens alterados**. Para consultar essa informação por API, utilize o endpoint [Get order modifications history](https://developers.vtex.com/docs/api-reference/orders-api#get-/api/order-system/orders/-changeOrderId-/changes).\n\n## Características gerais\n\nA **Alterar pedidos** possui características específicas, como apresentado na tabela a seguir:\n\n| **Aspecto** | **Descrição** |\n| :---: | :--- |\n| Número de alterações do pedido | Não existe um limite para quantas vezes um pedido pode ser alterado. |\n| Pedidos incompletos | Não é possível alterar [pedidos incompletos](/pt/docs/tutorials/entendendo-os-pedidos-incompletos), aqueles que não têm todas as informações necessárias para serem processados pela plataforma VTEX. |\n| Contas franquia | É possível alterar pedidos nos quais o seller é um conta franquia. |\n| 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:<ul><li>É possível alterar pedidos de lojas que atuam tanto como seller VTEX quanto como [marketplace VTEX](/pt/docs/tutorials/estrategias-de-marketplace-na-vtex#ser-um-marketplace-vtex).</li><li>É possível alterar pedidos de [Multilevel Omnichannel Inventory (MOI)](/pt/docs/tutorials/multilevel-omnichannel-inventory) quando são realizados em [marketplaces externos](https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces).</li><li>Não é possível alterar pedidos realizados em [marketplaces certificados](/pt/docs/tutorials/estrategias-de-marketplace-na-vtex#integrado-a-marketplaces-certificados) e [marketplaces parceiros](/pt/docs/tutorials/estrategias-de-marketplace-na-vtex#integrado-a-marketplaces-parceiros).</li></ul> |\n| Reserva | A [reserva](/pt/docs/tutorials/como-a-reserva-funciona) de itens em cenários de alteração de pedidos é automática. |\n| Atualização de inventário | Ao alterar um pedido, o [inventário](/pt/docs/tutorials/gerenciar-itens-em-estoque) 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](https://developers.vtex.com/docs/api-reference/logistics-api#put-/api/logistics/pvt/inventory/skus/-skuId-/warehouses/-warehouseId-). |\n| Permissão no Licence Manager | Para um usuário ser capaz de alterar pedidos, o seu [perfil de acesso](/pt/docs/tutorials/perfis-de-acesso) precisa estar associado a pelo menos um dos seguintes [recursos do Licence Manager](/pt/docs/tutorials/recursos-do-license-manager):<ul><li>`Orders Full Access`</li><li>`Change order`</li></ul> |\n\n## Mudanças de preço\n\nQuando 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:\n\n* **Preço menor após alteração:** O comportamento depende do status do pagamento no [fluxo de transação](/pt/docs/tracks/fluxo-de-uma-transacao).\n    *  Se o pagamento foi liquidado (status `settled`), uma notificação é enviada ao [gateway](/pt/tracks/payments--6GAS7ZzGAm7AGoEAwDbwJG/kdPbEIWf8Xq8tESQvViMB#gateway) de pagamento para estornar o valor que deve ser devolvido ao cliente.\n    * Se o pagamento ainda não foi liquidado, uma notificação é enviada ao gateway para modificar o total do pedido.\n* **Preço maior após alteração:** uma notificação é enviada ao gateway de pagamento para solicitar que o cliente pague o valor adicional.\n\nVeja na tabela abaixo mais informações sobre pagamento e fatura na alteração de pedidos:\n\n| **Aspecto** | **Informações** |\n|:---:|:--- |\n| 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:<ul><li>O pedido foi feito com cartão de crédito, [promissórias](/pt/docs/tutorials/configurar-pagamentos-com-promissoria) ou [customer credit](/pt/docs/tutorials/customer-credit-visao-geral).</li><li>O [adquirente](/pt/docs/tutorials/o-que-e-um-adquirente) do pedido permite transações sem o código CVV.</li><li>O adquirente do pedido permite duas transações de cobrança no mesmo pedido.</li></ul>Se o [conector](/pt/docs/tutorials/o-que-e-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. |\n| Alteração de pedido liquidado | No [fluxo de transação](/pt/docs/tracks/fluxo-de-uma-transacao), o pedido pode ser alterado no status `settled` (liquidado), desde que cumpra as seguintes condições:<ul><li>O pedido foi feito com um cartão de crédito.</li><li>A liquidação do pagamento ocorre antes do pedido ser faturado.</li><li>O conector de pagamento está configurado para permitir reembolsos parciais. Atualmente, a [Adyen](/pt/tutorial/configuring-payment-with-adyenv3--7xAz67E2Eg63LWCQNjVdwv) é o único conector de pagamento que suporta essa operação.</li></ul>Pedidos em que a transação se encontra com status `finished` (concluído) não podem ser alterados. |\n| 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](/pt/docs/tutorials/split-de-pagamento). |\n| Descontos | Não é possível alterar o pedido aplicando descontos maiores ou iguais ao valor total do pedido original. |\n| Fatura | Com relação à [fatura](/pt/docs/tracks/faturar-um-pedido), a alteração de pedidos se comporta da seguinte forma:<ul><li>Se o pedido já foi [faturado](/pt/docs/tutorials/faturar-um-pedido-manualmente) por completo, ele não pode mais ser alterado.</li><li>Pedidos ainda não faturados ou apenas [parcialmente faturados](/pt/docs/tracks/faturas-parciais) podem sim ser alterados.</li><li>O valor das faturas parciais do pedido alterado precisa ser igual ou maior que o valor de uma fatura já emitida.</li><li>Se o valor total do pedido alterado for menor do que o valor de uma fatura já emitida, ele não pode ser alterado.</li></ul>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](/pt/docs/tutorials/configurar-tempo-maximo-para-liquidacao-automatica). |"}