Alteração de Armazém de Origem

Descrição

Este endpoint permite o redirecionamento logístico de pedidos, alterando o armazém (estoque) de onde os produtos serão despachados. O acesso exige o escopo de permissão ORDER_WRITE.

Ao realizar a troca, o sistema gerencia a integridade do estoque: a reserva no armazém original é cancelada e uma nova reserva é criada automaticamente no armazém de destino para todos os itens do pedido.

Esta operação só é permitida quando o pedido possui reserva de estoque aberta

Sem essa reserva ativa, a alteração é recusada (por exemplo, após a reserva já ter sido concluída ou cancelada).

Parâmetros

Headers Obrigatórios

Parâmetros de Corpo

Exemplo de Requisição

1curl --request PUT \
2  --url https://sua-loja-uappi.com.br/api/v3/orders/change-storage \
3  --header "Authorization: Bearer SEU_TOKEN_AQUI" \
4  --header "Content-Type: application/json" \
5  --data '{
6    "orders": {
7      "123": 2,
8      "124": 1
9    }
10  }'

✅ Resposta de Sucesso

1[
2  {
3    "orderId": 123,
4    "oldProductStorageId": 1,
5    "newProductStorageId": 2,
6    "error": null
7  },
8  {
9    "orderId": 124,
10    "oldProductStorageId": 2,
11    "newProductStorageId": 1,
12    "error": null
13  }
14]

⚠️ Possíveis erros:

Atenção: a seguir estão destacados os principais erros que podem ocorrer neste endpoint.

Os cenários descritos representam os erros mais relevantes do contexto atual, servindo como referência para entendimento e tratamento das falhas.