Níveis de acesso
Cada escopo da API pode ser liberado em dois níveis:| Nível | Métodos HTTP permitidos | Quando usar |
|---|---|---|
| Visualizar | GET | O app só precisa ler dados da loja, consultar pedidos, listar produtos, verificar estoque. |
| Gerenciar | GET, POST, PUT, PATCH, DELETE | O app precisa criar ou modificar dados, atualizar status, criar cupons, registrar rastreamento. |
Como selecionar as permissões no painel

Acesse as configurações do app
No Painel de Parceiros, vá em Parceiro Tech, Meus aplicativos e selecione o app e clique em Configurações da integração.
Localize a seção de permissões
Role até Permissões do aplicativo. Cada módulo disponível aparece com duas opções: Visualizar e Gerenciar.
Marque o nível correto por módulo
Para cada módulo que o app precisa acessar, marque o nível adequado. Se o app só precisa ler, marque apenas Visualizar. Se também precisa escrever, marque Visualizar e Gerenciar. O acesso de gerenciamento não inclui automaticamente o acesso de leitura.
Escopo das permissões
Catálogo
Catálogo
| Nível | Ações permitidas |
|---|---|
| Visualizar | Consultar produtos, SKUs, categorias, coleções, variações, imagens, avaliações e estoque |
| Gerenciar | Criar, editar, atualizar e excluir produtos, SKUs, categorias, coleções, variações e imagens; atualizar estoque; gerenciar avaliações |
Banners
Banners
Promoções
Promoções
| Nível | Ações permitidas |
|---|---|
| Visualizar | Consultar cupons, combos, descontos progressivos, frete grátis, upsells, order bumps e cashback |
| Gerenciar | Criar, editar, atualizar e excluir cupons, combos e demais regras de promoção; gerenciar saldo de cashback |
Logística
Logística
| Nível | Ações permitidas |
|---|---|
| Visualizar | Consultar transportadoras, armazéns, embalagens, preços de frete e reservas de estoque |
| Gerenciar | Criar, editar, atualizar e excluir transportadoras, armazéns e embalagens; gerenciar preços de frete e reservas de estoque |
Clientes
Clientes
| Nível | Ações permitidas |
|---|---|
| Visualizar | Consultar cadastro de clientes, endereços e clusters |
| Gerenciar | Criar, editar e atualizar clientes, endereços e regras de frete por cluster |
Leads
Leads
| Nível | Ações permitidas |
|---|---|
| Visualizar | Consultar leads cadastrados na loja |
| Gerenciar | Atualizar, gerenciar e exportar leads |
Configurações
Configurações
| Nível | Ações permitidas |
|---|---|
| Visualizar | Consultar dados da loja, credenciais, configurações de checkout e integrações ativas |
| Gerenciar | Editar, atualizar e gerenciar dados da loja, configurações de checkout e integrações |
Pedidos
Pedidos
| Nível | Ações permitidas |
|---|---|
| Visualizar | Consultar pedidos, endereços, comentários, notas fiscais, etiquetas e rastreamento |
| Gerenciar | Atualizar status de pedidos, adicionar e atualizar comentários, emitir notas fiscais, gerar etiquetas e registrar rastreamento |
Checkout
Checkout
| Nível | Ações permitidas |
|---|---|
| Visualizar | Consultar formas de pagamento, gateways, parcelamento, status de pedidos e transações |
| Gerenciar | Configurar, atualizar e gerenciar formas de pagamento e transações |
Conteúdos
Conteúdos
| Nível | Ações permitidas |
|---|---|
| Visualizar | Consultar páginas estáticas e redirecionamentos |
| Gerenciar | Criar, editar, atualizar e excluir páginas estáticas e redirecionamentos |
Links de pagamento
Links de pagamento
| Nível | Ações permitidas |
|---|---|
| Visualizar | Consultar links de pagamento criados na loja |
| Gerenciar | Criar, editar, atualizar e excluir links de pagamento |
Planeje as permissões com antecedência. Cada alteração gera um novo ciclo de análise e impacta lojistas com o app já instalado. Mais detalhes em Atualizando aplicativos publicados.