> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.troquecommerce.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como instalar a Troquecommerce na loja de aplicativos da VTEX

###### Se você possui uma loja virtual na VTEX e está se cadastrando na Troquecommerce, você possivelmente está nesta tela aqui:

![](https://storage.crisp.chat/users/helpdesk/website/ff2e9ea7a06be000/vtex-miolo_1o9wzn5.jpg)

### Para conseguir essas informações, você precisará gerar uma AppKey e um AppToken para Troquecommerce na plataforma da VTEX:
**Passo 01** – Primeiramente acesse sua conta no site de clientes da plataforma.

**Passo 02** – Na parte superior direita, você encontrará um ícone com a inicial do seu e-mail. Ao clicar nele, terá acesso a essas opções, clique em **Configuração de conta**.
![](https://storage.crisp.chat/users/helpdesk/website/ff2e9ea7a06be000/image_1dvlstl.png)

**Passo 03** – No menu de configuração da conta, você encontrará a opção de **Chaves de Aplicação**. Clique nela para acessar.

![](https://storage.crisp.chat/users/helpdesk/website/ff2e9ea7a06be000/image_58cib2.png)

**Passo 04** –Você identificará um botão com o texto **Gerenciar Minhas Chaves**. Por favor, clique nele.
![](https://storage.crisp.chat/users/helpdesk/website/ff2e9ea7a06be000/image_jx84vh.png)

**Passo 05** – no lado direito terá um botão escrito **Gerar chave**, acesse ela.
![](https://storage.crisp.chat/users/helpdesk/website/ff2e9ea7a06be000/image_1f0xr6o.png)

**Passo 06** – Na página de **Informações do usuário**, você deverá vincular as credenciais ao usuário clicando em **Adicionar Perfis**.

![](https://storage.crisp.chat/users/helpdesk/website/ff2e9ea7a06be000/image_j3b6mi.png)

**Passo 08** –   Será listado os usuários pertencentes à sua organização. Selecione o usuário que possua o perfil de Owner e em seguida clique em Adicionar Perfis.
![](https://storage.crisp.chat/users/helpdesk/website/ff2e9ea7a06be000/image_1sl9bw4.png)

**Passo 09** – Selecione o usuário e clique em **Gerar** .
![](https://storage.crisp.chat/users/helpdesk/website/ff2e9ea7a06be000/image_tlwxue.png)


**Passo 10** – Utilize as credenciais salvas, **App Key** e **App Token** nos campos correspondentes no momento de realizar seu cadastro na plataforma Troquecommerce.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/e/ff2e9ea7a06be000/image_1ecaulg.png)


### ⚠️Para garantir o funcionamento da integração sem conceder acessos adicionais, basta habilitar somente as permissões listadas abaixo.

**⚙️1) Recursos Gerais** 
    * a) OMS - OMS access - List Orders 
    * b) OMS - OMS access - View Order 
    * c) Checkout - CheckoutResources - Orders Full Access 
    * d) Checkout - CheckoutResources - Shopping Cart Full Access 
    * e) Catalog - Content - SKUs 
    * f) Logistics - Logistics access - Logistics full access 
    * g) Logistics - Logistics access - Logistics viewer access 
    * h) Logistics - Logistics access - Logistics inventory access 
    * i) 
Logistics - Logistics access - Logistics inventory read only 
    * j) Dynamic Storage - Dynamic storage generic resources - Read only 
    * documents 
    * k) Dynamic Storage - Dynamic storage generic resources - Insert or 
    * update document (not remove) 
    * l) Dynamic Storage - Dynamic storage generic resources - Full access to 
    * all documents 
    * m) Dynamic Storage - Dynamic storage generic resources - Master Data 
    * administrator 
    * n) Seller Register - Seller Administration - View Seller 


**⚙️2) Reembolso Integrado** 
    * a) PCI Gateway - Payment-Make Payments - Process payments 
    * b) PCI Gateway - Payment-Make Payments - View Payment Data 
    * 3) Cupom/Vale Trocas 
    * a) Rates and Benefits - Promotions - Manage benefits and rates 
    * b) Rates and Benefits - Manage benefits and rates - 
    * GerenciarPromocoesETarifas 
    * c) GiftCard - GiftCard - Gift Card full access 


**⚙️4) Troca por Produto** 
    * a) Checkout - CheckoutResources - Orders Full Access 
    * b) Checkout - CheckoutResources - Save Order Configuration 
    * c) OMS - OMS access - Notify payment 
    * d) OMS - OMS access - Cancel order

||| A Plataforma VTEXexibe a chave App Token apenas 1 vez quando é gerada. Caso perca essa chave, deverá realizar o processo novamente para gerar uma nova credencial.
| Sua **URL API** é o mesmo endereço do seu painel administrativo com uma pequena alteração. Substitua **/admin** por **/api** e essa será sua **URL API**. **Exemplo:** Se a URL do seu painel Administrativo é https://meudominio.myvtex.com/admin, sua **URL API** será https://meudominio.myvtex.com/api. ![](https://storage.crisp.chat/users/helpdesk/website/ff2e9ea7a06be000/captura-de-tela-2022-07-15-180_1f3sb90.png)


| A VTEX possui também um guia de como gerar e administrar suas Chaves API. Acesse o link https://help.vtex.com/pt/tutorial/chaves-de-aplicacao--2iffYzlvvz4BDMr6WGUtet para mais informações.