> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Permissões de um aplicativo

> Entenda os níveis de acesso disponíveis e saiba quais permissões solicitar ao configurar seu app.

Ao configurar seu app no Painel de Parceiros, você define quais permissões ele vai solicitar ao lojista durante a instalação. O lojista visualiza essas permissões na tela de consentimento OAuth e precisa aceitá-las para concluir a instalação.

***

## 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. |

<Warning>
  Solicite apenas as permissões que o app **realmente utiliza**. Apps com permissões desnecessárias ou sem justificativa podem ser reprovados na homologação de acordo com a [diretriz de aplicativos na Yampi](/apps/criacao-e-configuracao/diretrizes-para-aplicativos-na-yampi#segurança) de **Menor privilégio**.
</Warning>

***

## Como selecionar as permissões no painel

<img src="https://mintcdn.com/yampi/LJ_J1Be7A8qoLlE5/images/apps/permissoes-de-um-aplicativo/permissoes-do-aplicativo.png?fit=max&auto=format&n=LJ_J1Be7A8qoLlE5&q=85&s=0b799fa142469e0ca40698c70b8c1f10" alt="" width="1192" height="910" data-path="images/apps/permissoes-de-um-aplicativo/permissoes-do-aplicativo.png" />

<Steps>
  <Step title="Acesse as configurações do app">
    No [Painel de Parceiros](https://partners.yampi.com.br), vá em **Parceiro Tech**, **Meus aplicativos** e selecione o app e clique em **Configurações da integração**.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Salve as configurações">
    Clique em **Salvar**.
  </Step>
</Steps>

***

## Escopo das permissões

<AccordionGroup>
  <Accordion title="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 |
  </Accordion>

  <Accordion title="Banners">
    | Nível      | Ações permitidas                           |
    | ---------- | ------------------------------------------ |
    | Visualizar | Consultar banners configurados na loja     |
    | Gerenciar  | Criar, editar, atualizar e excluir banners |
  </Accordion>

  <Accordion title="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 |
  </Accordion>

  <Accordion title="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 |
  </Accordion>

  <Accordion title="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 |
  </Accordion>

  <Accordion title="Leads">
    | Nível      | Ações permitidas                      |
    | ---------- | ------------------------------------- |
    | Visualizar | Consultar leads cadastrados na loja   |
    | Gerenciar  | Atualizar, gerenciar e exportar leads |
  </Accordion>

  <Accordion title="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 |
  </Accordion>

  <Accordion title="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 |
  </Accordion>

  <Accordion title="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                    |
  </Accordion>

  <Accordion title="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 |
  </Accordion>

  <Accordion title="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 |
  </Accordion>
</AccordionGroup>

<Note>
  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](/apps/criacao-e-configuracao/atualizando-aplicativos-publicados).
</Note>