Como cancelar pedidos via POSTMAN?

Informação técnica: este artigo explica como cancelar pedidos via Postman utilizando a collection do ANYMARKET, o ID do pedido e o Gumga Token da conta.

Neste artigo:

• Pré-requisitos
• Como funciona
• Passo a passo
• Boas práticas
• Dúvidas comuns

Pré-requisitos

• Ter o Postman instalado ou acessível.
• Possuir a collection do ANYMARKET importada no Postman.
• Ter o número do pedido do cliente.
• Identificar o ID interno do pedido no ANYMARKET.
• Possuir o Gumga Token da conta.

Para importar a collection do ANYMARKET, acesse o artigo relacionado: Collections do Postman.

Para localizar o Gumga Token, acesse o artigo relacionado: Onde conseguir o Gumga Token?.

Como funciona

Para cancelar um pedido via Postman, é necessário utilizar a collection do ANYMARKET e informar o ID interno do pedido na requisição de cancelamento.

A partir do número do pedido, é possível localizar o ID interno do pedido de duas formas:

• Pela URL do pedido no ANYMARKET;
• Por consulta no banco de dados.

Passo a passo

1. Localizar o ID do pedido pela URL

Acesse o pedido no ANYMARKET e verifique o ID exibido na URL.

2. Localizar o ID do pedido pelo banco de dados

Também é possível localizar o ID do pedido consultando a tabela salesorder pelo código do pedido no marketplace.

Consulta exemplo:

SELECT * 
FROM salesorder
WHERE id_in_marketplace = '4577823265';

Observação: substitua o valor do campo id_in_marketplace pelo código do pedido no marketplace.

3. Cancelar o pedido pelo Postman

Com o ID do pedido localizado, siga os passos abaixo:

1. Acesse o Postman.

2. Abra a collection do ANYMARKET no caminho Order > Put - Cancelado.

3. Acesse a aba Headers e altere o gumgaToken para o token da conta correspondente.

4. Na URL da requisição, insira o ID do pedido.

5. Clique em Send.

Boas práticas

• Confirme se o pedido correto foi localizado antes de realizar o cancelamento.
• Valide se o ID informado na URL da requisição corresponde ao pedido desejado.
• Utilize o Gumga Token da conta correta.
• Evite executar a requisição sem validar previamente os dados do pedido.
• Após o envio, confira se o status do pedido foi atualizado corretamente.
• Registre evidências da consulta e da requisição quando o procedimento fizer parte de uma análise técnica.

Dúvidas comuns

O que preciso para cancelar um pedido via Postman?
É necessário ter a collection do ANYMARKET, o ID interno do pedido e o Gumga Token da conta.

Onde encontro a collection do ANYMARKET?
No artigo Collections do Postman.

Como encontro o ID interno do pedido?
O ID pode ser localizado pela URL do pedido no ANYMARKET ou por consulta no banco de dados pela tabela salesorder.

Qual collection devo usar?
Use a collection do ANYMARKET no caminho Order > Put - Cancelado.

O que devo alterar nos headers?
Altere o gumgaToken para o token da conta correspondente.

O que devo inserir na URL da requisição?
Insira o ID interno do pedido que será cancelado.

O que fazer após clicar em Send?
Valide se o pedido foi atualizado para o status cancelado corretamente.

Em caso de dúvidas sobre cancelamento de pedidos via Postman, consulte os canais internos responsáveis por API, pedidos ou suporte técnico do ANYMARKET.