Como usar o ambiente de Sandbox

O sandbox da Open API Magalu é um ambiente controlado usado para testar aplicações, códigos ou configurações sem afetar os sistemas reais.

Nosso ambiente de sandbox será um canal da Open e cada marketplace terá um ambiente de sandbox distinto (ex: Magalu, Netshoes, Kabum, enetre outros). Sendo assim, cada canal de sandbox terá um identificador único mediante o marketplace que se deseja atuar.

Verifique abaixo quais os canais de sandbox disponibilizados:

Magalu: 5f62650a-0039-4d65-9b96-266d498c03bd (atualmente com o módulo de Catálogo/Produto ativo inicialmente)

Como se conectar a um canal de sandbox?​

Cliente de aplicação:
A integradora/seller deve criar seu client conforme a documentação disponibilizada em https://developers.magalu.com/docs/first-steps/create-an-application/create-application, podendo utilizar um client já existente.

Audência de sandbox
É necessário que exista uma audiência de sandbox. https ://api-sandbox.magalu.com
Caso não tenha, utilizar:
idm client update --uuid "uuid" --audience "https ://api.magalu.com,https ://api-sandbox.magalu.com,https ://services.magalu.com"

Escopos
Para acessar todos os escopos das APIs, é necessário configurar os seguintes escopos:
Catálogo/Produtos: open:portfolio-skus-seller:read open:portfolio-skus-seller:write open:portfolio-prices-seller:read open:portfolio-prices-seller:write open:portfolio-stocks-seller:read open:portfolio-stocks-seller:write

Consentimento
Efetuar o fluxo de autenticação mostrado na documentação: Autenticação e autorização | Magalu Devs
Nota: O tenant usado para o consentimento pode ser qualquer um, inclusive a conta pessoa física da integradora.

Conexão para consentimento (atentar para sempre usar o channel_id do sandbox):

curl --request PUT \
--url https://api-sandbox.magalu.com/v1/samples/onboarding \
--header 'authorization: Bearer {{token}}' \
--header 'content-type: application/json' \
--header 'x-tenant-id: ' \
--data '{
"channel_id": "5f62650a-0039-4d65-9b96-266d498c03bd"
}

Resposta para a solicitação de consentimento:​

{
  "seller_id": "GENPUB.cd994404-973a-4fe1-9089-46fad31073a5",
  "seller_alias": "sandbox-alias",
  "channel_id": "5f62650a-0039-4d65-9b96-266d498c03bd",
  "channel_alias": "sandbox-1"
}

Utilização das APIs em sandbox:​

Após efetuar os passos acima, deverá ser possível obter o token e efetuar chamadas conforme documentação das APIs, sendo:
Host: https ://api-sandbox.magalu.com
Channel ID: 5f62650a-0039-4d65-9b96-266d498c03bd (quando aplicável)

atenção

Disponibilizaremos o ambiente de sandbox por módulos, sendo Catálogo/Produto inicialmente, sendo seguido pelo módulo de Pedidos, SAC, Perguntas & Respostas e Chat com o Cliente.

Por se tratar de ambiente de homologação/testes, iremos efetuar uma limpeza dos dados a cada 3 (três) meses automaticamente, a partir da data que for iniciado o uso do sandbox, reiniciando a cada novo processo de autenticação.

Qualquer dúvida sobre esse ambiente, por favor entre em contato com nosso suporte.