Oi Daniel!
Vamos lá… Primeiramente você vai ter que ter um programa para rodar essa API, aqui na VTEX normalmente usamos o Postman, mas você pode utilizar qualquer outra plataforma que deseje.
Nele, você vai precisar importar o cURL dessa API, para fazer isso você vai precisar executar dois passos:
- Copiar o cURL dessa requisição aqui:
Obs¹.: Reparei que esse cURL precisava de alguns ajustes (alterei a variável para accountName e inseri {reservationId} no lugar correto) então já fiz eles, e vou deixar um cURL já ajustado para você usar aqui:
curl --request post \
--url https://{{accountName}}.vtexcommercestable.com.br/api/logistics/pvt/inventory/reservations/{reservationId}/cancel \
--header 'Accept: application/json' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'X-VTEX-API-AppKey: ' \
--header 'X-VTEX-API-AppToken: '
- Importar ele para o seu Postman, aqui:
Após isso você vai precisar executar essa requisição, mas antes de fazer isso será necessário, substituir o nome da sua account e inserir uma autenticação (AppKey e AppToken):
Obs².: Vou deixar aqui a nossa documentação de como gerar AppKey e AppToken aqui caso você não saiba: Chaves de aplicação | VTEX Help Center.
Obs³.: Para conseguir gerar essas chaves você precisar ter o perfil de acesso User Administrator - RESTRICTED, tem um tópico que eu publiquei recentemente aqui sobre isso: Dúvidas Frequentes: Porque não consigo adicionar novos usuários na plataforma? | Community VTEX.
Bom, após isso basta você preencher o campo {reservationId} com o id da reserva:
Obs.: Para conseguir o {reservationId} basta acessar o seu Gerenciamento de Inventário referente ao produto com a reserva que você quer cancelar, clicar no número de produtos reservados:
Na página que irá abrir você conseguirá obter o {reservationId} para substituir no campo indicado na imagem enviada anteriormente:
Feito isso, você deverá clicar em Send e obter um retorno com Status: 200 Ok:
Entretanto, caso você não queira realizar esse processo, basta esperar por 11 dias, que essa reserva irá expirar. Repare que na documentação de como funciona a Reserva, temos o destaque sobre o período:
Karina Mota
Field Software Engineer | VTEX