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

# WShop

## **Fase 1: Configuração do Backend (Acesso à API)**

*Este passo permite ao Kleep recuperar o seu catálogo de produtos, histórico de encomendas e dados de devoluções para calibrar o algoritmo.*

**1. Fornecer Credenciais de API**

Por favor, partilhe os seguintes dados de autenticação com o seu contacto Kleep:

* **URL da API**
* **Nome de utilizador**
* **Palavra-passe**

**2. Autorizar os Endpoints de API Necessários**

Após a concessão de acesso, a nossa equipa irá obter os dados necessários a partir dos endpoints abaixo. Por favor, certifique-se de que temos autorização para os mesmos:

* `/products/get` (importação de produtos)
* `/sizes/get` (importação de produtos)
* `/returns/getreasons` (importação de encomendas)
* `/returns/get` (importação de devoluções)
* `/orders/get` (importação de encomendas)
* `/departments/get` (importação de produtos)
* `/authentificate` (verificação de autenticação)
* `/attributes/get`

**3. Partilhar as Credenciais**

Envie as credenciais de API ao seu contacto Kleep por e-mail.

***

## **Fase 2: Integração Frontend (Widget)**

*Este passo envolve a adição do script Kleep às suas páginas de produto (PDP). Compatível com todas as versões do WSHOP.*

Siga o nosso [**guia do Widget da Biblioteca JS**](/pt/cms/js-library) para instalar e configurar o CTA frontend nas suas páginas de produto.

***

## **Fase 3: Gestão de Dados em Falta (SFTP)**

*Se a sua API WSHOP não permitir a recuperação de Devoluções ou determinados dados específicos, utilizamos a troca de ficheiros CSV.*

Consulte a documentação abaixo. Irá guiá-lo passo a passo para nos enviar os dados em falta.

***

## **Fase 4: Validação e Entrada em Produção**

1. **Ambiente de Teste:**
   * Implemente primeiro no seu ambiente de **Preprod/Staging**.
2. **Validação Visual:**
   * O botão é apresentado corretamente?
   * O clique abre o pop-up (Drawer)?
   * Não há erros "CORS" na consola do browser?
3. **Entrada em Produção:**
   * Uma vez validado por si e pela equipa Kleep, implemente as alterações no seu ambiente de **Produção**.

***

## **Informações Adicionais**

### Configuração de Produtos

Antes da integração, por favor forneça as seguintes informações:

* **Referência Interna do Produto:**
  * Tem um código de referência específico da marca para cada produto, diferente do ID de produto padrão utilizado pelo WSHOP?
* **Agrupamento de Produtos por Variantes de Cor:**
  * Tem produtos que partilham o mesmo dimensionamento mas estão distribuídos por várias páginas de produto (por exemplo, cores diferentes)? Se sim, como podemos identificar uma referência principal comum a todas as variantes de cor?
* **Dimensões do Produto:**
  * As dimensões do produto estão disponíveis no seu catálogo? Se sim, podemos fornecer-lhe um modelo a preencher para recomendações mais precisas.

### Idiomas Suportados

Kleep suporta os seguintes idiomas: fr, en, de, it, ja, ko, pt, br, es, pl, sv, da, nl, fi.

Por favor, confirme quais os idiomas de que necessita para a sua loja.---

## Cookies e privacidade de dados

O Kleep está totalmente condicionado ao consentimento do visitante: o script só carrega **após** a recolha do consentimento através do seu CMP, e deve condicionar o seu carregamento em conformidade. Para a lista completa de trackers, os dados processados, as finalidades e bases legais, alojamento, subprocessadores e segurança, consulte [Cookies, CMP e Privacidade de Dados](/pt/cookie-consent).